用 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
一键导入怎么走
- 安装 CC Switch,并至少打开一次 —— 打开过之后系统才认得 ccswitch:// 链接,按钮才能唤起它。
- 准备 key:在控制台 API Keys 点「为 CC Switch 创建 Key」,建好的弹窗里就有导入按钮;已经有 key 的话,粘贴到下面的生成器。
- 点你要用的工具。浏览器会问是否打开 CC Switch,选「打开」。
- CC Switch 弹出确认框,列出地址、打码后的 key、模型和余额查询脚本全文。核对无误后点「导入」。底部的开关决定导入后是否立即切换(Claude Code、Codex、Gemini CLI),或立即写进工具配置(OpenCode、OpenClaw)。
- 切到 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 Code | Anthropic Messages | https://api.apimodels.app | claude-opus-5-5 |
| Codex | OpenAI Responses | https://api.apimodels.app/v1 | gpt-6-sol |
| Gemini CLI | Gemini 原生 | https://api.apimodels.app | gemini-3-flash-preview |
| OpenCode | OpenAI Chat Completions | https://api.apimodels.app/v1 | claude-opus-5-5 |
| OpenClaw | OpenAI Chat Completions | https://api.apimodels.app/v1 | claude-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-5Codex不用 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-previewOpenCode
npm @ai-sdk/openai-compatible
baseURL https://api.apimodels.app/v1
apiKey sk_…your_apimodels_key…
models claude-opus-5-5OpenClaw不用 CC Switch 的配置方法
api openai-completions
baseUrl https://api.apimodels.app/v1
apiKey sk_…your_apimodels_key…
models claude-opus-5-5MCP:一个按钮加到全部工具
「把 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 或更新后重新导入。也可以在卡片上打开「配置用量查询」,点「测试脚本」看报什么错。 |
| 切过去后请求报 401 | key 已经在控制台删除,或复制不完整。新建一把 key 重新导入。 |
| 报模型不存在 | 在 CC Switch 的卡片里把模型改成我们提供的模型 id(见模型列表),或重新导入,用本页的默认模型。 |
常见问题
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。