教程CC Switch

用 CC Switch 管理中转站配置：给 Claude Code 和 Codex 添加、切换和恢复

按 CC Switch 的官方说明整理：它是开源的桌面应用，用图形界面把中转站的地址和 key 写进 Claude Code、Codex 的配置文件，一键切换。讲清怎么安装、添加供应商时各项怎么填、切换后是否要重启、怎么换回官方登录，以及它会改动哪些文件。

发布 · 约 6 分钟读完 · 经人工审核（）· 本站的内容怎么来的

本文根据公开分享整理，本站尚未实测。操作前请对照文末的原始来源。

本页目录（11 节）
  1. 安装
  2. 开始之前
  3. 给 Claude Code 添加中转站
  4. 给 Codex 添加中转站
  5. 切换之后要不要重启
  6. 验证
  7. 换回官方登录
  8. 几个常见的疑问
  9. 路由、聚合和授权中心：先别急着用
  10. 安全上的两件事
  11. 接上之后

手动接入中转站要改配置文件：Claude Code 改 settings.json，Codex 改 config.toml，格式还不一样。CC Switch 是一个开源的桌面应用，把这件事做成了图形界面：填一次地址和 key，点一下就切换。

先说清楚它是什么、不是什么：

  • 它做的事和手动配置相同：把接口地址和 key 写进你电脑上各个工具自己的配置文件。它不是中转站，不提供模型。
  • 它是第三方的开源项目，不是 Anthropic 或 OpenAI 的产品。项目说明里写着唯一的官方网站是 ccswitch.io，代码在 GitHub 的 farion1231/cc-switch。只从这两处下载。
  • 只接一个中转站、以后也不换的话，不一定需要它。 手动配置见Claude Code 接入中转站和Codex 接入中转站。它的好处在有两个以上的配置要来回切换时才明显。

安装

系统 要求 安装方式
Windows Windows 10 及以上 从 GitHub 的 Releases 页面下载 .msi 安装包，或者 Portable 绿色版
macOS macOS 12 及以上 brew install --cask cc-switch，或者从 Releases 下载 .dmg
Linux x86_64 或 ARM64，glibc 2.35 以上（如 Ubuntu 22.04、Debian 12） 从 Releases 下载 .deb、.rpm 或 .AppImage

Mac 上用 Homebrew 装的，以后用 brew upgrade --cask cc-switch 更新。

开始之前

清掉之前手动设的环境变量。 如果你以前在 shell 里设过 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 这类变量，先删掉并重开终端。否则会有两套配置同时存在，Claude Code 启动时会提示认证冲突。

知道它会改哪些文件。 启用一个供应商时，CC Switch 会改写：

工具 文件
Claude Code ~/.claude/settings.json
Codex ~/.codex/config.toml、~/.codex/auth.json

它的说明里对改动范围有明确的承诺：

  • 只替换关键字段：请求地址、key、模型名和接口协议。你的插件、hooks、权限、MCP、自己加的环境变量和注释都原样保留。
  • 第一次改写每个配置文件之前，会把原文件备份到 ~/.cc-switch/backups/live-first-write/。

给 Claude Code 添加中转站

  1. 在侧栏选中 Claude Code，点页面右上角的“+”。

  2. 可以从预设里选（它内置了九十多个供应商预设，包括一些中转服务），也可以选自定义配置。预设里没有你的中转站时用自定义。

  3. 按下表填写：

    字段 填什么
    供应商名称 自己认得出就行
    API Key 中转站控制台创建的 key
    请求地址（Base URL） 中转站给 Claude Code 用的地址。一般末尾不带 /v1，也不带 /
    上游格式（高级选项） Anthropic Messages（原生）

  4. 保存，在供应商卡片上点“启用”。

启用之后，~/.claude/settings.json 里会有这样一段：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的中转站地址",
    "ANTHROPIC_AUTH_TOKEN": "你的key"
  }
}

这和手动配置写的是同一个地方。注意它把 key 放在 ANTHROPIC_AUTH_TOKEN 里，也就是用 Bearer 的方式发送；你的中转站如果只认 x-api-key，要按它的文档调整。

界面上各项的名称和位置会随版本变化，以你装的版本为准。

给 Codex 添加中转站

在侧栏切到 Codex，同样点“+”：

字段 填什么
供应商名称 建议用小写英文，它会成为配置文件里供应商的 id
API Key 中转站控制台创建的 key
Base URL 中转站给 Codex 用的地址，带不带 /v1 以它的文档为准
模型 Codex 认识的模型名，例如 gpt-6.1-sol
上游格式 Responses（原生）

保存并启用后，key 写进 ~/.codex/auth.json，~/.codex/config.toml 里会出现类似这样的内容，可以在 CC Switch 的编辑框里核对：

model_provider = "myrelay"
model = "gpt-6.1-sol"

[model_providers.myrelay]
name = "myrelay"
base_url = "https://你的中转站地址"
wire_api = "responses"
requires_openai_auth = true

Codex 只能用 OpenAI 系的模型，并且中转站要支持 Responses 接口，原因见Codex 接入中转站。

切换之后要不要重启

工具 生效方式
Claude Code 支持热切换，不用重启
Codex 要重启终端或重新启动 Codex
Claude Desktop 要完全退出再打开

切换的入口有两个：主界面里选中供应商点“启用”，或者在系统托盘的菜单里直接点供应商的名字。

酷站AI 的文档提醒：已经开着的 Claude Code 或 Codex 可能还在用旧的配置，切换后以新开的终端为准。

验证

供应商卡片上的“检测连通”不能代替验证。 CC Switch 自己的说明写得很清楚：它只检查地址能不能连上，不会发真实的模型请求，所以验证不了 key 和模型名对不对。

真正的验证是打开一个新终端，让工具回一句话（命令的写法取自酷站AI 的文档）：

claude -p "只回复 OK"
codex exec --skip-git-repo-check "只回复 OK"

在 Claude Code 里还可以输入 /status，看 Anthropic base URL 一行是不是你的中转站地址。

换回官方登录

供应商列表里自带官方的那一项：Claude Code 是 Claude Official，Codex 是 OpenAI Official。切换到它，然后按工具自己的方式登录（Claude Code 用 /login，Codex 用 codex login）。之后就可以在官方和中转站之间来回切换。

官方的那一项被删掉了的话，可以从预设里重新添加。

另外，同一时间只启用一个供应商的工具，总会保留一个正在使用的配置，所以正在用的那个删不掉。想删它，先切到别的。

几个常见的疑问

在工具里换了模型，切走再切回来又变回去了。 模型属于供应商的关键字段。你在 Claude Code 里用 /model 换的模型会生效到下次切换；切换时，配置文件里的模型会换成目标供应商保存的那个。想长期用某个模型，在 CC Switch 里编辑这个供应商。

配置文件里的地址变成了 127.0.0.1。 那是打开了“路由”模式：工具的请求先发到 CC Switch 在本机的转发服务，再转给供应商，配置文件里只留本机地址和一个占位的 key。普通的接入用“直连”就够，不需要开路由。

Claude Code 返回 404。 多半是请求地址末尾多了 /v1 或 /。

提示缺少 key。 key 没有写进配置。Codex 要确认 requires_openai_auth = true 还在。

在 Windows 上想管 WSL 里的工具。 CC Switch 不会自动识别 WSL，要在“设置 → 应用配置”里把对应工具的配置目录改成 WSL 里的路径，例如 \\wsl.localhost\Ubuntu\home\<用户名>\.claude。

路由、聚合和授权中心：先别急着用

CC Switch 还有几个进阶功能，这里只说它们是什么，以及用之前要想清楚的事。

功能 做什么 要注意
路由 请求经本机转发，可以转换接口格式，比如让 Claude Code 用 OpenAI 格式的供应商 Anthropic 的官方文档写明，不支持通过网关让 Claude Code 使用非 Claude 的模型。出了问题没有官方支持
聚合 把多家供应商的模型放进同一个模型列表 Codex 进入或退出聚合后要彻底重启才能看到新列表
授权中心（测试版） 登录多个订阅账号，把订阅当作供应商用在别的工具里 CC Switch 自己的说明里写着：在官方客户端以外使用订阅可能违反厂商的服务条款，要自己评估风险

安全上的两件事

  • 含 key 的链接不要外传。 CC Switch 支持用 ccswitch:// 链接一键导入供应商，这类链接里带着 API key。含 key 的链接、配置文件和截图都不要发到群聊和公开的地方。
  • 云同步会把配置带到别处。 它支持通过 WebDAV 或 S3 兼容的存储同步，打开之前想清楚你的 key 会存到哪里。

接上之后

用图形界面填进去的中转站，和手动配置的没有区别：能回答不等于给你的是它声称的模型。用同一把 key 到 Veridrop 检测一次；还没选好站的，看中转站排行榜。

来源

通过 API 中转站使用这些模型？到 Veridrop 免费检测中转站给你的是不是它声称的模型，或者看看中转站排行榜前 100 名。

相关文章

  • 从 Claude Code、Codex 过来：DeepSeek Harness 认哪些现成的配置教程 · DeepSeek Harness · 约 10 分钟

    按 DeepSeek Harness 官方文档整理：项目里的 AGENTS.md 和 CLAUDE.md 默认就读；技能要放在 .agents/skills；Claude Code、Codex 的钩子有实验性桥接，只支持部分事件；模组兼容层只是演示；还能把 Claude Code、Codex 当子智能体调用。

  • Claude 桌面应用接入中转站：在第三方推理设置里填网关地址和 key教程 · Claude Code · 约 6 分钟

    按 Claude 官方文档整理：桌面应用不读环境变量和 settings.json，要打开开发者模式，在 Configure Third-Party Inference 里选 Gateway 并填中转站的地址和 key。讲清中转站要满足什么条件、认证方式怎么选、模型列表为什么是空的，以及接入后哪些功能不可用。

  • Claude Code 接入中转站：两个环境变量、settings.json 的写法和常见报错教程 · Claude Code · 约 8 分钟

    按 Claude Code 官方的网关文档整理：接入中转站只需要接口地址和 API key 两样，先在终端里临时设置并验证，再写进 settings.json。讲清凭据该放哪个变量、VS Code 扩展和桌面应用怎么单独设置，以及 401、404、认证冲突等报错怎么查。

  • Codex 接入中转站：config.toml 里自定义供应商的写法、验证和常见问题教程 · Codex · 约 6 分钟

    按 Codex 官方的网关文档整理：在 config.toml 里加一个自定义供应商，把 key 放进环境变量，就能让 Codex 走中转站。讲清中转站必须支持 Responses API、配置文件里顶层项的位置、怎么验证，以及供应商不生效、认证失败、流式卡住等问题怎么查。