Cline接入教程编程 Agent

Cline 配置 Claude 和 GPT:自定义 API 密钥教程

(文中价格随实时价格表更新)

简短回答

在 Cline 中使用 APIVAI:打开 Cline 设置,把 API Provider 设为 OpenAI Compatible,Base URL 填 https://api.apivai.com/v1,把 APIVAI 密钥粘贴到 API Key,再填写模型 ID,例如 claude-sonnet-4-6 或 gpt-5.5。如果只用 Claude,也可以选择 Anthropic 提供方,勾选 Use custom base URL 并填入不带 /v1 的 https://api.apivai.com,因为 Cline 会自己补上路径。截至 2026-10-07,通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.04 / $5.22,官方价为 $3.00 / $15.00。费用按 token 从预付余额扣除,无需订阅。

Cline 是什么?为什么要接入自己的 API?

Cline 是一个运行在 VS Code 中的开源 AI 编程 Agent。它会读取你的文件、提出修改、在你批准后运行终端命令,并一步步完成任务。Cline 本身不带模型:你需要接入一个 API 提供方和密钥,任务中的每一步都是一次由该提供方计费的请求。

因此,选哪个提供方基本决定了 Cline 的花费。APIVAI 提供一个可同时调用 Claude 和 GPT 模型的密钥,按 token 计费且低于官方标价,从你按需充值的余额中扣除。同一个密钥同时支持 OpenAI 格式和 Anthropic 格式,所以 Cline 的两种提供方都能用。

在 Cline 中应该选哪个 API Provider?

Cline 有两种提供方类型可以配合 APIVAI 使用:

OpenAI CompatibleAnthropic
Base URLhttps://api.apivai.com/v1https://api.apivai.com(不带 /v1)
模型Claude 和 GPT仅 Claude
选择模型的方式手动填写模型 ID从 Cline 的列表中选择
适合一套配置覆盖所有模型以原生 Messages 格式使用 Claude

选 OpenAI Compatible:想在 Claude 和 GPT 之间切换,或者要用比 Cline 内置列表更新的模型 ID。选 Anthropic:只用 Claude,并且更喜欢 Cline 对 Claude 的原生集成。两者随时可以切换,密钥是同一个。

如何一步步把 Cline 接入 APIVAI?

第 1 步:创建 APIVAI 密钥

  1. 在 apivai.com 用邮箱注册。
  2. 充值 $10 起,支持银行卡、加密货币、支付宝和微信支付。没有免费试用,用多少付多少。
  3. 打开控制台,创建密钥并复制。可以给密钥单独设置预算上限,这样 Cline 的花费不会超出计划。

第 2 步:配置 OpenAI Compatible 提供方

  1. 在 VS Code 中打开 Cline 面板,点击设置(齿轮)图标。
  2. 在 API Provider 中选择 OpenAI Compatible。
  3. 按下表填写各字段。
  4. 如果你的版本有 Verify 按钮就点一下,然后保存并开始任务。
字段值
API ProviderOpenAI Compatible
Base URLhttps://api.apivai.com/v1
API Key你的 APIVAI 密钥
Modelclaude-sonnet-4-6(或 GET /v1/models 返回的任意 ID)
Max Output Tokens8192 或更高(至少 4096)
Input Price / Output Price可选:Claude Sonnet 4.6 填 $1.04 / $5.22

Base URL 必须以 /v1 结尾且只出现一次:Cline 会在后面自动加上 /chat/completions。模型配置里还有 Context Window、Image Support 和 Computer Use,除非确定需要修改,否则保持默认即可。

价格字段只影响 Cline 为任务显示的费用估算。填上 APIVAI 的价格后,估算会与实际扣费一致;真实用量始终以控制台为准。

查看你的密钥可用哪些模型 ID:

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer YOUR_APIVAI_KEY"

模型列表会随时间变化,请从这个接口的返回或价格页复制 ID,不要照抄旧教程里的名称。

第 3 步(可选):用 Anthropic 提供方接入 Claude

  1. 在 API Provider 中选择 Anthropic。
  2. 把 APIVAI 密钥粘贴到 Anthropic API Key。
  3. 勾选 Use custom base URL,填入 https://api.apivai.com。
  4. 在 Model 下拉框中选择一个 Claude 模型。

这里不要加 /v1。Cline 的 Anthropic 客户端会自己在基础地址后加上 /v1/messages,填 https://api.apivai.com/v1 会变成 /v1/v1/messages,返回 404。如果想用的 Claude 模型还不在 Cline 的列表里,请改用 OpenAI Compatible 提供方并手动填写 ID。这种格式的更多说明见 Claude API 代理页面。

在 Cline 中该选哪个模型?

Cline 每个任务会发出很多次请求,所以单价比在聊天应用里更重要。以下为每百万输入 / 输出 token 价格,截至 2026-10-07:

模型 ID价格(输入 / 输出)用途
claude-sonnet-4-6$1.04 / $5.22日常编程的默认选择
claude-sonnet-5-5$0.69 / $3.47日常编程,更新的 Sonnet
claude-opus-5-5$1.39 / $6.96疑难 bug、大型重构
claude-haiku-4-5$0.35 / $1.74小改动,便宜又快
gpt-5.5$0.77 / $4.56GPT 方案,第二意见
gpt-6-luna$0.0144 / $0.0768非常便宜的简单任务

实用搭配:默认用 Claude Sonnet 4.6 或 Claude Sonnet 5.5;任务反复失败时换成 Claude Opus 5.5;重命名、写注释、小修小补用 Claude Haiku 4.5。GPT 模型只能通过 OpenAI Compatible 提供方使用。

Cline 配合 APIVAI 要花多少钱?

Cline 任务的每一步都会重新发送对话和已读取的文件,所以输入 token 累积得很快。以下是 Claude Sonnet 4.6 的两个实际例子:

  • 一个中等任务,例如跨几个文件添加一个功能:约 20 次请求,每次约 30,000 输入和 1,500 输出 token。费用:APIVAI $0.781,官方价 $2.25。
  • 一个工作月,每天三个这样的任务,共 22 天(1,320 次请求):APIVAI $51.52,官方价 $149。

同样一个月换成 Claude Haiku 4.5,费用为 $17.31。以上估算未计入提示缓存,并假设思考 token 已包含在输出数中(思考 token 按输出计费)。控制台会列出每次请求的 token 和费用,用上一天就能用自己的真实数据替换这些假设。更全面的对比见 2026 年 Claude API 价格对比。

Cline 常见报错怎么解决?

  • 401 Unauthorized / 密钥无效: 密钥没复制完整、已被删除,或已用完预算上限。请在控制台检查。使用 Anthropic 提供方时,还要确认已勾选 Use custom base URL,否则 Cline 会把密钥直接发给 Anthropic。
  • 404 Not Found: 几乎都是 /v1 的问题。OpenAI Compatible 需要 https://api.apivai.com/v1(一个 /v1,末尾不要加 /chat/completions)。Anthropic 需要不带 /v1 的 https://api.apivai.com。
  • 找不到模型: Model 字段必须是准确的 ID,例如 claude-sonnet-4-6,而不是显示名称。请用 GET /v1/models 核对。
  • 回复为空或被截断: 思考默认开启并消耗输出 token。把 Max Output Tokens 调到 8192(至少 4096)。
  • 429 Too Many Requests: 每个密钥默认每分钟 60 次请求。长时间的 Agent 任务可能触发限制,稍等片刻或联系客服提高限额。

通用的格式规则见 OpenAI 兼容 API 页面和文档。

常见问题

在 Cline 中能用一个密钥同时使用 Claude 和 GPT 吗?

可以。一个 APIVAI 密钥适用于所有模型。使用 OpenAI Compatible 提供方,修改 Model 字段即可在 claude-sonnet-4-6 和 gpt-5.5 之间切换。

选 OpenAI Compatible 还是 Anthropic 提供方?

OpenAI Compatible 一套配置覆盖 Claude 和 GPT,可以填写任意模型 ID。Anthropic 提供方只支持 Claude,使用 Claude 原生格式;基础地址不要带 /v1。

APIVAI 会保存我的代码吗?

不会。请求和响应的内容不会被记录,只保留模型、token 数和费用等用于计费的使用数据。

有订阅或免费试用吗?

没有订阅,也没有免费额度。充值 $10 起,只为实际使用的 token 付费。

同一个密钥能用在其他工具里吗?

可以。同一个密钥也适用于 Roo Code、Cursor 和 Claude Code。每个工具单独建一个密钥,控制台里的用量会更清楚。

注册账号,充值 $10 起,把密钥粘贴到 Cline 即可。

准备好了吗?

30 秒获取 API 密钥,按量付费使用 Claude 和 GPT