Codex 配置
用 CC Switch 一键配置 Codex CLI / VS Code 插件 / Codex App 使用 OminiApi
开始前请先完成 通用步骤:安装 CC Switch,并确认 Codex 已经装好。
选哪个模型
Codex 走的是 OpenAI Responses 接口(/v1/responses),推荐:
| 场景 | 推荐模型 |
|---|---|
| 日常写代码(默认) | gpt-6.1-sol |
| 追求效果 | gpt-6、gpt-6-sol、gpt-6-astra |
| 更快、更省 | gpt-6-luna、gpt-5.6-luna、gpt-5.3-codex-spark |
其他可选:gpt-5.6、gpt-5.6-sol、gpt-5.6-terra、gpt-5.5。
除了 GPT,deepseek-v4-pro、kimi-k3、gemini-3.8-flash 等模型也支持 Responses 接口,可以直接填进 Codex 里用。Claude 系列模型不支持 Responses 接口,不能在 Codex 里用,请改用 Claude Code。
能用哪些模型取决于你密钥的分组,以控制台 模型广场 和导入弹窗里的下拉列表为准。
方式一:从控制台一键导入(推荐)
在控制台「API 密钥」页面新建一个密钥,见 API 密钥。
在密钥列表中,对刚创建的密钥点击「在 CC Switch 中打开」。
工具选择 Codex,「主模型」选一个上面推荐的 GPT 模型。

确认后浏览器会唤起 CC Switch,在弹出的导入确认中点击确认。地址已经自动填好(带 /v1),无需修改。
提示「已脱敏,需轮换」?
一键导入需要完整密钥,而完整密钥只在刚创建时保存在页面里(刷新后就没了)。遇到这个提示,新建一个密钥,或在密钥详情里「轮换密钥」后再导入。
方式二:在 CC Switch 里手动添加
打开 CC Switch,在顶部应用切换栏中选择 Codex。
点击右上角 +,选择「自定义配置」,填写:
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | OminiApi(随意) |
| 请求地址 | https://omini.ominiapi.top/v1(必须带 /v1) |
| API Key | 你在控制台复制的 API 密钥 |
| 模型 | 按上面「选哪个模型」填写,例如 gpt-6.1-sol |
填好后点击右下角「添加」。
启用并验证
回到主界面,找到刚添加的 OminiApi 供应商,点击右侧「启用」,显示「使用中」即表示切换成功。
VS Code 插件和 Codex App
Codex CLI、VS Code 插件、Codex App 共用同一套配置(~/.codex/config.toml 和 auth.json),CC Switch 切换后三者都会生效。
- 切换供应商后要完全重启:只关闭窗口,应用可能还在后台运行。请从菜单选择退出(或按
Ctrl + Q/Cmd + Q),再重新打开。 - App 仍然显示登录页:先完全退出,确认 Codex CLI 在终端里能正常对话,再重新打开。还是不行的话,点击「使用其他方式登录」,把 OminiApi 的 API 密钥粘贴到「OpenAI API 密钥」,点击继续。
常见问题
- 返回 401:检查 API Key 是否完整;之前用 ChatGPT 账号登录过的话,
auth.json里可能还留着旧的登录信息,在 CC Switch 里重新启用一次 OminiApi 供应商即可覆盖。 - 返回
No eligible upstream supports the requested interface or model:这个模型在你密钥的分组里不支持 Responses 接口,换一个 GPT 模型或在 API 密钥 里调整分组。 - 更多问题见 Codex 手动配置。