Codex CLI

Codex 接入需要当前渠道支持 Responses API 及所用模型的工具调用。先在 Ontoway 确认可用模型，再配置自定义供应商。

1. 设置密钥环境变量

macOS / Linux

export ONTOWAY_API_KEY="替换为你的 Ontoway API Key"

Windows PowerShell

$env:ONTOWAY_API_KEY = "替换为你的 Ontoway API Key"

2. 配置供应商

在用户级 ~/.codex/config.toml 中合并以下配置。Windows 通常位于 %USERPROFILE%\.codex\config.toml；设置了 CODEX_HOME 时以实际配置目录为准。修改前备份原文件，避免重复定义同一个 TOML 字段。

model = "替换为可用的模型 ID"
model_provider = "ontoway"

[model_providers.ontoway]
name = "Ontoway"
base_url = "https://api.ontoway.ai/v1"
env_key = "ONTOWAY_API_KEY"
wire_api = "responses"

env_key 填的是环境变量名，真实密钥不写入这份 TOML。模型必须支持该协议，不能仅凭名称出现在列表中就判断所有代理功能均兼容。

3. 启动并检查

在设置环境变量的同一个终端执行 codex，发送一个简短请求，并检查 Ontoway 使用日志。若修改后仍访问旧服务，检查当前供应商、环境变量以及启动终端是否一致。

安装与配置字段以 OpenAI 官方 Codex 文档和配置参考为准。