进阶配置
Claude Code 与 GPT 的兼容说明
Claude Code 原生使用 Anthropic Messages 协议；Jerry API 当前重点提供 GPT 的 OpenAI-compatible 接口。因此 GPT 接入 Claude Code 需要本地协议转换，不属于直接配置。
不要把 Jerry 的 /v1 直接填进 ANTHROPIC_BASE_URL
Claude Code 发出的请求结构是 Anthropic Messages，而 Jerry GPT 接口是 OpenAI Responses / Chat Completions。只改 Base URL 不会自动完成协议转换。
先判断是否真的需要
通过 CC Switch 接入
- 先安装 Claude Code 与 CC Switch
确认
claude --version可以运行，并完成 CC Switch 安装。 - 切换到 Claude Code
在 CC Switch 顶部选择 Claude Code，点击添加 Provider。
- 添加 Jerry API
选择 OpenAI Compatible 或 Custom，填写 API Key、
https://www.jerryapi.com/v1和gpt-5.4。 - 协议选择 OpenAI Responses
在 Advanced Options 中将 API Format 设为
OpenAI Responses API。 - 启用本地路由接管
启动 CC Switch Proxy，并为 Claude Code 开启 Takeover。协议转换依赖这个本地代理持续运行。
- 保存、启用并重启 Claude Code
新开终端运行
claude，先测试对话，再测试文件读取和工具调用。
本地路由必须保持运行
关闭 CC Switch Proxy 后，Claude Code 无法继续通过该转换链路访问 Jerry API。
模型角色映射
如果 CC Switch 提供 Main / Sonnet / Opus / Haiku 等角色字段，可使用下面的起点：
| Claude Code 角色 | Jerry 模型 |
|---|---|
| Main | gpt-5.4 |
| Sonnet | gpt-5.4 |
| Opus | gpt-5.5 |
| Haiku | gpt-5.4-mini |
这些是任务分工映射，不代表 GPT 与 Claude 模型能力完全等价。
兼容边界
- 普通对话和基础工具调用通常最容易验证
- 流式事件、思考内容和工具参数需要本地代理正确转换
- Prompt Cache、模型专属参数、MCP 与部分 Skills 行为可能与原生 Claude 不一致
- 升级 Claude Code 或 CC Switch 后应重新执行一次完整验证
| 现象 | 优先检查 |
|---|---|
| 启动后 401 | CC Switch 中的 Jerry API Key 是否有效，本地代理是否接管 |
| 404 或协议字段错误 | API Format 是否为 OpenAI Responses，本地路由是否正在运行 |
| 能回答但不会调用工具 | 查看 CC Switch 代理日志，并改用 Codex 对比同一任务 |
| 升级后突然失效 | 重启两端、重新启用 Provider，并检查 CC Switch 版本说明 |