安装 Codex CLI（Windows）

本指南将帮助你在 Windows 系统上安装和配置 Codex CLI。

推荐方式：使用 Windows Subsystem for Linux (WSL2)

Codex 是为 Unix 风格的环境设计的，在 WSL2 中运行可以获得 Linux shell、unix 风格的语义和工具链，这与 Codex 的最佳工作方式相匹配。

第一步：安装 WSL2 和 Codex CLI

在提升权限的 PowerShell 或 Windows Terminal 中执行以下命令：

# 安装默认 Linux 发行版
wsl --install
 
# 进入 WSL 环境
wsl
 
# 通过 nvm 安装 Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

重启终端后，继续执行：

# 安装 Node.js
nvm install 22
 
# 全局安装 Codex
npm i -g @openai/codex
 
# 启动 Codex
codex

第二步：配置 Codex 环境变量

方式一：使用 aihezu 一键配置（推荐）

在 WSL shell 中直接运行：

# 方式 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

方式二：手动配置（备用）

1. 配置 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）。

2. 配置 API 密钥

在 ~/.codex/auth.json 文件中配置 API 密钥：

{
  "OPENAI_API_KEY": null
}

提示：将 OPENAI_API_KEY 设置为 null，然后设置环境变量 AIHEZU_OAI_KEY 为你的 API 密钥。

3. 设置环境变量

临时设置（仅当前终端会话有效）：

export AIHEZU_OAI_KEY=你的API密钥

永久设置（推荐）：

将环境变量添加到你的 shell 配置文件中：

echo "export AIHEZU_OAI_KEY=你的API密钥" >> ~/.bashrc
source ~/.bashrc

注意：请将 你的API密钥 替换为你实际的 API 密钥。

最佳实践建议

项目位置

将项目保存在 Linux 主目录中（如 ~/code/my-app），而不是 Windows 挂载路径（如 /mnt/c/...），这样可以获得更好的 I/O 性能，并减少符号链接和权限问题。

VS Code 集成

安装 WSL 扩展后，在 WSL 终端中使用 code . 启动 VS Code，以确保集成终端在 Linux 中运行。

故障排除

如果使用 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"

如果遇到无响应的情况，请安装 C++ 开发工具：

• Visual Studio Build Tools（C++ 工作负载）
• Microsoft Visual C++ Redistributable (x64)

验证安装

配置完成后，你可以通过以下命令验证 Codex CLI 是否正确安装和配置：

codex --version

下一步

安装和配置完成后，你可以开始使用 Codex CLI 了。建议查看 VS Code 集成了解如何在编辑器中使用 Codex。