🖥️ Windows 平台

（一）安装Node.js环境

Windows安装方法：

方法一：官网下载（推荐）

1. 打开浏览器访问：https://nodejs.org/zh-cn/download
2. 点击 "LTS" 版本进行下载（版本号要大于18，推荐长期支持版本）
3. 下载完成后双击 .msi 文件
4. 按照安装向导完成安装，保持默认设置即可

方法二：包管理器安装

💡 提示

Winget、Chocolatey、Scoop选一个使用，具体选哪个看你环境。

使用 Winget

Windows 11 或 Windows 10 最新版：

winget install OpenJS.NodeJS.LTS

或者使用 Chocolatey

如使用Chocolatey需要先安装 Chocolatey

choco install nodejs-lts

或者使用 Scoop

scoop install nodejs-lts

验证安装

打开命令提示符或 PowerShell，执行：

node --version
npm --version

如果显示版本号（如 v18.x.x 或更高），说明安装成功。

---

（二）安装 Codex Cli

安装 Codex Cli

打开 PowerShell 或 CMD，运行以下命令：

全局安装 Codex

安装codex：

npm i -g @openai/codex --registry=https://registry.npmmirror.com

这个命令会从 npm 官方仓库下载并安装最新版本的 Codex。更新也使用这个命令

验证是否安装成功：

codex --version

提示

• 建议使用 PowerShell 而不是 CMD，功能更强大
• 如果遇到权限问题，以管理员身份运行 PowerShell

---

（三）配置 Codex 环境变量

使用编辑配置文件方式配置 Codex 环境变量

• 打开文件资源管理器，找到 C:\Users\你的用户名\.codex 文件夹（如果没有则创建） 如图:
• 
• 创建config.toml,用Notepad或Visual Studio Code打开，输入以下内容：

model_provider = "AICY"
model = "gpt-5.2"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
approval_policy = "on-request"
web_search = "live"
sandbox_mode = "danger-full-access"
collaboration_mode = true
model_supports_reasoning_summaries = true

[model_providers.AICY]
name = "aicy"
base_url = "https://api.aicy.pro/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
shell_snapshot = true

collab = false
collaboration_modes = false
steer = false
unified_exec = false

• 创建 auth.json 文件，在文件添加以下内容：

{
  "OPENAI_API_KEY": "你的密钥"
}

令牌密钥获取方式：

然后保存（Ctrl+S）

设置后需要重新打开 PowerShell 窗口才能生效。

---

（四）开始使用 Codex

启动 Codex

配置完成后，在 PowerShell 或 CMD 中输入以下命令启动 Codex：

codex

首次启动时，Codex 会进行初始化配置。

基本使用

• ​交互模式​：直接输入 codex 进入交互式对话
• ​指定项目​：在项目目录下运行 codex，Codex 会自动识别项目上下文
• ​退出程序​：输入 exit​ 或按 Ctrl+C 退出

---

（五）常见问题解决

1. 命令未找到错误

​问题​：运行 codex 时提示 "不是内部或外部命令"

​解决方法：

# 检查 npm 全局安装路径
npm config get prefix

# 确保该路径在 PATH 中
$env:Path

# 如果不在，添加到系统环境变量
# 打开系统环境变量设置，将 npm 全局路径添加到 Path 中
# 默认路径通常是：C:\Users\你的用户名\AppData\Roaming\npm

2. 权限问题

​问题：安装时提示权限不足

​解决方法：

# 以管理员身份运行 PowerShell
# 右键点击 PowerShell 图标，选择"以管理员身份运行"

# 然后重新安装
npm install -g @openai/codex

3. API 连接失败

​问题：Codex 无法连接到 API 服务

​解决方法：

# 检查环境变量是否正确设置
echo $env:OPENAI_BASE_URL
echo $env:OPENAI_API_KEY

# 测试网络连接
Test-NetConnection -ComputerName aicy.pro -Port 443

# 重新设置环境变量
$env:OPENAI_BASE_URL = "https://api.aicy.pro/v1"
$env:OPENAI_API_KEY = "你的API密钥"

4. 更新 Codex

​问题：如何更新到最新版本

​解决方法：

# 更新 Codex（推荐使用国内镜像）
npm i -g @openai/codex --registry=https://registry.npmmirror.com

# 或者重新安装
npm install -g @openai/codex

5. Node.js 版本过低

​问题：提示 Node.js 版本不兼容

​解决方法：

# 检查当前版本
node --version

# 从官网下载最新的 LTS 版本（需要 18 或更高版本）
# 访问 https://nodejs.org/ 下载安装

6. 防火墙或杀毒软件拦截

​问题：安装或运行时被防火墙拦截

​解决方法：

• 将 Node.js 和 npm 添加到防火墙白名单
• 临时关闭杀毒软件进行安装
• 检查企业网络策略是否允许访问 npm 仓库

‍