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 = "flashapi"
model = "gpt-5.2-codex"
approval_policy = "on-request"

[model_providers.flashapi]
name = "flashapi"
base_url = "https://api.ci-yuan-ai.com/v1"
wire_api = "responses"
requires_openai_auth = true
'@ | Set-Content -Path "$env:USERPROFILE\.codex\config.toml" -Encoding UTF8

配置说明：

• model_provider - 使用的服务提供商（这里是 flashapi）
• model - 默认使用的模型
• approval_policy - 执行代码前是否需要确认（on-request 表示需要）
• base_url - 词元AI的服务地址
• wire_api - 使用 OpenAI 兼容格式

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