通过 CC Switch 为 Claude Code 接入 OpenAI 格式中转接口

背景与核心原理

  • 使用背景：Claude Code 默认仅支持 Anthropic 官方模型接口，不兼容市面上多数 API 中转站常用的 OpenAI 协议。
  • 工作机制：CC Switch 在本地充当“同声传译”。Claude Code 将原生请求发给本地 CC Switch 代理，CC Switch 将其转换为 OpenAI 协议格式，并携带真实的 API Key 转发给远端中转站。

第一步：在 CC Switch 中配置服务商

在 CC Switch 软件界面中添加供应商，使用自定义配置：

image-20261001182104557

  • 请求地址：填写中转站基础域名，绝对不要以 /v1 结尾
  • 完整 URL 开关：开启。
  • API Key：填写你真实的 sk-xxx 密钥。

image-20261001182512349

  • 上游格式：选择 OpenAI Chat Completions (需开启路由) 。
  • 认证字段：选择 ANTHROPIC_AUTH_TOKEN 。
  • 模型映射：将对应模型的“实际请求模型”填为中转站支持的名称（如 gpt-5.6-sol）。

image-20261001182857040

  • 启用路由：打开路由总开关，确保该配置处于“使用中”，并记下软件界面显示的“服务地址”。

第二步：检查是否开启成功

打开本地实际的配置文件（通常是 ~/.claude.json），将流量和鉴权完全交给 CC Switch 托管。确保包含以下核心字段：

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:15721", 
    "ANTHROPIC_AUTH_TOKEN": "PROXY_MANAGED",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "gpt-5.6-sol"
    // ... 其他模型映射保持默认或按需填写即可，具体转发由 CC Switch 决定
  }
}
  • ANTHROPIC_BASE_URL 必须指向本地服务端口。
  • ANTHROPIC_AUTH_TOKEN 设为 PROXY_MANAGED（声明由代理管理密钥）。

避坑与总结

  1. 不要在 JSON 里写远端地址：如果你在 JSON 里填了 https://api...，请求就会绕过 CC Switch 直连远端。远端如果不支持 Anthropic 原生协议，就会直接报错。
  2. 避免路径叠加报错：如果在 CC Switch 开启“完整 URL”的情况下强行填入带有 /v1 的地址，底层拼接后会变成 .../v1/v1/chat... 导致 404 错误。
  3. 终身免修改：一旦以上两步配置完成，JSON 配置文件就再也不需要修改了。以后换 Key、换接口地址、换模型，全部在 CC Switch 软件界面操作即可。