JetAPI / CC Switch 配置教程

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.tomlmodel_providers.*.base_url、env_key

手工切换的常见问题:改错路径前缀、把 A 平台的 Key 填进 B 工具、覆盖掉已有的其他配置、改了但忘记重启、Key 留在终端历史里。

CC Switch 把每个供应商存成一份配置档案(Provider Profile),点一下切换就写入对应工具的配置文件。

二、三种连接模式的区别

CC Switch 顶部通常有模式切换(直连 / 路由 / 聚合)。这三种模式的请求路径完全不同:

模式请求路径适用场景
直连 CLI 直接请求供应商端点 端点原生支持该 CLI 使用的协议
路由 先经本机 CC Switch,可做协议转换 例如在 Claude Code 里调用 OpenAI 协议模型
聚合 按会话内选中的模型分发到不同供应商 多家端点混用,想在会话里换模型不重启
能用直连就别开路由。路由多一层本机转换,出问题时排查链路更长。 只有当端点协议与 CLI 协议不匹配时,才需要路由。

三、Claude Code 配置步骤

3.1 切换到 Claude 应用

顶部应用切换器选 Claude。

3.2 新增供应商,预设选「自定义」

点右上角 + 按钮,「预设」下拉框拉到最底部选 Custom / 自定义。

这一步最容易错。如果保留内置的官方预设,Base URL 仍然是官方地址,等于没配。 必须显式改成自定义,才能填入自己的端点。

3.3 填写字段

字段填什么
名称自定义,建议带上线路特征,例如 MyAPI-日常
Base URLhttps://api.jetapi.icu(不带 /v1)
API Keysk- 开头的密钥
模型 ID(若有)留空,或填端点支持的模型名

3.4 为什么 Claude Code 的 Base URL 不带 /v1

Claude Code 会自己在 Base URL 后面拼接 /v1/messages。实测各路径的返回:

Base URL实际请求返回
https://api.jetapi.icu/v1/messages401(正常,只是缺 Key)
https://api.jetapi.icu/v1/v1/v1/messages404 Invalid URL
只填域名但漏了 /v1 的客户端路径/messages405 Method Not Allowed

3.5 保存并切换

点「添加」→ 卡片出现在列表 → 点卡片上的 切换 → 状态变为 使用中。

3.6 必须重启 Claude Code

CC Switch 只改配置文件,运行中的进程不会重新读取。

# 完全退出(不是 /clear,是退出进程)后重新启动
claude

四、Codex CLI 配置步骤

流程相同,但 Base URL 的规则相反:

字段填什么
名称自定义,例如 MyAPI-codex
Base URLhttps://api.jetapi.icu/v1(带 /v1)
API Keysk- 开头的密钥
模型 ID端点支持的模型名,例如 gpt-6.1-sol

为什么 Codex 要带 /v1

Codex 走 OpenAI 协议,把 Base URL 当目录前缀,自己再拼 /chat/completions 或 /responses。

一个比 404 更难查的坑:OpenAI 协议的端点如果漏写 /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 本身。

九、相关页面