APIMODELSAPIMODELS
CC Switch · 一键导入 · Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw

用 CC Switch 一键接入 apimodels

CC Switch 是一个开源桌面应用,把 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具的供应商配置放在一处管理。粘贴你的 apimodels API Key,点一下对应工具的按钮,地址、key、默认模型和余额显示就一起导入,不用手动填表;MCP 也只要一个按钮。

CC Switch 是什么

  • 开源(MIT)的桌面应用,支持 Windows、macOS 和 Linux。
  • 每个工具一个供应商列表。点「启用」,CC Switch 就把这个工具的配置文件改成对应的地址和 key;OpenCode、OpenClaw 可以同时添加多个供应商。
  • 还能统一管理 MCP、提示词和 Skills,并在供应商卡片上显示余额。
  • 它是第三方项目,与 apimodels 没有隶属关系。源码和下载:github.com/farion1231/cc-switch

一键导入怎么走

  1. 安装 CC Switch,并至少打开一次 —— 打开过之后系统才认得 ccswitch:// 链接,按钮才能唤起它。
  2. 准备 key:在控制台 API Keys 点「为 CC Switch 创建 Key」,建好的弹窗里就有导入按钮;已经有 key 的话,粘贴到下面的生成器。
  3. 点你要用的工具。浏览器会问是否打开 CC Switch,选「打开」。
  4. CC Switch 弹出确认框,列出地址、打码后的 key、模型和余额查询脚本全文。核对无误后点「导入」。底部的开关决定导入后是否立即切换(Claude Code、Codex、Gemini CLI),或立即写进工具配置(OpenCode、OpenClaw)。
  5. 切到 apimodels 之后:Claude Code 下一条消息就生效;Codex、Gemini CLI 要重开终端或重启 CLI。

粘贴 key,生成导入按钮

key 只存在这个页面的内存里,用来在你的浏览器里拼出导入链接:不上传、不保存,刷新或关掉页面就没了。

还没有 key?到 控制台 → API Keys 点「为 CC Switch 创建 Key」,建好后弹窗里就有同样这组按钮。

一键导入 CC Switch

需要先在这台电脑上安装 CC Switch(v4.0.10 及以上)。链接里带着这把 key,点按钮后只交给你本机的 CC Switch,不会发给 apimodels 或任何其他服务器。

导入为供应商(每个应用一个按钮)

浏览器会先问是否打开 CC Switch,选「打开」,再在 CC Switch 的确认框里核对后点「导入」。点了没反应,多半是还没安装,或浏览器拦下了外部应用。同一个按钮点两次会导入两份。

每个按钮导入了什么

工具接口格式地址默认模型
Claude CodeAnthropic Messageshttps://api.apimodels.appclaude-opus-5-5
CodexOpenAI Responseshttps://api.apimodels.app/v1gpt-6-sol
Gemini CLIGemini 原生https://api.apimodels.appgemini-3-flash-preview
OpenCodeOpenAI Chat Completionshttps://api.apimodels.app/v1claude-opus-5-5
OpenClawOpenAI Chat Completionshttps://api.apimodels.app/v1claude-opus-5-5
  • 五个按钮都用该工具的原生接口格式,导入后是直连,不需要开 CC Switch 的路由。
  • 每条链接还带着名称 apimodels、官网地址、图标和余额查询脚本。
  • Codex 另外带一小段 config.toml:review_model 同为 gpt-6-sol,推理强度 medium,与 Codex 文档页的推荐配置一致。
  • 默认模型导入后随时可以在 CC Switch 的卡片里改;OpenCode、OpenClaw 的可选模型只有导入时这一个,要用别的模型就在卡片里加。

不用链接,手动添加

在 CC Switch 侧栏选中工具,点右上角「+」添加供应商,选自定义配置,按下面的值填,保存后点「启用」(OpenCode、OpenClaw 是「添加」)。这些就是一键导入写进各工具配置的字段。

Claude Code不用 CC Switch 的配置方法

ANTHROPIC_BASE_URL     https://api.apimodels.app
ANTHROPIC_AUTH_TOKEN   sk_…your_apimodels_key…
ANTHROPIC_MODEL        claude-opus-5-5

Codex不用 CC Switch 的配置方法

base_url   https://api.apimodels.app/v1
wire_api   responses
model      gpt-6-sol
API Key    sk_…your_apimodels_key…

Gemini CLI不用 CC Switch 的配置方法

GOOGLE_GEMINI_BASE_URL   https://api.apimodels.app
GEMINI_API_KEY           sk_…your_apimodels_key…
GEMINI_MODEL             gemini-3-flash-preview

OpenCode

npm       @ai-sdk/openai-compatible
baseURL   https://api.apimodels.app/v1
apiKey    sk_…your_apimodels_key…
models    claude-opus-5-5

OpenClaw不用 CC Switch 的配置方法

api       openai-completions
baseUrl   https://api.apimodels.app/v1
apiKey    sk_…your_apimodels_key…
models    claude-opus-5-5

MCP:一个按钮加到全部工具

「把 apimodels MCP 加到全部应用」会在 CC Switch 里添加一个名为 apimodels 的远程 MCP 服务器,并在导入时立即写进 Claude Code、Codex、Gemini CLI 和 OpenCode 的配置文件。之后这些工具里的智能体就能直接调用图片、视频、对话和语音工具。CC Switch 不给 OpenClaw 写 MCP,所以它不在其中。

{
  "mcpServers": {
    "apimodels": {
      "type": "http",
      "url": "https://api.apimodels.app/mcp",
      "headers": { "Authorization": "Bearer sk_…your_apimodels_key…" }
    }
  }
}
  • CC Switch 里已经有名为 apimodels 的 MCP 时,导入只会给它多勾上这些工具,不会改它原来的配置。想换成这份,先删掉旧的再导入。
  • key 会以请求头的形式明文写进各工具的 MCP 配置文件。不想这样,可以改用浏览器登录授权的方式,见 MCP 文档页。
  • 有哪些工具、托管版和本地版的区别:/docs/mcp

在卡片上看余额

每条供应商链接都带着下面这段用量查询脚本,导入后默认启用:CC Switch 用你的 key 请求 GET https://api.apimodels.app/v1/balance,在卡片上显示可用余额(美元)。这个接口只读,不扣费。请求由 CC Switch 从你的电脑直接发出,只发到 api.apimodels.app。

({
  request: {
    url: "{{baseUrl}}".replace(/\/+$/, "").replace(/\/v1$/, "") + "/v1/balance",
    method: "GET",
    headers: { "Authorization": "Bearer {{apiKey}}" }
  },
  extractor: function (response) {
    var data = response && response.data;
    if (response && response.code === 200 && data && typeof data.balance === "number") {
      return { remaining: data.balance, unit: "USD" };
    }
    return { isValid: false, invalidMessage: (response && response.msg) || "Balance query failed" };
  }
})

链接没有设定自动刷新间隔;想定时刷新,在卡片的「配置用量查询」里设置。

排错

点了按钮没有任何反应多半是 CC Switch 还没装,或装了没打开过(macOS 要先放进「应用程序」文件夹并打开一次,系统才注册 ccswitch://)。也可能是浏览器拦下了外部应用:看地址栏有没有拦截提示,允许后再点。网页没法可靠判断你装没装,所以按钮一直可以点。
API key is required / Endpoint is required链接不完整,通常是 key 粘贴时被截断。重新粘贴完整的 key 再点。
列表里出现两个 apimodels同一个按钮点了两次就会导入两份,CC Switch 不去重。删掉多余的那一份即可。
卡片上有「需要路由」意思是这个供应商的接口格式不是该工具原生的,要在 CC Switch 里切到「路由」模式,由本机转换格式。本页五个按钮都用各工具的原生格式,导入后是直连,正常不会出现;出现了先检查是不是手动改过接口格式。
卡片上不显示余额版本太旧的 CC Switch 不认链接里的用量脚本(图标也要 v4.0.10 起才显示):升级到 v4.0.10 或更新后重新导入。也可以在卡片上打开「配置用量查询」,点「测试脚本」看报什么错。
切过去后请求报 401key 已经在控制台删除,或复制不完整。新建一把 key 重新导入。
报模型不存在在 CC Switch 的卡片里把模型改成我们提供的模型 id(见模型列表),或重新导入,用本页的默认模型。

安装包下载:github.com/farion1231/cc-switch/releases

常见问题

CC Switch 是干什么用的?

CC Switch 是一个开源(MIT)的桌面应用,支持 Windows、macOS 和 Linux,用来管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程工具的供应商:多个接口地址和 key 存在一处,点一下就切换,不用手改各工具的配置文件;还能统一管理 MCP、提示词和 Skills,在供应商卡片上显示余额。它是第三方项目,与 apimodels 没有隶属关系。

CC Switch 怎么安装?

到 github.com/farion1231/cc-switch 的 Releases 页下载:Windows 用 .msi 安装包(或免安装 zip),macOS 用 .dmg(或 brew install --cask cc-switch),Linux 有 .deb、.rpm 和 AppImage。系统要求 Windows 10 及以上、macOS 12 及以上,Linux 需要 glibc 2.35+ 和 WebKitGTK 4.1。装好后先打开一次,系统才会注册 ccswitch:// 链接,一键导入按钮才唤得起它。

CC Switch 怎么配置中转站的 API?

CC Switch 给每个工具单独存供应商:名称、接口地址、API Key 和模型。服务方提供「导入到 CC Switch」按钮的话,点一下就全部填好。apimodels 的按钮在 /docs/cc-switch 页面和控制台 API Keys 的新建 key 弹窗里,会按工具填好地址(Claude Code、Gemini CLI 用 https://api.apimodels.app,Codex、OpenCode、OpenClaw 用 https://api.apimodels.app/v1)、默认模型和余额显示。

不用一键链接,怎么在 CC Switch 里手动添加中转站?

在 CC Switch 侧栏选中工具,点右上角「+」添加供应商,选自定义配置,填接口地址、API Key 和模型,保存后点「启用」(OpenCode、OpenClaw 是「添加」)。每个工具要填的值见 /docs/cc-switch 的「手动添加」一节。Codex 的接口要选 Responses(wire_api = "responses")。

怎么用 CC Switch 把 apimodels 接入 Claude Code?

装好 CC Switch 后,在 /docs/cc-switch 粘贴 key 点「Claude Code」,或在控制台新建 key 的弹窗里点同一个按钮。在确认框里核对地址 https://api.apimodels.app(不带 /v1)和默认模型 claude-opus-5-5,导入并切换到 apimodels。Claude Code 不用重启,下一条消息就走新的供应商。

CC Switch 的路由和直连有什么区别?

直连是工具直接请求供应商的地址,CC Switch 只负责写配置。路由是请求先经过 CC Switch 在你本机开的转发,由它转换接口格式(比如让 Claude Code 用 OpenAI 格式的供应商)、在供应商之间故障转移,再发出去。apimodels 给每个工具都提供原生格式,从 /docs/cc-switch 导入的都是直连,不需要开路由;卡片上标了「需要路由」才需要。

用 CC Switch 接中转站,中转站能看到我的代码吗?

CC Switch 自己只在你电脑上改配置文件,不经手请求(开了路由时,转发也在你本机完成)。真正发出去的是 Claude Code 这类工具的请求:它把对话连同读进上下文的代码发到你配置的接口地址,所以这部分内容会经过中转站(包括 apimodels)再到模型;没被读进对话的本地文件不会上传。各家怎么处理数据,以各自的隐私政策为准,apimodels 的见 apimodels.app/privacy。