CC Switch 配置第三方 API 完整教程
CC Switch 是一个跨平台桌面应用,把 Claude Code、Codex CLI、Gemini CLI 等工具的供应商配置收口到一个界面里管理。 配置第三方端点的核心是三点:预设必须选「自定义」、 Claude Code 的 Base URL 不带 /v1、Codex 的带 /v1、 切换后必须重启 CLI。它本身不调用模型,只是配置管理,真正发请求的仍是命令行工具。
一、CC Switch 解决什么问题
不用 CC Switch 时,每换一个供应商都要手动改配置文件或环境变量:
| 工具 | 配置位置 | 关键字段 |
|---|---|---|
| Claude Code | ~/.claude/settings.json 或环境变量 | ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN |
| Codex CLI | ~/.codex/config.toml | model_providers.*.base_url、env_key |
手工切换的常见问题:改错路径前缀、把 A 平台的 Key 填进 B 工具、覆盖掉已有的其他配置、改了但忘记重启、Key 留在终端历史里。
CC Switch 把每个供应商存成一份配置档案(Provider Profile),点一下切换就写入对应工具的配置文件。
二、三种连接模式的区别
CC Switch 顶部通常有模式切换(直连 / 路由 / 聚合)。这三种模式的请求路径完全不同:
| 模式 | 请求路径 | 适用场景 |
|---|---|---|
| 直连 | CLI 直接请求供应商端点 | 端点原生支持该 CLI 使用的协议 |
| 路由 | 先经本机 CC Switch,可做协议转换 | 例如在 Claude Code 里调用 OpenAI 协议模型 |
| 聚合 | 按会话内选中的模型分发到不同供应商 | 多家端点混用,想在会话里换模型不重启 |
三、Claude Code 配置步骤
3.1 切换到 Claude 应用
顶部应用切换器选 Claude。
3.2 新增供应商,预设选「自定义」
点右上角 + 按钮,「预设」下拉框拉到最底部选 Custom / 自定义。
3.3 填写字段
| 字段 | 填什么 |
|---|---|
| 名称 | 自定义,建议带上线路特征,例如 MyAPI-日常 |
| Base URL | https://api.jetapi.icu(不带 /v1) |
| API Key | sk- 开头的密钥 |
| 模型 ID(若有) | 留空,或填端点支持的模型名 |
3.4 为什么 Claude Code 的 Base URL 不带 /v1
Claude Code 会自己在 Base URL 后面拼接 /v1/messages。实测各路径的返回:
| Base URL | 实际请求 | 返回 |
|---|---|---|
https://api.jetapi.icu | /v1/messages | 401(正常,只是缺 Key) |
https://api.jetapi.icu/v1 | /v1/v1/messages | 404 Invalid URL |
| 只填域名但漏了 /v1 的客户端路径 | /messages | 405 Method Not Allowed |
3.5 保存并切换
点「添加」→ 卡片出现在列表 → 点卡片上的 切换 → 状态变为 使用中。
3.6 必须重启 Claude Code
CC Switch 只改配置文件,运行中的进程不会重新读取。
# 完全退出(不是 /clear,是退出进程)后重新启动
claude
四、Codex CLI 配置步骤
流程相同,但 Base URL 的规则相反:
| 字段 | 填什么 |
|---|---|
| 名称 | 自定义,例如 MyAPI-codex |
| Base URL | https://api.jetapi.icu/v1(带 /v1) |
| API Key | sk- 开头的密钥 |
| 模型 ID | 端点支持的模型名,例如 gpt-6.1-sol |
为什么 Codex 要带 /v1
Codex 走 OpenAI 协议,把 Base URL 当目录前缀,自己再拼 /chat/completions 或 /responses。
/v1,
服务端可能返回 200 加一段 HTML(撞到站点自己的单页应用路由),而不是 404。
客户端会在「解析 JSON 失败」那一步报错,看起来像 SDK 问题。
遇到 Unexpected token < 之类的错误,先打印原始响应体确认是不是 HTML。
五、验证配置是否真的生效
看环境变量不够可靠,因为进程可能缓存了旧值。按可靠性排序:
| 方式 | 可靠性 | 做法 |
|---|---|---|
| 看环境变量 | 低 | echo $ANTHROPIC_BASE_URL |
| 直接发 API 请求 | 中 | curl 打端点,排除 CLI 层 |
| 看调用记录 | 最高 | 去端点后台看有没有产生这次调用 |
第三种方法最可靠:环境变量可能被旧进程缓存,但调用记录不会骗人。
六、配置不生效的排查
| 现象 | 原因 | 解法 |
|---|---|---|
| 切换了但还是连官方 | CLI 进程未重启 | 完全退出所有相关进程后重启 |
| 预设没改成「自定义」 | Base URL 仍是官方默认值 | 重新编辑供应商,确认预设是 Custom |
| 改了 Key 还是 401 | 进程缓存了旧的 ANTHROPIC_AUTH_TOKEN |
彻底退出进程 |
| 报 404 | Base URL 多了 /v1(Claude Code) |
只填域名 |
| JSON 解析失败 | Base URL 少了 /v1(Codex),拿到 HTML |
补上 /v1 |
彻底退出进程
# Windows PowerShell
Get-Process | Where-Object { $_.ProcessName -match 'claude|node' } | Stop-Process
# macOS / Linux
pkill -f claude
七、多套配置怎么管理
如果同一个工具要连多个端点(比如便宜线路和稳定线路),建议按用途建多个供应商档案:
MyAPI-日常 Base URL: https://api.jetapi.icu Key: 便宜线路分组
MyAPI-重要任务 Base URL: https://api.jetapi.icu Key: 稳定线路分组
官方 Base URL: 留空(用官方默认)
切换时点一下卡片,然后重启 CLI。
CC Switch 也支持同一个供应商下挂多个 API Key,适合一个 Key 配额用完切另一个的场景。
八、和手动配置的对照
CC Switch 出问题时,可以直接写配置文件,内容与它写入的一致。
Claude Code
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.jetapi.icu",
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
}
}
Codex CLI
model_provider = "custom"
model = "gpt-6.1-sol"
[model_providers.custom]
name = "Custom"
base_url = "https://api.jetapi.icu/v1"
env_key = "CUSTOM_API_KEY"
注意 env_key 填的是环境变量名,不是 Key 本身。