本指南将协助您在 Windows 系统上构建一套稳健的 AI 协作开发环境。不同于普通的软件安装，我们将专注于搭建一套能够让 Codex 顺畅执行“阅读-修改-验证”闭环任务的工程底座。
> 前置要求：在开始安装前，请确保您已阅读 Codex 入门导航，明确了本阶段的学习目标。
环境检查清单
在正式操作前，请确认您的系统环境满足以下基础要求：
- 操作系统：推荐 Windows 11（版本 22H2 及以上）或更新至最新的 Windows 10。
- 终端工具：Windows 终端 (Windows Terminal) 或原生的命令提示符 (cmd.exe)。
- 必备组件：Git 版本控制、Node.js LTS 运行环境。
- 代码编辑器：VS Code 或基于其二次开发的 AI 原生编辑器 Cursor。
第 1 步：系统环境验证
1.1 确认 Windows 版本
按下 Win + R 键，输入 winver 并回车。
- 推荐结果：Windows 11 是目前与 Codex CLI 及桌面版兼容性最佳的系统环境。
- 兼容结果：如果您使用 Windows 10，请确保已安装所有关键系统补丁，以获得现代终端能力的完整支持。
1.2 启动终端环境
点击“开始”菜单，搜索 cmd 或 Terminal 并打开。
在终端中输入以下命令以确认环境基础信息：
``cmd
ver
`
若能正确显示 Windows 内部版本号，说明您的终端环境已准备就绪。
第 2 步：安装 Git 版本控制工具
Git 是 Codex 协作流程中的“核心骨干”，它负责改动对比 (Diff)、错误回滚以及任务复盘。
2.1 检查现有版本
在终端执行：
`cmd
git --version
`
- 若显示 git version 2.x.x
，说明已安装，可跳过此步。 - 若提示“不是内部或外部命令”，请执行下一步。
2.2 下载与安装
访问 Git 官网下载页，下载适用于 Windows 的 64 位安装包。
- 安装建议：对于新手，建议全程保持默认选项。默认配置已能完美适配 Codex 的 Git 操作需求。
- Winget 安装（推荐）：如果您熟悉包管理器，可直接运行：
`cmd
winget install --id Git.Git -e --source winget
`
2.3 配置全局身份
安装完成后，务必配置您的 Git 标识，以便 Codex 生成准确的提交记录：
`cmd
git config --global user.name "YourName"
git config --global user.email "your@email.com"
`
第 3 步：部署 Node.js LTS 运行环境
如果您计划进行 Web 开发（Vue, React, Nuxt 等），Node.js 是必不可少的基础设施。
3.1 选择版本
访问 Node.js 官网，请务必选择 LTS (长期支持版)。LTS 版本具有更高的稳定性，能有效避免因实验性特性导致的构建失败。
3.2 验证安装
安装完成后，重启终端并执行以下命令：
`cmd
node -v
npm -v
`
若能看到版本号（如 v20.x.x），则说明运行环境部署成功。
第 4 步：选择 AI 友好型编辑器
我们强烈建议您安装 VS Code 或 Cursor 作为您的主开发工具。
- VS Code：社区生态最丰富的编辑器，拥有完善的 Codex 插件支持。
- Cursor：深度集成了 AI 协作能力的编辑器，适合追求极致 Vibe Coding 体验的开发者。
安装小贴士：在安装 VS Code 时，请务必勾选“添加到 PATH”选项，这能让您在终端中通过 code . 命令快速唤起项目。
第 5 步：构建您的第一个“安全练习场”
为了让您能够放心地进行 Codex 实操练习，建议创建一个专门的练习目录。
5.1 创建练习目录
建议在非系统盘（如 D 盘）创建路径简单、无权限限制的文件夹：
`cmd
mkdir D:\code\codex-practice
cd D:\code\codex-practice
`
- 避免使用：桌面目录、云盘同步文件夹或包含大量中文字符的长路径，这些环境可能会引发非预期的权限或编码报错。
5.2 初始化 Demo 项目
我们可以利用 Vite 快速生成一个纯净的前端练习项目：
`cmd
npm create vite@latest demo-app -- --template vanilla
cd demo-app
npm install
git init
git add .
git commit -m "chore: init practice project"
`
第 6 步：执行首次“只读任务”验证
在正式让 AI 修改代码前，请先执行一次只读分析，验证整个环境链路的可靠性。
实战提示词：
> “请对当前项目进行只读分析，向我解释项目的技术栈、入口文件以及 package.json 中定义的关键脚本。请注意：在获得我明确授权前，禁止修改任何文件。”
验证要点：
- AI 是否定位正确：它能否准确识别出您的 demo-app
路径？
2. Git 状态是否保持洁净：分析完成后，运行 git status` 确认没有非预期的文件改动。
阶段性结语
完成上述步骤后，您已成功搭建了 Codex 本地实战的最小可用环境：
终端 (cmd) + 版本控制 (Git) + 运行时 (Node.js) + 洁净的项目状态。
下一步，我们将正式进入 Codex CLI 的深度配置与登录 阶段，开启真正的 AI 编程体验。