在 Codex 中使用 onomeo

Codex 是 OpenAI 的终端编程智能体。按以下六步将本站写入它的配置文件后，即可使用本站的模型。

OpenAI 的终端编程智能体。

需要填写的内容

兼容 OpenAI

以下信息适用于任何兼容 OpenAI 的工具。

Base URL

https://onomeo.com/v1

密钥

模型

尚无密钥时，请先在「我的」页创建，返回本页后下方字段将自动填入。前往「我的」页

操作步骤

1
安装 Codex
Windows：按键盘上的 Win 键，输入 PowerShell 后按回车。macOS：打开「终端」。粘贴下方命令后按回车。
```
npm install -g @openai/codex
```
提示找不到 npm 时，请先在 nodejs.org 安装 Node.js（LTS 版本），然后关闭 PowerShell 并重新打开。
2
写入配置
点击「复制」，粘贴到同一窗口后按回车。该命令将本站的地址、你的密钥和模型 auto 写入 Codex 的配置文件。
```
$f = "$HOME\.codex\config.toml"
if (-not (Test-Path $f)) {
New-Item -ItemType Directory -Force -Path (Split-Path $f) | Out-Null
[IO.File]::WriteAllText($f, @'
model_provider = "onomeo"
model = "auto"

[model_providers.onomeo]
name = "onomeo"
base_url = "https://onomeo.com/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"
'@)
Write-Host "已保存：$f" -ForegroundColor Green
} else { Write-Host "已有配置文件，未改动：$f" -ForegroundColor Yellow }
```
命令中的 YOUR_API_KEY 需替换为你的密钥。在本浏览器创建密钥后，此处将自动填入。
最后一行出现绿色的「已保存」，表示配置已写入。如出现黄色的「已有配置文件，未改动」，说明此前已配置过 Codex：请用记事本打开提示中的文件，把上方方框里的内容添加到文件末尾（开头的 model_provider 和 model 两行替换原有的同名两行）。
3
启动 Codex
先进入项目文件夹（例如输入 cd D:\my-project 后按回车），再运行下方命令。首次启动会问是否信任该文件夹（Do you trust the contents of this directory?）：按回车选择 Yes, continue。
```
codex
```
选择沙箱方式
接着会问沙箱方式（Set up the Codex agent sandbox）：按一次键盘上的 ↓ 键移动到 Use non-admin sandbox，再按回车，无需管理员权限。此时上方方框中显示 model: auto，表示配置已生效。
方框中显示 model: auto；沙箱选第二项即可。
以管理员身份运行 PowerShell 的，可选第一项，更安全。
发起任务
输入任务内容后按回车。写入文件或运行命令前，Codex 会先询问 Would you like to run the following command?：按回车选择 Yes, proceed。
每条命令运行前都会这样询问一次，按回车即可。
发出第一句后出现的「Model metadata for auto not found」一行，是 Codex 不认识 auto 这个名称的提醒，不影响使用。
查看结果
命令运行完成后，Codex 会汇报结果，底部一行显示所用的模型 auto。
示例任务为新建 hello.py：Codex 写入文件、运行后汇报了输出，底部显示模型 auto。
每一步计 1 次调用，较长的一步按长度折算为多次。2026 年 10 月 9 日使用 Codex 0.153.4 实测：上图任务使用 auto 计 4 次，不扣费。

连接失败时

地址末尾保留 /v1，其后无需添加任何内容；wire_api 必须填写 responses，新版 Codex 不再支持 chat。
如需换用模型页上的其他模型，修改配置文件中 model = "auto" 一行，然后重新启动 Codex。
编写代码时，整份文件将随问题一并发送：免费模型不扣费，但较长的请求按长度折算为多次调用；Claude、GPT 等大模型按用量计费，余额消耗较快。
回答中出现「onomeo could not run this request (bad_key)」：密钥无效，请修改配置文件中 experimental_bearer_token 一行的内容。括号中为 not_enough_credit：余额不足。Claude、GPT 等大模型按用量计费，可在价格页充值或换用免费模型。
若已在「我的服务商」页接入自己的密钥，将 model 一行改为 my/服务商/模型名称，即可改由该服务商作答，其余设置不变，本站不另收费。

Codex 官方文档

需要填写的内容

兼容 OpenAI

操作步骤

安装 Codex

写入配置

启动 Codex

选择沙箱方式

发起任务

查看结果

连接失败时