读完这篇你能做到什么
- 一句话说清中转站、CC Switch、Codex++ 三者分别是什么、谁管谁
- 挑一家中转站,并且知道自己在承担哪一档风险
- 用 CC Switch 把 Claude Code / Codex CLI 接到中转站,五步搞定
- 用 Codex++ 把 Codex 桌面 App 接到中转站,并看懂它的四种供应商模式
- 配完之后验证它真的走了中转站、真的是满血模型,而不是自我感觉良好
- 报错时按顺序排查,而不是瞎改
不需要编程基础。原理部分本文只给结论,想搞明白为什么,看这篇:一把钥匙、三种协议、两个配置文件:AI API 小白指南
一、先拆掉最大的那个误解
很多人(包括本文最初的标题)会说「cc switch、codex++ 这些中转站」。
这句话是错的,而且错得很要命。 它们根本不是一类东西:
| 中转站 | CC Switch / Codex++ | |
|---|---|---|
| 它是什么 | 一个网站 | 一个装在你电脑上的软件 |
| 它卖什么 | 卖 API Key,按 token 收你钱 | 免费开源,不收钱 |
| 它干什么 | 帮你把请求转发给真正的大模型 | 帮你改本地配置文件 |
| 出事了谁的锅 | 跑路、降智、断供,都是它 | 顶多配置写错,删了重来 |
| 能不能不用 | 不能(你总得有个地方买 token) | 能(手改配置文件即可) |
一句话记住:
中转站是「油站」,切换工具是「你车上那个换油箱的开关」。 开关再好用,油的质量也是油站决定的。
所以本文的顺序也是这个:先选油站(第二、三章),再学开关(第四、五章)。 顺序反了,你会配得很顺利,然后被割得很干脆。
三个名字对号入座(2026-07-22 核实)
- CC Switch — farion1231/cc-switch,12.0 万 Star,v3.18.0(2026-07-21)。桌面 GUI,管 8 个命令行工具的配置文件:Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes Agent。全平台。
- Codex++ — BigPizzaV3/CodexPlusPlus,2.6 万 Star,v1.2.41(2026-07-20),AGPL-3.0。只管 OpenAI 的 Codex 桌面 App 一个,除了换供应商还会给 App 注入界面增强。只有 Windows 和 macOS,没有 Linux。
- 中转站 — 各种网站,第二章细说。
二、选中转站:先看懂价格,再看别的
2.1 一条能救你钱的判断法则
行业里正规「官转」(用官方 Key 转发)的价格是官方定价的 0.8 ~ 1.5 倍——它要付官方的钱,还要赚服务费,不可能更便宜。
所以:
| 价格档位 | 大概率对应的机制 | 风险 |
|---|---|---|
| 官方的 0.8 ~ 1.5 倍 | 官价透传 + 手续费;或换成国产模型顶替 | 🟢 低 |
| 官方的 0.3 ~ 0.8 倍 | 企业批量采购折扣转售 | 🟡 中,看转售条款 |
| 官方的 0.3 倍以下 | 逆向网页版、共享账号池、多账号轮询 | 🔴 高,明确违规 |
2.2 点名清单与风险标注
🟢 低风险:第一方官方平台 / 合规聚合
这一档严格说不算中转站,是厂商自己或者正规聚合商:
- OpenRouter(https://openrouter.ai)——国际合规聚合。token 单价零加价,钱收在充值环节(信用卡 5.5%,最低 $0.80/笔;加密货币 5%)。支持 Anthropic 原生格式,能直接接 Claude Code。默认只记 metadata 不记你的内容。
- 硅基流动 SiliconFlow(https://siliconflow.cn)——国内。上架的全是开源权重模型(GLM、DeepSeek、Qwen、Kimi),没有 Claude 和 GPT,属于自建推理服务。有官方 Claude Code 接入文档。
- 智谱开放平台 —— Anthropic 兼容端点
https://open.bigmodel.cn/api/anthropic - 阿里云百炼 —— Anthropic 兼容端点
https://dashscope.aliyuncs.com/apps/anthropic,官方文档里直接教你用 CC Switch 接入 - 火山方舟 —— 同为第一方平台,合同与计费直连厂商
这一档的共同点:有公司主体、有发票、有客服、跑不掉。 代价是不便宜,且大多没有 Claude / GPT 的满血原版。
🟡 中风险:品牌中转站
价格在官方 0.8 ~ 1.5 倍区间、运营半年以上、有明确主体的第三方中转。这一档我不点名——因为**「有没有跑路」只能靠时间验证,我今天写下的名字,半年后可能就是个 404**。判断方法在 2.3。
🔴 高风险:低价中转站(含 Codex++ 官方赞助商)
这里必须点破一件事:Codex++ 的 GitHub README 页面上挂着 4 个赞助商,全部是中转站,全部是带推广返利(aff)的注册链接。
- JOJO Code(jojocode.com)——README 里自称「Codex++ 官方中转站」
- AIGoCode(aigocode.com)——给 Codex++ 用户首充额外 10% 奖励
- APIKEY.FUN(apikey.fun)——自称「价格低至官方原价的 7%」
- RunAPI(runapi.co)——自称「OpenRouter 平替」,一个 Key 通 150+ 模型
风险判断:
- 「官方中转站」这个说法没有任何官方背书。 Codex++ 自己就是第三方工具,OpenAI 不认它;它认证的中转站,自然更不代表任何官方关系。
- 这些链接都带 aff 参数,作者从你的充值里抽成。这不违法,但你要知道推荐动机不纯粹。
- 7% 官价这种数字,直接落在 🔴 档,见 2.1。
结论不是「绝对别用」,而是:把它当成一次性消耗品。 只充你输得起的最小额度,同时注册 2~3 家互为备份,永远不要把它当长期基础设施。
2.3 五个可以自己动手验的探针
不要信宣传页,自己测。以下五招都不需要编程基础,复制粘贴就行。
① 协议真实性探针
用一个故意写错的 Key 去打它的接口:
curl -i -X POST "https://它的地址/v1/messages" \
-H "x-api-key: sk-this-key-is-fake" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'
- 返回 401 → 这个路由真实存在,它确实实现了 Anthropic 协议 ✅
- 返回 404 → 它没实现,只是套了层壳 ❌
② 核对模型清单
curl "https://它的地址/v1/models" -H "Authorization: Bearer 你的key"
返回的列表和宣传页对得上吗?宣传页写了 200 个模型,实际返回 12 个,就是虚标。
③ 价格反推
把它的单价和官方定价页逐条比,算出倍率,对照 2.1 的表。这一步是五招里最重要的,因为价格骗不了人。
④ 上下文窗口探针
塞一篇长文档进去(比如把这篇文章整个粘贴进去),让它总结中间某一段的内容。答不上来,说明窗口被偷偷缩短了——你以为买的是 200K,实际给你 32K。
⑤ 降智探针
同一个问题,分别问中转站和官方(或已知靠谱的渠道),比较回答质量和速度。回答明显变笨、变短、变快,大概率是背后偷换成了便宜的小模型。
2.4 黑话解码
看中转站的宣传页和群聊,这些词你得认识:
- 官转 = 用官方 Key 转发(正规)
- 逆向 / 2API = 破解网页版,或把包月订阅转成 API(违规)
- 满血 / 阉割 = 完整模型 / 被削过的
- 降智 = 表面点名大模型,背后偷偷换成便宜的小模型
- 上车 / 拼车 = 多人合租一个账号
- 翻车 = 服务挂了或者跑路了
- 裸价 / 加价率 = 相对官方定价的倍数
2.5 三个必须知道的代价
- 你的对话内容对中转站完全明文可见。 别传公司机密、身份证、代码里的密钥。
- 预充值有跑路风险。 连 OpenRouter 这种正规平台的退款政策都是「24 小时内、手续费不退、加密货币永不退」,无名小站更别指望。
- 账单无法与官方对账。 官方的用量查询接口只覆盖你自己直连的账号,中转站不可能给你这个。你只能信它自己的账单页。
三、通用五步:从注册到拿到能用的 Key
无论选哪家,流程都是这五步。第 4 步千万别跳。
- 注册。 邮箱注册,开二次验证。用一个专门的邮箱,别用主力邮箱。
- 找到三样东西。 在它的「文档」或「接入指南」页面,抄下这三个(这是所有中转站的最小公约数):
base_url—— 请求发到哪个地址,形如https://api.xxx.comapi_key——sk-开头的一长串model—— 模型名,形如claude-sonnet-5、gpt-5.6
- 充最小额度。 通常是 1 美元或 10 元。不要绑自动续费。
- 跑第 2.3 章的探针 ①②③。 五分钟,能替你省下几百块。
- 记住控制台在哪。 出问题第一件事是去看用量和余额,不是重装软件。
四、三条路线,你走哪条
配置的目标只有一个:让工具知道 base_url、api_key、model 这三样。 区别只在于你用什么方式告诉它。
| 路线 | 用什么工具 | 管的是谁 | 适合谁 |
|---|---|---|---|
| A | CC Switch | Claude Code、Codex CLI 等 8 个命令行工具 | 绝大多数人 ✅ |
| B | Codex++ | OpenAI Codex 桌面 App | 用桌面版 Codex 的人 |
| C | 手改配置文件 | 同上,但纯手工 | 服务器、无桌面环境 |
路线 A 和 B 不冲突,可以同时用——一个管命令行,一个管桌面 App,Codex++ 甚至能直接导入 CC Switch 里已配好的供应商。
路线 C 本文不展开(改 ~/.claude/settings.json 和 ~/.codex/config.toml 两个文件),详细写在一把钥匙、三种协议、两个配置文件:AI API 小白指南第九章。
五、路线 A:CC Switch 五步走
5.1 第一步:确认系统够格
- Windows:10 及以上
- macOS:12(Monterey)及以上
- Linux:Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 及其他主流发行版
5.2 第二步:下载安装
macOS(推荐用 brew)
brew tap farion1231/ccswitch
brew install --cask cc-switch
或者去 Releases 下 CC-Switch-v3.18.0-macOS.dmg。macOS 版做了 Apple 签名和公证,双击就能开,不用绕 Gatekeeper。
Windows
去 Releases 下这两个之一:
CC-Switch-v3.18.0-Windows.msi—— 安装版(推荐)CC-Switch-v3.18.0-Windows-Portable.zip—— 免安装版
ARM 设备选带 arm64 的那个。
Linux
- Arch 系:
paru -S cc-switch-bin - 其他:Releases 里下
.deb/.rpm/.AppImage,注意分x86_64和arm64
5.3 第三步:添加供应商
打开 CC Switch,界面顶部有一排工具图标(Claude Code、Codex、Gemini CLI……)。
- 先在顶部选中你要配的那个工具(比如 Claude Code 的橙色星形图标)——这一步最容易漏,选错了配到别的工具上去
- 点右上角
+进入「添加新供应商」 - 填三样东西:
- 名称 —— 随便起,你自己认得就行,比如「某站-Claude」
- Base URL / 接口地址 —— 中转站文档里给的那个
- API Key / 密钥 —— 你申请的那个
- 点「添加」
5.4 第四步:切换
在供应商列表里点一下你要用的那个,它就成为「当前激活」。
生效时机不一样,这点很多人卡住:
- Claude Code —— 支持热切换,不用重启
- 其他所有工具(Codex CLI、Gemini CLI……)—— 必须重启终端或重启 CLI
5.5 第五步:验证
打开 Claude Code,随便问一句,能正常回答就通了。
更严格的验证,看第七章。
5.6 三个必须知道的行为
六、路线 B:Codex++ 配桌面版 Codex
6.0 先搞清楚它是个「壳」
Codex++ 的工作方式是:启动官方 Codex App,然后往里面注入增强脚本。
所以:
- 必须先装官方 Codex App,没有本体它启动不了
- 必须从
Codex++这个入口启动,直接开官方 App 是没有增强的 - 官方 App 一更新,注入的功能就可能失效,要等作者跟进适配
6.1 下载
去 Releases 下载,按你的机器选:
- Windows:
CodexPlusPlus-*-windows-x64-setup.exe - macOS(Intel 芯片):
CodexPlusPlus-*-macos-x64.dmg - macOS(M 系列芯片):
CodexPlusPlus-*-macos-arm64.dmg
没有 Linux 版。 用 Linux 的直接走路线 A 或 C。
不确定自己 Mac 是哪种芯片:左上角 → 关于本机,写着「Apple M…」就是 arm64,写着「Intel」就是 x64。
6.2 安装
装完你会得到两个图标,别搞混:
Codex++—— 启动器。以后就用它开 Codex,不要再点官方图标。Codex++ 管理工具—— 配置台。配供应商、模型、增强功能都在这里。
Windows:双击 exe,会自动建桌面和开始菜单快捷方式。
macOS:拖进「应用程序」,会得到 /Applications/Codex++.app 和 /Applications/Codex++ 管理工具.app。
6.3 首次使用的正确顺序
作者建议的顺序,照做能少踩坑:
- 先打开
Codex++ 管理工具 - 在「安装维护」/「关于」页面确认应用路径和运行状态——它得先找到你的官方 Codex App
- 再配置供应商与增强功能
- 最后从
Codex++入口启动
6.4 四种供应商模式,选哪个
这是 Codex++ 最核心也最容易配错的地方。它把「官方登录」和「API」严格分开存:
| 模式 | 什么时候用 | 认证怎么处理 |
|---|---|---|
| 官方登录 | 你有 ChatGPT / Codex 官方订阅,不用中转 | 清掉自定义 provider 和 API Key,只留官方登录 |
| 官方登录 + API | 想保留官方账号和插件入口,但模型请求走中转 | Key 写进 provider 的 bearer token,不写进 auth.json |
| 纯 API | 没有官方账号,完全靠中转站 ✅ 多数人选这个 | 独立存 config.toml 和 Key,不碰官方认证 |
| 聚合供应商 | 配了多家中转,想自动切换 | 支持故障转移、按会话轮转、按请求轮转、权重轮转 |
6.5 每个供应商能配什么
- 协议:
Responses或Chat Completions- Codex 原生只认 Responses
- 如果你的中转站只支持 Chat Completions,Codex++ 会起一个本地代理帮你转协议——这是它比手改配置文件强的地方
- 模型列表 / 测试模型 / User-Agent
- 上下文窗口:支持
1M、200K或直接填数字。它会生成独立的model_catalog_json,让 Codex 按当前模型用对应窗口 - 自动压缩阈值
- 每个供应商单独启用哪些 MCP Server、Skill、Plugin
6.6 省事技巧:从 CC Switch 导入
如果你已经在 CC Switch 里配好了供应商,Codex++ 支持直接导入 cc-switch 配置,也支持「链接导入」。不用重新敲一遍 base_url 和 Key。
6.7 它还顺手给了什么
换供应商之外,Codex++ 给官方 App 加的增强(每一项都能单独关):
- 插件市场与模型白名单、中文界面、粘贴修复、快速启动
- 会话管理:批量删除、Markdown 导出、Token 用量历史、会话宽度与滚动恢复
- 开发工作流:项目移动、Upstream worktree、线程 ID、Zed Remote 项目识别
七、验证:怎么确认「真的走了中转站、真的是满血」
配完能回答问题 ≠ 配对了。这一章的四个检查,建议每换一次供应商都跑一遍。
① 它真的走中转了吗
最直接的办法:把中转站的 Key 故意改错一个字符,重启工具,再问一句。
- 报鉴权错误 ✅ 说明请求确实发给了中转站
- 照常回答 ❌ 说明它压根没读你的配置,还在用原来的账号 / 官方登录态
测完记得改回来。
② 用量对得上吗
去中转站控制台看用量曲线。你刚才问的那几句,应该在几分钟内出现在账单里。一直是 0,就是没走通。
③ 模型是满血的吗
跑第 2.3 章的探针 ④(上下文窗口)和 ⑤(降智)。
④ 配置文件里写的是什么
想彻底确认,直接看文件:
# Claude Code
cat ~/.claude/settings.json
# Codex
cat ~/.codex/config.toml
看 base_url 是不是中转站的地址。
八、报错速查
排查顺序:先看报错码 → 再看地址 → 再看模型名 → 最后才怀疑工具。
| 报错 / 现象 | 大概率原因 | 怎么办 |
|---|---|---|
401 Unauthorized / 鉴权失败 | Key 错了、过期了、或者余额清零被禁用 | 去控制台核对 Key 和余额;重新复制一遍,注意别带空格 |
404 Not Found | base_url 写错,多写或少写了 /v1 | 对照中转站文档一个字符一个字符核 |
model not found / 模型不存在 | 模型名过期或该站没有这个模型 | 跑探针 ②(/v1/models)看它到底有什么 |
429 Too Many Requests | 请求太频繁,或该站在限流 | 等一会;频繁出现说明这家并发能力不行 |
| 余额充足但一直失败 | 上游被封,中转站自己挂了 | 换备用的那家;这就是为什么要注册 2~3 家 |
| 切换供应商后插件 / hooks 配置没了 | CC Switch 整份覆盖了 settings.json | 见 5.6 ①,用「共享配置片段」 |
| 改了配置但没生效 | 除 Claude Code 外都要重启 | 重启终端或 CLI,见 5.4 |
| Codex++ 菜单没出现 | 你从官方图标启动的,不是从 Codex++ | 用 Codex++ 入口;再去管理工具的「安装维护」查应用路径和诊断日志 |
| Codex++ 切换供应商后请求失败 | 协议 / Base URL / Key / 测试模型不匹配 | 在供应商详情里跑「模型测试」或 Provider Doctor;别手工复制两种模式的 auth.json |
| macOS 提示「已损坏,无法打开」 | 安装包未签名未公证 | 见 6.2 的 xattr 命令 |
| 回答明显变笨 / 变短 | 降智,背后被换成小模型了 | 跑探针 ⑤;确认了就换平台 |
九、一页纸总结
买之前
- 中转站是油站,CC Switch / Codex++ 是开关,别混为一谈
- 价格低于官方 0.3 倍 = 违规渠道 = 随时跑路,只当消耗品用
- 注册 2~3 家互为备份,每家只充最小额度,不绑自动续费
配的时候
- 命令行工具 → CC Switch(认准 ccswitch.io)
- 桌面版 Codex → Codex++(先装官方 App,能关注入就关掉)
- 你要的永远只有三样:
base_url、api_key、model
配完之后
- 故意写错 Key 验证请求真的走了中转
- 去控制台看用量曲线对不对得上
- 跑一次长文档总结,确认窗口没被偷偷缩水
永远记住
- Key 不进代码、不进 GitHub、不进截图
- 对话内容对中转站完全透明,别传敏感信息
- 出问题第一步是看控制台余额和用量,不是重装软件
十、下一步
- 想搞明白为什么改三个值就能换厂商:一把钥匙、三种协议、两个配置文件:AI API 小白指南
- 想学会用好 Claude Code / Codex 本身:从零开始用 Codex 和 Claude Code:一篇写给完全不懂代码的人的上手指南
- 想理解提示词之上还有哪三层:你不是不会用 AI,你只是只做了第一层:Prompt / Context / Harness / Loop
- 想自己搭一个中转站(团队多人共用一个 Key):看开源网关 new-api(4.3 万 Star,当前事实标准)。注意 one-api 已停更约 17 个月,别照老教程装。
附:本文的事实核实边界
截至 2026-07-22 已核对一手来源:Codex++ 仓库状态(2.6 万 Star / v1.2.41 / AGPL-3.0 / 平台支持 / 四种供应商模式 / 注入机制 / FAQ / 赞助商清单)、CC Switch 仓库状态(12.0 万 Star / v3.18.0 / 8 工具 / 安装方式 / 系统要求 / 读写行为)、阿里云百炼官方 CC Switch 接入文档、OpenRouter 定价机制、Anthropic 关于第三方网关与支持地区的官方表述。
未能核实、文中已回避或标注:各中转站的实际到手价格与运营主体、Codex++ 赞助商的服务质量、Codex 桌面 App 的官方下载地址(请从 OpenAI 官网获取,别从第三方下载站)、CC Switch 与 Codex++ 界面的具体按钮位置(版本更新频繁,以你屏幕上看到的为准)。
看到本文与你实际操作不一致时,以官方文档和你自己的探针结果为准。
留言功能暂时不可用,请稍后再试。