Codex用CC Switch接第三方API不花会员钱：Mac和Windows双平台完整教程
📖 名词释义
AI Box（又称 AI盒子 / 智能体计算机 / Agent Computer），是一种专门运行 AI Agent 的本地硬件设备，预装智能体应用管理系统，开箱即用，7×24 小时在线运行。用户可以通过微信、飞书、企业微信、钉钉等社交软件远程指挥 AI 帮你干活。
摘要： Codex官方会员每月20刀贵且地区限制多，用CC Switch接DeepSeek、Kimi、百炼等第三方API，单价能降到官方的1/10。这篇把Mac和Windows双平台完整流程跑通：Codex安装、CC Switch接管、Provider切换、常见踩坑排查，跟着抄就行。
Codex作为OpenAI官方CLI编程助手，写代码、读仓库、改文件能力一流。但官方订阅有两个硬伤：每月20刀会员费对个人开发者不便宜，部分地区还要求绑定海外支付方式。想换DeepSeek、Kimi、智谱这些国产模型，光改环境变量不够——Codex默认用OpenAI的Responses API协议，而国产厂商统一提供的是Chat Completions接口，协议直接不兼容。
CC Switch 就是解决这个痛点的工具。本地运行的API路由器，把Codex请求自动转译成任意第三方API能识别的格式，多Provider一键切换。安装包不到10MB，Mac、Windows、Linux都有原生图形界面。本文以"Codex + DeepSeek"组合为例，双平台一步步教你跑通。
一、装Codex本体
Mac用户两种方式：方式一终端粘贴curl -fsSL https://claude.ai/install.sh | bash；方式二官网Quickstart下载.pkg双击安装。
Windows用户同样两种：方式一官网Quickstart页面点"Download for Windows"下载安装包双击运行；方式二微软商店一键安装——开始菜单搜"商店"，搜"codex"或"chatgpt"（新版改过名），点安装。
装完终端输入codex --version能显示版本号就装好了。这一步会同时生成~/.codex/config.toml配置目录骨架，CC Switch后续接管的就是这个文件。
注意：装完Codex不要登录官方账号。 跟CC Switch一起用时，登录官方账号会和自定义Provider冲突报冲突警告。后续接入第三方API时选"其他登录方式"输入API Key，根本不用登录官方账号。
二、装CC Switch：双平台通用
GitHub开源桌面工具，作者farion1231，最新3.16.0版本。
Mac用户：releases页（https://github.com/farion1231/cc-switch/releases）下载.dmg格式，双击图标拖进Applications文件夹。
Windows用户：同GitHub releases页，下载.msi安装包双击运行。装完系统托盘出现CC Switch图标。
装好打开主界面：顶部一排工具图标（Claude Code、ChatGPT即Codex、Gemini CLI、OpenCode、OpenClaw），点ChatGPT图标切换到Codex管理。右上角"+"号新建Provider，下方列表显示已配置的所有模型源。
三、核心一步：CC Switch接管Codex配置
这一节是整个流程的关键。点开CC Switch顶部ChatGPT图标进入Codex管理，点击右上角"+"号选"自定义配置"。
通用配置字段（双平台一致）：
- 供应商名称：自定义，比如"DeepSeek"、"百炼"都行
- API请求地址：填第三方Provider的Base URL
- DeepSeek官方：
https://api.deepseek.com/v1 - QuickRouter（聚合站，便宜通道多）：
https://api.quickrouter.ai/v1 - 阿里云百炼：
https://dashscope.aliyuncs.com/compatible-mode/v1 - 硅基流动：
https://api.siliconflow.cn/v1 - API Key：去对应平台控制台创建
- 模型名称：填该平台支持的模型，如DeepSeek的
deepseek-chat、Kimi的moonshot-v1-128k、百炼的qwen-coder-plus
填完点Save，列表出现你刚添加的Provider。
关键步骤：点击"启用"按钮把状态切到Active。 CC Switch这时会做几件事：把~/.codex/config.toml改写指向本地代理http://127.0.0.1:15721/v1，强制锁定wire_api="responses"协议；后台启动本地代理服务监听15721端口，所有请求被拦截。
协议转换链路（理解这个能少踩很多坑）：
- 配置改写：CC Switch把Codex指向127.0.0.1:15721本地代理，锁定Responses协议
- 格式标记：Provider的
meta.apiFormat="openai_chat"告知路由层上游真实接口是ChatCompletions - 请求转发：路由拦截
/responses路径映射为/chat/completions，请求体格式互转 - 响应回译：上游Chat格式响应（SSE流）重新组装为Codex能解析的Responses格式返回
无论上游是Chat Completions、Anthropic还是Bedrock自定义，CC Switch都能翻译成Codex吃得到的格式。
四、注册Key并测试连通
填完Provider还要确保API Key真的可用。先测Base URL连通：
curl -sS "https://api.deepseek.com/v1/models" \
-H "Authorization: Bearer sk-你的key"
返回JSON列出平台支持的所有模型就通了。如果返回401/403，说明Key填错或账号没激活。
再测一次最小请求：
curl -sS "https://api.deepseek.com/v1/chat/completions" \
-H "Authorization: Bearer sk-你的key" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "hello"}]}'
返回200说明Provider完全可用，这时回CC Switch启用它，启动Codex就能正常对话。
几个常用平台对比（2026年8月）：
| 平台 | 招牌模型 | 输入价（元/百万token） | 输出价 | 适合场景 |
|---|---|---|---|---|
| DeepSeek | deepseek-chat | 缓存0.02/未命中1 | 2 | 通用代码、低成本批处理 |
| 阿里云百炼 | qwen-coder-plus | 约2 | 约6 | 中文注释、长上下文 |
| QuickRouter | gpt-5.4/claude系 | 约0.5-2 | 约1.5-6 | 自由切换多家 |
| 硅基流动 | Qwen/Qwen3-Coder | 免费额度充足 | 极低 | 个人开发调试 |
官方Codex会员20美元/月约145元人民币，DeepSeek按token计费，代码任务1小时消耗一般几毛钱到几块钱，一个月成本不到官方的1/10。
五、双平台验证
配置完不直接信CC Switch显示状态，要用Codex CLI实跑验证。
终端验证（双平台命令一样）：
任意项目目录下打开终端，输入codex进入交互模式，敲一句"列出当前目录所有Python文件"。如果CC Switch工作正常，Codex会调用底层模型给出回应，终端显示"Used deepseek-chat (provider: DeepSeek)"日志，说明这次请求确实走了DeepSeek通道。
查看配置文件确认：
Mac/Linux终端执行cat ~/.codex/config.toml，Windows执行type %USERPROFILE%\.codex\config.toml。应该能看到：
model_provider = "custom"
model = "deepseek-chat"
wire_api = "responses"
[providers.custom]
name = "DeepSeek"
base_url = "http://127.0.0.1:15721/v1"
base_url指向127.0.0.1:15721就对了——这是CC Switch本地代理地址。如果还指向官方地址，说明CC Switch没接管成功，回CC Switch点"启用"。
多Provider切换：列表里多个Provider都点过"启用"后，右键托盘图标可快速切换当前生效Provider。上午写Python用DeepSeek便宜，下午调Claude系模型用聚合站通道，一秒切换不用重启Codex。
六、常见报错与排查
报错1：Codex启动报"配置冲突"
原因：同时登录官方账号 + 添加了CC Switch自定义Provider。解决：终端执行codex /logout退出官方账号登录，回CC Switch启用Provider。
报错2：请求返回401 Unauthorized
原因：API Key填错、过期或没激活对应模型分组。解决：去平台控制台重新生成Key，注意有些平台需把模型加到"分组"里才能调用。
报错3：返回"model not found"或404
原因：模型名称拼错或该平台没有这个模型。解决：参考第四节模型列表修改CC Switch的"模型名称"字段。
报错4：流式响应卡住、只输出半截
原因：上游SSE事件命名和Codex期待的Responses协议不兼容，CC Switch没识别全。解决：升级CC Switch到最新版（3.16.0+），或换一家SSE规范的Provider。
报错5：CC Switch改了配置但Codex不生效
原因：Codex缓存了旧配置。解决：完全退出Codex（Ctrl+C或.exit）重新启动。还不行就删掉~/.codex/config.toml让CC Switch重新生成。
报错6：Mac系统提示"无法打开，因为无法验证开发者"
原因：个人开发者发布未走Apple公证。解决：系统设置 → 隐私与安全 → 仍要打开。Windows SmartScreen类似，点"更多信息 → 仍要运行"即可。
七、为什么这种方案值得用
对个人开发者来说，这种方案最大价值不是省那点API费，而是解锁模型自由。官方Codex只能调OpenAI一家——但实际开发中，复杂架构用Claude Opus 5、中文注释用Kimi K3、批量数据用DeepSeek V4-Flash凌晨低谷、视频脚本用MiniMax H3，每种任务都有最适合的模型。官方一家独大反而成了限制。
CC Switch这种本地路由，相当于在Codex和上游API之间架了座"翻译桥"。你不用关心上游协议是Responses、Chat Completions还是Anthropic，CC Switch全帮你转译。另一好处是配置即代码——~/.codex/config.toml可纳管进Git，新机器clone项目后一键还原整套AI开发环境，团队协作也方便。
铠盒AIBOX作为24小时AI调度管家，把类似的多模型调度思路做到了硬件层面：本地Agent根据任务复杂度自动切不同模型——复杂推理走Claude/GPT-5.6 Sol、文案批处理走Kimi便宜通道、批量数据凌晨跑DeepSeek低谷时段，用户根本不用关心底层用了谁家的模型。和CC Switch的本地路由理念一脉相承：让模型适配任务，而不是反过来。
需要提醒的是，CC Switch是本地工具只负责协议转发和Provider管理，实际API调用费还是要付给上游平台。不存在"用CC Switch就免费"——它解决的是协议兼容和多模型切换问题，不是绕过付费。就像家里的路由器：路由器本身不提供上网服务，它只是把你家的网络请求正确转发到运营商。
延伸阅读
- Codex新手最该先学的5个斜杠命令 - /plan /mention /approvals 等基础但提效的关键操作
- Codex用了一年还在当聊天框用？5个斜杠命令让你每次少返工50% - 进阶避坑：权限、C盘空间、AGENTS.md
- Claude Opus 5 / Kimi K3 / MiniMax H3 / DeepSeek V4-Flash - 7月最后一周6款新模型对比
- 铠盒AIBOX商城 - 全系列24小时AI调度管家，模型自由切换不受限于一家
-#铠盒AI #AI Agent #Codex #CC Switch #DeepSeek #国产模型 #开源工具 #AI编程助手 #CLI工具 #大模型路由
铠盒AIBOX · 7×24小时为你工作的私人AI助手 · AI智能体