Ollama Cline
2026-10-29 18:54 更新
Cline 是 VS Code 里最流行的自主编码代理之一,能读项目、改文件、跑终端命令。它把 provider 做成下拉选项,接 Ollama 只需要改两个字段。
版本基线 v0.40.12,官方
docs.ollama.com/integrations/cline。命令行版本见 12.8 Ollama Cline CLI。
一、安装
在 IDE 里安装 Cline(支持 VS Code 等)。
二、接本地 Ollama
- 打开 Cline 设置 →
API Configuration - 把
API Provider设为 Ollama - 在
Model下选一个模型,或直接输入模型名(如qwen3) - 把
Context Window调到至少 32K tokens
第 4 步不能跳。编码任务需要大上下文,默认值往往只有 8k 或更小,会让代理频繁「忘记」前面的代码。
三、接 ollama.com 云端
- 在
ollama.com/settings/keys生成 API Key - 勾选
Use custom base URL,填https://ollama.com - 填入 Ollama API Key
- 从列表里选模型
云端模型要选支持工具调用(tool calling)的,否则 Cline 的改文件、跑命令会全部失效。按 tools 能力筛选:ollama.com/search?c=cloud。
四、关键配置速查
| 配置项 | 本地 | 云端 |
|---|---|---|
| API Provider | Ollama | Ollama |
| Base URL | http://localhost:11434(默认) |
https://ollama.com |
| 认证 | 不需要 | Ollama API Key |
| Context Window | ≥ 32K | ≥ 32K |
| 模型要求 | 支持 tools 更好 | 必须支持 tools |
五、和 Cline CLI 的区别
| 维度 | Cline(IDE 扩展) | Cline CLI |
|---|---|---|
| 运行位置 | 编辑器侧边栏 | 终端 |
| 安装 | 应用市场 | npm i -g cline |
| 配置入口 | 设置面板 | cline auth |
| 上下文建议 | ≥ 32K | 越大越好 |
| 适合 | 边改代码边对话 | 服务器、脚本 |
两边的配置不共享,接本地模型需要在各自界面里各配一次。
六、常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 代理不会改文件 | 模型不支持 tools | 换支持工具调用的模型 |
| 中途「忘记」前面代码 | Context Window 太小 | 调到 32K 以上 |
| 云端 401 | API Key 错误或未填 | 重新生成并填入 |
| 连不上本地服务 | Ollama 未运行 | 启动 Ollama |
| 模型下拉是空的 | 本地没有模型 | 先 ollama pull |
动手试
## ① 确认模型就绪
ollama list
## ② 确认服务在跑
curl http://localhost:11434/api/version
然后在 Cline 设置里把 Provider 切到 Ollama,模型填 qwen3,上下文填 32768,随便让它改一行代码验证工具调用是否正常。
以上内容是否对您有帮助:

TRAE-AI编程


更多建议: