Codex 配置

Codex 是 OpenAI 官方的命令行编程助手，本节介绍如何接入 HuiLiu API。

前置条件

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

配置 Codex

Codex 的配置文件位于 ~/.codex/config.toml（Linux/macOS）或 %USERPROFILE%\.codex\config.toml（Windows）。

创建配置文件

Linux / macOS

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows PowerShell

New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.codex
notepad $env:USERPROFILE\.codex\config.toml

写入配置

model_provider = "huiliu"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true

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

设置 API Key

Linux / macOS

echo 'export OPENAI_API_KEY="sk-你的令牌"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的令牌", "User")

启动 Codex

codex

推荐模型

模型	说明
gpt-5-codex	官方推荐，专为 Codex 优化
o3	顶级推理
gpt-4o	通用多模态

推理强度

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

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

wire_api 必须正确

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

如果你使用的是旧版 Chat Completions 接口，将 wire_api 改为 chat，但功能会受限（不支持工具调用等）。

验证配置

codex
# 输入：帮我写一个 Python 快速排序

如果正常返回代码，说明配置成功。

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