简短回答
在 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 Compatible | Anthropic | |
|---|---|---|
| Base URL | https://api.apivai.com/v1 | https://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 密钥
- 在 apivai.com 用邮箱注册。
- 充值:银行卡或加密货币 $10 起,支付宝 / 微信支付 ¥20 起。没有免费试用,用多少付多少。
- 打开控制台,创建密钥并复制。可以给密钥单独设置预算上限,这样 Cline 的花费不会超出计划。
第 2 步:配置 OpenAI Compatible 提供方
- 在 VS Code 中打开 Cline 面板,点击设置(齿轮)图标。
- 在 API Provider 中选择 OpenAI Compatible。
- 按下表填写各字段。
- 如果你的版本有 Verify 按钮就点一下,然后保存并开始任务。
| 字段 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.apivai.com/v1 |
| API Key | 你的 APIVAI 密钥 |
| Model | claude-sonnet-4-6(或 GET /v1/models 返回的任意 ID) |
| Max Output Tokens | 8192 或更高(至少 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
- 在 API Provider 中选择 Anthropic。
- 把 APIVAI 密钥粘贴到 Anthropic API Key。
- 勾选 Use custom base URL,填入
https://api.apivai.com。 - 在 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.52 | GPT 方案,第二意见 |
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 即可。