Cline 插件怎么配置自定义 API？接入 DeepSeek / Claude / 本地模型
Cline（saoudrizwan.claude-dev）是 VS Code 里的自主 AI 编程 Agent，安装量超千万。它能创建/编辑文件、执行终端命令、浏览网页，还支持 MCP 工具扩展。与 Continue 插件（continue.continue）不同，Cline 是独立发布的另一个工具，本文只讲 Cline 的配置。
Cline 支持任意 OpenAI 兼容端点，不绑定任何特定模型商。以下是三种常见接入方案的完整配置。
配置入口
在 VS Code 中安装 Cline 后，点击左侧栏的 Cline 图标 → 点击右上角齿轮图标（Settings） → 选择 Use your own API key，进入 API 配置面板。关键字段：
| 字段 | 含义 |
|---|---|
| API Provider | 选择接入方式（OpenAI Compatible / Anthropic / Ollama 等） |
| API Key | 你的平台密钥 |
| Base URL | API 端点地址 |
| Model | 模型标识符 |
| Context Window Size | 上下文窗口大小 |
场景一：接入 DeepSeek 官方 API
DeepSeek 开放平台提供兼容 OpenAI 的端点，Base URL 填官方地址即可。
配置参数：
yaml
API Provider: OpenAI Compatible
Base URL: https://api.deepseek.com/v1
API Key: YOUR_DEEPSEEK_API_KEY
Model: deepseek-chat确认 API Key 来自 DeepSeek 开放平台，是
sk-开头的字符串。
验证连接： 在 Cline 输入框发送一条消息（如"你好"），底部状态栏若显示模型名称而非报错，说明配置成功。
场景二：接入 Claude（通过兼容中转服务）
如果直接用 Anthropic 官方 API 受地区或额度限制，可以通过支持 Anthropic 协议的中转服务接入。
Anthropic 协议方式（推荐用于 Claude 模型）：
yaml
API Provider: Anthropic
API Key: YOUR_PROXY_API_KEY
Use Custom URL: ✓ 勾选
Base URL: YOUR_PROXY_BASE_URL # 中转服务提供的地址，不含 /v1/messages 后缀
Model: claude-sonnet-4-6Anthropic 协议下，SDK 会自动在 Base URL 后追加
/v1/messages，所以 Base URL 只需填到/api这级，不要 手动加/v1/messages，也不要加末尾斜杠。
OpenAI 兼容方式（通用）：
yaml
API Provider: OpenAI Compatible
Base URL: https://YOUR_PROXY_HOST/openai/v1
API Key: YOUR_PROXY_API_KEY
Model: claude-sonnet-4-6场景三：接入本地 Ollama（零成本、完全离线）
Ollama 提供 OpenAI 兼容的 /v1/ 接口，无需任何 API Key。先确保 Ollama 已运行：
bash
# 拉取一个编程模型
ollama pull llama3.2
# 拉取嵌入模型（用于代码搜索等场景）
ollama pull nomic-embed-textCline 配置：
yaml
API Provider: OpenAI Compatible
Base URL: http://localhost:11434/v1
API Key: ollama # 任意非空字符串，Ollama 不校验
Model: llama3.2 # 使用 ollama list 看到的完整标签注意：Ollama 模型名必须精确匹配，包括标签后缀（如
:latest）。在终端执行ollama list复制完整名称。
进阶：使用 Ollama 专属 Provider
部分 Cline 版本内置了 Ollama Provider，选 Ollama 后会自动检测本地模型，适合不想填 Base URL 的情况。
常见坑
1. Base URL 末尾多了斜杠或 /v1/messages Anthropic 协议下 SDK 会自动拼接路径，手动加了会变成 https://xxx.com/api/v1/messages/v1/messages。解决：只填到 /api。
2. 模型名写错了 DeepSeek 填了 deepseek-coder 而实际应该填 deepseek-chat。每个平台模型名以官方文档为准，注意区分聊天模型和推理模型。
3. 选了错误的 Provider 类型 Claude 模型用了 OpenAI Compatible 但模型标识符里带了 claude-sonnet-4-6，而中转服务不认识这种写法。选对 Provider 类型后再填对应格式的模型名。
4. 上下文窗口没设或设错 Claude 3.5 Sonnet 支持 200K 上下文，但 Cline 默认可能更小。在 Settings 里找到 Context Window Size 填入正确数值，否则长文件会被悄悄截断。
5. 本地 Ollama 没启动 ollama serve 或 Ollama 应用需要在后台运行。重启电脑后若 Cline 连不上，先确认 curl http://localhost:11434/api/tags 有返回。
6. 中转服务域名被污染 国内直连海外 API 不稳定，换用国内镜像域名（如 api.deepseek.com 换为区域节点），或切换到火山引擎等国内服务商提供的兼容端点。
快速排错表
| 现象 | 可能原因 | 解决方式 |
|---|---|---|
| 401 Unauthorized | API Key 错误或已失效 | 去平台控制台重新生成 Key |
| 404 Not Found | Base URL 不对或模型名错误 | 核对平台文档中的端点和模型标识符 |
| 429 Too Many Requests | 请求频率超限 | 降低调用频率，或升级 API 套餐 |
| 503 Service Unavailable | 服务商维护或区域不可用 | 换用备用域名或稍后重试 |
| 响应很慢/超时 | 网络延迟或上下文窗口过大 | 检查网络；适当减小 Context Window Size |
| 模型不支持 Tool Use | 所选模型本身不支持函数调用 | 切换到支持工具调用的模型版本 |
| 本地 Ollama 连接失败 | 服务未启动或端口被占用 | 执行 ollama serve；检查 11434 端口 |
配置检查清单
- VS Code 已安装 Cline 插件（
saoudrizwan.claude-dev），不是 Continue - API Key 已从平台控制台获取，不含多余空格或引号
- Base URL 格式正确，末尾无多余斜杠（Anthropic 协议下无需填
/v1/messages） - 模型标识符与平台文档完全一致
- Context Window Size 与所选模型匹配（如 Claude 3.5 Sonnet 填 200000）
- 国内访问时确认网络可达，必要时配置代理或换用国内服务商端点
- 首次测试用简单问题（如"你好"），确认响应正常后再进行复杂编码任务