统一配置
CC Switch 管理 Jerry API
用一个桌面工具管理 Codex、OpenCode、OpenClaw、Hermes 和 Claude Code 的 Provider。WorkBuddy 与 Cursor 仍需在各自应用内单独配置。
1. 安装 CC Switch
macOS
Homebrew
brew install --cask cc-switchWindows / Linux
从 CC Switch 官方 GitHub Releases 下载与你的系统匹配的安装包。首次启动时，如果提示导入现有工具配置，建议先完成导入并保留备份。
2. 为 Codex 添加 Jerry API
- 选择 Codex
在 CC Switch 顶部切换到
Codex，点击右上角添加 Provider。 - 选择 OpenAI Compatible 或 Custom
如果预设中没有 Jerry API，使用自定义 Provider。
- 填写基础信息
Name 填
Jerry API，API Key 填你的密钥，Endpoint URL 填https://www.jerryapi.com/v1。 - 添加模型
先添加
gpt-5.4，再按需添加gpt-5.4-mini与gpt-5.5。 - 保存并启用
点击 Provider 卡片上的 Enable，随后完全退出并重新启动 Codex。
Codex 默认无需本地路由
Jerry API 的 GPT 链路按 Responses 配置时，Needs Local Routing 先保持关闭。只有明确出现协议不兼容时才启用转换。
3. 自动获取或手动添加模型
CC Switch 可以使用 API Key 请求 /v1/models。点击模型输入框旁的 Fetch Models，勾选需要的 GPT 模型。
| 模型 ID | 显示名称建议 |
|---|---|
gpt-5.4 | Jerry GPT-5.4 |
gpt-5.4-mini | Jerry GPT-5.4 mini |
gpt-5.5 | Jerry GPT-5.5 |
如果获取模型返回 401、403 或超时，先检查密钥状态与 IP 限制，也可以直接手动输入上面的模型 ID。
4. 管理其他工具
| 工具 | 配置方式 | 是否需要本地路由 |
|---|---|---|
| OpenCode | App-specific Provider，OpenAI Compatible | 通常不需要 |
| OpenClaw | App-specific Provider，选择 Responses 或 Completions | 通常不需要 |
| Hermes | App-specific Provider，Custom endpoint | 通常不需要 |
| Claude Code | OpenAI Responses API + 模型角色映射 | 需要 |
| WorkBuddy | 不由 CC Switch 管理，在 WorkBuddy 内单独添加 | 不适用 |
| Cursor | 不由 CC Switch 管理，在 Cursor Models 中单独添加 | 不适用 |
Universal Provider 不等于所有工具都同一种协议
共享 Name、Key 和地址很方便，但 Codex、Claude Code 和普通 Chat 工具的协议不同。同步后仍要检查每个 App 的 API Format。
5. 验证与恢复
- 启用 Provider 后重启目标工具
- 在目标工具中确认当前模型是 Jerry GPT
- 发送最小请求，再测试一次工具调用
- 从 Jerry API 使用记录核对模型、Token 与消费
| 现象 | 处理 |
|---|---|
| 切换后工具仍用旧配置 | 完全退出目标工具并重启；部分模型目录只在启动时加载 |
| Codex 会话列表变化 | Provider ID 可能影响会话命名空间；保持稳定 Provider ID，切换前导出配置备份 |
| Claude Code 无法请求 | 确认 Local Routing 与 Claude Takeover 都在运行 |
| 想恢复原配置 | 在 CC Switch 数据管理中恢复备份，或重新启用原 Provider |