--- title: "CC Switch 配置中转站：Claude Code、Codex 的导入链接与手动步骤" canonical: https://relayswitch.ai/zh/guides/cc-switch generated: 2026-11-12T04:32:49.304Z source: https://api.relayswitch.io/v1/catalog base_url: https://api.relayswitch.io/v1 --- 配置教程 · 核对于 2026-11-11 # CC Switch 配置中转站 CC Switch 是一个桌面工具，把 Claude Code、Codex 这些命令行客户端的接口地址和密钥存成一个个“供应商”，点一下就切换。下面是把本站加进去的两种办法：手动添加，或者用一条导入链接。 ## 01什么时候用得上 只用一个接口地址的话，照 [Claude Code 配置第三方 API](https://relayswitch.ai/zh/guides/claude-code) 手写两个环境变量就够了。CC Switch 解决的是另一类问题：手上有不止一个地址和密钥，比如订阅登录、本站、公司的网关，想在它们之间来回换，又不想每次去改配置文件。 它把每一组“地址 + 密钥 + 模型”存成一个供应商，切换时只改写客户端配置文件里的这几项。它支持的客户端不止 Claude Code，还有 Codex、Gemini CLI、OpenCode 等十来种，本文讲前两种。 ## 02准备 两样东西：装好的 CC Switch，和一把本站密钥。CC Switch 在 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载：Windows 有 MSI 安装包和免安装的 ZIP，macOS 可以用 `brew install --cask cc-switch`，Linux 有 DEB、RPM 和 AppImage。 密钥在 [控制台](https://app.relayswitch.io/console?lang=zh) 创建，以 `sk-relay-` 开头，充值从 $10 起。还没有密钥，先看 [Claude API Key 购买与充值](https://relayswitch.ai/zh/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 1`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 的 [站长接入指南](https://github.com/farion1231/cc-switch/blob/main/docs/guides/deeplink-site-integration-guide-zh.md) 里：供应商链接必须带密钥，带密钥的链接等于密钥本身，不应该出现在公开页面上。所以这里给的是模板，密钥由你在自己电脑上填。 ## 06Codex Codex 走 OpenAI Responses 格式，本站的 Base URL 带 `/v1`。导入链接多两个参数：`apiFormat` 声明接口格式，`model` 写默认模型（不写的话 CC Switch 会填一个它自己的默认值）： text 1`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 中转配置](https://relayswitch.ai/zh/guides/codex-cli)。 ## 07可用的 Claude 模型 切换过来之后，`/model` 里的 opus、sonnet、haiku 对应的就是下表里的 id，按表里的价格从预付余额扣费，没有倍率。价格渲染时读取。 | 模型 | 开发商 | 输入 / 百万 | 输出 / 百万 | | --- | --- | --- | --- | | [Claude Fable 5.1](https://relayswitch.ai/zh/models/claude-fable-5.1)claude-fable-5.1 | Anthropic | $6.00≈ ¥40.82 | $30.00≈ ¥204.12 | | [Claude Fable 5.2](https://relayswitch.ai/zh/models/claude-fable-5.2)claude-fable-5.2 | Anthropic | $4.00≈ ¥27.22 | $20.00≈ ¥136.08 | | [Claude Fable 5](https://relayswitch.ai/zh/models/claude-fable-5)claude-fable-5 | Anthropic | $3.00≈ ¥20.41 | $15.00≈ ¥102.06 | | [Claude Opus 5.5](https://relayswitch.ai/zh/models/claude-opus-5-5)claude-opus-5-5 | Anthropic | $2.716≈ ¥18.48 | $9.70≈ ¥66.00 | | [Claude Sonnet 4.6](https://relayswitch.ai/zh/models/claude-sonnet-4-6)claude-sonnet-4-6 | Anthropic | $1.80≈ ¥12.25 | $9.00≈ ¥61.24 | | [Claude Opus 4.6](https://relayswitch.ai/zh/models/claude-opus-4-6)claude-opus-4-6 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Opus 4.7](https://relayswitch.ai/zh/models/claude-opus-4-7)claude-opus-4-7 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Opus 4.8](https://relayswitch.ai/zh/models/claude-opus-4-8)claude-opus-4-8 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Opus 5](https://relayswitch.ai/zh/models/claude-opus-5)claude-opus-5 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Haiku 4.5](https://relayswitch.ai/zh/models/claude-haiku-4-5)claude-haiku-4-5 | Anthropic | $0.60≈ ¥4.08 | $3.00≈ ¥20.41 | | [Claude Sonnet 5](https://relayswitch.ai/zh/models/claude-sonnet-5)claude-sonnet-5 | Anthropic | $1.20≈ ¥8.16 | $3.00≈ ¥20.41 | | [Claude Sonnet 5.5](https://relayswitch.ai/zh/models/claude-sonnet-5-5)claude-sonnet-5-5 | Anthropic | $1.20≈ ¥8.16 | $3.00≈ ¥20.41 | | [Claude Haiku 5.5](https://relayswitch.ai/zh/models/claude-haiku-5-5)claude-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 报错速查](https://relayswitch.ai/zh/fix/claude-code-api-error)。CC Switch 自身的功能说明以它的 [用户手册](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md) 为准。 ## 常见问题 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 一行是不是你要的地址。 相关页面 - [Claude Code 中转站](https://relayswitch.ai/zh/claude-code) - [国内怎么用 Claude Code](https://relayswitch.ai/zh/guides/claude-code-china) - [Claude Code 配置第三方 API](https://relayswitch.ai/zh/guides/claude-code) - [Claude API 中转站](https://relayswitch.ai/zh/claude-api) - [Claude API Key 购买与充值](https://relayswitch.ai/zh/claude-api-key) - [Claude Code 报错速查](https://relayswitch.ai/zh/fix/claude-code-api-error) - [Claude Code 报错 403](https://relayswitch.ai/zh/fix/claude-code-403) - [Claude Code 封号](https://relayswitch.ai/zh/claude-code-fenghao) - [API 中转站怎么选](https://relayswitch.ai/zh/zhongzhuanzhan-tuijian) - [Codex CLI 中转配置](https://relayswitch.ai/zh/guides/codex-cli) - [全部配置教程](https://relayswitch.ai/zh/guides) ## 把本站加进 CC Switch Claude Code 填 https://api.relayswitch.io，Codex 填 https://api.relayswitch.io/v1，同一把密钥。 [Claude Code 中转站](https://relayswitch.ai/zh/claude-code)[获取密钥](https://app.relayswitch.io/console?lang=zh)