← 博客
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-6.1-sol。如果只用 Claude,也可以选择 Anthropic 提供方,勾选 Use custom base URL 并填入不带 /v1 的 https://api.apivai.com,因为 Cline 会自己补上路径。截至 2026-11-18,通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.14 / $5.68,官方价为 $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 起,支付宝 / 微信支付 ¥20 起。没有免费试用,用多少付多少。
  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.14 / $5.68

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-11-18:

模型 ID价格(输入 / 输出)用途
claude-sonnet-5-5$0.75 / $3.79日常编程的默认选择;更新、更便宜
claude-sonnet-4-6$1.14 / $5.68支持最广泛;Sonnet 5.5 更新、更便宜
claude-opus-5-5$1.52 / $7.57疑难 bug、大型重构
claude-haiku-4-5$0.38 / $1.89小改动,便宜又快
gpt-6.1-sol$0.30 / $1.52GPT 方案,第二意见
gpt-6-luna$0.0144 / $0.0768非常便宜的简单任务

实用搭配:默认用 Claude Sonnet 5.5(也可以用较早的 Claude Sonnet 4.6);任务反复失败时换成 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.854,官方价 $2.25。
  • 一个工作月,每天三个这样的任务,共 22 天(1,320 次请求):APIVAI $56.39,官方价 $149。

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

Cline 常见报错怎么解决?

  • 401 Unauthorized / 密钥无效: 密钥没复制完整,或已被删除。请在控制台检查。使用 Anthropic 提供方时,还要确认已勾选 Use custom base URL,否则 Cline 会把密钥直接发给 Anthropic。
  • 402 insufficient_quota: 密钥预算已用完,或者剩下的预算不够这个模型用。Opus、Sonnet 4.6 这类较贵的模型会最先遇到,便宜的模型还能多用一会儿。在控制台给密钥增加预算,或者换一个更便宜的模型。密钥上剩下的钱不会浪费:删除密钥后会退回账户余额。
  • 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 核对。
  • 回复为空或被截断: Claude 模型即使没开 thinking 也可能先思考,思考会消耗输出 token。把 Max Output Tokens 调到 8192(至少 4096)。
  • 429 Too Many Requests: 每个密钥每分钟 60 次请求。长时间的 Agent 任务可能触发限制,稍等片刻或把请求分散到多个密钥。

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

所有 API 错误码及解决方法见 Claude API 错误码大全。

常见问题

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

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

选 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

开始使用