1. 文档
  2. 编程工具
  3. Codex CLI

在 Codex CLI 中使用 Airoutly

在 Codex 的 config.toml 里把 Airoutly 加为模型提供方。Codex 使用 Responses 接口,请选择模型页上标有 Resp 的模型。

Base URL
https://api.airoutly.com/v1
Key 变量
AIROUTLY_API_KEY
可用模型
模型页上标有 Resp 的模型

1. 安装 Codex CLI

npm install -g @openai/codex

2. 在 config.toml 中添加 Airoutly

先把 Key 放进环境变量 AIROUTLY_API_KEY,再在 ~/.codex/config.toml(或 CODEX_HOME 指定的目录)里加上:

config.toml
model = "gpt-5"
model_provider = "airoutly"

[model_providers.airoutly]
name = "Airoutly"
base_url = "https://api.airoutly.com/v1"
env_key = "AIROUTLY_API_KEY"
wire_api = "responses"
保留默认沙箱这份配置只改变 Codex 的请求地址,沙箱和审批设置请保持默认。

3. 选择模型

config.toml 里的 model 是默认模型;单次运行可以用 codex --model gpt-5-mini。模型必须在模型页上标有 Resp。

4. 验证是否生效

运行 codex exec "say hi",几秒内会收到回复,控制台的用量日志里也会出现这次请求。

常见问题

401 或提示缺少 API Key

Codex 从 env_key 指定的变量读取 Key。确认运行 codex 的终端里已经导出了 AIROUTLY_API_KEY。

503:model_not_found

这个模型在 Airoutly 上不支持 Responses 接口。请选择模型页上标有 Resp 的模型。

[profiles] 配置不生效

新版 Codex 不再读取 config.toml 里的 profile。把每个 profile 放进单独的 ~/.codex/<name>.config.toml,再用 codex –profile <name> 切换。