Codex

OpenAI Codex CLI 是 OpenAI 官方的命令行 AI 编程工具，支持通过配置文件接入自定义 API。

安装

需要 Node.js 22+。

bash

npm install -g @openai/codex
# 验证安装
codex --version

macOS 也可通过 Homebrew 安装：

bash

brew install --cask codex

配置

第一步：创建配置文件

在用户目录创建 ~/.codex/config.toml（Windows 路径：C:\Users\用户名\.codex\config.toml）：

toml

[model_providers.aigateway]
name = "aigateway"
base_url = "https://aigateway.link/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 5
stream_idle_timeout_ms = 300000

[profiles.aigateway]
model_provider = "aigateway"
model = "gpt-latest"
model_reasoning_effort = "high"

必须设置 wire_api

wire_api = "responses" 是必填项，Codex 使用 OpenAI Responses API 协议，缺少此项将无法正常工作。

配置说明

base_url 必须以 /v1 结尾，Codex 会在其后自动拼接 /responses。
env_key 指定从哪个环境变量读取 API Key，下一步的 OPENAI_API_KEY 即与此对应。
model_reasoning_effort 可选 low / medium / high，控制推理深度。
request_max_retries / stream_max_retries / stream_idle_timeout_ms 为重试与超时参数，弱网环境下可适当调大。

第二步：设置 API Key

方式一：环境变量（推荐）

bash

# Mac / Linux
export OPENAI_API_KEY=sk-你的令牌

# Windows CMD
set OPENAI_API_KEY=sk-你的令牌

# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的令牌"

方式二：auth.json 文件

找到 ~/.codex/ 目录下的 auth.json 文件：

auth.json 文件位置

填入 API Key：

json

{"OPENAI_API_KEY": "sk-你的令牌"}

auth.json 内容

启动

bash

codex --profile aigateway

模型别名	说明
`gpt-latest`	始终指向最新一代 GPT，推荐默认使用
`gpt-5`	GPT-5，综合能力强
`gpt-mini-latest`	轻量版，速度快、更省

Codex ​

安装 ​

配置 ​

第一步：创建配置文件 ​

第二步：设置 API Key ​

启动 ​

推荐模型 ​

Codex

安装

配置

第一步：创建配置文件

第二步：设置 API Key

启动

推荐模型