CC Switch 配置中转站
CC Switch 是一个桌面工具,把 Claude Code、Codex 这些命令行客户端的接口地址和密钥存成一个个“供应商”,点一下就切换。下面是把本站加进去的两种办法:手动添加,或者用一条导入链接。
01什么时候用得上
只用一个接口地址的话,照 Claude Code 配置第三方 API 手写两个环境变量就够了。CC Switch 解决的是另一类问题:手上有不止一个地址和密钥,比如订阅登录、本站、公司的网关,想在它们之间来回换,又不想每次去改配置文件。
它把每一组“地址 + 密钥 + 模型”存成一个供应商,切换时只改写客户端配置文件里的这几项。它支持的客户端不止 Claude Code,还有 Codex、Gemini CLI、OpenCode 等十来种,本文讲前两种。
02准备
两样东西:装好的 CC Switch,和一把本站密钥。CC Switch 在 GitHub Releases 下载:Windows 有 MSI 安装包和免安装的 ZIP,macOS 可以用 brew install --cask cc-switch,Linux 有 DEB、RPM 和 AppImage。
密钥在 控制台 创建,以 sk-relay- 开头,充值从 $10 起。还没有密钥,先看 Claude API Key 购买与充值。
03Claude Code:手动添加
- 在 CC Switch 侧栏选中 Claude Code。
- 点页头右侧带 + 号的“添加供应商”。
- 第一步选“自定义配置”(它固定在“全部”分类的最上面)。
- 名称填 RelaySwitch,把下面的 JSON 填进配置编辑框,密钥换成你自己的,点“添加”。
{ "env": { "ANTHROPIC_BASE_URL": "https://api.relayswitch.io", "ANTHROPIC_AUTH_TOKEN": "sk-relay-..." }}ANTHROPIC_AUTH_TOKEN 以 Authorization: Bearer 发送密钥,是本站推荐的写法;一个供应商里只写这一个密钥变量。Claude 模型用原名,模型字段全部留空即可,Claude Code 会用自带的模型列表。
地址这里写的是 https://api.relayswitch.io,没有 /v1。这是 CC Switch 对 Claude Code 供应商的惯例写法:Claude Code 会自己在后面拼 /v1/messages。填成 https://api.relayswitch.io/v1 也能用,本站网关对重复的 /v1 做了兼容,不用为这个纠结。
04切换并确认生效
回到供应商列表,点 RelaySwitch 卡片上的“切换”,按钮变成“使用中”。CC Switch 这时改写的是 ~/.claude/settings.json 里 env 块的地址和密钥,你自己加的权限、插件、MCP 等设置原样保留。
Claude Code 不用重启。在会话里运行 /status,看到 Anthropic base URL 一行是 https://api.relayswitch.io 就对了;发一句话,几秒后控制台的用量页会出现这条请求。常驻后台时,右键系统托盘里的 CC Switch 图标,也能在 Claude Code 子菜单里直接切换。
05导入链接
CC Switch v4.0.10 及以上支持 ccswitch:// 链接:浏览器打开链接,CC Switch 弹出确认框,核对后点“导入”,省掉手动填表。Claude Code 的链接是这样的:
ccswitch://v1/import?resource=provider&app=claude&name=RelaySwitch&endpoint=https%3A%2F%2Fapi.relayswitch.io&apiKey=sk-relay-...用法:复制整条链接,把末尾的 sk-relay-... 换成你的密钥,粘贴到浏览器地址栏回车。确认框里的地址应当是 https://api.relayswitch.io,密钥是打码显示的。导入后默认不会自动切换,回到列表点一下“切换”。
本页不放“一键导入”按钮,原因写在 CC Switch 的 站长接入指南 里:供应商链接必须带密钥,带密钥的链接等于密钥本身,不应该出现在公开页面上。所以这里给的是模板,密钥由你在自己电脑上填。
06Codex
Codex 走 OpenAI Responses 格式,本站的 Base URL 带 /v1。导入链接多两个参数:apiFormat 声明接口格式,model 写默认模型(不写的话 CC Switch 会填一个它自己的默认值):
ccswitch://v1/import?resource=provider&app=codex&name=RelaySwitch&endpoint=https%3A%2F%2Fapi.relayswitch.io%2Fv1&apiKey=sk-relay-...&apiFormat=openai_responses&model=gpt-5.5同样先把密钥换掉再打开。Responses 是 Codex 的原生格式,不用开 CC Switch 的本地路由,也不做格式转换。切换后要重启 Codex:命令行退出后重新运行 codex,桌面版彻底退出再打开。想手写 config.toml,或者换别的 GPT 模型,看 Codex CLI 中转配置。
07可用的 Claude 模型
切换过来之后,/model 里的 opus、sonnet、haiku 对应的就是下表里的 id,按表里的价格从预付余额扣费,没有倍率。价格渲染时读取。
| 模型 | 开发商 | 输入 / 百万 | 输出 / 百万 |
|---|---|---|---|
| Claude Fable 5.1claude-fable-5.1 | Anthropic | $6.00≈ ¥40.82 | $30.00≈ ¥204.12 |
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00≈ ¥27.22 | $20.00≈ ¥136.08 |
| Claude Fable 5claude-fable-5 | Anthropic | $3.00≈ ¥20.41 | $15.00≈ ¥102.06 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716≈ ¥18.48 | $9.70≈ ¥66.00 |
| Claude Sonnet 4.6claude-sonnet-4-6 | Anthropic | $1.80≈ ¥12.25 | $9.00≈ ¥61.24 |
| Claude Opus 4.6claude-opus-4-6 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 |
| Claude Opus 4.7claude-opus-4-7 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 |
| Claude Opus 4.8claude-opus-4-8 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 |
| Claude Opus 5claude-opus-5 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 |
| Claude Haiku 4.5claude-haiku-4-5 | Anthropic | $0.60≈ ¥4.08 | $3.00≈ ¥20.41 |
| Claude Sonnet 5claude-sonnet-5 | Anthropic | $1.20≈ ¥8.16 | $3.00≈ ¥20.41 |
| Claude Sonnet 5.5claude-sonnet-5-5 | Anthropic | $1.20≈ ¥8.16 | $3.00≈ ¥20.41 |
| Claude Haiku 5.5claude-haiku-5-5 | Anthropic | $0.0582≈ ¥0.396 | $0.1455≈ ¥0.99 |
美元 / 百万 tokens,人民币参考价按 ECB 2026-11-11 汇率
08排错
切换后请求没走本站:多半是系统环境变量盖住了配置。CC Switch 顶部出现“检测到系统环境变量冲突”的黄色横幅时,点“查看详情”,把以前在 ~/.zshrc 或 Windows 环境变量里设的 ANTHROPIC_* 删掉,重开终端。
导入链接点了没反应:多半是这台电脑没装 CC Switch,或者版本低于 4.0.10。浏览器没办法判断你装没装,所以不会有任何提示。先把 CC Switch 打开,再粘贴一次链接。
能连上但报错:401 是密钥不对,402 是余额或预算用完,403、429 各有几种原因,按状态码查 Claude Code 报错速查。CC Switch 自身的功能说明以它的 用户手册 为准。
常见问题
- CC Switch 里的请求地址带不带 /v1?
- Claude Code 的供应商填 https://api.relayswitch.io,不带 /v1:Claude Code 自己会在后面拼 /v1/messages。Codex 的供应商填 https://api.relayswitch.io/v1,带 /v1。Claude Code 这边带了也不会错,网关两种写法都接受。
- 切换供应商后要重启吗?
- 按 CC Switch 的用户手册:Claude Code 切换后即时生效,不用重启;Codex 需要退出后重新运行 codex,桌面版要彻底退出再打开。
- 导入链接安全吗?
- 链接里带着完整的密钥,谁拿到链接谁就拿到了密钥,所以只在自己的电脑上用,不要发到群里,也不要贴在公开页面。CC Switch 打开链接后不会直接写入,会先弹出确认框显示地址和打码后的密钥,点“导入”才生效。
- 点了两次链接,出现两个一样的供应商?
- CC Switch 不去重,同一条链接点两次就导入两份。删掉多余的那个即可,不影响使用。
- 之前在终端里 export 过 ANTHROPIC_BASE_URL,会冲突吗?
- 会让人分不清哪个在生效。CC Switch 启动时检测以 ANTHROPIC 开头的系统环境变量,发现后在界面顶部显示冲突警告,可以在那里查看来源并删除。改完在 Claude Code 里运行 /status,看 Anthropic base URL 一行是不是你要的地址。
把本站加进 CC Switch
Claude Code 填 https://api.relayswitch.io,Codex 填 https://api.relayswitch.io/v1,同一把密钥。