CC 反代接入教程：让 Claude Code 与 Codex 走同一中转

一、这是什么

CC 反代（常见如 cc-switch、claude-code-proxy）是一类本地/自建转发代理：对外提供统一入口（Anthropic / OpenAI 兼容），再把请求转发到你的上游。这样本地的 Claude Code（Anthropic）和 Codex（OpenAI）都接同一个反代，统一流到本站网关，用一份 sk- 密钥与额度。

当你本地的 Claude Code（Anthropic）与 Codex（OpenAI）需要统一走本站网关时，反代可以把请求下发到统一入口，用一份密钥与额度。

二、准备工作

1. 登录极智API控制台，创建 sk-… API Key（只显示一次，请保存）。
2. 确认要用的模型 slug（Claude 与 GPT 各一个或按需）。
3. 确认网关地址：https://www.relay-api.com。

三、配置 CC 反代

① 安装并启动

npm install -g cc-switch   # 或 claude-code-proxy / 对应反代工具
cc-switch start            # 默认本地端口 127.0.0.1:8787

② 把反代「上游」指向本站网关（核心两项：上游地址 + 密钥）。以 cc-switch 配置为例：

# cc-switch 配置示例
anthropic_upstream = "https://www.relay-api.com"
openai_upstream    = "https://www.relay-api.com/v1"
api_key            = "sk-你的密钥"

③ 分别接入 Claude Code 与 Codex（指向反代的本地端口）：

export ANTHROPIC_BASE_URL="http://127.0.0.1:8787"
export ANTHROPIC_API_KEY="sk-你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

export OPENAI_BASE_URL="http://127.0.0.1:8787"
export OPENAI_API_KEY="sk-你的密钥"
codex --model gpt-5.5

四、上游端点对照

用途	上游 Base URL
Claude Code（Claude）	https://www.relay-api.com
Codex（GPT）	https://www.relay-api.com/v1

五、常见问题

现象	处理
401 / 403	密钥无效或余额不足；确认 sk- 正确并充值。
404 / 模型无效	确认上游地址用的是本站入口；模型需已启用。

安全建议：平台 sk- 别写进公开仓库；建议给反代单独建一个 Key，便于统计与限额。

Base URL 说明：本站同时接受 /v1beta/models/... 与 /v1beta/v1beta/models/...（以及 /v1/... 与 /v1/v1/...），所以客户端是否自己补 /v1、/v1beta 都不影响调用：Base URL 填域名根或填带 /v1beta 的地址都能用。模型 ID 请在控制台「令牌」页右上角「模型 ID」里查询复制。