通过 OmwAI 中转服务快速接入Codex

通过 OmwAI 中转服务快速接入，支持 config.toml 与 auth.json 配置方式。

Codex CLI 是 OpenAI 推出的终端 AI 编程助手，支持在本地直接运行编码代理，通过自然语言指令生成代码、编辑文件和执行命令。

官方项目地址：https://github.com/openai/codex

准备工作

开始配置之前，请确保：

已安装 Node.js（推荐 v18+）
已全局安装 Codex CLI：

bash 复制代码

npm install -g @openai/codex

已在 OmwAI 后台创建一个 Codex 专用 的 API 令牌（建议在令牌分组中选择 codex 分组，以便后续管理和限速）
记下你的 OmwAI 站点地址（例如 https://www.omwai.xyz）

配置目录说明

Codex CLI 的配置文件存放在用户目录下的 .codex 文件夹中：

系统	配置目录路径
Windows	`%userprofile%\.codex\`
macOS	`~/.codex/`
Linux	`~/.codex/`

该目录下主要有三个文件：

文件	用途
`config.toml`	核心配置文件，配置中转服务地址、模型等
`auth.json`	存放 API Key 密钥
`AGENTS.md`	设置 Codex CLI 全局工作提示词（可选）

如果目录中缺少这些文件，请手动创建。

配置 config.toml

创建或编辑 config.toml 文件，写入以下配置：

toml 复制代码

disable_response_storage = true
model = "gpt-5.2"
model_provider = "omwai"
model_reasoning_effort = "xhigh"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.omwai]
base_url = "https://www.omwai.com"
name = "omwai"
requires_openai_auth = true
wire_api = "responses"

配置项说明：

配置项	说明
`model`	使用的模型名称，根据 OmwAI 支持的最新模型填写
`model_provider`	自定义的供应商名称，需与下方 `[model_providers.xxx]` 对应
`base_url`	OmwAI 站点地址 + `/v1` 路径
`requires_openai_auth`	设为 `true`，表示使用 OpenAI 兼容的认证方式
`wire_api`	设为 `"responses"`，使用 OpenAI Responses API
`web_search_request`	设为 `true` 开启联网搜索能力
`disable_response_storage`	设为 `true` 禁止本地存储响应历史

配置 auth.json

创建或编辑 auth.json 文件，填入从 OmwAI 后台复制的 API Key：

json 复制代码

{
  "OPENAI_API_KEY": "sk-你的API令牌"
}

将 sk-你的API令牌 替换为你在 OmwAI 后台创建的令牌值。

建议为 Codex CLI 单独创建一个分组令牌，方便后续在 OmwAI 后台查看用量和进行速率限制。

验证配置

完成以上两步配置后，在终端中运行以下命令测试：

bash 复制代码

codex

如果 Codex CLI 能够正常启动并响应你的对话，说明配置成功。

首次启动时，Codex CLI 会询问文件读写权限，建议选择"允许 Codex 直接修改文件"以获得最佳体验。

切换模型

在 Codex CLI 运行期间，输入 /model 可以查看和切换可用模型列表。

常见问题

检查 `base_url` 是否填写正确，确保末尾包含 `/v1` 路径，并且 OmwAI 站点可以正常访问。确认 `auth.json` 中的 API Key 是否有效，可在 OmwAI 后台重新创建令牌后重试。如果所选模型不可用，请在 OmwAI 后台确认该模型渠道状态正常，或使用 `/model` 命令切换其他模型。