安装 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），工具会自动：
- 写入
~/.codex/config.toml（设置base_url和env_key=AIHEZU_OAI_KEY） - 写入
~/.codex/auth.json，将OPENAI_API_KEY设为null并填入你的AIHEZU_OAI_KEY
企业用户可以在交互提示中输入独立域名（如 your-org.aihezu.dev），工具会自动补全为 https://your-org.aihezu.dev/openai。Codex 模式不修改 hosts，通常不需要 sudo。如遇权限问题再加 sudo 运行。
方式二：手动配置（备用）
- 配置 Codex 配置文件
在 ~/.codex/config.toml 文件开头添加以下配置：
model_provider = "aihezu"
model = "gpt-5.2-codex"
model_reasoning_effort = "high"
model_verbosity = "medium"
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
env_key = "AIHEZU_OAI_KEY"默认配置说明：建议保留
model_verbosity = "medium"，用于控制回答详细程度，平衡速度与信息量（可按需改为low或high）。
- 配置 API 密钥
在 ~/.codex/auth.json 文件中配置 API 密钥：
{
"OPENAI_API_KEY": null
}提示：将
OPENAI_API_KEY设置为null，然后设置环境变量AIHEZU_OAI_KEY为你的 API 密钥。
- 设置环境变量
临时设置（仅当前终端会话有效）
export AIHEZU_OAI_KEY=你的API密钥永久设置（推荐）
将环境变量添加到你的 shell 配置文件中：
对于 zsh（macOS 默认）：
echo "export AIHEZU_OAI_KEY=你的API密钥" >> ~/.zshrc
source ~/.zshrc对于 bash：
echo "export AIHEZU_OAI_KEY=你的API密钥" >> ~/.bash_profile
source ~/.bash_profile注意：请将
你的API密钥替换为你实际的 API 密钥。
故障排除
如果使用 gpt-5.2-codex 模型时报错如下：
{
"error": {
"message": "Unsupported value: 'low' is not supported with the 'gpt-5.2-codex' model. Supported values are: 'medium'.",
"type": "invalid_request_error",
"param": "text.verbosity",
"code": "unsupported_value"
}
}请在 ~/.codex/config.toml 中增加：
model_verbosity = "medium"验证安装
配置完成后，你可以通过以下命令验证 Codex CLI 是否正确安装和配置：
codex --version下一步
安装和配置完成后，你可以开始使用 Codex CLI 了。建议查看 VS Code 集成了解如何在编辑器中使用 Codex。