VSCode AI 插件自定义 API 配置教程

在 Cline / Roo Code / Continue.dev 里接入 Claude

一个自定义 API Key,就能让 Cline、Roo Code、Continue.dev 这些 VSCode 编程插件用上 Claude 等模型。选 OpenAI Compatible 供应商,Base URL 填 https://apitopmix.com/v1,选一个模型即可,成本自己说了算。

Cline、Roo Code、Continue.dev 是 VSCode 上最好用的一批 AI 编程插件——它们能读文件、规划、循环调用工具,把智能体编程直接搬进编辑器。而让它们如此灵活的能力很简单:每一个都支持用自定义 API Key自定义 Base URL 接入 Claude(以及 GPT 等模型),而不必被某一家供应商绑死。这篇教程按插件逐个给出配置步骤,照着做就能把 ApiTopMix 添加为供应商,让 Cline、Roo Code、Continue.dev 跑在 Claude 等模型上,成本完全自己掌控。

为什么要在 VSCode AI 插件里折腾自定义 API Key?两个原因。其一是成本可控:按 Token 用自己的账户计费,而不是被打包席位限量。其二是模型自由:一个 Key 就能覆盖 Claude 全系加 GPT-5 等模型,在插件的模型下拉里随手切换,不用改配置。ApiTopMix 在 https://apitopmix.com/v1 提供 OpenAI 兼容网关,这正是这些插件选 OpenAI Compatible 供应商时期望的格式。

你能得到什么

动手之前,先说清楚把这些插件接到 ApiTopMix 之后,到底拿到了哪些实际好处。

🔑

一把 Key 覆盖多个插件

Cline、Roo Code、Continue.dev、Cherry Studio、ChatBox,一把自定义 API Key 全通吃,配置一次到处复用,不用为每个插件单独申请。

💰

成本自己说了算

按 Token 用自己的账户计费,插件里的对话、编辑、智能体任务都跑在你自己的账单上,用量越大越能感受到成本可控。

🔧

OpenAI 兼容,配置极简

提供标准 /v1/chat/completions 端点,正好对上各插件的 OpenAI Compatible 供应商,无需本地代理。

模型自由切换

日常用 Sonnet、难题上 Opus、需要第二意见时切 GPT-5,全在同一个 Key 和同一个 Base URL 之下,加模型只是多填一行。

准备工作

打开任意插件设置之前,先确认你手上有这几样东西:

清单就这些。Cline 和 Roo Code 全在设置界面里完成、不用改配置文件;Continue.dev 走一个小配置文件,下面也一步步讲。

第 0 步:拿到 ApiTopMix 密钥

1

apitopmix.com 注册账号(邮箱注册即可)。

2

进入控制台,打开 Tokens(令牌),点击 创建新令牌

3

复制生成的密钥——它以 sk- 开头。稍后把它粘进每个插件的 API Key 框里。

这一把 sk- 密钥,就是本文所有插件唯一需要的凭证——因为它们都是 OpenAI 兼容客户端,一把 Key 全通用。

Cline:cline claude api key + 自定义 base url

Cline 是 VSCode 上旗舰级的智能体编程插件,它的 OpenAI Compatible 供应商正是做 cline 自定义 base url 配置所需要的。下面是完整的 cline api 提供商 设置流程:

1

打开 Cline 设置。点 VSCode 侧边栏的 Cline 图标,再点 Cline 面板顶部的设置齿轮。

2

选择 API 供应商。API Provider 下拉里选 OpenAI Compatible。这是接任何 OpenAI 风格自定义端点(包括 ApiTopMix)的模式。

3

填入 Base URL。Base URL 框里填 https://apitopmix.com/v1。结尾的 /v1 必须保留——OpenAI 兼容端点就在这个路径上——且结尾不加斜杠。

4

粘贴 API 密钥。API Key 框里粘贴 ApiTopMix 的 sk- 密钥。这就是你的 cline claude api key,它对刚填的 Base URL 做鉴权。

5

填入 Model ID。Model ID 框里填准确的 ApiTopMix 模型 ID,例如 claude-sonnet-4-6。Cline 会原样把它作为 model 字段发出,所以必须和真实 ID 一致。

6

保存并开新任务。保存设置,开一个新的 Cline 任务,它就会通过 ApiTopMix、用你选的模型来规划、改文件、调用工具。

下面把整套配置整理成可复制的对照表——把这几个值填进 Cline 设置对应字段即可:

Cline → Settings → API Provider: OpenAI Compatible
# Cline 设置 → API Provider: OpenAI Compatible
Base URL:  https://apitopmix.com/v1
API Key:   sk-你的ApiTopMix密钥
Model ID:  claude-sonnet-4-6   # 也可填 claude-opus-4-6、gpt-5
cline base url claude 提醒:Cline 会自动在你的 Base URL 后面拼 /chat/completions。所以只填 https://apitopmix.com/v1——如果把完整路径或多余斜杠也填进去就会 404。拿不准时用下面的 cURL 测试单独确认端点。

Roo Code:Cline 分支里的 claude 中转

Roo Code 是 Cline 的热门分支,所以 roo code claude api 配置和 Cline 同构——做过 Cline 的话不到一分钟就能搞定。这是完整的 roo code 中转流程:

1

打开 Roo Code 设置。点 VSCode 侧边栏的 Roo Code 图标,打开它的设置面板。

2

选择供应商。把 API 供应商设为 OpenAI Compatible

3

填入 Base URL。https://apitopmix.com/v1——和 Cline 同值、同规则(保留 /v1,结尾不加斜杠)。

4

粘贴密钥。粘贴同一把 ApiTopMix sk- 密钥。一把 Key 同时服务 Cline 和 Roo Code。

5

填入 Model ID。用有效 ID,如 claude-sonnet-4-6claude-opus-4-6

6

保存。保存并开任务,Roo Code 就会把智能体工作走 ApiTopMix。

Roo Code → Settings → OpenAI Compatible
# Roo Code 设置 → API Provider: OpenAI Compatible
Base URL:  https://apitopmix.com/v1
API Key:   sk-你的ApiTopMix密钥
Model ID:  claude-sonnet-4-6

因为 Roo Code 沿用了 Cline 的供应商模型,你在一边学到的东西都能迁移到另一边——包括下面的排错。

Continue.dev:用自定义模型接入 Claude

Continue.dev 通过一个小配置文件而非纯 UI 来配置,所以 continue 接入 claude 只是复制粘贴一个 model 块。要添加一个指向 ApiTopMix 的 continue.dev 自定义 api 模型:

1

打开 Continue 配置。打开 VSCode 里的 Continue 面板,点齿轮编辑它的配置(视 Continue 版本是 YAML 或 JSON)。

2

加一个 model 条目。provideropenaiapiBasehttps://apitopmix.com/v1apiKey 填 ApiTopMix 密钥,model 填有效 ID。

3

保存并选中。保存配置,在 Continue 对话框底部的模型下拉里选中你新加的模型。

YAML 配置(较新版本 Continue):

~/.continue/config.yaml
# ~/.continue/config.yaml
models:
  - name: Claude Sonnet (ApiTopMix)
    provider: openai
    apiBase: https://apitopmix.com/v1
    apiKey: sk-你的ApiTopMix密钥
    model: claude-sonnet-4-6

JSON 配置(经典 config.json):

~/.continue/config.json
// ~/.continue/config.json
{
  "models": [
    {
      "title": "Claude Sonnet (ApiTopMix)",
      "provider": "openai",
      "apiBase": "https://apitopmix.com/v1",
      "apiKey": "sk-你的ApiTopMix密钥",
      "model": "claude-sonnet-4-6"
    }
  ]
}
continue 自定义 api 说明:provider: openai 这一行让 Continue 说 OpenAI 兼容协议,apiBase 就是自定义 base url 的落点。再加几个 model 不同的条目(如 claude-opus-4-6gpt-5),就能在一把 Key 下把多个模型都放进下拉里。

同样适用:Cherry Studio 与 ChatBox

同一套模式不止限于编程插件。Cherry StudioChatBox 是很流行的桌面 AI 客户端,两者都支持自定义 OpenAI 兼容供应商:

结论:任何 OpenAI 兼容客户端——无论编程插件还是聊天应用——都能用同一把 ApiTopMix 密钥和同一个 Base URL。配置一次,到处复用。

先用 cURL 验证端点

在把锅甩给插件之前,先单独确认密钥和 Base URL 本身是通的。用一条 cURL 打一下 OpenAI 兼容端点——只要它能返回正常的对话结果,插件那边也一定能通:

POST https://apitopmix.com/v1/chat/completions
快速验证(cURL)
curl https://apitopmix.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的ApiTopMix密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好,帮我确认 VSCode 插件接入是否成功"}]
  }'

返回一段正常的 JSON 回复,就同时证明了三件事:你的 sk- 密钥有效、https://apitopmix.com/v1 这个 base url 可达、你填的模型 ID 存在。这样一来,下面的插件排错会快很多,因为密钥、URL 和模型名都已经排除嫌疑了。

智能体编程推荐用哪些模型

Cline、Roo Code、Continue.dev 都是智能体式的——它们读文件、规划、循环调用工具,所以模型选择很关键。可以放在下拉里的实用分法:

Anthropic · 日常

claude-sonnet-4-6

默认首选。响应快、工具调用与多文件编辑强、跟随智能体循环稳定,是 Cline、Roo Code 日常工作里性价比最高的档位。

Anthropic · 复杂

claude-opus-4-6

难缠调试、大规模重构、长上下文密集推理时用它。Sonnet 卡在硬骨头上时切过去。

OpenAI · 备选

gpt-5

规划、交叉验证时的另一种声音,放在下拉里对同一个问题换个视角很方便。

这些模型都在同一个 ApiTopMix 密钥和同一个 Base URL 之下,所以加一个模型只是多填一个 Model ID(或多一个配置条目)——不用第二个供应商、不用第二把 Key。各模型的实时单价、可用型号见 价格页,准确的模型 ID 和接口细节见 API 文档。特别在意成本?可以看看我们的 便宜的 Claude API 专题。

插件常见报错排查

这些插件接自定义供应商出问题的情形其实屈指可数。下面这张表把每个现象对应到解决办法:

现象可能原因解决办法
invalid api key / 鉴权错误 Base URL 填错或密钥被截断 Base URL 填成恰好 https://apitopmix.com/v1(结尾无斜杠),重新粘贴完整 sk- 密钥。用上面的 cURL 测试确认。
model not found / model_not_found 模型 ID 和 ApiTopMix 的 ID 不一致 插件原样把你填的字符串作为 model 发出。改用有效 ID,如 claude-sonnet-4-6gpt-5,对照 文档/v1/models 列表。
请求 404 Base URL 里带了 /chat/completions 或多余斜杠 只填 https://apitopmix.com/v1。Cline、Roo Code、Continue 会自己拼路径,填完整路径或加斜杠都会破坏路由。
找不到对应供应商选项 选错了供应商 OpenAI Compatible(Cline/Roo Code),或在 Continue.dev 里用 provider: openaiapiBase。这条路线不要选原生 Anthropic 供应商。
请求返回 401 / 403 密钥没生效,或余额不足 重新粘贴密钥使其绑定到自定义 Base URL,并在控制台查看 ApiTopMix 余额。
流式 / 工具调用行为异常 所选模型不太适合智能体循环 切到 claude-sonnet-4-6claude-opus-4-6,它们对工具调用和多步智能体编辑处理得很好。

关于 base url 和连接错误更系统的排查清单(跨工具通用),见我们专门的 Base URL 排错指南。无论在 VSCode 插件还是命令行里,根因往往一样——路径错、多余斜杠、模型 ID 不对。

这些插件与 Claude Code CLI、Cursor 的区别

这篇专讲 VSCode 插件家族。如果你也在别处工作,配置方式因工具而异:

同一把 ApiTopMix 密钥驱动它们全部,所以接一个、接几个、全接都行——编辑器插件、Cursor、命令行,一把凭证全搞定。想先弄懂 base url 是什么、为何重要,见 Claude API base url 详解

常见问题

怎么在 Cline 里用自定义 base url 配置 claude api key?

打开 Cline 设置,把 API 供应商选为 OpenAI Compatible,Base URL 填 https://apitopmix.com/v1,粘贴以 sk- 开头的 ApiTopMix 密钥,再填一个模型 ID 如 claude-sonnet-4-6。Cline 会以 OpenAI 格式把请求发给 ApiTopMix,由网关转发到 Claude。结尾的 /v1 必须保留。

Cline 的自定义 base url 到底该填什么?

恰好填 https://apitopmix.com/v1,结尾不加斜杠、不加多余路径。Cline 会自己拼 /chat/completions,填完整路径或多余斜杠就会 404。用 cURL 测试https://apitopmix.com/v1/chat/completions 可独立确认端点。

Roo Code 怎么接入 Claude 中转 API?

Roo Code 是 Cline 的分支,配置方式一样。供应商选 OpenAI Compatible,Base URL 填 https://apitopmix.com/v1,粘贴 ApiTopMix 密钥,模型 ID 填 claude-sonnet-4-6claude-opus-4-6。同一把 Key 在 Cline 和 Roo Code 里都能用。

Continue.dev 怎么用自定义 api 接入 Claude?

编辑 Continue 配置文件,加一个 model:provider: openaiapiBase: https://apitopmix.com/v1apiKeysk- 密钥、model: claude-sonnet-4-6。保存后在 Continue 下拉里选中即可。这就是完整的 continue 自定义模型配置。

每个 VSCode AI 插件都要单独一把 api key 吗?

不用。一把 ApiTopMix sk- 密钥、一个 Base URL https://apitopmix.com/v1,就能覆盖 Cline、Roo Code、Continue.dev、Cherry Studio、ChatBox。任何 OpenAI 兼容客户端都能复用同一套凭证。

智能体编程该用哪个模型?

日常智能体编程 claude-sonnet-4-6 是最好的默认——快、工具调用与多文件编辑强、性价比高。难缠调试或大重构用 claude-opus-4-6,需要第二意见时切 gpt-5。三者都在同一个 Key 和 Base URL 之下。

插件报 model not found 或 invalid api key 怎么办?

model not found 说明模型 ID 和 ApiTopMix 的 ID 不一致——改成有效 ID 如 claude-sonnet-4-6,对照 /v1/models 列表。invalid api key 一般是 Base URL 填错或密钥被截断——确认 Base URL 恰好是 https://apitopmix.com/v1,重新粘贴完整密钥。

ApiTopMix 是 OpenAI 兼容的吗,这些插件能直接用吗?

是。ApiTopMix 在 https://apitopmix.com/v1 提供 OpenAI 兼容端点(含 /v1/chat/completions/v1/models)。Cline、Roo Code、Continue.dev 选 OpenAI Compatible 供应商时期望的正是这个格式。

让你的 VSCode AI 插件跑在自己的 Claude Key 上

拿一个 Key,填一个 Base URL,选一个模型——继续在 Cline、Roo Code、Continue.dev 里用 Claude 写代码,账单由你掌控。

结语

在 Cline、Roo Code、Continue.dev 里接入 Claude,归根结底就是一件事:把每个插件的 OpenAI Compatible 供应商指向 https://apitopmix.com/v1,粘贴 ApiTopMix 密钥,填一个模型 ID 如 claude-sonnet-4-6gpt-5。此后智能体循环——读文件、改代码、调工具——就跑在你掌控的模型和账单上。记住把 Base URL 填准、只用真实模型 ID,连接卡住时用 cURL 自检。

配置一次,你整套 VSCode AI 工具就成了 ApiTopMix 各模型的前端——日常用 Sonnet、难题上 Opus、需要第二意见时切 GPT-5,全在一个 Key 之下。等你转到 Cursor 或终端,同一把 Key 还能驱动 CursorClaude Code CLI,让每个界面保持一致。有任何接口细节,随时回 文档查阅。