Codex 配置

Codex 是 OpenAI 官方的命令行编程助手。本节介绍如何把它接入汇流 API。

前置条件

1. 已完成 环境检查 并安装好 Codex
2. 已在控制台创建 Codex 分组 的令牌

认识配置目录

Codex 的配置都放在用户目录下的 .codex 文件夹里，我们主要用到这几个文件：

• config.toml：Codex 的核心配置文件，中转服务、MCP 等都在这里配置
• auth.json：填入你在中转站获取的 API Key 密钥
• AGENTS.md：设置 Codex 全局工作的提示词（可选）

文件可能需要手动创建

很多人刚安装后这几个文件并不存在，需要你自己在 .codex 目录里手动创建 config.toml 和 auth.json 两个文件再写入内容。

配置步骤

Windows

1. 按下 Win + R，输入下面的路径后回车，打开 Codex 配置目录：

%userprofile%\.codex

2. 目录里可能已经有一些文件，我们只关心其中的 config.toml 和 auth.json（没有就手动新建）：

3. 配置 config.toml，将以下内容写入并保存：

disable_response_storage = true
model = "gpt-5.2"
model_provider = "huiliu"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.huiliu]
name = "HuiLiu API"
base_url = "https://www.huiliuapi.com/v1"
wire_api = "responses"
requires_openai_auth = true

4. 配置 auth.json，将以下内容写入文件：

{
  "OPENAI_API_KEY": "xxx"
}

在汇流 API 控制台「令牌管理」中创建一个 Codex 分组 的令牌，点击复制按钮，把密钥替换到上面的 xxx 部分后保存。

5. 测试对话，在终端执行下面的命令，出现对话界面后随便发一句话，能收到回复就说明配置成功：

codex

macOS

1. 在访达中按下 Command + Shift + G，输入下面的路径并回车，打开 Codex 配置目录：

~/.codex

2. 目录里可能已经有一些文件，我们只关心其中的 config.toml 和 auth.json（没有就手动新建）：

3. 配置 config.toml，将以下内容写入并保存：

model_provider = "huiliu"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.huiliu]
name = "HuiLiu API"
base_url = "https://www.huiliuapi.com/v1"
wire_api = "responses"
requires_openai_auth = true

4. 配置 auth.json，将以下内容写入文件：

{
  "OPENAI_API_KEY": "xxx"
}

在汇流 API 控制台「令牌管理」中创建一个 Codex 分组 的令牌，点击复制按钮，把密钥替换到上面的 xxx 部分后保存。

5. 测试对话，在终端执行下面的命令，出现对话界面并能收到回复即表示配置成功：

codex

常见注意事项

wire_api 必须是 responses

wire_api = "responses" 是 OpenAI 新版 Responses API，必须配置，否则会出现 404 Not Found。

密钥填错会报 401

如果启动后提示 401 Invalid token，请检查 auth.json 中的密钥是否完整复制、是否选了 Codex 分组 的令牌。修改 auth.json 后需要重新启动 codex。

推理强度

Codex 支持设置推理强度（reasoning effort）：

model_reasoning_effort = "low"      # 低，快速
model_reasoning_effort = "medium"   # 中
model_reasoning_effort = "high"     # 高，深度思考

如果遇到模型一直转圈、迟迟不返回，可以把强度降到 medium 或 low。

更多排错请见 Codex 常见问题。