安装 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 环境变量

1. 配置 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
env_key = "CRS_OAI_KEY"

2. 配置 API 密钥

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

{
  "OPENAI_API_KEY": null
}

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

3. 设置环境变量

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

export CRS_OAI_KEY=你的API密钥

永久设置（推荐）：

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

echo "export CRS_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 中运行。

故障排除

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

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

验证安装

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

codex --version

下一步

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