配置教程 · 核对于 2026-11-11

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:手动添加

  1. 在 CC Switch 侧栏选中 Claude Code。
  2. 点页头右侧带 + 号的“添加供应商”。
  3. 第一步选“自定义配置”(它固定在“全部”分类的最上面)。
  4. 名称填 RelaySwitch,把下面的 JSON 填进配置编辑框,密钥换成你自己的,点“添加”。
json
1{
2 "env": {
3 "ANTHROPIC_BASE_URL": "https://api.relayswitch.io",
4 "ANTHROPIC_AUTH_TOKEN": "sk-relay-..."
5 }
6}

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 的链接是这样的:

text
1ccswitch://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 会填一个它自己的默认值):

text
1ccswitch://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.1Anthropic$6.00≈ ¥40.82$30.00≈ ¥204.12
Claude Fable 5.2claude-fable-5.2Anthropic$4.00≈ ¥27.22$20.00≈ ¥136.08
Claude Fable 5claude-fable-5Anthropic$3.00≈ ¥20.41$15.00≈ ¥102.06
Claude Opus 5.5claude-opus-5-5Anthropic$2.716≈ ¥18.48$9.70≈ ¥66.00
Claude Sonnet 4.6claude-sonnet-4-6Anthropic$1.80≈ ¥12.25$9.00≈ ¥61.24
Claude Opus 4.6claude-opus-4-6Anthropic$1.80≈ ¥12.25$7.50≈ ¥51.03
Claude Opus 4.7claude-opus-4-7Anthropic$1.80≈ ¥12.25$7.50≈ ¥51.03
Claude Opus 4.8claude-opus-4-8Anthropic$1.80≈ ¥12.25$7.50≈ ¥51.03
Claude Opus 5claude-opus-5Anthropic$1.80≈ ¥12.25$7.50≈ ¥51.03
Claude Haiku 4.5claude-haiku-4-5Anthropic$0.60≈ ¥4.08$3.00≈ ¥20.41
Claude Sonnet 5claude-sonnet-5Anthropic$1.20≈ ¥8.16$3.00≈ ¥20.41
Claude Sonnet 5.5claude-sonnet-5-5Anthropic$1.20≈ ¥8.16$3.00≈ ¥20.41
Claude Haiku 5.5claude-haiku-5-5Anthropic$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,同一把密钥。