Codex 使用前的准备：在 Windows 上安装 Git、Node.js 和 VS Code
Codex 使用前的准备：在 Windows 上安装 Git、Node.js 和 VS Code
在正式安装 Codex 之前，建议先把几个基础工具准备好。这里主要是三样：
1Git
2Node.js
3VS Code
严格来说，它们的“必须程度”不完全一样。Git 和 Node.js 更像是基础环境，很多 AI 编程工具、命令行工具和项目依赖都会用到；VS Code 不是绝对必需，但非常建议安装，因为后面查看项目、改代码、安装扩展都会方便很多。
这篇文章只写安装 Codex 前的准备工作，不展开讲 Codex 本身怎么安装和使用。
1. 这三个软件分别是干什么的？
先简单说一下，不然后面只跟着点“下一步”，容易不知道自己装了什么。
| 软件 | 作用 | 是否建议安装 |
|---|---|---|
| Git | 管理代码版本，方便回退、提交、拉取项目 | 建议安装 |
| Node.js | 提供 node 和 npm，很多命令行工具和前端项目依赖它 | 建议安装 |
| VS Code | 代码编辑器，用来看项目、改代码、装插件 | 强烈建议安装 |
Codex 是 AI 编程工具，但它不是传统意义上的代码编辑器。AI 帮你生成或修改代码之后，如果你想自己看一下、改一下，还是需要一个编辑器。对新手来说，VS Code 是最常见也最省心的选择。
推荐安装顺序：
1Git → Node.js → VS Code
2. 官网下载地址
建议尽量从官网下载安装包，不要随便从第三方下载站下载。
| 软件 | 官网地址 |
|---|---|
| Git for Windows | https://git-scm.com/install/windows |
| Node.js | https://nodejs.org/en/download |
| VS Code | https://code.visualstudio.com/download |
如果你是在跟着视频教程操作，老师可能会提供资料包里的安装包。资料包通常也可以用，但如果网络能正常访问官网，我个人更建议直接从官网下载最新版，来源更清楚。
3. 安装 Git
打开 Git for Windows 下载页面：
1https://git-scm.com/install/windows
进入页面后，选择 Windows 版本下载安装包。一般 64 位 Windows 电脑下载 x64 版本即可。
下载完成后，双击安装包开始安装。
Git 的安装选项很多，新手不用紧张。大多数情况下，一路点击：
1Next → Next → Next → Install
保持默认选项就可以了。
安装完成后，可以检查一下是否安装成功。
按下键盘：
1Win + R
输入：
1cmd
打开命令提示符后输入：
1git --version
如果看到类似下面这样的版本号，就说明 Git 安装成功了：
1git version 2.xx.x.windows.x
4. 顺手配置一下 Git 用户信息
Git 安装完成后，建议顺手配置用户名和邮箱。以后如果你用 Git 提交代码，这两个信息会显示在提交记录里。
在 CMD 或 PowerShell 里输入：
1git config --global user.name "你的名字"
2git config --global user.email "你的邮箱"
例如：
1git config --global user.name "example"
2git config --global user.email "[email protected]"
也可以把默认分支名设置为 main：
1git config --global init.defaultBranch main
查看配置是否生效：
1git config --global --list
如果里面能看到 user.name 和 user.email，就说明配置完成了。
5. 安装 Node.js
打开 Node.js 官网下载页面：
1https://nodejs.org/en/download
Node.js 官网通常会根据你的系统自动推荐 Windows 版本。
这里有一个小建议：
- 普通用户、新手：优先安装 msl 版本；
- 如果某个工具明确要求 Node 版本，再按那个工具要求安装。
下载 Windows 安装包后，双击安装。安装过程也基本保持默认即可：
1Next → Next → Install
中间如果看到类似“Automatically install the necessary tools”之类的选项，新手可以先不勾。只有后面安装某些依赖报错时，再考虑补装编译工具。
安装完成后，同样检查一下。
按下：
1Win + R
输入：
1cmd
在命令提示符里输入：
1node --version
如果能看到版本号，例如：
1v24.15.0
就说明 Node.js 安装成功了。
再检查一下 npm：
1npm --version
如果 npm 也能显示版本号，说明 Node.js 和 npm 都可以正常使用。
6. 安装 VS Code
打开 VS Code 官网：
1https://code.visualstudio.com/download
一般官网会自动识别你的系统，Windows 用户直接点击：
1Download for Windows
下载完成后双击安装。
安装路径可以默认放在 C 盘，也可以改到其他盘。只要你的 C 盘空间不是特别紧张，默认安装就行。VS Code 本体不算很大，真正占空间的通常是后面项目里的依赖文件，而不是 VS Code 本身。
安装过程中，建议勾选这些选项：
1Add to PATH
2Register Code as an editor for supported file types
3Add "Open with Code" action to Windows Explorer file context menu
4Add "Open with Code" action to Windows Explorer directory context menu
如果没看到这些选项，也不用太担心，默认安装也可以正常使用。
安装完成后，打开 VS Code。如果界面是英文，后面可以安装中文语言包。
7. 把 VS Code 改成中文界面
第一次打开 VS Code 时，很多人看到的是英文界面。想改成中文，可以这样操作。
点击左侧扩展图标，也就是左边栏里四个小方块那个按钮。
在搜索框输入：
1Chinese
找到：
1Chinese (Simplified) Language Pack for Visual Studio Code
点击安装。
安装完成后，右下角通常会提示重启 VS Code。点击重启，重启后界面就会变成中文。
如果没有自动提示，也可以自己关闭 VS Code 再重新打开。
8. 最后统一检查一遍
三个软件都装好之后，建议统一检查一下。
打开 CMD 或 PowerShell，依次输入：
1git --version
2node --version
3npm --version
4code --version
正常情况下，前面三个都会显示版本号。
code --version 如果不能识别，通常是因为 VS Code 没有加入 PATH，或者安装后还没有重新打开命令行窗口。可以先关闭 CMD，重新打开再试一次；还不行的话，重启电脑再试。
只要下面三个命令能正常显示版本号，Codex 前置环境基本就没问题了：
1git --version
2node --version
3npm --version
VS Code 就算命令行暂时识别不了，也不影响你从桌面图标直接打开使用。
9. 需要占用多少空间？
这三个软件本身都不算特别大。大概可以这样理解：
| 软件 | 大致占用 |
|---|---|
| Git | 几百 MB |
| Node.js | 几百 MB以内 |
| VS Code | 几百 MB |
建议电脑至少预留：
13GB - 5GB 可用空间
这不是因为这三个软件本身特别大，而是因为后面你用 Codex 做项目时，项目依赖可能会占空间。尤其是前端项目里的 node_modules，一个项目几百 MB 甚至几个 GB 都很常见。
内存方面，如果只是普通学习和小项目，8GB 内存可以用；如果同时开浏览器、VS Code、Codex、终端和本地项目，16GB 会舒服很多。
10. 常见问题
10.1 输入 git --version 提示不是内部或外部命令
先关闭 CMD，重新打开再试。
如果还是不行，重启电脑。
再不行，可能是 Git 没有加入系统环境变量。最简单的办法是重新安装 Git，安装时保持默认选项，不要手动取消 PATH 相关配置。
10.2 输入 node --version 没反应或提示找不到命令
同样先关闭 CMD，重新打开。
如果仍然不行，重启电脑。
Node.js 安装完成后，环境变量有时候需要新的命令行窗口才会生效。
10.3 VS Code 是英文怎么办？
安装中文语言包即可：
1Extensions → 搜索 Chinese → 安装中文语言包 → 重启 VS Code
安装后界面会变成中文。
10.4 一定要把软件装在 C 盘吗？
不一定。
如果 C 盘空间够，默认装 C 盘最省事。装到其他盘也可以，不会因为换了盘符就不能用。
真正需要注意的是后面项目文件和依赖文件的位置。项目多了以后，建议把项目放在空间比较大的盘里，例如：
1D:\Code
2D:\Projects
10.5 Git、Node.js、VS Code 都装好了，还需要立刻学会它们吗？
不用。
这一步只是为了把 Codex 需要的基础环境准备好。刚开始只要会检查版本号、会打开 VS Code、知道项目文件放在哪里就够了。
后面真正用到 Git、终端命令、npm 命令时，再针对具体问题学习会更容易。
11. 发布前检查清单
正式开始安装 Codex 前，可以按下面这张表检查：
| 检查项 | 是否完成 |
|---|---|
| Git 已安装 | 是 / 否 |
git --version 能显示版本号 | 是 / 否 |
| Git 用户名和邮箱已配置 | 是 / 否 |
| Node.js 已安装 | 是 / 否 |
node --version 能显示版本号 | 是 / 否 |
npm --version 能显示版本号 | 是 / 否 |
| VS Code 已安装 | 是 / 否 |
| VS Code 中文语言包已安装 | 是 / 否 |
| 电脑至少预留 3GB - 5GB 可用空间 | 是 / 否 |
如果这些都没问题，就可以进入下一步：安装 Codex。
12. 参考资料
OpenAI Codex Windows App 说明
https://developers.openai.com/codex/app/windowsOpenAI Codex Quickstart
https://developers.openai.com/codex/quickstartOpenAI Codex CLI 说明
https://developers.openai.com/codex/cliGit for Windows 下载页
https://git-scm.com/install/windowsNode.js 下载页
https://nodejs.org/en/downloadVS Code 下载页
https://code.visualstudio.com/download