Cline 接入 OpenAI API：Base URL、API Key 与 Model ID 配置步骤
简答：Cline 接入 OpenAI API 通常有两种方式：使用 Cline 设置中的 OpenAI 原生提供商，或选择 OpenAI Compatible 填写兼容服务的 Base URL、API Key 和 Model ID。最稳妥的流程是先确认凭据和模型权限，再用短消息验证；不要把完整的 /chat/completions 路径误填到 Base URL。
定义：Cline 接入 OpenAI API，是在 Cline 的 API Provider 设置中选择 OpenAI 原生接口或 OpenAI Compatible，并让 Cline 使用对应的密钥、接口根地址和模型标识发送请求。
先看结论：三步完成 Cline 接入
本文按截至 2026 年 11 月 1 日可核验的 Cline 文档整理。本站是第三方 AI API 接入指南站，不是 Cline 或任何 API 平台的官网。
- 在 VS Code 打开 Cline 面板，点击设置图标，在 API Provider 中选择 OpenAI 或 OpenAI Compatible。
- 准备对应服务的 API Key；兼容接口还需要填写服务方提供的 Base URL 和准确的 Model ID。
- 保存后发送一条简单任务，例如“请用一句话说明什么是 HTTP”，再根据状态、响应文本和 Cline 界面提示判断是否成功。
Cline 官方文档明确把 OpenAI Compatible 的关键配置归纳为 Base URL、API Key 和 Model ID，并提示兼容服务的模型名称需要以服务方文档为准。可参考 Cline OpenAI Compatible 配置文档。
| 方式 | 适用场景 | 主要填写内容 | 注意事项 |
|---|---|---|---|
| OpenAI | 直接使用 OpenAI API | API Key、模型选择 | 按 OpenAI 账户权限和当前 Cline 界面填写 |
| OpenAI Compatible | 使用其他兼容 OpenAI 协议的服务或自建接口 | Base URL、API Key、Model ID | 三项必须属于同一个服务，模型 ID 不要凭记忆填写 |
| OpenAI Codex | 使用 Cline 中单独提供的登录或授权方式 | 按 Cline 当前授权流程操作 | 不要把 ChatGPT 订阅直接当成普通 API Key |
配置前：先确认你要接的是哪一种接口
OpenAI 原生接口
如果你使用的是 OpenAI API，应优先在 Cline 的 API Provider 中选择 OpenAI，而不是把原生接口当作普通兼容网关填写。具体模型选项、菜单名称和可用权限可能随 Cline 版本变化，发布前请以当前安装版本显示为准。
OpenAI Compatible 接口
如果你使用的是第三方 API Router、自建 OpenAI 兼容服务、云平台兼容端点或本地推理服务，选择 OpenAI Compatible。Cline 文档说明，这类配置通常需要三项核心信息：Base URL、API Key 和 Model ID。
Base URL 只填接口根路径。例如服务方文档要求填写某个版本根路径，就按服务方给出的根路径填写；不要自行追加 /chat/completions，除非该服务的官方说明明确要求如此。最终请求路径由客户端和 SDK 组合生成，误填完整操作路径常会造成 404。
OpenAI Codex 与 API Key 不是一回事
Cline 的提供商列表中同时存在 OpenAI、OpenAI Compatible 和 OpenAI Codex 等选项。OpenAI Codex 登录流程与手动粘贴 API Key 的流程不能混用。OpenAI 也说明，ChatGPT 与 API 平台使用独立的计费体系；ChatGPT 订阅不应自动理解为普通 API 调用额度。相关账务区别可查看 OpenAI 关于 ChatGPT 与 API 计费的说明。
Cline 接入 OpenAI Compatible 的完整步骤
- 打开设置面板。在 VS Code 中打开 Cline 侧边栏，点击齿轮或设置入口。Cline 官方文档描述的配置入口位于 Cline 设置面板。
- 选择 API Provider。需要接入兼容服务时选择
OpenAI Compatible。如果选择的是 OpenAI 原生接口，则不要照搬兼容服务的 Base URL。 - 获取 API Key。从你实际使用的 API 服务控制台创建或复制 Key。只复制一次也要立即保存到密码管理器，不要粘贴到公开仓库、截图、Issue 或聊天记录中。
- 填写 Base URL。从服务方当前文档或控制台复制接口根地址。若页面没有明确说明是否带版本路径，先不要猜测，查看其 API 示例或模型列表接口说明。
- 填写 Model ID。从服务方当前模型列表复制完整值。不要使用搜索文章中的旧模型名，也不要把展示名称、营销名称当作实际 ID。
- 保存并选择模型。如果 Cline 能从 Base URL 和 Key 刷新模型列表，优先从下拉列表选择；如果需要手动输入，则保持大小写、斜杠、连字符完全一致。
- 发送最短测试。先发送一条不需要工具调用、图片或长上下文的文本任务。成功后再测试代码修改、工具调用、图像输入或长文本。
Cline 当前代码与文档显示，OpenAI Compatible 配置支持自定义 Base URL，并将模型选择作为独立字段处理；但具体界面和高级模型参数可能随版本调整，实际使用时应以当前安装版本为准。可查看 Cline OpenAI Compatible 设置实现。
四项成功判定：不要只看“保存成功”
配置保存不等于请求已经成功。建议按以下四项判断：
- 状态码：请求没有返回 401、403、404、429 或 5xx 错误。
- 响应字段：返回体中出现服务方兼容协议对应的有效响应字段，而不是 HTML 错误页或网关提示页。
- 实际文本：模型返回了与测试问题相关的文本内容。
- 客户端显示：Cline 面板完成本轮响应，没有持续转圈、空白消息或立即重试。
如果只看到“连接成功”但发送任务失败，优先查看 Cline 的错误详情、开发者日志或服务方请求记录，不要仅凭界面提示判断模型已经可用。
按顺序排查 401、404、429、超时和流式中断
| 现象 | 先核对什么 | 可执行处理 |
|---|---|---|
| 401 或 Invalid API Key | Key 是否复制完整、是否属于当前 Base URL 对应的服务 | 重新创建或复制 Key；确认没有多余空格、换行或使用了已撤销的旧 Key |
| 403 | 账户权限、项目权限、区域或模型授权 | 查看响应体和服务方控制台权限，不要仅凭状态码判断具体原因 |
| 404 或 Model Not Found | Base URL 路径、Model ID、大小写 | 删除误加的操作路径；从当前模型列表复制准确 ID；确认模型属于该端点 |
| 429 | 余额、组织限额、并发或请求频率 | 查看响应体中的错误码和限额提示，降低并发或等待后重试；不要把所有 429 都归因于余额不足 |
| 超时或连接失败 | 最终 URL、网络连通性、防火墙和代理 | 先用最小请求测试，再检查本机网络与服务方状态；不要直接更换模型掩盖路径问题 |
| 流式输出中断 | 服务是否支持流式、客户端是否兼容、响应是否被代理截断 | 先关闭流式或用最短文本测试，再查看响应头、日志和服务方对流式格式的说明 |
排错时建议固定顺序：凭据 → 最终 URL/路径 → 模型 → 权限或区域 → 最小请求 → 错误响应体。状态码只是线索，真正归因应以响应体、响应头或日志为准。
模型和高级参数怎么填才不容易失败
首次接入时不要一开始就启用图片、Computer Use、复杂工具调用或超长上下文。Cline 官方文档列出了上下文窗口、最大输出 Token、图像支持、Computer Use 以及输入和输出价格等模型配置项，但这些能力是否可用取决于当前模型与服务端实现。
- Model ID：以当前服务模型列表为准，不能把模型显示名当作 API ID。
- 上下文窗口：没有官方数值依据时不要随意填写，避免客户端发送超出服务端限制的请求。
- 最大输出 Token：先使用服务方推荐值；如果出现参数不支持，查看响应体确认服务端接受的字段。
- 图像和工具调用：只有服务方和模型都明确支持时再启用。
- 价格字段：Cline 中的价格配置主要用于估算或展示，不能替代服务方账单；未经核验的价格不要手动写成事实。
安全与费用：API Key、ChatGPT 订阅要分开看
API Key 应按密码处理。建议为不同工具或项目使用不同 Key，设置服务方提供的权限和额度限制，并定期轮换。不要在终端命令中直接回显完整 Key，也不要把 Key 写入 Git 仓库。
如果你使用 OpenAI 原生 API，请单独查看 API 平台的计费、余额和组织限额。OpenAI 的帮助文档明确说明，ChatGPT 订阅和 API 平台是分开的计费系统；因此，即使你拥有 ChatGPT 订阅，也不能据此推断 Cline 中的普通 API Key 调用已经获得同等额度。具体权限和费用以账户控制台显示为准。
常见问题 FAQ
Cline 的 Base URL 应该填到 /chat/completions 吗？
通常先填写服务方规定的接口根路径，而不是完整的 /chat/completions 操作路径。Cline 的 OpenAI Compatible 配置把 Base URL 作为独立字段处理；如果服务方文档没有明确要求完整操作路径，误加路径可能导致 404。最终以当前服务方文档和请求日志为准。
Model ID 可以直接填写模型名称吗？
不建议。应从当前 API 服务的模型列表或控制台复制准确 Model ID。展示名称、模型别名和实际 API ID 可能不同，大小写、斜杠和连字符也可能影响识别。
为什么 API Key 正确，Cline 仍然提示 401？
先确认 Key 是否属于当前 Base URL 对应的服务，再检查是否包含空格或换行、是否已撤销、是否有项目权限。还要查看错误响应体，因为 401 的具体含义可能由服务端定义。
ChatGPT Plus 或其他 ChatGPT 订阅能直接替代 OpenAI API Key 吗？
不能直接这样理解。OpenAI 文档说明 ChatGPT 与 API 平台的计费和使用体系分开；Cline 中的 OpenAI API 配置仍需要按当前授权方式提供凭据。若 Cline 提供单独的 Codex 或登录选项，应按对应流程操作，而不是把订阅名称填入 API Key 字段。
出现 429 一定是余额不足吗？
不一定。429 也可能与请求频率、并发、组织或项目限额有关。请先查看响应体中的错误码、限额字段和服务方控制台，再决定是降低并发、等待重试还是检查余额。
如何判断是 Cline 问题还是 API 服务问题？
用同一 Base URL、同一 Key 和同一 Model ID 发起一个最小请求，并记录状态码、响应体和响应头。如果最小请求也失败，优先核对服务方参数和权限；如果最小请求成功但 Cline 失败，再检查 Cline 版本、流式传输、工具调用或模型高级参数。
常见问题
Cline 的 Base URL 应该填到 /chat/completions 吗？
通常先填写服务方规定的接口根路径，不要自行追加 /chat/completions。若官方文档明确要求完整路径，才按其说明填写。
Model ID 可以直接填写模型名称吗？
不建议。应从当前 API 服务的模型列表或控制台复制准确 Model ID，并保持大小写、斜杠和连字符一致。
为什么 API Key 正确，Cline 仍提示 401？
检查 Key 是否属于当前 Base URL 对应的服务，是否有空格、换行、撤销或权限不足，并查看响应体中的具体错误信息。
ChatGPT 订阅能直接替代 OpenAI API Key 吗？
不能直接这样理解。ChatGPT 与 API 平台的计费和使用体系分开；Cline 应按 OpenAI 或 Codex 当前提供的对应授权流程配置。
429 一定是余额不足吗？
不一定。429 还可能由请求频率、并发、组织或项目限额触发，应先查看响应体和控制台限额信息。
相关阅读
- 查看 Claude Code 接入兼容 API 的配置差异
- 了解 Cursor 配置 API 时如何核对 Base URL 和模型
- 先掌握 API Key 创建与 401 排查方法
- 继续阅读 Codex 授权方式与 API Key 的区别