Codex 配置

规划中

Codex 使用 OpenAI Responses API，适合在终端中完成代码阅读、修改和验证。

官方下载与安装

Codex CLI 官方文档

OpenAI Codex GitHub

如果本机已安装 Node.js，可使用：

安装完成后运行 codex，确认命令可以启动。

配置文件

macOS / Linux：~/.codex/config.toml

Windows：%USERPROFILE%.codex\config.toml

认证文件：同目录下的 auth.json

config.toml

model_provider = "OpenAI"
model = "控制台中的模型名"
review_model = "控制台中的模型名"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"

[model_providers.OpenAI]
name = "私库云"
base_url = "你的 Base URL/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

auth.json

{
  "OPENAI_API_KEY": "你的 API Key"
}

如果控制台提供“复制 Codex 配置”，优先使用控制台生成的最新字段。

首次测试

保存配置文件。

完全退出已有 Codex 进程和终端。

重新运行 codex。

发送一个只读、短任务。

在控制台查看请求记录。

常见问题

命令不存在：检查 Node.js、npm 和全局安装路径。

401：检查 auth.json 是否为合法 JSON。

404：检查 Base URL 是否重复添加 /v1。

配置不生效：确认文件名不是 config.toml.txt，并重启 Codex。

模型不可用：使用控制台当前显示的模型名。

完成标志

工具已经安装，配置文件或环境变量已保存，工具完成重启，并且一条短消息返回成功。

下一步

查看余额和请求记录：打开账户与用量。

仍然失败：打开常见问题，根据状态码排查。

需要更底层的接口说明：打开开发者 API。

官方下载与安装#

配置文件#

config.toml#

auth.json#

首次测试#

常见问题#

完成标志#

下一步#