Cline 配置 API：从 Provider 选择到模型验证
简答：Cline 配置 API 的核心是先选对 API Provider，再填写 API Key、Base URL 和 Model ID。接入普通 OpenAI 兼容服务时，选择“OpenAI Compatible”；Base URL 是否包含 /v1 必须以服务商文档为准，配置后点击 Verify 或发送一条无敏感数据的测试消息。
定义：Cline API 配置，是在 Cline 的 Provider 设置中指定模型服务商、认证密钥、API 基础地址和模型标识，使插件或 CLI 能够向目标模型发送请求。
先判断接入方式：官方 Provider 还是 OpenAI Compatible
本文是第三方接入指南，不代表 Cline 或任何模型服务商的官网。Cline 当前支持直接选择多个 Provider，也支持把提供 OpenAI 兼容接口的云端服务或本地运行时接入。官方文档将这两种方式分开说明：如果选择内置 Provider，通常只需填写对应 Key 并选择模型；如果使用自定义网关或本地服务，应选择 OpenAI Compatible，再填写 Base URL、API Key 和 Model ID。可参考 Cline OpenAI Compatible 配置说明。
| 场景 | Provider 选择 | 需要填写的内容 | 注意事项 |
|---|---|---|---|
| 直接调用 OpenAI | OpenAI | API Key、模型；自定义网关时再填 Base URL | 不要把兼容网关地址误填到官方默认配置中 |
| 直接调用 Anthropic | Anthropic | Anthropic API Key、模型 | 认证头、路径和模型以当前官方文档为准 |
| OpenAI 兼容云服务 | OpenAI Compatible 或服务商专用 Provider | Base URL、API Key、Model ID | Base URL 是否带 /v1 由服务商决定 |
| 本地 Ollama 或 LM Studio | 对应本地 Provider 或 OpenAI Compatible | 本地地址、模型名称；有些场景不需要 Key | 先确认本地服务正在监听，并检查端口 |
最短判断：你手里只有一个“兼容 OpenAI 的接口地址”时，优先选择 OpenAI Compatible；你拿到的是 Cline、OpenAI、Anthropic 等内置 Provider 的专用凭据时，优先使用对应选项。
VS Code 中配置 Cline API：逐项填写并验证
- 安装并打开 Cline。在 VS Code 中按
Ctrl/Cmd + Shift + X打开扩展面板，搜索 Cline 并安装，然后从侧边栏打开 Cline。官方安装文档同时列出了 IDE 插件、桌面端、CLI 和 SDK 等路径，见 Installing Cline。 - 进入配置面板。点击 Cline 面板中的齿轮图标，在
API Provider中选择目标 Provider。使用自有服务商 Key 时，不要把“登录 Cline 账户”和“填写模型服务商 Key”混为一回事；官方授权说明把账户登录、BYOK 云服务和本地运行时列为不同路径，见 Cline Authorization。 - 填写 API Key。只粘贴当前服务商生成的密钥，不要把带引号、空格或换行的文本一起复制。Key 应保存在密码管理器或受保护的本地配置中，避免写入项目源码、提交记录和截图。
- 填写 Base URL。复制服务商文档中用于 OpenAI 兼容请求的基础地址。不要根据其他工具的写法自行猜测是否加
/v1；如果服务商给出的是完整路径，例如/v1/chat/completions，通常需要根据 Cline 字段含义转换为 Base URL，而不是重复拼接完整路径。 - 填写 Model ID。Model ID 必须从服务商控制台、模型列表或 API 文档复制。显示名称、套餐名称和真正的模型标识可能不同，不能只凭模型昵称填写。
- 点击 Verify 或发送最小测试消息。测试内容只用“请回复 OK”这类无敏感数据文本。成功判定应同时满足：请求返回正常响应、模型名称没有被替换、流式输出能够结束，并且 Cline 没有继续提示未配置 Provider。
OpenAI Compatible 的官方配置页明确把 Base URL、API Key 和 Model ID 作为主要配置项，并提醒不同服务商的模型 ID 不同；模型上下文、最大输出 Token、图片支持和 Computer Use 等参数也应按实际模型能力填写，不能因为字段存在就默认支持。
可核对的兼容接口示例：以公开 FishXCode 文档为例
下面给出一个可对照字段位置的实际案例。公开文档将 FishXCode 的兼容接口地址写为 https://api.fishxcode.com/v1，并说明模型需要按控制台或当前文档中的可用列表选择；这只能作为配置示例，不代表本站是其官网，也不代表该地址或模型在所有账户中都可用。请以服务商当前页面和控制台为准，参阅其 公开 FAQ 与 模型列表。
在 Cline 设置中可按以下逻辑填写：
- API Provider：
OpenAI Compatible - Base URL：
https://api.fishxcode.com/v1 - API Key：填写你在该服务商控制台生成的 Token，正文不展示真实密钥
- Model：填写控制台中与你账户或分组匹配的 Model ID，不能直接照抄其他教程中的模型名
- 高级参数：上下文窗口、最大输出 Token、图片支持等先使用服务商建议值；不确定时保留默认或标记为需核实
如果服务商文档只给出 https://api.example.com/，而没有说明兼容路径，就不要直接假定应改成 /v1。可以先查看文档中的 curl 示例或接口路径，再判断 Cline 的 Base URL 应该填写到哪一级。
Cline CLI 配置：插件与终端不是同一套操作入口
Cline CLI 的官方安装文档显示，CLI 可通过 npm 安装，随后使用 cline auth 进入交互式认证和 Provider 配置；CLI 参考还列出了 Provider、Key、Model ID 和 Base URL 参数。示例命令如下，尖括号内容必须替换为你自己的值：
npm install -g cline
cline auth --provider openai-compatible --apikey "YOUR_API_KEY" --modelid "YOUR_MODEL_ID" --baseurl "https://api.example.com/v1"
命令行参数名称和可用 Provider ID 可能随 Cline 版本变化，执行前先运行 cline --help 或 cline auth --help 核对。官方 CLI 参考见 Cline CLI Reference。
插件和 CLI 是否完全共享配置，取决于当前版本、登录方式和数据目录。不要仅凭“都叫 Cline”就假设配置文件互通。CLI 可使用 cline config 查看配置界面，也可用 cline version 检查当前版本；如果插件能用而 CLI 报未认证，应分别检查当前 Provider、模型和认证状态。
Base URL、模型和错误排查顺序
排错不要一开始就反复换模型或重装插件。建议按照“凭据→最终 URL→模型→权限或区域→最小请求→响应体和日志”的顺序检查。日志只保留请求 ID、环境名和脱敏后的 Key 标识，不要记录完整密钥或业务代码。
| 现象 | 优先检查 | 处理方法 |
|---|---|---|
| 401 Unauthorized | Key 是否完整、是否属于当前 Provider、是否已撤销 | 重新复制 Key，去掉首尾空格；确认没有把账户登录 Token 当成模型服务商 Key |
| 403 Forbidden | 账户权限、组织、区域或模型访问范围 | 在服务商控制台确认当前模型已授权；不要仅靠更换 Base URL 解决 |
| 404 Not Found | Base URL 层级、路径拼接和 Model ID | 对照服务商 curl 示例，检查是否重复添加或遗漏 /v1 |
| 429 Too Many Requests | 限流、余额、额度或并发限制 | 先阅读响应体和 Retry-After；额度或计费问题不能按普通限流无限重试，可参考本站的 429 排查指南 |
| 模型不存在 | 模型 ID 是否来自当前服务商列表 | 不要使用教程中的旧模型名；重新从控制台复制完整标识 |
| 连接超时或流式中断 | 网络可达性、代理、防火墙、超时设置和服务端响应 | 先用无敏感数据的最小请求测试，再区分连接失败、响应过慢和流式中途断开 |
如果配置面板中的自定义地址被自动改回默认值，先记录 Cline 版本、运行平台和复现步骤，再查看官方仓库的 Issues 或更新说明。不要直接把社区临时 workaround 当成长期官方配置方式。
API Key 安全清单：配置成功后还要做什么
- 不要把真实 Key 写进 Git 仓库、README、截图、终端录屏或聊天记录。
- 为开发、测试和生产环境使用不同的密钥；如果服务商支持权限范围或额度限制，按最小权限配置。
- 怀疑泄露时，先在服务商控制台撤销或轮换 Key，再用新 Key 发送最小测试请求。
- 分享错误日志时，仅保留状态码、请求 ID、Provider 名称和脱敏后的 URL。
- 不要把“Cline 登录成功”误认为“目标模型 API 已验证成功”；两者的认证主体可能不同。
本文核验时间为 2026 年 11 月 2 日。Cline 的界面字段、Provider 列表、CLI 参数、服务商模型和价格都可能变化，发布后应以当前官方文档、控制台和本机帮助输出为准。
常见问题
Cline 配置 API 时 Base URL 要不要加 /v1？
不能一概而论。应优先看服务商官方文档或 curl 示例：如果文档把 /v1 作为 API 基础路径，就填写带 /v1 的地址；如果已经给出完整请求路径，则按 Cline 字段要求拆分，避免重复拼接。
Cline 的 OpenAI Compatible 应该填什么模型？
填写服务商模型列表中的 Model ID，而不是产品昵称、套餐名称或其他教程里的旧名称。模型不存在时，先确认 Base URL 对应的服务商，再从当前控制台复制完整标识。
Cline 配置后出现 401，最先检查什么？
先检查前文“Base URL、模型和错误排查顺序”表中的 401 行：确认 Key 没有空格或换行、属于当前 Provider、没有被撤销，并确认没有把 Cline 账户认证信息误当成模型服务商 Key。
VS Code 插件和 Cline CLI 的 API 配置会自动同步吗？
不要默认会完全同步。两者可能使用不同的登录状态、Provider 配置和数据目录。插件中可用但 CLI 报未认证时，应分别运行本机的 <code>cline --help</code>、<code>cline auth</code> 或 <code>cline config</code> 检查。
可以直接把真实 API Key 发给别人帮忙排错吗？
不建议。排错只需提供脱敏后的 Base URL、Provider、Model ID、状态码和请求 ID；如果 Key 已经泄露，应先在服务商控制台撤销或轮换，再重新验证。
相关阅读
- API 429 排查与安全重试指南
- Claude Code 配置 API 的认证与 Windows 验证步骤
- Cursor 配置 Anthropic API 与 401/404/429 排查
- Dify 配置 Anthropic 接口与 Base URL 判断
参考资料
- Cline 官方 OpenAI Compatible 配置文档
- Cline 官方安装文档
- Cline 官方授权与 Provider 说明
- Cline 官方 CLI Reference
- FishXCode 公开 FAQ（doc.fishxcode.com）
- FishXCode 公开模型列表（doc.fishxcode.com）