CC Switch 使用教程:Claude Code 与 Codex 一键切换 API
截至 2026-10-13,用 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。4.0 这一线已经出了正式版,截至 2026-10-13 最新的正式版是 2026-10-13 发布的 v4.0.11(前一版 v4.0.10 发布于 2026-10-12),4.0 新增了聚合模式,v4.0.10 的重点是 ccswitch:// 一键导入链接,v4.0.11 加了从「应用」页卸载已装工具的功能,见下文。本页按 QCode 文档与 CC Switch 官方 README 整理安装、配置、切换与常见问题。
更新于 2026-10-14
把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费,实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
配置前先记住四件事
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-13)
2026-10-13 发布(UTC);v4.0.4(2026-10-07)起 4.0 转为正式版,此前的 v4.0.0(2026-10-04)到 v4.0.3(2026-10-06)在 GitHub 上标为预览版。
CC Switch 到底做了什么
截至 2026-10-13,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-13)
截至 2026-10-13,GitHub Releases 上最新的正式版是 v4.0.11,发布于 2026-10-13(UTC)。它的发布说明写明,这一版加了卸载功能,可以从「应用」页卸载已安装的工具,且只卸载能确认来源的安装,配置和会话数据都保留;上一版 v4.0.10(发布于 2026-10-12)的重点是一键导入链接(ccswitch:// 深度链接):CC Switch 没在运行时点链接不会再丢,链接可以声明接口格式,确认框里也能选导入后是否立即切换;同时发布了中、英、日三语的站长接入指南和在线链接生成器。4.0 的起点 v4.0.0 发布于 2026-10-04,v4.0.1 与 v4.0.2 发布于 2026-10-05、v4.0.3 发布于 2026-10-06,这四版在 GitHub 上都标为预览版;2026-10-07 的 v4.0.4 是正式版,v4.0.10 与 v4.0.11 同样是正式版。v4.0 的发布说明写明新增聚合模式,可以把多家服务商的模型放进 Claude Code 或 Codex 的同一个模型列表,在客户端里随手切换;聚合需要手动开启,目前支持 Claude Code 和 Codex,按你选的模型分发请求,不提供故障转移。配置写入机制也重写了,切换时由全量重写改为关键字段替换,其他内容原样保留。更早的 v3.20.4 发布于 2026-09-22,修复了编辑或切走 Codex 配置会清空已保存 API Key 的问题。QCode 的 CC Switch 文档更新于 2026-10-08,页内写明依据 CC Switch v3.20.3(2026-09-11)的官方文档核实、最后核实 2026-09-18,界面文案可能随版本不同。
版本与文档时间线
CC Switch v3.20.3 发布;QCode 的 CC Switch 文档就是依据这一版的官方文档核实的。QCode 文档写明,这一版起 Claude 配置编辑器提供「禁用 Artifact 工具」快捷开关。
v3.20.4 发布,修复了编辑或切走 Codex 配置会清空已保存 API Key 的问题;在 2026-10-07 的 v4.0.4 把 4.0 转为正式版之前,它是 GitHub 上最新的正式版。
v4.0.0 预览版发布,新增聚合模式,切换时由全量重写改为关键字段替换;2026-10-07 的 v4.0.4 起 4.0 转为正式版,到 2026-10-13 已出 v4.0.11:此前的 v4.0.10(2026-10-12)重点是一键导入链接(ccswitch://),v4.0.11 加了卸载已装工具的功能。
已确认 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;截至 2026-10-13,GitHub 上最新的正式版是 2026-10-13 发布的 v4.0.11(前一版 v4.0.10 发布于 2026-10-12),v4.0.0 到 v4.0.3 标为预览版,v4.0.4(2026-10-07)起是正式版;v4.0 的发布说明写明聚合模式需要手动开启、可以把多家服务商的模型放进同一个模型列表,v4.0.10 的发布说明写明应用没在运行时点 ccswitch:// 链接也不会丢。
文档没写或说法不一的
三件事本页不下结论:① 切换后要不要重启 Claude Code,两份官方说法并不完全一样。官方 README 写 Claude Code 支持热切换、无需重启;官方用户手册的常见问题写一般不用重启,只说没生效时关掉重开终端,或者重启 IDE;QCode 文档引用的 issue #3057 也记录了正在跑的会话仍走旧配置。以你手上的版本实测为准,还在走旧地址就重开会话。② 启用时会不会冲掉你手改的 settings.json:QCode 文档记录过若干版本整文件覆盖、丢掉 enabledPlugins 与 hooks 的报告,也建议启用前先备份;v4.0 的发布说明与官方用户手册的常见问题都写切换只替换地址、凭据、模型、协议这几项,插件、hooks、权限、MCP 和你自己加的环境变量连同注释、格式原样保留,4.0 也自 v4.0.4(2026-10-07)起转为正式版,但本页没有实测这一版的实际行为。③ 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) 之类的后缀,托盘里才分得清。4.0 之后还有两处新做法。一是聚合模式:v4.0 起需要手动开启,官方 README 写明 Claude Code 要 2.1.243 及以上,聚合不提供故障转移;把几家服务商添加进来后,它们的模型会同时出现在 Claude Code 或 Codex 的模型选择器里,选哪个模型请求就发给哪一家。用法另见本站「CC Switch 4.0 聚合模式」一页。二是一键导入链接:从服务商网站上的 ccswitch:// 链接直接添加配置,v4.0.10(2026-10-12)起,CC Switch 没在运行时点链接也不会丢,确认框里还能选导入后是否立即切换。
在 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。若你开了聚合模式,还要多看一层:官方 README 与用户手册都写明聚合模型的改动在 Claude Code 里即时生效,而 Codex 进出聚合或改动聚合模型列表都需要完全重启。聚合模式见本站「CC Switch 4.0 聚合模式」一页。
报 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 的发布说明与官方用户手册的 FAQ 都写切换只替换地址、凭据、模型、协议这几项,插件、hooks、权限、MCP 和你自己加的环境变量连同注释和格式原样保留,4.0 自 v4.0.4(2026-10-07)起是正式版。丢了可以从 ~/.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-10-08,页内写明依据 CC Switch v3.20.3(2026-09-11)的官方文档核实、最后核实 2026-09-18)与接入点与 API 格式页(讲清哪种协议走哪个端点、三个接入域与尾斜杠规则),均于 2026-10-13 抓取。CC Switch 侧的安装、系统要求、切换生效规则、连通性检查与官方登录:CC Switch GitHub 仓库的 README(MIT 许可)与官方用户手册的常见问题页,同日抓取。版本与日期:CC Switch 的 GitHub Releases API 与发布说明(v3.20.4、v4.0.0 到 v4.0.4、v4.0.10 与 v4.0.11 的发布日期、预览版或正式版标记与原文),同日抓取。
相关阅读
Claude Code 自定义端点配置
两个环境变量、settings.json 写法与 apiKeyHelper。
Codex CLI 接第三方 API 配置指南
config.toml 的 model_provider、base_url、env_key 怎么写。
CC Switch 4.0 聚合模式与一键导入
直连、路由、聚合拆成三个标签;聚合把多家服务商放进同一个模型列表;ccswitch:// 深链在应用未打开时不再丢失;官方 README 没有命令行版本。
加密货币充值指南
9 种币、56 条网络,0 平台手续费购买 AI 编程 API 额度。
本页步骤与引语核对于 2026-10-13,以 QCode 文档、CC Switch 官方 README 与 GitHub 发布说明等官方页面为准。CC Switch 的界面文案与切换行为随版本变化,以你手上的版本为准;模型可用性以 /models 为准。