Cline 接入中转 API 教程：VS Code 编程代理配置

发布时间2026年8月30日 09:08
语言zh

VS Code 开源编程代理 Cline 接入教程：创建 sk- 密钥、配置 API Provider 与 Base URL，调用 Claude / GPT / Gemini 模型。

一、Cline 是什么

Cline 是 VS Code 里流行的开源 AI 编程智能体，能读代码库、改文件、跑终端命令，原生支持 Anthropic / OpenAI / Google（Gemini）等多个 Provider。把它的 API Provider 指向中转网关、填入 sk- 密钥，即可用平台额度调用 Claude / GPT / Gemini，按 token 计费。

二、准备工作

登录极智API控制台，在「API 密钥」创建 sk-xxxxxx 密钥（只显示一次，请保存）。
确认要用的模型 slug（如 claude-sonnet-5、gpt-5.5、gemini-3.7-flash）。
确认网关地址：https://www.relay-api.com。

三、在 Cline 里配置

打开 Cline → 齿轮图标（Settings）→ API Provider，按模型类型选择：

① Anthropic（调 Claude）

Base URL : https://www.relay-api.com
API Key  : sk-你的密钥
Model ID : claude-sonnet-5

② OpenAI Compatible（调 GPT）

Base URL : https://www.relay-api.com/v1
API Key  : sk-你的密钥
Model ID : gpt-5.5

③ 调 Gemini：选 Google Gemini（或 OpenAI-compatible）Provider，Base URL 用 https://www.relay-api.com/v1beta、Model ID 用 gemini-3.7-flash（模型名走 URL）。

填完点 Connect / Continue 验证即可。Base URL 用上表入口。

四、接口地址对照

模型分组	本站入口（Base URL）	协议
Claude / Anthropic	`https://www.relay-api.com`	Anthropic Messages
GPT / OpenAI	`https://www.relay-api.com/v1`	OpenAI Chat Completions
Gemini	`https://www.relay-api.com/v1beta`	Google generateContent

五、常见问题排查

现象	处理
401 / 403	密钥无效、未启用或余额不足；确认 `sk-` 正确并充值。
404 / 模型不可用	模型名与平台 slug 不一致，或该模型未启用；核对模型 ID。
Unknown model	填的模型 id 要精确（含大小写），用模型广场核对。

安全建议：密钥别写法进公开仓库，用 .env 或环境变量；给每个工具单独建一个 Key 便于统计与限额。

Base URL 说明：本站同时接受 /v1beta/models/... 与 /v1beta/v1beta/models/...（以及 /v1/... 与 /v1/v1/...），所以客户端是否自己补 /v1、/v1beta 都不影响调用：Base URL 填域名根或填带 /v1beta 的地址都能用。模型 ID 请在控制台「令牌」页右上角「模型 ID」里查询复制。