工具接入
Cline 接入:OpenAI Compatible 配置与验证
Cline 是 VS Code 里的自主编码代理,支持自定义 API 端点。接入 CodeBridge API 只需要在插件设置里改三个字段:Provider、Base URL 和模型 ID。本文按可核对的顺序走一遍,并给出配错时的定位方法。
开始前先备齐三样东西
本站账号与 Key
在控制台注册并单独为 Cline 建一把 API Key。不要复用其他工具的 Key,方便单独回收。
真实模型 ID
先请求 /v1/models,把返回里要用的模型 ID 复制出来备用。不要凭记忆手写,也不要照抄教程示例。
已安装的 Cline
VS Code 扩展市场搜索 Cline 安装。本文以支持 OpenAI Compatible Provider 的近期版本为准,旧版本字段名可能略有差异。
# 取当前可用模型列表(把返回里的 id 复制出来)
curl https://codebridgeapi.top/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"四步配置
打开 Cline 设置
点开 VS Code 侧边栏的 Cline 图标,进入设置(齿轮)里的 API Configuration。
API Provider 选 OpenAI Compatible
不要选 OpenAI 官方项,官方项不允许改地址。选 OpenAI Compatible 后才会出现 Base URL 输入框。
填入三个字段
Base URL 填 https://codebridgeapi.top/v1;API Key 填本站控制台签发的 Key;Model ID 粘贴上一节从 /v1/models 复制的真实 ID。
发一条短任务验证
让 Cline 执行一个只读小任务(例如"解释当前文件的作用"),能正常返回即配置成功,再投入真实开发任务。
要在 Cline 里用 Claude 系模型,也可以把 Provider 换成 Anthropic:此时 Base URL 填 https://codebridgeapi.top(不带 /v1)。协议与地址必须成对,混填是最常见的失败原因。
配错时按现象定位
| Cline 里的现象 | 多半是 | 怎么改 |
|---|---|---|
| 401 Unauthorized | Key 错误或带空格 | 重新粘贴完整 Key;确认是本站签发,不是其他平台的 Key |
| 404 Not Found | Base URL 与 Provider 不配对 | OpenAI Compatible 要带 /v1;Anthropic 不带 /v1 |
| model not found | 模型 ID 手写或过期 | 重新请求 /v1/models,复制当前真实 ID |
| 长任务中途断流 | 网络代理缓冲了流式响应 | 关闭本地代理对该域名的拦截,或换直连网络重试 |
逐项排查后仍不通,可带上当前域名与请求时间通过支持入口反馈。