Ollama 0.20.4+ 本机 Windows 接入 WaLiCode v0.6.2 教程

仅Windows本机本地调用，无需局域网，Ollama 0.20.4及以上版本搭配WaLiCode v0.6.2，仅填入完整模型名即可完成对接

一、硬性版本要求

  1. Ollama：0.20.4 或更高版本
  2. WaLiCode：v0.6.2（低版本无简化Ollama配置面板）

二、前置操作：Windows打开终端（Win+R 完整步骤）

  1. 键盘同时按下快捷键 Win + R，弹出「运行」小窗口
  2. 在输入框输入 cmd，点击【确定】，打开Windows命令提示符终端
    • 若想用PowerShell：运行窗口输入 powershell 回车
  3. 窗口弹出后，即可输入Ollama相关命令

三、步骤1：检查Ollama版本，不达标则升级

1. 终端输入版本查看命令

ollama --version

2. 判断处理

  1. 正常示例（满足要求）：ollama version 0.20.5，直接下一步
  2. 版本低于0.20.4：
    1. 浏览器打开 Ollama 官网下载新版安装包覆盖安装
    2. 关闭所有终端、重启电脑后重新打开cmd校验版本

四、步骤2：拉取代码专用大模型

1. 终端执行拉取模型命令（任选其一/多个） PS:如果已经有模型，请省略这一步！

# 通义千问代码模型（推荐轻量7B）
ollama pull qwen2.5-coder:7b
# DeepSeek代码模型
ollama pull deepseek-coder:6.7b
# 通用编程大模型
ollama pull llama3.1:8b

2. 等待下载完成

根据网速不同等待几分钟，出现 success 代表模型下载完毕。

五、步骤3：复制完整模型名称（配置核心参数）

  1. 终端输入查看本地模型列表命令
ollama list
  1. 查看输出列表中 NAME 列，完整复制带标签的模型名称 示例输出：
NAME                    ID              SIZE    MODIFIED
qwen2.5-coder:7b        123abc          4.7GB   1 day ago
deepseek-coder:6.7b     456def          3.8GB   3 days ago

重点：必须完整复制 qwen2.5-coder:7b 这种带后缀标签名称，不能简写为 qwen2.5-coder

六、步骤4：校验Ollama本地服务是否正常运行

  1. 打开任意浏览器，地址栏输入
http://127.0.0.1:11434
  1. 页面显示Ollama服务提示文字，代表本地服务正常；
  2. 空白/无法访问：在终端输入 ollama serve 启动后台服务，保持终端窗口不要关闭。

七、步骤5：安装并启动 WaLiCode v0.6.2

  1. 关闭电脑上正在运行的旧版WaLiCode软件
  2. 下载v0.6.2安装包，覆盖安装，全程默认下一步即可
  3. 双击桌面WaLiCode图标启动软件
  4. 查看软件左下角版本号，确认显示 v0.6.2

八、步骤6：WaLiCode Ollama渠道完整配置（本机专用）

1. 进入渠道设置页面

  1. 软件左侧侧边栏点击【设置】图标
  2. 顶部切换标签页到【渠道配置】
  3. 点击页面下方【新建渠道】按钮
  4. 渠道类型下拉菜单，选择 Ollama

2. 固定基础参数（本机无需修改任何内容）

配置项 填写内容 补充说明 BaseUrl http://127.0.0.1:11434 Windows本机固定地址，禁止修改 APIKey local Ollama本地无验证密钥，随便填写字符均可，也可不填

3. 关键配置：粘贴Ollama模型名称

找到【模型名称】输入框，把第五步复制的完整模型名粘贴进去 示例：qwen2.5-coder:7b

4. 保存配置

点击页面底部【保存渠道】按钮，渠道列表会新增一条Ollama配置。

九、步骤7：测试本地模型调用是否成功

  1. 返回WaLiCode主代码对话界面
  2. 页面顶部模型下拉框，选中刚刚新建的Ollama渠道
  3. 在对话输入框输入测试代码指令：
输出一段Python冒泡排序完整代码，附带注释
  1. 等待几秒，软件正常返回代码内容，即代表本机Ollama接入WaLiCode完成。

十、Windows本机常见报错排查

问题1：WaLiCode提示「模型不存在」

  1. 模型名称简写、缺失:xxb标签；
  2. Ollama未完成模型下载； 解决：重新打开cmd执行ollama list复制完整名称，重启Ollama服务。

问题2：请求超时、无响应

  1. Ollama后台服务未启动，浏览器打不开127.0.0.1:11434；
  2. 11434端口被其他软件占用； 解决：cmd输入ollama serve保持窗口后台运行，关闭占用端口软件。

问题3：接口解析失败、报错

原因：Ollama版本低于0.20.4，接口协议不兼容v0.6.2； 解决：升级Ollama到0.20.4以上版本，重启电脑后重新配置渠道。

问题4：模型失败、报错

原因：看看有没有用中文字符！！！； 解决：换成英文输出。