OminiApi 文档

Codex 配置

用 CC Switch 一键配置 Codex CLI / VS Code 插件 / Codex App 使用 OminiApi

OminiApi TeamCC Switch约 7 分钟

开始前请先完成 通用步骤:安装 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 中打开」弹窗
控制台「在 CC Switch 中打开」弹窗
控制台「在 CC Switch 中打开」弹窗

确认后浏览器会唤起 CC Switch,在弹出的导入确认中点击确认。地址已经自动填好(带 /v1),无需修改。

提示「已脱敏,需轮换」?

一键导入需要完整密钥,而完整密钥只在刚创建时保存在页面里(刷新后就没了)。遇到这个提示,新建一个密钥,或在密钥详情里「轮换密钥」后再导入。

方式二:在 CC Switch 里手动添加

打开 CC Switch,在顶部应用切换栏中选择 Codex。

点击右上角 +,选择「自定义配置」,填写:

字段填写内容
供应商名称OminiApi(随意)
请求地址https://omini.ominiapi.top/v1(必须带 /v1)
API Key你在控制台复制的 API 密钥
模型按上面「选哪个模型」填写,例如 gpt-6.1-sol

填好后点击右下角「添加」。

启用并验证

回到主界面,找到刚添加的 OminiApi 供应商,点击右侧「启用」,显示「使用中」即表示切换成功。

打开一个新的终端,运行:

codex

看到对话界面并能正常回复,就说明配置完成。用量可以在控制台 使用日志 里查看。

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 手动配置。

本页目录