[2026最新] CC Switch 一键切换：Claude Code + Codex 同时接 apipifa 中转（可视化，不用手改 JSON，免翻墙·人民币·保姆级）

你是不是也踩过这几个坑：

想在 Claude Code 里用官方号，结果每次都要开代理翻墙，网络一抖就报连接错误；
官方订阅贵，还有那个恼人的「5 小时额度墙」，跑几轮就被限流；
好不容易配好 Claude Code，又想装 Codex，两边的配置文件（~/.claude/settings.json 和 ~/.codex/config.toml）藏在不同角落，格式还不一样，手改一个引号打错就整个跑不起来；
更怕的是——账号登录态一天到晚要维护，生怕哪天被官方风控封号，前面的活儿白干。

这篇教程给你一套「零手改配置」的可视化方案：用开源工具 CC Switch 当你的后端切换开关，配合 apipifa 中转，做到——

一份 apipifa Key，Claude Code 和 Codex 两个客户端都能用；在系统托盘点一下就切换后端，想回官方号也是一键回退，全程不用打开任何 JSON 文件。

apipifa 是正规的人民币 API 中转服务：支付宝 / 微信充值，国内直连不用翻墙，按量计费没有官方那道 5 小时额度墙，而且它原生兼容 OpenAI 和 Anthropic 两套协议——这正是「一份 Key 喂两个客户端」能成立的技术前提。

下面保姆级、从零开始，跟着做就行。

一、先搞懂 CC Switch 是干嘛的（1 分钟）

CC Switch（开源项目 farion1231/cc-switch）是一个跑在系统托盘 / 菜单栏里的小工具，它的唯一使命就是：帮你在不同「供应商」之间一键切换 Claude Code 和 Codex 的后端，而你不用去手动编辑那些配置文件。

它的心智模型很简单，记住两句话：

它内部分 Claude 和 Codex 两个应用板块，各自维护一组「供应商卡片」。
每张供应商卡片 = 一套后端配置（Base URL + Key）。你点哪张卡，它就把对应客户端的配置帮你写好，你直接开客户端用即可。

所以我们的目标就很清晰了：

在 Claude 板块，建一张指向 apipifa 的卡；
在 Codex 板块，也建一张指向 apipifa 的卡；
顺手在两边各留一张官方卡，随时一键切回官方号做对照或回退。

贯穿全文最关键的一句话：apipifa 不是 CC Switch 内置的预设供应商，所以每次添加时都要选「自定义供应商（Custom）」，然后手动填 Base URL 和 Key。凡是让你「填任意 Base URL」的入口，走的就是这条自定义路子。记住这句，你就不会在下拉列表里找不到 apipifa 而卡住。

二、准备工作：先把 Node、Claude Code、CC Switch 装好

CC Switch 只是「切换开关」，真正干活的还是 Claude Code / Codex 本体，所以本体得先装上。

步骤 1：装 Node.js（Claude Code 和 Codex 的运行底座）

去 Node 官网下载 LTS 版本装上即可。装完在终端验证：

node -v
npm -v

两条都能打印出版本号就算好了。

提示：Codex 要求 Node ≥ 22，所以直接装最新 LTS，一步到位，省得回头再升级。

步骤 2：装 Claude Code

npm install -g @anthropic-ai/claude-code

国内网络慢的话，加国内镜像源会快很多：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

装完验证：

claude --version

能打印版本号即成功。

步骤 3（可选，想同时用 Codex 才装）：装 Codex

npm install -g @openai/codex

同样验证：

codex --version

只想先跑通 Claude Code 的，这步可以先跳过，后面用到 Codex 再回来装。

步骤 4：下载并打开 CC Switch

去 CC Switch 的开源发布页（GitHub farion1231/cc-switch 的 Releases）下载对应你系统的安装包（macOS / Windows 都有），装好后打开。它会驻留在系统托盘 / 菜单栏，点开就是主界面。

界面上你会看到 Claude 和 Codex 两个板块（或标签页），每个板块下面是一个「供应商列表」，现在多半是空的或只有官方默认项——接下来我们往里加卡。

三、拿到你的 apipifa Key（两个客户端共用这一份）

打开 apipifa 后台，注册 / 登录。
到「令牌 / API 密钥」页，新建一个令牌。
直接用默认设置即可——apipifa 新建令牌默认就是 auto 全模型通用池：一份 Key 覆盖 Claude、Codex（GPT）、Grok 所有模型，按你实际调用的模型名自动路由、自动计费，不用手动分组。
复制这串 Key，先存到记事本里备用。

这就是「一份 Key 两个客户端都能用」的来源：同一份 auto Key，Claude Code 走 Anthropic 协议、Codex 走 OpenAI 协议，apipifa 后端按模型名自动识别该走哪条。你不需要为 Claude 和 Codex 各办一份 Key。

价格方面：apipifa 是人民币按量 / 包月，比官方省，具体档位以 apipifa 价格页 / 后台为准（这里不写死数字，以免过期）。

四、Claude 侧：给 Claude Code 加一张 apipifa 卡

进入 CC Switch，切到 Claude 板块，跟着做：

步骤 1：点 「添加供应商 / Add Provider」。

步骤 2：类型这里，选「自定义供应商（Custom）」——不要选任何预设（预设里没有 apipifa）。这是全文最容易点错的一步。

步骤 3：在弹出的表单里填：

名称（Name）：随便起个好认的，比如 apipifa-claude。
Base URL：填

  https://api.apipifa.com/v1

API Key / Token：粘贴你上一节拿到的 apipifa Key。

步骤 4：保存，然后在列表里点这张卡把它设为「启用 / 当前」（一般是点一下卡片，或点卡片上的「启用 / Use」）。CC Switch 会把 Claude Code 的配置替你写好。

步骤 5：跳过官方联网验证（重要，卡这里的人最多）

有些机器第一次用中转启动 Claude Code，会卡在官方的联网 / 登录验证界面。遇到就手动加两处标记跳过（这两个文件本身是 JSON 对象，把下面这项加进去时记得跟已有内容之间用逗号隔开，别破坏 JSON 格式）：

编辑 ~/.claude.json，在对象里加一项：

  "hasCompletedOnboarding": true

编辑 ~/.claude/config.json，在对象里加一项：

  "primaryApiKey": "any-string"

这两处只是让 Claude Code 别再去要求走官方登录流程，primaryApiKey 填任意字符串即可，真正生效的鉴权是 CC Switch 帮你写进去的 apipifa Key。

步骤 6：跑通验证（这才叫真的配好了）

开一个全新的终端窗口（关键，见 FAQ Q1），然后：

claude

进入交互后，随便问一句，比如：

你好，报一下你现在是什么模型

能正常回话就说明 Claude Code 已经在走 apipifa 了。想指定模型时，Claude 侧常用这几个模型名（严格照这个写）：

claude-opus-4-8（最强）
claude-sonnet-5
claude-sonnet-4-6（Claude Code 常用）
claude-haiku-4-5（快、省，Claude Code 常用）

全程你没打开过 settings.json——配置是 CC Switch 帮你写的，这正是它的价值。

五、Codex 侧：再加一张 apipifa 卡（一份 Key 复用）

回到 CC Switch，切到 Codex 板块，套路和 Claude 侧一模一样：

步骤 1：点 「添加供应商 / Add Provider」。

步骤 2：类型同样选「自定义供应商（Custom）」（Codex 板块的预设里也没有 apipifa）。

步骤 3：填表单：

名称：比如 apipifa-codex。
Base URL：还是同一条

  https://api.apipifa.com/v1

API Key：粘贴同一份 apipifa Key（对，就是刚才 Claude 侧用的那份，不用换）。

步骤 4：保存并启用这张卡。CC Switch 会替你把 Codex 的配置（相当于 ~/.codex/config.toml 里指向 apipifa 的那套 provider 设置）写好，效果等价于：

model_provider = "apipifa"

[model_providers.apipifa]
name = "apipifa"
base_url = "https://api.apipifa.com/v1"

（这段只是让你理解 CC Switch 背后干了啥，你不用手敲——它替你写，Key 也由它注入。）

步骤 5：跑通验证 —— Codex 有一条硬规矩

Codex 改了后端配置必须彻底重启 Codex 进程，它不会热重载。 如果你之前开着 Codex，先完全退出再重开，否则新配置不生效。

重启后，在 Codex 里用 /model 命令选一个模型。Codex（GPT）侧可用的模型名（严格照写）：

gpt-5.5
gpt-5.4
gpt-5.4-mini
gpt-5.3-codex
gpt-image-2（生图）

选好模型随便发一句，能正常回复即接通。

到这里，一份 apipifa Key 已经同时喂饱了 Claude Code 和 Codex 两个客户端，而你在 CC Switch 里点两下就完成了，没碰过任何配置文件。

六、留一张「官方卡」：apipifa ↔ 官方号一键回退

CC Switch 最香的地方，是让「切后端」变成点一下的事。所以强烈建议你在两个板块里各再留一张官方卡，方便随时对照或回退：

Claude 板块：再「添加供应商」，这次可以用官方预设（或自定义填官方 Base + 你的官方 Key），命名 claude-官方。
Codex 板块：同理建一张 codex-官方。

之后你的托盘菜单里就有了这样一组开关：

板块	卡片	作用
Claude	`apipifa-claude`	走 apipifa 中转（免翻墙、人民币、无额度墙）
Claude	`claude-官方`	切回官方号
Codex	`apipifa-codex`	走 apipifa 中转
Codex	`codex-官方`	切回官方号

想用哪个点哪个。注意：Claude Code 认 Claude 卡的切换、Codex 认 Codex 卡的切换，切完记得按各自的规矩重开终端 / 重启进程（见下方 FAQ）。这样你既享受了 apipifa 的省钱与稳定，又保留了随时回官方的后路，进退自如。

七、FAQ · 排错（切换不生效先看这条）

Q1：CC Switch 切了卡，但 Claude Code 还是老样子 / 没生效？ A：Claude Code 在启动时读取一次配置，切换后必须开一个全新的终端窗口重新 claude。老终端里的会话不会自动跟着变。90% 的「切了没反应」都是这个原因。

Q2：Codex 切了 apipifa 卡还是连不上 / 还是走官方？ A：Codex 不热重载配置。切完卡要彻底退出 Codex 进程再重开，光关窗口可能没杀干净进程。重启后用 /model 重新选模型确认。

Q3：报 401 / Unauthorized（鉴权失败）？ A：Key 填错或粘贴时带了空格 / 换行。回 CC Switch 那张卡里，把 apipifa Key 重新完整粘贴一遍再保存启用。确认用的是 apipifa 后台那份，别混进了官方 Key。

Q4：报 404 / 找不到接口？ A：多半是 Base URL 尾缀错了。apipifa 统一是

https://api.apipifa.com/v1

Claude 卡、Codex 卡都填这一条，别漏 /v1，也别在后面多加路径（像 /chat/completions 这种子路径不用你填，客户端自己会拼）。

Q5：报「模型不存在 / 无此模型」？ A：模型名写错了。严格照这份：Claude 侧 claude-opus-4-8 / claude-sonnet-5 / claude-sonnet-4-6 / claude-haiku-4-5；Codex 侧 gpt-5.5 / gpt-5.4 / gpt-5.4-mini / gpt-5.3-codex / gpt-image-2；Grok 侧 grok-4.3。别写已下线的旧名（如 opus-4-6、gpt-5.2）。

Q6：添加供应商时列表里找不到 apipifa？ A：本来就没有。apipifa 不是内置预设，每次都走「自定义供应商（Custom）」手动填 Base URL + Key。这是设计如此，不是 bug。

Q7：Claude Code 一直卡在官方登录 / 联网验证界面出不来？ A：按第四节步骤 5，给 ~/.claude.json 加 "hasCompletedOnboarding": true、给 ~/.claude/config.json 加 "primaryApiKey": "any-string"，再重开终端。

Q8：一份 Key 真能同时给 Claude 和 Codex 用？会不会串？ A：能，不会串。apipifa 新令牌默认是 auto 全模型通用池，后端按你请求里带的模型名自动路由：带 claude-* 就走 Anthropic 协议链路，带 gpt-* 就走 OpenAI 协议链路，各走各的、各自计费，互不影响。

八、为什么这套组合值得用（apipifa 差异化收口）

同样是「给 Claude Code / Codex 换后端」，选 apipifa 做中转，实打实的好处是：

一份 Key 全模型：Claude + Codex（GPT）+ Grok 一份 auto Key 全覆盖，按模型名自动路由计费，不用为每个模型各办各的。
人民币付费，无需外币卡：支付宝 / 微信直接充，告别绑外币信用卡的麻烦。
国内直连，不用翻墙：https://api.apipifa.com/v1 国内网络直接可达，网络稳，不再为代理抖动背锅。
原生兼容 OpenAI / Anthropic 协议，直连不用本地路由：同一条 Base URL 两套协议都吃，不需要在本机额外开什么本地路由 / 转换层（有些竞品接第三方模型要你在本地起个中转进程，apipifa 不用，CC Switch 填个 Base URL 就完事）。
按量计费，没有官方 5 小时额度墙：用多少算多少，不会跑两轮就被官方限流卡住。
不依赖官方登录态：中转走的是 apipifa 的 Key，不走官方账号登录态，所以这条链路本身不涉及官方账号的封号风险（指不碰你的官方账号这条链路，非"绝不封"包票；apipifa 账户仍需按其条款正常使用）——你可以把官方号留着做备用，主力活儿交给中转。

配合 CC Switch 的一键切换，你得到的是一个可视化、可回退、零手改配置的多客户端 AI 工作台。

九、开始用

去 apipifa 注册开号，新建一个令牌（默认就是 auto 全模型池），复制 Key。
下 CC Switch，Claude 板块和 Codex 板块各加一张自定义供应商卡，Base URL 都填 https://api.apipifa.com/v1，Key 都用同一份。
按本文验证步骤各自跑通一句，收工。

一份 Key、两个客户端、托盘一键切换、随时回退官方——去 apipifa 后台开个号、拿到你的 Key，照着上面走一遍就行。具体价格和额度以 apipifa 价格页 / 后台为准。