1. 没有 OpenAI 账号Codex 还能不能跑起来很多开发者第一次接触 Codex CLI卡住的地方不是不会写代码而是手里没有 OpenAI 账号。注册流程、支付方式、地区限制随便哪一条都能让人在第一步就停下来。但 Codex 本身只是一个终端里的 AI 编程助手外壳它真正干活靠的是背后那个符合 Responses API 规范的模型服务。只要有一个能说同一种协议的服务端Codex 就能正常跑。问题在于国产大模型大多暴露的是 OpenAI Chat Completions 形态也就是/chat/completions这套接口。而新版 Codex CLI 面向的是 Responses API两者的请求体结构、流式事件格式、返回结构都不一样。你如果直接把 Chat 接口的 base URL 填进 Codex 配置常见结果就是模型列表拉不出来、请求报 404 或 400、流式响应解析失败。这不是模型不行是协议对不上。cc-switch 这个插件解决的就是这个协议转换问题。它让 Codex 始终连本机的一个路由地址仍然以 Responses API 发送请求路由在内部识别当前供应商是不是 Chat 格式再把请求改写成 Chat Completions 发给上游最后把上游返回的 JSON 或 SSE 转回 Codex 能理解的 Responses 形态。整条链路是Codex → cc-switch 本地路由 → 国产模型。这篇面向的是没有 OpenAI 账号、但想在本地把 Codex 跑通的开发者。我会给出config.toml和 cc-switch 的可复制配置骨架演示三步完成接入并做一次真实对话验证。全程不需要 OpenAI 账号也不需要任何特殊网络手段就是本机路由加一个统一 Key 通道。2. 前置准备统一 Key 通道与 cc-switch 安装在动手改配置之前先把两样东西准备好一个可用的 API Key 通道以及 cc-switch 插件本体。2.1 用统一 Key 通道拿到可调用的凭证国产模型各自有各自的开放平台DeepSeek、通义千问、智谱 GLM、Kimi 这些都能单独申请 Key。但如果你想像我一样用一个 Key 就能在多个模型之间切换走统一 Key/API 通道会更省事。TaoToken 提供的就是这种聚合入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 。操作路径很直接进控制台创建 API Key然后把这个 Key 填到 cc-switch 的供应商配置里。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。Key 只在创建时完整显示一次复制后先存到安全的地方。注意不管用哪家的 Key都建议在平台侧设置用量上限或余额告警。终端里的 AI 编程助手调用频率不低尤其是让它读整个项目目录的时候token 消耗会比聊天场景快很多。2.2 安装 cc-switch 插件cc-switch 的项目地址在 GitHub 上搜索farion1231/cc-switch就能找到。下载后按插件方式安装到 Codex CLI。安装前确认两件事Codex CLI 版本支持插件系统插件文件格式是.codex-plugin。如果安装失败先看 Codex 日志里的具体报错多数情况是版本不匹配或文件不完整。安装完成后cc-switch 会接管 Codex 的本地配置把~/.codex/config.toml里的 base URL 写成http://127.0.0.1:15721/v1并强制保持wire_api responses。这一步是后面所有配置能生效的前提。3. 三步配置config.toml 与 cc-switch 路由骨架配置的核心逻辑就三步配供应商、开本地路由、让 Codex 连上路由。下面给出可直接复制的骨架。3.1 第一步配置供应商并勾选本地路由映射打开 cc-switch 界面选择预设的供应商。如果你用的是统一 Key 通道就选对应的聚合入口只需要填 API Key 即可。关键的一步是勾选「需要本地路由映射」这个选项告诉路由真实上游是 Chat Completions 格式需要做协议转换。供应商配置里有一个meta.apiFormat字段值设为openai_chat。这个字段是路由判断要不要改写请求的依据。填完之后cc-switch 会生成一份模型目录文件cc-switch-model-catalog.json并把它的路径写进 Codex 配置的model_catalog_json字段。3.2 第二步开启 cc-switch 本地路由进入 cc-switch 的设置找到「路由」页选择「本地路由」把开关都打开。服务地址保持默认的127.0.0.1:15721不需要改。使用中的模型可以不写路由会自动根据当前供应商选择。保存后返回主界面顶部会显示路由已开启。这一步做完本机就有一个在15721端口监听的路由服务它负责把 Codex 发来的 Responses 请求转成 Chat 请求再把响应转回去。3.3 第三步确认 config.toml 指向本地路由cc-switch 接管后会自动更新~/.codex/config.toml。你可以手动打开确认一下核心内容应该长这样# ~/.codex/config.toml model_provider cc-switch model deepseek-chat [model_providers.cc-switch] name cc-switch base_url http://127.0.0.1:15721/v1 wire_api responses这里有两个点必须对base_url指向本机15721端口wire_api是responses。如果你之前手动把上游的 Chat base URL 写进来过一定要改回本地路由地址否则 Codex 会直接去请求上游的/responses而国产模型那边根本没有这个端点结果就是 404。配置完成后打开 Codex 客户端或终端里的 Codex CLI它会自动连上 cc-switch。原理就是 cc-switch 把config.toml改成了指向本地路由Codex 以为自己在跟一个标准的 Responses 服务说话实际上请求被路由转发并转换后打到了国产模型上。4. 验证请求一次真实对话跑通国产模型配置写完不算跑通得发一次真实请求看返回。下面是我实测的验证过程。4.1 用 Codex CLI 发一次对话在终端里进入一个测试目录启动 Codexcd ~/codex-test codex启动后 Codex 会读取config.toml连上127.0.0.1:15721。你直接输入一句自然语言比如让它解释一段代码帮我解释一下这个 Python 函数的作用def add(a, b): return a b如果路由和协议转换都正常你会看到模型正常流式返回解释内容。这时候说明整条链路已经通了Codex 发出 Responses 请求 → 本地路由改写成 Chat 请求 → 国产模型返回 Chat 响应 → 路由转回 Responses 流 → Codex 渲染出来。4.2 用 curl 直接验证路由端点如果想更直接地确认路由在工作可以绕过 Codex直接对本地路由发一个请求curl http://127.0.0.1:15721/v1/models \ -H Authorization: Bearer 你的Key正常返回会是一个模型列表 JSON。如果这里就报错说明路由服务本身没起来或者 Key 没配对跟 Codex 无关先把路由这层排掉。4.3 确认模型目录被加载cc-switch 生成的cc-switch-model-catalog.json会被写进config.toml的model_catalog_json。你可以在 Codex 里用/model命令查看当前可用模型。如果看不到预期的模型先重启 Codex。正在运行的 Codex 进程不一定会热加载模型目录重启是最省事的办法。提示目前 Codex app 不支持多模型同时选择默认使用配置里的第一个模型。想换模型在 cc-switch 里切换供应商后重启 Codex。5. 本篇常见错排查404、模型列表为空、请求走错供应商配置过程中最容易踩的坑集中在几个报错上下面按现象给排查路径。5.1 Codex 报 404 或找不到 /responses这个报错基本可以锁定为Codex 没有走本地路由而是直接去请求了上游。检查~/.codex/config.toml里的base_url是不是http://127.0.0.1:15721/v1。如果你之前手动填过上游的 Chat base URL比如带/chat/completions的完整路径一定要删掉改回本地地址。另外确认 cc-switch 的「Codex 接管」是开启状态。5.2 上游报 404如果本地路由通了但上游返回 404先确认当前供应商是不是来自预设。用内置预设时base URL 由 cc-switch 管理一般不会错。只有用自定义供应商时才需要检查 base URL它应该是服务根地址比如https://taotoken.net/api而不是带/chat/completions的完整接口路径。多写一段路径上游就会 404。5.3 /model 看不到模型保存供应商后重启 Codex。cc-switch 会生成模型目录文件并把路径写进配置但运行中的 Codex 不保证热加载。重启后如果还是看不到检查model_catalog_json指向的文件是否存在、内容是否是合法 JSON。5.4 开了路由但请求走错供应商确认三处状态一致Codex 标签下当前供应商是你想用的那个本地路由服务正在运行路由启用里 Codex 开关已打开。这三处只要有一处不对请求就可能落到别的供应商或者直接失败。5.5 API Key 无效或请求超时Key 无效先检查拼写、是否已激活、账户余额或配额是否够、有没有超过每日调用次数。超时的话检查网络稳定性避开高峰期重试减少上下文长度或者在配置里适当增加超时时间。上下文太长是终端 AI 编程场景里超时的常见原因让它一次读太多文件就容易卡。5.6 关于官方账号走本地路由不建议用官方 OpenAI 账号走本地路由。cc-switch 在本地路由接管模式下会阻止切到官方供应商因为用代理方式访问官方 API 可能带来账号风险。本地路由的定位就是第三方、聚合或协议转换场景官方账号直接连官方端点就好。6. 后续接入与长期使用建议三步配置跑通之后日常使用还有几个可以优化的地方。如果你只是偶尔验证模型、试试对话直接用模型对话入口就够了https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。想管理 Key、看用量去控制台和 API Keys 页。接入过程中遇到协议或配置问题接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面把 Responses 与 Chat 的转换细节写得更细。如果你打算把 Codex 当成长期编码助手每天在终端里用它读项目、改代码、跑 Agent 任务那 Coding Plan 会更合适https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。长期高频调用下按量计费和套餐的差别会很明显提前选好能省不少事。最后说一个我踩过的坑改完config.toml之后一定要把正在运行的 Codex 进程完全退出再重启。我有一次改完配置直接在当前会话里试怎么都不生效折腾了十几分钟才发现是旧进程还在用旧配置。终端工具不像 Web 应用会自动刷新配置重启是最可靠的动作。
