Codex CLI

本页介绍如何在命令行安装 Codex CLI，并通过 AIRouter 中转站接入可用模型。

一、安装 Codex CLI

Codex CLI 需要 Node.js 环境。先确认本机可以运行 npm：

node -v
npm -v

安装 Codex CLI：

npm install -g @openai/codex@latest

确认安装成功：

codex --version

如果系统提示找不到 codex，请检查 Node.js 的全局 bin 目录是否已经加入 PATH。

二、准备 AIRouter API Key

登录 AIRouter 控制台：https://aigc.aochengcloud.com。
进入「API Keys」页面。
创建或复制一个可用 API Key。
确认账号余额、模型权限和 API Key 状态正常。

注意

API Key 是调用凭证，不要提交到 Git 仓库，也不要发到公开聊天记录。

三、找到 Codex 配置目录

Codex CLI 使用用户目录下的 .codex 配置。

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

需要配置两个文件：

文件	作用
`auth.json`	保存 API Key
`config.toml`	配置模型、API 地址、网络权限和推理强度

如果目录不存在，可以手动创建。

四、配置 auth.json

在 .codex 目录下创建或编辑 auth.json：

{
  "OPENAI_API_KEY": "你的中转站 API Key"
}

填写时注意：

只替换引号中的 Key。
Key 前后不要有空格或换行。
如果复制后调用失败，优先重新复制一次 Key。

五、配置 config.toml

在 .codex 目录下创建或编辑 config.toml：

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
network_access = "enabled"

[model_providers.OpenAI]
base_url = "https://aigc.aochengcloud.com/v1"
requires_openai_auth = true

如果使用自己的中转站域名，把 base_url 改为：

base_url = "https://你的中转站域名/v1"

关键点

base_url 末尾必须带 /v1。如果写成 https://你的中转站域名，Codex CLI 通常会请求失败。

六、启动 Codex CLI

进入任意项目目录后运行：

codex

也可以直接带上任务：

codex "读取项目结构，并总结这个项目的技术栈"

首次验证建议使用简单任务，例如：

请读取当前目录文件结构，并用中文总结项目用途。

七、验证是否接入成功

运行 Codex CLI 后，打开 AIRouter「使用日志」：

https://aigc.aochengcloud.com/usage-logs

重点看三项：

检查项	说明
是否有请求进入	有请求说明本地配置已经指向中转站
请求状态	成功或失败都能帮助判断问题位置
实际模型	确认是否使用了 `config.toml` 中配置的模型

如果日志中出现成功请求，说明 Codex CLI 已经通过 AIRouter 中转站接入。

八、常见问题排查

仍然走官方地址

检查：

检查项	处理
配置文件位置	确认修改的是当前用户目录下的 `.codex`
`model_provider`	要和 `[model_providers.OpenAI]` 对应
Codex 进程	关闭当前 Codex CLI 后重新运行
环境变量	检查是否有其他 OpenAI 配置覆盖本地文件

认证失败

常见原因：

auth.json 中的 API Key 写错。
API Key 已删除、禁用或过期。
当前账号余额不足。
API Key 没有目标模型权限。
requires_openai_auth 没有设置为 true。

请求超时

重点检查：

检查项	说明
域名解析	本机是否能解析中转站域名
网络代理	代理或公司网络是否拦截请求
SSL 证书	中转站 HTTPS 证书是否有效
反向代理	Nginx 是否正确转发 `/v1`
使用日志	AIRouter 是否收到请求

如果 AIRouter 使用日志没有任何记录，通常说明请求没有到达中转站，应先排查本机网络和 Base URL。

模型不存在或无权限

处理步骤：

到 AIRouter 控制台「模型」页面确认可用模型 ID。
修改 config.toml 中的 model 和 review_model。
确认 API Key 没有限制该模型。
重新运行 codex。