Codex
手动配置 Codex CLI / VS Code 插件 / Codex App 使用 OminiApi
安装 Codex
npm i -g @openai/codex@latest三种形态共用同一套配置文件，下面的步骤对它们都适用。
配置目录里的三个文件
| 文件 | 作用 |
|---|---|
config.toml | 核心配置：请求地址、模型、MCP 等 |
auth.json | 存放 API Key |
AGENTS.md | 可选，全局提示词 |
刚安装时这些文件可能都不存在，需要手动新建。
配置步骤
打开配置目录
按 Win + R，输入下面的路径后回车：
%USERPROFILE%\.codex编辑 config.toml
model_provider = "omini"
model = "gpt-6.1-sol"
model_reasoning_effort = "high"
model_verbosity = "high"
disable_response_storage = true
[model_providers.omini]
name = "OminiApi"
base_url = "https://omini.ominiapi.top/v1"
wire_api = "responses"
requires_openai_auth = truebase_url必须以/v1结尾；model_provider要和[model_providers.xxx]里的名字一致；model_reasoning_effort可选low/medium/high/xhigh，越高越慢、越费 Token；- Windows 用户可以再加一行
windows_wsl_setup_acknowledged = true，跳过 WSL 提示。
编辑 auth.json
{
"OPENAI_API_KEY": "你的 API Key"
}把 你的 API Key 换成在控制台 API 密钥 页面创建的 Key。之前用 ChatGPT 账号登录过的话，auth.json 里会有旧的登录信息，整体替换成上面的内容。
可用模型
model 填平台上架的 GPT 系列模型名：
| 模型 | 说明 |
|---|---|
gpt-6.1-sol、gpt-6、gpt-6-sol、gpt-6-astra、gpt-6-luna | GPT-6 系列 |
gpt-5.6、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna | GPT-5.6 系列 |
gpt-5.5 | GPT-5.5 |
gpt-5.3-codex-spark | Codex 专用轻量模型 |
deepseek-v4-pro、kimi-k3、gemini-3.8-flash 等支持 Responses 接口的模型也可以在 Codex 里使用。
你的密钥能用哪些模型取决于它选的分组，以 模型广场 为准。填了分组里没有的模型会返回 No eligible upstream supports the requested interface or model。
切换模型
CLI 启动后尽量不要在会话中切换模型。想换模型时，修改 config.toml 的 model 后重启，或者启动时指定：
codex -m gpt-5.5全局提示词 AGENTS.md
在配置目录新建 AGENTS.md，写入你希望 Codex 一直遵守的规则，例如：
# Codex 全局工作指南
## 回答风格
- 回答必须使用中文
- 总结、计划、任务等长内容，先整理逻辑再用表格输出保存后重启 Codex 生效。
遇到问题
401、Connection failed、乱码、账单里出现别的模型等问题，见 Codex 常见问题。