不用官方 Key 也能跑 Claude Code？CC Switch 中转配置实操（2026）
TL;DR — CC Switch 把 Claude Code、Codex、Gemini CLI 这几个工具的供应商配置统一收口到一个 GUI 里，添加一次中转站（比如 ofox.ai），下次想从官方 Key 切到中转 Key 只要点一下。装它的核心理由是：你同时在用多个 AI CLI，或者需要在官方 / 中转之间频繁切换，省掉每次手改环境变量的折腾。下面按”装—加 Provider—切—验证”走一遍完整流程。
为什么国内用 Claude Code 几乎必须配中转
Anthropic 的 API 端点 api.anthropic.com 在国内属于不可访问列表，Claude Code 启动会直接卡在认证那一步。这是从 Claude Code 国内使用实录 那篇就说过的老问题，到今天没变。
解法只有两类：科学上网 + 官方账号付款，或者把 ANTHROPIC_BASE_URL 改到国内可访问的中转站。前者门槛在付款（官方现在禁了不少国家的银行卡），后者门槛在配置，你得知道在哪里改、改成什么。
如果只用一个工具，手动 export 两个环境变量就完事：
export ANTHROPIC_BASE_URL=https://api.ofox.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-xxx但只要你还同时碰 Codex（OpenAI 协议）、Gemini CLI（Google 协议）、OpenClaw（自有 schema），每个工具的环境变量名都不一样，写在不同的配置文件里，临时切官方 Key 还要回去注释掉中转。CC Switch 就是为这个痛点造的。
CC Switch 是什么
GitHub 上叫 farion1231/cc-switch，截至 2026-05-16 发到 v3.15.0，star 数 80k+。定位就一句话：给几个 AI CLI 做一个统一的 Provider 切换器。
核心做的事就两件：
- 存供应商配置。每个 Provider 是一个 record，含 name、base_url、auth_token、默认 model，还有它该写到哪个工具的哪个配置位置（Claude Code 是 env vars，Codex 是
~/.codex/config.toml，Gemini CLI 是~/.gemini/settings.json）。 - 激活一个 Provider。点 “Enable” 之后，CC Switch 把这个 Provider 的字段填到对应工具的配置位置，覆盖原来的值。
配置全部存本地：
~/.cc-switch/
├── cc-switch.db # SQLite，存所有 Provider
├── settings.json # CC Switch 自己的偏好
├── backups/ # 每次覆盖前的备份
└── skills/ # 扩展插件目录不上传远程，不做账号同步。
安装
macOS：
brew install --cask cc-switch或者从 GitHub Releases 下 .dmg 拖到 Applications。
Windows：从 Releases 下 .msi 双击装，或者 Portable.zip 解压即用。
Linux：
# Arch / Manjaro
paru -S cc-switch-bin
# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb
# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm其他发行版下 .AppImage，chmod +x 之后直接跑。
装完第一次启动，应用会扫描本机已有的 CLI 配置（~/.claude、~/.codex、~/.gemini 这些），如果检测到环境变量或配置文件，会问你要不要把这些导入成 “默认” Provider。建议勾上导入，以后想切回原来的官方账号一键就够。
添加一个中转 Provider：以 ofox.ai 为例
主界面点 “添加供应商”，弹出来一个表单。这里以 ofox.ai 的 Anthropic 协议中转为例，因为 Claude Code 对 Anthropic 协议是原生支持，不用任何额外适配层。
| 字段 | 值 |
|---|---|
| 名称 | ofox-anthropic |
| 适用工具 | Claude Code |
| API 协议 | Anthropic |
| Base URL | https://api.ofox.ai/anthropic |
| Auth Token | 你的 ofox API Key（sk- 开头） |
| 默认 model | anthropic/claude-sonnet-4.6（可选） |
API Key 从 app.ofox.ai 控制台 → API Keys 创建一个，复制下来粘进去。
默认 model 这一栏建议填一个，对应你日常常用的。Sonnet 4.6 性价比最高，写代码、改 bug 这类日常活够用；Opus 4.7 留给复杂重构和多文件改动，token 贵几倍但深度强。Claude Code 内部还能用 /model 命令在 session 里临时切。当前 ofox 上架可调用的 Claude 系列型号是：
anthropic/claude-opus-4.7anthropic/claude-opus-4.6anthropic/claude-sonnet-4.6anthropic/claude-haiku-4.5
要写得更细的版本差异和场景选择，可以看 Claude Opus 4.7 完全指南 和 Opus 4.6 vs Sonnet 4.6 选型。
保存之后这条 Provider 会出现在主界面列表里，状态是 “未启用”。
一键切换：Claude Code、Codex、Gemini CLI
回到主界面，找到刚才加的 ofox-anthropic，点 “Enable”。
CC Switch 做的事情等价于：
- 备份当前
~/.claude/settings.json到~/.cc-switch/backups/ - 把这个 Provider 的字段写到
~/.claude/settings.json的env段（ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN/ 可选的ANTHROPIC_MODEL） - 下次 Claude Code 启动时直接读取新值
Claude Code 每次启动会读 settings.json，所以重启一下 claude 进程就生效，不需要重新登录或重装。
如果同一个 Provider 想给多个工具用，在表单里勾上 “适用工具” 多选 Codex / Gemini CLI 就行。CC Switch 会把对应字段写到每个工具的原生配置位置：
| 工具 | 配置位置 | CC Switch 写入的字段 |
|---|---|---|
| Claude Code | env vars | ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL |
| Codex | ~/.codex/config.toml | [providers.xxx] 段，含 base_url、api_key |
| Gemini CLI | ~/.gemini/settings.json | selectedAuthType、apiKey、baseUrl |
| OpenClaw | OpenClaw 自有 schema | provider 配置 + 默认 model |
Codex 和 Gemini CLI 换完之后要重启终端窗口（或者新开一个 tab），因为它们启动时把 env 一次性缓存到进程，不会监听变化。这是 CC Switch GitHub README 里专门提的一个坑：很多人切完发现没生效，就是没重启 CLI。
验证：跑一次确认走的是中转
cd ~/your-project
claude设置了 ANTHROPIC_AUTH_TOKEN 之后 Claude Code 不会再走 OAuth 登录，直接进交互界面。输入：
/status/status 会列出当前认证方式、模型、Base URL 等。重点是 Base URL 那一行——如果显示的是 https://api.ofox.ai/anthropic（或你填的中转地址），不是 api.anthropic.com，就说明 CC Switch 切换成功了。然后随便发一句 写一个 hello world Python 脚本 看模型响应，能稳定吐字就完工。
如果 /status 还显示官方 base_url：要么是 CC Switch 没成功覆盖（看 ~/.claude/settings.json 里的 env 字段），要么是你 shell 里手动 export 过同名变量优先级更高，需要 unset ANTHROPIC_BASE_URL 再启动 Claude Code。
用 CC Switch 还是直接改环境变量
如果你只用 Claude Code 一个工具，又只用一个 Provider，那 CC Switch 是过度工程。往 ~/.zshrc 写两行 export 完事，不用装一个 80MB 的 Electron 应用。
CC Switch 真正有意义的场景是：
- 同时用 2-3 个 AI CLI：Claude Code 写代码、Codex 跑长任务、Gemini CLI 处理多模态。三个工具配三套环境变量很乱，统一管能省心。
- 频繁在官方 / 中转之间切：比如出差有 VPN 就用官方账号、回国就走中转，每天切两次手动改 env 烦。
- 管理多个中转站做对比：想同时挂 ofox、OpenRouter、硅基流动比延迟和价格，CC Switch 一键切，省得每次重写 base_url。多个中转站怎么选，AI API 中转站对比评测 有横评。
- 团队里有人不熟命令行：GUI 比让设计师同事改
.bashrc现实。
如果上面四条都不沾，省下来装 CC Switch 的时间直接 export 两行。
几个真容易踩的坑
Provider 添加后还是连不上。先确认 Auth Token 没拷错。ofox 的 Key 是 sk- 开头一长串，复制时别带前后空格。再 curl 单独测一下：
curl https://api.ofox.ai/anthropic/v1/messages \
-H "x-api-key: $YOUR_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"anthropic/claude-sonnet-4.6","max_tokens":50,"messages":[{"role":"user","content":"hi"}]}'返回正常 200 + JSON 说明 base_url 和 Key 都对，问题在 CC Switch 这边，重启一次或重新 Enable Provider 一般就好。
切换之后 Codex 还在用老 Provider。Codex 不像 Claude Code 那样动态读取，必须关掉当前终端窗口重新开。如果 tmux / screen 里跑，注意是 detach session 后重新 attach 也不够，得 kill 进程重启。
ANTHROPIC_MODEL 写了一个 ofox 没上架的型号。比如随手写了 claude-3-5-sonnet-20241022（这是 Anthropic 官方 ID），ofox 这边没这个 mapping，请求会 404。要么删掉这个字段让 Claude Code 用默认 model，要么写成 ofox 列表里的精确 ID（带 anthropic/ 前缀）。具体能用哪些查 curl https://api.ofox.ai/v1/models | jq '.data[].id'。
Linux 上托盘图标不显示。这是 Electron 在 GNOME 上的老问题，装一下 gnome-shell-extension-appindicator 就好。
接下来
CC Switch 解决的是配置切换的工程问题，不解决 “我应该用哪个 Provider” 的问题。如果你还在选中转站，Ofox vs 硅基流动深度对比 那篇有横评数据；如果你刚开始研究 AI CLI 这条技术路线，Vibe Coding 工具横评 里把 Claude Code、Cursor、Windsurf、Roo Code 几个工具的定位拆得比较清楚，可以先看看自己适合从哪个入手。
配好 CC Switch + ofox 之后，Claude Code 的体验和海外直连官方 API 几乎一样：首 token 延迟 800ms-1.5s，长输出 streaming 稳定，所有 tool use / Extended Thinking 功能完整。最大的好处是付款方式：ofox 支持支付宝和微信，Claude API 付费指南 里有完整流程。
