安装 Codex CLI（Mac/Linux）
本指南将帮助你在 macOS 或 Linux 系统上安装和配置 Codex CLI。
第一步：安装 Codex CLI
根据你的系统选择合适的安装方法：
方法一：npm 安装（推荐）
# 全局安装 Codex CLI
npm install -g @openai/codex
# 验证安装
codex --version方法二：Homebrew 安装（macOS）
# 更新 Homebrew
brew update
# 安装 Codex CLI
brew install codex
# 验证安装
codex --version方法三：直接下载（所有平台）
# 下载最新版本
curl -sSL https://releases.openai.com/codex/install.sh | bash
# 添加到 PATH
echo 'export PATH="$HOME/.codex/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc第二步：配置 Codex 环境变量
方式一：使用 aihezu 一键配置（推荐）
无需手写配置文件，直接运行：
# 方式 1: 交互式安装（推荐，选择 codex 选项）
npx aihezu install
# 方式 2: 直接指定服务
npx aihezu install codex执行后会提示输入 API Key 和 API URL（默认 https://cc.aihezu.dev/openai），并选择模型（默认 gpt-5-codex，可选 gpt-5.2、gpt-5.2-codex、gpt-5.3-codex 或自定义）和推理能力（high 或 xhigh），工具会自动：
- 写入
~/.codex/config.toml（设置model_provider、model、base_url等） - 写入
~/.codex/auth.json，将你的 API Key 存入OPENAI_API_KEY字段
企业用户可以在交互提示中输入独立域名（如 your-org.aihezu.dev），工具会自动补全为 https://your-org.aihezu.dev/openai。也可以通过 --api/--model 预填。Codex 模式不修改 hosts，通常不需要 sudo。如遇权限问题再加 sudo 运行。
如需仅修改配置（不清理缓存），可以使用 config 命令：
npx aihezu config codex
# 预填参数（可选）
npx aihezu config codex --api your-org.aihezu.dev --key sk-xxx --model gpt-5-codex方式二：手动配置（备用）
- 配置 Codex 配置文件
在 ~/.codex/config.toml 文件开头添加以下配置：
model_provider = "aihezu"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.aihezu]
name = "aihezu"
base_url = "https://cc.aihezu.dev/openai"
wire_api = "responses"
requires_openai_auth = true可选模型：
gpt-5-codex（默认）、gpt-5.2、gpt-5.2-codex、gpt-5.3-codex。推理能力model_reasoning_effort可选high（默认）或xhigh（Extra High）。
- 配置 API 密钥
在 ~/.codex/auth.json 文件中配置 API 密钥：
{
"OPENAI_API_KEY": "你的API密钥"
}注意：请将
你的API密钥替换为你实际的 API 密钥。Codex 优先读取~/.codex/auth.json中的OPENAI_API_KEY，如果配置文件不存在，才会读取环境变量。
故障排除
如果使用 gpt-5-codex 模型时报错如下：
{
"error": {
"message": "Unsupported value: 'low' is not supported with the 'gpt-5-codex' model. Supported values are: 'medium'.",
"type": "invalid_request_error",
"param": "text.verbosity",
"code": "unsupported_value"
}
}请在 ~/.codex/config.toml 中增加：
model_verbosity = "medium"验证安装
配置完成后，你可以通过以下命令验证 Codex CLI 是否正确安装和配置：
npx aihezu check codex确认配置无误后，再检查 CLI 版本：
codex --version下一步
安装和配置完成后，你可以开始使用 Codex CLI 了。