Cline 怎么配置 API Key 和 Base URL？
简答：在 VS Code 中配置 Cline 时，若要接入各类兼容 API，需将 <strong>API Provider</strong> 设为 <code>OpenAI Compatible</code>，填入对应的 <strong>Base URL</strong>（通常需带 <code>/v1</code> 后缀）、<strong>API Key</strong> 以及当前官方模型列表核实的 <strong>Model ID</strong>。完成填写后通过发送简单提示词进行验证。
定义：Cline 是一款 VS Code 中的 AI 编程助手插件，支持通过配置兼容端点接入各类大语言模型。
30秒速查卡：Cline 兼容接口必填参数清单
在将 Cline 接入各类兼容 API 或中转服务时，核心参数的填写规则如下表所示。请根据实际使用的服务商提供的信息进行替换：
| 参数项 | 推荐选择 / 填写规范 | 说明 |
|---|---|---|
| API Provider | OpenAI Compatible | 接入非 OpenAI 官方原生端点时的通用标准选择 |
| Base URL | https://api.example.com/v1 | 根据服务商要求填写，通常以 /v1 结尾（注意路径拼接） |
| API Key | 服务商后台获取的密钥 | 形如 sk-... 的鉴权凭证，切勿泄露 |
| Model ID | 按当前官方模型列表核实 | 例如兼容的模型名称 |
第一步：打开 VS Code 的 Cline 设置面板
1. 打开 VS Code，在左侧边栏找到 Cline 插件图标（通常为一个机器人或代码图标）。
2. 点击 Cline 顶部的设置齿轮图标（Settings），进入配置页面。
3. 在 Provider 下拉菜单中，若使用兼容中转或通用网关，推荐选择 OpenAI Compatible。
第二步：填写 API Provider、Base URL 与凭证
选定 OpenAI Compatible 后，界面会展开以下几个关键输入框：
- Base URL: 填入服务商提供的根路径。大多数兼容网关要求以
/v1结尾（例如https://api.example.com/v1）。如果后续测试出现 404 错误，可参考 AI API Base URL 末尾要不要加 v1？ 一文进行路径调整。 - API Key: 将你在对应服务商或控制台生成的密钥粘贴于此。
- Model ID: 输入你希望调用的模型标识符。由于模型名称经常更新，请务必以当前官方模型列表为准。
第三步：保存配置并发送测试任务
参数填写完毕后，点击保存。为了验证配置是否成功，可以在 Cline 的对话框中输入一句最简单的指令，例如：
print "hello world" in python成功判据： Cline 能够正常发起流式响应，并在聊天框中逐字返回代码或回复。若遇到报错，请根据返回的代码进行排查：若提示 401 说明鉴权失败（可核对 Anthropic API 401 错误怎么解决？ 或 OpenAI 鉴权排查），若提示 404 多数为 Base URL 路径或模型 ID 填写有误。
常见问题
Cline 配置好后为什么一直转圈或超时？
多半是网络连通性问题或 Base URL 填错了网关地址。建议检查本地网络、代理设置，或者核对服务商提供的 Base URL 是否完整支持流式传输（SSE）。
Base URL 到底要不要加 /v1？
这取决于服务商的接口规范。如果服务商文档里给出的完整端点带有 /v1（例如 OpenAI 兼容规范），Base URL 就需要写到 /v1 结束。如果不确定，可以参考网关的官方接入文档。
Cline 支持切换不同的模型吗？
支持。在 Cline 的设置面板中，你可以随时更改 Model ID 输入框内的模型名称，切换到其他兼容的模型来执行编程任务。
相关阅读
参考资料
- apimaster.ai（apimaster.ai）
- docs.cline.bot（docs.cline.bot）