Cline / Roo Code 配置教程：自定义 API Provider 接入 OpenAI Compatible 与 Claude 模型
更新于
Cline 和 Roo Code 是 VS Code（也可装在 Cursor 里）中的 AI 编程扩展，Roo Code 由 Cline 分支而来，两者的服务商设置几乎一样。这篇讲清楚怎么把它们接到 API 快连：OpenAI 兼容方式怎么填、Claude 模型的两种接法、模型参数怎么设，以及常见报错。
⚠️
Roo Code 已停止更新：它的官方仓库已于 2026 年 5 月归档，不再发布新版本。已经在用的可以照下文继续配置；新装建议直接用 Cline。
📌
一句话答案：API Provider 选 OpenAI Compatible，Base URL 填
https://apikl.ai/v1，API Key 填控制台创建的 sk-...，Model ID 先填 gpt-5.6-sol 测通。Cline / Roo Code
API Provider : OpenAI CompatibleBase URL : https://apikl.ai/v1API Key : sk-你的密钥Model ID : gpt-5.6-sol
准备工作
- 在 VS Code 扩展市场安装 Cline 或 Roo Code。
- 在 控制台 创建密钥：用 GPT 模型选 GPT 类分组，用 Claude 模型选 Claude 类分组。
- 第一次接入先打开一个测试项目，不要直接让它改重要的生产仓库。
Cline 配置步骤
- 点 Cline 面板右上角的齿轮图标，打开设置。
- 「API Provider」下拉选择 OpenAI Compatible。
- 「Base URL」填
https://apikl.ai/v1（带 /v1，末尾不要加 /chat/completions）。 - 「API Key」粘贴你的密钥，「Model ID」填模型名，例如
gpt-5.6-sol。 - 展开模型配置（Model Configuration），按下文建议设置上下文窗口和最大输出，保存。
- 在对话框发一句「用一句话介绍你自己」，能回复就接通了。
Roo Code 配置步骤
- 点 Roo Code 面板的齿轮图标进入设置，找到 Providers（服务商 / 配置档案）。
- 点「+」新建一个配置档案，起个名字，例如「API 快连 GPT」。
- 「API Provider」选择 OpenAI Compatible，按上面的表填写 Base URL、API Key 和 Model。
- 在 Model Configuration 里设置最大输出、上下文窗口、是否支持图片等参数，保存。
- 发一个小任务验证，例如「请用一句话说明你当前能做什么」。
Roo Code 支持多个配置档案，可以给 GPT 和 Claude 各建一个，在对话框里随时切换。
模型参数怎么设
OpenAI Compatible 方式下，扩展不知道模型的真实能力，需要你手动设置。设得太小会频繁截断或压缩上下文，设得太大可能请求失败：
| 参数 | 建议 | 说明 |
|---|---|---|
| 上下文窗口（Context Window） | 200000 | 主流 GPT、Claude 模型都能满足；任务很大时再按模型实际能力调整 |
| 最大输出（Max Output Tokens） | 16000 ~ 32000 | 写长文件时调大；输出越长费用越高 |
| 支持图片（Image Support） | 开启 | 需要发截图时打开；GPT 和 Claude 主流模型都支持图片输入 |
| 价格（Input / Output Price） | 可不填 | 只影响扩展里显示的估算费用，实际扣费以控制台使用记录为准 |
想用 Claude 模型：两种接法
方式一：用 Anthropic 服务商 + 自定义地址（推荐，Cline）
Cline 的 Anthropic 服务商支持自定义地址，走的是 Claude 原生协议，能用上提示缓存，长任务省钱很多：
- 「API Provider」选择 Anthropic。
- 「Anthropic API Key」填 Claude 分组的密钥。
- 勾选 Use custom base URL，填
https://apikl.ai（不带 /v1）。 - 在模型下拉里选择 Claude 模型。下拉列表由扩展版本决定，如果找不到你要的新型号，请更新扩展，或暂时改用方式二。
方式二：继续用 OpenAI Compatible（只适合偶尔用）
换一把 Claude 分组的密钥，Model ID 填 claude-sonnet-5-5 或 claude-opus-5-5，其他不变，网关会自动把 OpenAI 格式转换成 Claude 的格式。
⚠️
这种接法不走提示缓存：每一轮都按原价重新计算全部上下文。Cline 会自动读很多文件，上下文涨得快，同样的任务费用常常是方式一的好几倍。长期用 Claude 请选方式一。可以在控制台「使用记录」里看 Claude 请求的缓存读取，一直是 0 就说明没用上缓存。
常见报错
- 401 invalid_api_key：Base URL 还是官方地址，或者只填了密钥没填 Base URL。看 401 排查。
- Model Not Found：Model ID 写错，或密钥所在分组没有这个模型。可以用 /v1/models 查准确名字。
- 404 或返回网页：Base URL 多写了路径，或填成了网页地址。OpenAI Compatible 必须是
https://apikl.ai/v1；Anthropic 自定义地址必须是https://apikl.ai。 - 改了配置不生效：保存后重开 VS Code，或在 Roo Code 里确认当前选中的是正确的配置档案。
- 任务很慢或很贵：这类扩展会自动读取很多文件，上下文涨得很快。用 Claude 模型时先确认用的是方式一（OpenAI Compatible 不走提示缓存）；先在小项目里试，复杂任务再换 Opus 等更强的模型。
✅