OpenAI Codex CLI

Codex CLI 是 OpenAI 官方的命令行 AI 编程助手(2025 年发布,跟 Claude Code 对位)。

1. 安装

# npm 全局
npm install -g @openai/codex

# 或 curl 一键 (Mac / Linux)
curl -fsSL https://codex.openai.com/install.sh | bash

验证:

codex --version

2. 配置文件

需要建两个文件:

文件macOS / LinuxWindows
主配置~/.codex/config.toml%USERPROFILE%\.codex\config.toml
凭证~/.codex/auth.json%USERPROFILE%\.codex\auth.json

2.1 config.toml 内容

# Codex CLI 主配置
disable_response_storage = true
model = "gpt-5.5"
model_provider = "miloapi"
model_reasoning_effort = "high"
model_verbosity = "medium"

[features]
web_search_request = true

[model_providers.miloapi]
name = "miloapi"
base_url = "https://www.miloapi.com/v1"
requires_openai_auth = true
wire_api = "responses"

⚠️ Codex CLI 用的 base URL 必须带 /v1,跟 Claude Code 不同。

2.2 auth.json 内容

{
  "OPENAI_API_KEY": "sk-你的key"
}

⚠️ Key 选 GPT 池(platform=openai),Claude 池的 Key 用不了。

3. 验证

codex

出现交互界面就 OK。

4. 故障排查

现象处理
auth.json not found文件路径不对 / 没创建,手动建目录和文件
model not foundconfig.toml 里 model = "..." 填了不支持的模型,改成 gpt-5.5 / gpt-5.4
工具调用循环model_reasoning_effort 设太低,改成 "high" 或 "xhigh"
connection refused检查代理,Codex 默认不读 HTTP_PROXY,可能要单独设置
Windows 找不到 .codex 目录mkdir %USERPROFILE%\.codex 手动创建

5. 关键参数对照

model 字段填什么实际调用
gpt-5.5最新版,推荐
gpt-5.4略旧但稳
gpt-4o自动映射到 gpt-5.5
o1-pro自动映射到 gpt-5.5

完整支持的模型见 API 文档。