CC Switch 使用教程：Claude Code 与 Codex 一键切换 API
截至 2026-10-07，用 CC Switch 给 Claude Code 切换 API 的做法是：在 Claude 页点右上角「+」新建一份自定义配置，ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api，ANTHROPIC_AUTH_TOKEN 填 cr_ 开头的 key，保存后点卡片上的「启用」，CC Switch 会把这两项写进 ~/.claude/settings.json；要换回另一套，点那张卡片的「启用」即可。Codex 在 Codex 页另建一份，Base URL 填 https://api.qcode.cc/openai。本页按 QCode 文档与 CC Switch 官方 README 整理安装、配置、切换与常见问题。
更新于 2026-10-07
配置前先记住四件事
Claude Code 填的地址
ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api，ANTHROPIC_AUTH_TOKEN 填 cr_ 开头的 key；末尾不要带斜杠。
Codex 填的地址
Base URL 填 https://api.qcode.cc/openai，不是 /openai/v1；生成的 config.toml 里要保留 wire_api = "responses"。
切换只需这一下
Claude Code 与 Codex 同一时刻各只有一份配置处于启用态；点另一张卡片的「启用」，CC Switch 就把那一套重新写进配置文件。
最新正式版（截至 2026-10-07）
发布于 2026-09-22；v4.0.0 到 v4.0.3 是 2026-10-04 起发布的预览版，预览版不会自动更新。
CC Switch 到底做了什么
截至 2026-10-07，CC Switch 是一款开源（MIT 许可）的跨平台桌面应用，支持 Windows、macOS 与 Linux，用卡片管理 Claude Code、Codex 等命令行工具的 API 配置，点一下「启用」就换一套。QCode 文档把它定义为「配置档案（profile）切换器」：它自己不是推理端点，只把每份配置写进对应工具的标准配置文件（Claude Code 是 ~/.claude/settings.json，Codex 是 ~/.codex/config.toml），激活时覆盖、切换时换回。所以 Claude Code、Codex 同一时刻各只有一份配置生效，不会两套同时起作用。官方 README 的说法是一键切换、不用再手改 JSON / TOML / YAML 配置文件；它支持的工具清单随版本变化，以官方 README 为准。
CC Switch 最近几版（截至 2026-10-07）
截至 2026-10-07，GitHub Releases 上最新的正式版是 v3.20.4，发布于 2026-09-22（UTC），它的发布说明写明修复了编辑或切走 Codex 配置会清空已保存 API Key 的问题。2026-10-04 的 v4.0.0 到 2026-10-06 的 v4.0.3 都标为预览版：v4.0 发布说明写明重写了配置写入机制，切换时由全量重写改为关键字段替换，并新增聚合模式，可以把多家服务商的模型放进 Claude Code 或 Codex 的同一个模型列表。预览版不会自动更新，应用内更新只跟随正式版。QCode 的 CC Switch 文档是依据 v3.20.3（2026-09-11）的官方文档核实的，界面文案可能随版本不同。
版本与文档时间线
CC Switch v3.20.3 发布；QCode 的 CC Switch 文档就是依据这一版的官方文档核实的。QCode 文档写明，这一版起 Claude 配置编辑器提供「禁用 Artifact 工具」快捷开关。
v3.20.4 发布，修复了编辑或切走 Codex 配置会清空已保存 API Key 的问题；截至 2026-10-07，它仍是 GitHub 上最新的正式版。
v4.0.0 预览版发布，切换时由全量重写改为关键字段替换；到 2026-10-06 已出到 v4.0.3，预览版不会自动更新。
已确认 vs 文档没写或说法不一的
已确认（文档原文逐字可核）
以下都能在 QCode 文档、CC Switch 官方 README、用户手册或 GitHub 发布说明里逐字核到：Claude Code 的配置填 ANTHROPIC_BASE_URL = https://api.qcode.cc/api 与 ANTHROPIC_AUTH_TOKEN = cr_ 开头的 key，启用后写进 ~/.claude/settings.json；Codex 的 Base URL 填 https://api.qcode.cc/openai，CC Switch 生成 ~/.codex/config.toml 与 ~/.codex/auth.json，其中 wire_api = "responses"；Codex 面板里给只支持 Chat Completions 的服务做本地代理转换的开关，接 QCode 不要开；同一时刻只有一份配置处于启用态；Claude 与 Codex 两份配置可以用同一把 key；CC Switch 对每份配置单独存 key；卡片上的连通性检查不校验 key；最新正式版 v3.20.4 发布于 2026-09-22，v4.0.0 到 v4.0.3 是预览版。
文档没写或说法不一的
三件事本页不下结论：① 切换后要不要重启 Claude Code，说法不一。官方 README 写 Claude Code 支持热切换、无需重启；官方用户手册的常见问题却写要关掉重开终端，QCode 文档引用的 issue #3057 也记录了正在跑的会话仍走旧配置。以你手上的版本实测为准，还在走旧地址就重开会话。② 启用时会不会冲掉你手改的 settings.json：QCode 文档记录过若干版本整文件覆盖、丢掉 enabledPlugins 与 hooks 的报告；v4.0 改为只替换关键字段，但目前仍是预览版，v3.20.4 正式版的行为本页没有实测。③ Base URL 末尾的斜杠：QCode 端点要求不带；CC Switch 自己怎么处理尾斜杠，QCode 文档写明官方文档未记载。
用 CC Switch 还是手改配置文件
CC Switch 对手改配置文件
两者改的是同一份文件：CC Switch 把 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 写进 ~/.claude/settings.json，把 base_url 等写进 ~/.codex/config.toml，它自己不是推理端点。经常在几套配置之间来回换，比如大陆网络在 asia.qcode.cc 与 api.qcode.cc 之间换，或在官方登录与 QCode 之间对照，用 CC Switch 省事；只用一套，或在没有桌面环境的服务器上，手改更直接：CC Switch 只有需要图形界面的桌面版，官方 README 给无桌面环境推荐的是社区维护的 CC Switch CLI。
Claude Code 对 Codex
在 CC Switch 里是两个页面、两份配置：Claude 写到 ~/.claude/，Codex 写到 ~/.codex/，互不干扰，终端里分别运行 claude 和 codex 即可。区别在协议与地址：Claude Code 走 Anthropic 协议，填 https://api.qcode.cc/api；Codex 走 OpenAI Responses 协议，填 https://api.qcode.cc/openai。QCode 文档写明 Claude 模型只能走 Anthropic 端点、Codex 必须用 Responses；两份配置可以填同一把 cr_ key。
六步：安装、配置、切换
① 安装：从 CC Switch 的 GitHub Releases 下载安装包。Windows 10 及以上用 .msi 或便携版 .zip；macOS 12 及以上用 .dmg，或 brew install --cask cc-switch；Linux 用 .deb、.rpm 或 .AppImage（官方要求 glibc 2.35+ 与 WebKitGTK 4.1），Arch 用 paru -S cc-switch-bin。② 配 Claude Code：用顶部切换器选到 Claude，点右上角「+」，预设选「自定义」，在配置 JSON 里把 ANTHROPIC_BASE_URL 填成 https://api.qcode.cc/api、ANTHROPIC_AUTH_TOKEN 填你的 cr_ key；名称可自定，文档示例用 QCode.cc。③ 保存后把鼠标移到卡片上，点「启用」，CC Switch 会把这两项写进 ~/.claude/settings.json；在终端运行 claude 验证。④ 配 Codex：切到 Codex，点「+」选「自定义」，Base URL 填 https://api.qcode.cc/openai，API Key 填同一把 cr_ key，默认模型填 gpt-6-sol 或 gpt-5.6-terra；名称可自定，文档示例用小写 qcode（便于作 TOML 键名），生成的 config.toml 里就是 model_provider = "qcode"。面板里那个给只支持 Chat Completions 的服务做本地代理转换的开关不要开。⑤ 保存并点「启用」，运行 codex 验证；config.toml 里应能看到 base_url = "https://api.qcode.cc/openai" 与 wire_api = "responses"。⑥ 以后切换：点另一张卡片的「启用」，或在系统托盘里直接点配置名。先打开 ~/.claude/settings.json（Codex 看 ~/.codex/config.toml）确认地址已变；Codex 要重开终端，Claude Code 若还在走旧地址，也关掉会话重开。为 asia.qcode.cc 另存一份时，名称加 (asia) 之类的后缀，托盘里才分得清。
在 QCode 上
在 QCode 上，Claude Code 与 Codex 两份配置可以填同一把 cr_ key（控制台创建）：key 不区分协议，协议由请求路径决定。Claude Code 那份走 https://api.qcode.cc/api，模型可选 claude-sonnet-5、claude-sonnet-5-5、claude-opus-5，也可以在 Claude Code 里用 /model 切换；Codex 那份走 https://api.qcode.cc/openai，模型可选 gpt-6-sol 或 gpt-5.6-terra。三个接入域业务能力一致，同一把 key 都能用：北美与欧洲可用 us.qcode.cc，中国大陆网络文档推荐 asia.qcode.cc，路径不变，可以在 CC Switch 里为每个域各存一份配置。两份配置共用一把 key，不会因此重复扣费；按 token 计费，各模型单价见 /models；每次请求都能在 probe.qcode.cc 输入 key 查看。
常见问题
CC Switch 切换后 Claude Code 没生效怎么办？
先看文件，再重开会话。打开 ~/.claude/settings.json，确认 ANTHROPIC_BASE_URL 已经变成你刚启用的那一套；文件已变而会话没变，就关掉当前的 claude，新开终端再进。QCode 文档引用的 issue #3057 记录过这种情况：Claude Code 在进程启动时把 settings.json 里的 env 读进环境变量，跑着的会话不会重读。至于切换后是否必须重启，官方说法不一：官方 README 写 Claude Code 支持热切换、无需重启，用户手册 FAQ 写关掉重开终端或重启 IDE；Codex 则两处都写要重开终端。托盘切换写的是同一份文件，不会替你结束正在跑的 claude。
报 401 Unauthorized 怎么查？
多半是某一份配置的 key 没填对。先确认 key 以 cr_ 开头、前后没有空格，再到控制台检查它是否有效。如果 Claude Code 报 401 而 Codex 正常（或反过来），出错的就是那一份配置：CC Switch 对每份配置单独存 key，换 key 时要逐个更新。另外，卡片上的连通性检查只看地址能否连上，官方用户手册写明它不校验 key，检查通过不代表 key 是对的。
Codex 启动后一直转圈怎么办？
先查 ~/.codex/config.toml。base_url 要填到 /openai 为止，不是 /openai/v1；wire_api = "responses" 必须保留。QCode 文档说最常见的漏因是顶层的 model_provider 没写，或与 [model_providers.xxx] 表名不一致，这时 Codex 会回落到内置的 openai 官方端点。改完重开终端，再运行 codex。
Claude Code 和 Codex 能同时用吗？
能。CC Switch 把 Claude 的配置写到 ~/.claude/，Codex 的写到 ~/.codex/，两份互不干扰，终端里分别运行 claude 和 codex 即可。两份可以填同一把 cr_ key：Claude Code 走 https://api.qcode.cc/api，Codex 走 https://api.qcode.cc/openai。QCode 文档写明，这样共用一把 key 不会因为多建一份配置而重复扣费。
我手改过 settings.json，启用另一份配置会丢吗？
可能会，启用前先备份。QCode 文档写明：启用时 CC Switch 会用该配置的字段覆盖 ~/.claude/settings.json 里的对应项，若干版本里还出现过整文件覆盖、丢掉 enabledPlugins 与 hooks 的报告；v4.0 预览版的发布说明写明切换改为只替换关键字段。丢了可以从 ~/.cc-switch/backups/（官方写保留最近 10 个）或你导出的 cc-switch-export-{timestamp}.sql 恢复。另外，首次启动时 CC Switch 会把已有的 Claude Code、Codex 配置导入为一份名为 default 的配置。
怎么切回官方 Anthropic 登录？
在列表里选内置的官方配置（Claude Code 是 Claude Official，Codex 是 OpenAI Official；删掉了就从预设里加回来），点「启用」，重开 CLI，再走工具自己的登录流程：Claude Code 用 /login，Codex 用 codex login。之后就能在官方登录和 QCode 的自定义配置之间来回切。QCode 文档提醒，不要手搓一份「空 env 又留着 cr_ 密钥」的混合配置。
信息来源
配置写法、地址与排错：QCode 文档的 CC Switch 配置页（更新于 2026-09-25，依据 CC Switch v3.20.3 的官方文档核实）与接入点与 API 格式页（更新于 2026-09-25，含哪种协议走哪个端点、三个接入域与尾斜杠规则），均于 2026-10-07 抓取。CC Switch 侧的安装、系统要求、切换生效规则与官方登录：CC Switch GitHub 仓库的 README 与用户手册常见问题页，同日抓取。版本与日期：CC Switch 的 GitHub Releases（v3.20.3、v3.20.4 与 v4.0.0 到 v4.0.3 的发布说明），同日抓取。
相关阅读
Claude Code 自定义端点配置
两个环境变量、settings.json 写法与 apiKeyHelper。
Codex CLI 接第三方 API 配置指南
config.toml 的 model_provider、base_url、env_key 怎么写。
Claude Code 使用指南
从安装配置到日常使用的 Claude Code CLI 教程。
本页步骤与引语核对于 2026-10-07，以 QCode 文档、CC Switch 官方 README 与 GitHub 发布说明等官方页面为准，上游调整不另行通知。CC Switch 的界面文案与切换行为随版本变化，以你手上的版本为准；模型可用性以 /models 为准。