本文为个人学习记录仅记录配置过程与排查经验不涉及任何商业推广。涉及的工具与模型均为各自厂商的产品请通过各自官方渠道获取自行甄别。目录一、准备工作二、安装软件三、获取 API Key以 Kimi 为例四、配置供应商五、直连 / 路由 / 聚合的区别六、常见问题一、准备工作Codex 默认只能使用 OpenAI 官方账号。想在 Codex 里调用国产大模型Kimi、DeepSeek、GLM 等需要通过一个本地配置管理工具改写 Codex 的配置文件把请求指向国产模型的 OpenAI 兼容接口。开始前需要准备准备项说明配置管理工具用于统一管理多个模型供应商的地址、Key 和连接方式本文以 CC Switch 为例Codex 客户端可在系统应用商店安装 ChatGPT 桌面版内含 Codex或使用命令行版需 Node.js 环境npm i -g openai/codex模型厂商账号任一家国产大模型开放平台账号API Key 与余额开放平台创建的 Key以及按量计费余额注意不是 App 会员关于网络环境配置管理工具和国产模型开放平台通常可以直接访问只有调用 OpenAI 官方服务时才需要相应的网络环境。二、安装软件2.1 安装配置管理工具在搜索引擎中搜索工具名称进入项目官网在下载页选择 Windows 版本安装要求 Windows 10 及以上。安装后保持默认设置即可。2.2 安装 Codex 客户端桌面版推荐新手打开系统应用商店Microsoft Store搜索chatgpt找到开发者工具分类下的 ChatGPT 应用并安装该应用包含 Codex 功能安装后即可在其中打开 Codex 界面命令行版可选安装 Node.js 后在终端执行npm i -g openai/codex至少运行一次以生成~/.codex/config.toml配置目录。三、获取 API Key以 Kimi 为例顺序提示先拿到 API Key再做供应商配置配置时会要求粘贴 Key。3.1 创建 API Key搜索引擎搜索「Kimi 开放平台」进入国内站控制台左侧找到「API Key 管理」点击「新建 API Key」输入自定义名称权限组保持默认default确定创建立即复制并妥善保存 Key完整字符串只显示一次关闭后无法再次查看注意部分厂商的国内站与海外站账号、Key 完全独立不能混用创建时注意站点地区。3.2 充值在开放平台的费用中心为账户充值按量计费余额各平台最低充值金额不同常见为 10 元起费用按实际 Token 用量从余额扣除部分厂商提供面向编程场景的包月套餐如 Coding Plan 类产品会生成专用 Key在配置工具中选择对应预设即可3.3 会员与 API Key 的区别这是新手最容易混淆的一点官网/App 月度会员API Key开放平台对应对象人网页/App 里的对话使用程序代码或第三方客户端调用计费方式按时间包月有功能上限不按 Token 计费按量计费按 Token 花钱无包月无限量能否用于 Codex不能直接使用编程专用订阅除外可以本教程用的就是它高峰期会员享优先按账户速率限额RPM/TPM执行四、配置供应商4.1 进入 Codex 页面并添加供应商打开配置管理工具左侧选择「Codex」顶部先选择「直连」标签三种模式的区别见第五节点击「添加供应商」4.2 选择供应商预设在添加界面通过搜索栏搜索或在列表中找到目标厂商优先使用内置预设Base URL、模型列表和协议格式都会自动填好避免手写地址出错。4.3 填入 API Key 并选择模型在 API Key 输入框粘贴第三节获取的 Key点击「选择模型」勾选需要在 Codex 中使用的模型「思考等级Reasoning Effort」建议把该模型支持的档位全部勾选——这样在 Codex 内才能在「轻度 ~ Ultra」之间自由切换未勾选的档位在 Codex 中不可选。勾选数量不影响模型本身的能力三种模式下添加供应商的操作几乎完全相同。4.4 选择连接模式只用一家模型保持「直连」在供应商卡片上启用即可想在 Codex 内随时切换多家模型切到「聚合」标签把多家厂商加入列表Add设置一个默认供应商执行切换需要协议转换或故障自动转移使用「路由」并在设置中打开「路由总开关」和「Codex」开关4.5 重启 CodexCodex 只在启动时读取一次模型列表配置后必须重启才能看到新模型桌面版完全退出应用进程不是关闭窗口再重新打开命令行版在配置工具中执行「Restart Codex daemon」仅重开终端无效4.6 验证是否成功打开 Codex在模型选择器/model中确认能看到已配置的模型和思考等级发送一条测试消息能正常回复即成功聚合模式下默认供应商的模型不带前缀其他厂商模型带ccs-前缀配置原理改了什么配置工具实际修改的是~/.codex/config.toml——直连模式把base_url指向供应商路由模式指向本机地址默认127.0.0.1:15721。真实 Key 保存在配置工具中路由转发时才注入Codex 配置文件里不会出现明文 Key。五、直连 / 路由 / 聚合的区别直连 Direct路由 Routing聚合 Aggregation请求路径Codex 直接连接供应商先经过本机服务转发一次只走一家经本机服务按/model所选模型分发到多家切换供应商配置工具中切换需重启 Codex配置工具中切换无需重启直接在 Codex 的/model中切换无需重启协议转换不支持支持Responses / Chat / Anthropic 互转支持故障转移无支持挂了自动切备用厂商无请求日志/用量统计无有有管理工具需常驻否是是适用范围所有客户端所有客户端仅 Codex / Claude Code选型建议固定用一家、追求稳定省事 → 直连一家主力、担心限流或宕机、需要自动切换 → 路由想在一个模型列表里混用多家模型做对比 → 聚合六、常见问题Q1提示「429 请求过多 / 服务器繁忙重试 5/5 失败」429 表示触发速率限制或额度用尽按顺序排查登录开放平台后台检查余额、今日用量、速率限额Codex 是智能体一次任务会高频发请求容易打满免费额度等待 5~10 分钟后重试避开晚高峰20:00~23:00充值余额或购买编程套餐提高 RPM/TPM 限额聚合模式下切换到另一家供应商临时顶替若使用第三方中转共享 Key建议更换为官方平台直连 KeyQ2报 404、找不到/responses供应商是 Chat 协议而未启用路由。确认供应商卡片是否有「Needs Routing需要路由」角标按第 4.4 节开启路由新版 DeepSeek、Kimi 预设为原生直连无需此操作。Q3/model里看不到配置的模型没有重启 Codex。桌面版完全退出重开命令行版重启 daemon。Q4配置好后请求跑到了别的厂商检查三处是否一致当前启用的供应商、本机路由总开关与 Codex 开关、Codex 中选择的模型。Q5API Key 泄露了怎么办立即去开放平台删除该 Key 并重新生成不要把 Key 硬编码进代码后提交到 Git应放在环境变量或配置文件中。如果觉得有用的话可以点赞收藏哦