Ollama Roo Code
Roo Code 是 Cline 的一个衍生项目（原 Roo Cline），在 VS Code 里提供自主编码代理，配置项比 Cline 更细。接 Ollama 的路径几乎一样。
版本基线 v0.40.12，官方
docs.ollama.com/integrations/roo-code。
一、安装
从 VS Code 应用市场安装 Roo Code。
二、接本地 Ollama
- 在 VS Code 中打开 Roo Code，点窗口右上角的齿轮图标进入 Provider Settings
- 把
API Provider设为 Ollama - （可选）如果 Ollama 跑在远程机器上，修改
Base URL；默认是http://localhost:11434 - 填一个有效的
Model ID，例如qwen3或qwen3-coder:480b-cloud - 把
Context Window调到至少 32K tokens
第 5 步是必须的。编码工具需要大上下文，官方明确建议 ≥ 32K。
三、接 ollama.com 云端
- 在
ollama.com/settings/keys生成 API Key - 勾选
Use custom base URL，设为https://ollama.com - 填入 Ollama API Key
- 从列表里选模型
四、配置项速查
| 配置项 | 本地 | 云端 |
|---|---|---|
| API Provider | Ollama | Ollama |
| Base URL | http://localhost:11434 |
https://ollama.com |
| Model ID | 如 qwen3 |
如 qwen3-coder:480b-cloud |
| Context Window | ≥ 32K | ≥ 32K |
| 认证 | 无 | Ollama API Key |
五、Cline 与 Roo Code 怎么选
两者都是 VS Code 里的自主编码代理，接 Ollama 的方式几乎一致。差别在工程取向：
| 维度 | Roo Code | Cline |
|---|---|---|
| 起源 | Cline 衍生 | 更早、社区更大 |
| 配置粒度 | 更细（多 provider 混合、按模式配置） | 相对简洁 |
| 上下文建议 | ≥ 32K | ≥ 32K |
| 适合 | 想精细控制不同模式的模型 | 追求开箱即用 |
实际用哪一个差别不大，关键是模型要支持 tools + 上下文给够，这两条不满足，换哪个插件都一样卡。
常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 找不到齿轮图标 | 插件版本旧 | 升级 Roo Code |
| 连不上本地 | Ollama 未运行 | 启动 Ollama |
| Model ID 报错 | 名称与本地不一致 | ollama list 核对 |
| 代理频繁「失忆」 | Context Window 太小 | 调到 32K 以上 |
| 云端 401 | API Key 未填 | 重新生成填入 |
动手试
## ① 拉模型
ollama pull qwen3
## ② 确认服务
curl http://localhost:11434/api/version
然后在 Roo Code 的 Provider Settings 里选 Ollama、Model ID 填 qwen3、Context Window 填 32768。