Cline API Key 怎么配置？
简答：Cline 配置 API Key 的核心是先在设置中选择与接口匹配的 API Provider，再填写同一服务商提供的 API Key、Base URL 和 Model ID。不要把密钥、接口地址和模型名混用；保存后先用一条简短消息测试，失败时根据 HTTP 状态码区分认证、路径、权限、额度和网络问题。
定义：Cline API Key 配置，是在 Cline 中选择接口提供方，并将该提供方的密钥、基础地址和可调用模型 ID 绑定到同一套配置中。
先看这张表：Cline 配置到底要填什么
截至 2026-11-03，Cline 官方文档同时提供直接登录、订阅型提供方、BYOK（自带 API Key）和本地运行时等方式。本文只讲最常见的 VS Code Cline 自带 API Key 接口配置，不把某个第三方服务的 Base URL、模型或价格当作已核实事实。官方路径可参考 Cline Authorization 文档。
| 字段 | 填写内容 | 核验方法 |
|---|---|---|
| API Provider | 选择与接口协议匹配的提供方；若界面提供 OpenAI Compatible，才选择该项 | 查看服务商 API 文档，确认是否兼容 OpenAI Chat Completions 或其他协议 |
| Base URL | 服务商给出的基础地址，不要自行猜测 | 确认是否需要 /v1，以及 Cline 会不会自动拼接请求路径 |
| API Key | 完整密钥，不能粘贴遮罩文本、前后空格或带引号内容 | 在服务商控制台重新复制，必要时撤销旧密钥并创建新密钥 |
| Model ID | 服务商当前允许该 Key 调用的模型标识 | 从模型列表、控制台或服务商返回结果核对，不能只凭模型显示名称猜测 |
| 请求协议 | Chat Completions、Responses 或其他协议 | 必须与 Cline 当前提供方适配方式和服务商文档一致 |
关键原则：API Key、Base URL 和 Model ID 必须属于同一服务商。能在模型目录中看到某个模型，也不等于当前账号或当前密钥一定有权调用它。
最短配置步骤：在 VS Code Cline 中填写 API Key
- 确认前置条件。准备好 VS Code、Cline 扩展、服务商账号、API Key、Base URL、Model ID，以及可用额度或权限。若服务商没有明确给出其中某项，不要用猜测值替代。
- 打开 Cline 设置。在 VS Code 中打开 Cline 面板，点击设置齿轮，找到
API Provider或类似的提供方选择项。Cline 官方文档说明，IDE 设置入口位于 Cline 面板的设置图标中。 - 选择认证方式。如果使用 Cline 自己的登录方式，按页面提示登录；如果使用自有密钥，选择对应的 BYOK 或服务商配置项。官方文档将两种方式分开说明，不能把登录会话当成普通 API Key。
- 填写 API Key。粘贴完整密钥，不要把密钥发到聊天、截图、公开仓库或项目配置文件中。若密钥只显示一次，应在创建后立即保存到密码管理器。
- 填写 Base URL。只使用服务商文档给出的基础地址。不要直接填写完整的
/chat/completions路径，也不要在已经包含/v1的地址后再次追加/v1，除非服务商文档明确要求。 - 填写 Model ID。使用服务商控制台或模型接口返回的准确 ID。显示名称、别名和真正请求用的 ID 可能不同，大小写和连字符也不要自行修改。
- 保存并测试。点击界面中的 Continue、Save、Done 或等效按钮，然后发送一条短消息，例如“请只回复 OK”。如果 Cline 能返回文本，说明基础配置已通过；复杂任务、工具调用和流式输出仍需单独验证。
如果你使用的是 Cline CLI，官方文档提供了 cline auth 认证入口，并说明 CLI 与 VS Code 扩展共享提供方配置逻辑；但 CLI 命令不能自动替代 VS Code 面板中的字段核对。可查看 Cline CLI 官方说明。
最小请求：先独立验证接口，再判断是不是 Cline 配置问题
下面是通用模板，不是已核验的某个服务商实例。只有当服务商明确声明兼容 OpenAI Chat Completions，并给出了对应路径时，才可以按其文档替换占位符测试。Base URL、模型 ID 和密钥必须自行核实。
export API_KEY='请替换为自己的密钥'
export BASE_URL='请替换为服务商文档中的基础地址'
export MODEL_ID='请替换为当前账号可调用的模型 ID'
curl -i "$BASE_URL/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d "{\"model\":\"$MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with OK only.\"}],\"stream\":false}"检查结果时先看 HTTP 状态码，再看响应体。200 通常表示请求层面成功；兼容 Chat Completions 的返回体通常应能找到 choices[0].message.content，但具体字段仍以服务商协议为准。Cline 自身的 API 文档也使用 choices、message.content 和 usage 作为示例字段，可参考 Cline API Getting Started。
如果独立请求都失败，优先检查服务商的 Base URL、协议路径、密钥权限和模型 ID；如果独立请求成功而 Cline 失败，再回到 Provider 选择、字段保存和 Cline 版本界面排查。
错误分流：按状态码和现象排查
| 现象 | 优先检查 | 处理动作 |
|---|---|---|
| 401 Unauthorized | API Key 是否完整、是否过期、Authorization 格式是否正确 | 重新复制密钥；确认没有多余空格、引号或换行；必要时撤销旧 Key 后创建新 Key |
| 403 Forbidden | 账号权限、组织权限、模型权限或来源限制 | 在服务商控制台确认当前 Key 是否有该模型和接口权限，不要只更换模型名 |
| 404 Not Found | Base URL、版本路径或协议路径 | 对照服务商文档确认是否需要 /v1，不要把完整接口路径重复填入 Base URL |
| Model Not Found | Model ID 是否真实存在且属于当前服务商 | 从当前模型列表或控制台复制准确 ID；模型目录可见不代表当前 Key 可调用 |
| 429 Too Many Requests | 限速、并发、额度或短时间重复请求 | 降低并发，等待服务商规定的重试时间；不要在没有退避机制时无限重试 |
| 超时或无响应 | 网络、代理、接口区域、请求体大小或服务端排队 | 先用短消息和非流式请求测试，再检查网络与服务商状态；不要直接判断为 API Key 错误 |
| 能返回文本但工具调用失败 | 工具调用协议、模型能力和 Cline 适配情况 | 把“基础文本调用成功”和“工具调用可用”分开验证，不能用前者推断后者 |
流式输出、工具调用、Responses API 和区域限制都属于额外能力，不能因为普通文本请求成功，就默认 Cline 已获得这些能力。应分别查看服务商文档、Cline 当前提供方支持情况和实际响应。
安全边界：API Key 配好后还要做什么
- 为 Cline 单独创建密钥，能设置权限、额度或有效期时优先使用最小权限和较短有效期。
- 不要把 API Key 写进 Git 仓库、项目 README、截图、录屏、聊天记录或公开 issue。
- 不要把密钥硬编码到
settings.json、脚本或前端代码中；命令行测试使用环境变量，并在测试后清理终端历史。 - 如果怀疑泄露，先撤销旧密钥，再检查用量记录和访问日志，最后创建新密钥。仅修改 Cline 中的字段不能让已经泄露的旧 Key 失效。
- 保存配置后记录 Base URL、Model ID 和协议来源，但不要记录完整 API Key。
本文是独立的接入说明，不代表 Cline 或任一接口服务商的官方页面；具体入口、字段名称、模型权限和价格应以当前官方文档或控制台显示为准。
站内延伸阅读：如果你还要配置其他开发工具，可继续查看 Claude Code 使用 API Key、Cursor AI API Key 配置 和 Codex API Key 配置，重点仍是先确认认证方式、接口协议和模型 ID。
常见问题
Cline 一定要填写 API Key 吗？
不一定。Cline 官方文档列出了直接登录、订阅型提供方、BYOK 和本地运行时等方式。使用直接登录或本地运行时可能不需要单独填写云端 API Key；使用自有云端接口时，才需要按提供方要求填写密钥。先看 Cline 设置中的 API Provider 选项，再确认当前方案。
Cline 中的 Base URL 要不要加 /v1？
不能一概而论。是否添加 /v1 由接口服务商的官方文档和实际路由决定。先确认服务商给出的 Base URL，再用独立请求检查最终地址；如果返回 404，优先排查版本路径重复、缺失或协议路径填错。
模型列表里能看到模型，但 Cline 仍然提示 Model Not Found，为什么？
模型目录可见不等于当前 API Key 有调用权限。请从当前账号控制台或模型接口复制准确 Model ID，再确认该模型属于同一 Base URL 和服务商；同时检查大小写、连字符和区域限制。
Cline 返回 401，重新粘贴 API Key 仍然失败怎么办？
先在独立 HTTP 请求中验证密钥，确认 Authorization 使用 Bearer 格式、密钥没有遮罩字符和多余空格。如果独立请求也返回 401，应在服务商控制台检查密钥状态；如果独立请求成功，再检查 Cline Provider、保存状态和是否误用了另一套配置。
为什么普通对话能用，但 Cline 工具调用或流式输出失败？
普通文本请求只证明基础文本接口可用，不能证明工具调用、流式输出或其他协议能力可用。请分别确认模型能力、服务商协议、Cline 当前提供方适配和返回格式，不要仅凭一次文本回复判断全部功能正常。