Codex 安装教程（Windows）

Windows 上你有两种常见用法：

• 方案 A（推荐）：在 WSL2 里安装和运行
• 方案 B：直接在 PowerShell 里安装和运行

下面两套我都写了，你按自己的环境选一个。

0. 前置：安装 Node.js

先装 Node.js（建议 22+）：Nodejs Windows

验证：

node -v
npm -v

方案 A：PowerShell 原生安装

1) 安装 Codex

第一步：全局安装 Codex

npm install -g @openai/codex

第二步：验证安装

codex --version

2) 配置 Codex（接入AI驿站）

2.1 配置文件在哪里？

配置目录：%USERPROFILE%\.codex

什么意思？

• 完整路径是：C:\Users\你的用户名\.codex\

2.2 创建配置目录

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

2.3 写入主配置文件 config.toml

@'
# 基础配置
model_provider = "aizhan"
model = "gpt-6.1-sol"
review_model = "gpt-6.1-sol"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 272000
model_auto_compact_token_limit = 272000
effective_context_window_percent = 95

[model_providers.aizhan]
name = "aizhan"
base_url = "https://api.aizhan.space/v1"
wire_api = "responses"
requires_openai_auth = true
http_headers = { "x-openai-actor-authorization" = "api.aizhan.space" }
'@ | Set-Content -Path "$env:USERPROFILE\.codex\config.toml" -Encoding UTF8

配置说明：

• model_provider - 使用的服务提供商（这里是 aizhan）
• model - 默认使用的模型
• review_model - 代码审查同样使用 gpt-6.1-sol
• model_context_window - 按 GPT-6.1 Sol 的 272K 档配置上下文
• base_url - AI驿站的服务地址
• wire_api - 使用 OpenAI 兼容格式
• requires_openai_auth - 必须保持为 true，否则 Codex 不会读取 auth.json 中的 API Key

2.4 写入认证文件 auth.json（注意替换 API Key）

@'
{
  "OPENAI_API_KEY": "你的AI驿站 Key"
}
'@ | Set-Content -Path "$env:USERPROFILE\.codex\auth.json" -Encoding UTF8

必须替换：把 你的AI驿站 Key 替换成你从AI驿站官网复制的真实 Key

3) 启动并验证

cd C:\path\to\your\project
codex

方案 B：WSL2

1. 先安装 WSL2 并进入 Linux 子系统
2. 在 WSL2 里按 Linux 教程做：

Codex Linux