AI编程助手Codex新手安装指南：Node.js/Git/VS Code零基础避坑教程

如果你最近总刷到“Codex 能帮你写代码、改项目、修 Bug”，但一看到 Node.js、Git、npm、PowerShell 就头大——这篇文章就是为你准备的。
我们不讲术语，不甩命令，只按普通人的安装习惯，一步步带你避开所有常见坑。

一、先把要下载的东西列清楚（附官方地址）

很多教程一上来就扔命令，新手直接懵。我们先不急，先把需要的软件和官方下载入口列出来。

1. Node.js（附带 npm）

• 官网：https://nodejs.org/en/download

• 选哪个：看见 LTS（长期支持版）就选它，别选 Current / Latest。

• Windows 用户：点 Windows Installer (.msi) 64-bit / x64

• 下载文件：node-vxx.x.x-x64.msi

2. Git（代码存档工具）

• 官网：https://git-scm.com/install/windows

• 选哪个：页面有明显提示 “Click here to download the latest x64 version of Git for Windows”，直接点。

• 下载文件：Git-2.xx.x-64-bit.exe

3. VS Code（代码编辑器，非必须但强烈推荐）

• 官网：https://code.visualstudio.com/download

• 选哪个：Windows 用户选 Windows User Installer x64

• 下载文件：VSCodeUserSetup-x64-x.xx.x.exe

4. Codex（AI 编程助手）

• 官方快速开始：https://developers.openai.com/codex/quickstart

• CLI 文档：https://developers.openai.com/codex/cli

• App 下载：https://developers.openai.com/codex/app

• 核心安装命令（后面会教）：npm install -g @openai/codex

⚠️ 重要安全提醒：
绝对不要下载任何“国内版”“免登录版”“全功能完整版”Codex。它会接触你的项目代码，非官方来源极可能导致源码泄露、账号被盗或密钥失窃。只认 OpenAI 官方渠道。

二、Codex 到底是什么？能帮你做什么？

Codex 不只是聊天机器人，它是能直接进入你的项目文件夹的 AI 助手——读懂目录、分析代码、修改文件、运行命令，就像有个实习生坐在你电脑里。

举个真实场景：

• 你下载了一个项目，不知道如何启动 → Codex 帮你看

• 你想改首页但找不到文件 → Codex 帮你定位

• 项目报错看不懂英文 → Codex 帮你分析

• 想加搜索框、登录页、商品列表 → Codex 帮你写代码

• 想生成 README 文档 → Codex 自动生成

一句话：普通 AI 告诉你怎么做，Codex 直接帮你做。

三、Node.js 下载与安装（含检查方法）

1. Node.js 是干什么的？

对新手来说，你只需知道：装好 Node.js，电脑里就有了 npm，而 npm 是安装 Codex CLI 的必备工具。
所以这条命令能跑通的前提，就是 Node.js 装好了：

npm install -g @openai/codex

2. 下载步骤

• 浏览器打开 https://nodejs.org/en/download

• 找到 LTS 版本，点击 Windows Installer (.msi) 64-bit

• 下载完成后得到 .msi 文件

3. 安装步骤

• 双击 .msi 文件，允许系统权限

• 一路点 Next，遇到协议勾选 “I accept...”

• 安装路径保持默认（C:\Program Files\nodejs\）

• 关键选项：务必确保以下三项都被勾选：

  • Node.js runtime

  • npm package manager

  • Add to PATH（这个最重要，让你能在任何命令行使用 node 和 npm）

• 点 Install，完成点 Finish

4. 验证是否装好

• 按 Win + R，输入 cmd，回车打开命令提示符

• 输入 node -v → 看到版本号（如 v24.15.0）→ 成功

• 输入 npm -v → 看到版本号（如 11.x.x）→ 成功

❗ 如果提示“node 不是内部或外部命令”：
最常见原因是安装完没重启命令行，或没勾选 Add to PATH。
解决：关闭命令行 → 重启电脑 → 重新打开 CMD 再试。若还不行，重装 Node.js，保持默认选项。

四、Git 下载与安装（附带基本配置）

1. Git 是干嘛的？

它像“代码时光机”——在让 Codex 改代码前，先用 Git 保存当前状态，改坏了能一键恢复。
强烈建议新手安装，即使你不懂 Git 命令，只做备份也值。

2. 下载步骤

• 打开 https://git-scm.com/install/windows

• 点击明显的下载链接（Click here to download the latest x64 version...）

• 得到 Git-2.xx.x-64-bit.exe

3. 安装步骤

• 双击 .exe，允许权限

• 安装路径默认（C:\Program Files\Git），一直 Next

• 组件选择保持默认

• 默认编辑器：若已装 VS Code，可选 “Use Visual Studio Code as Git's default editor”；否则默认即可

• PATH 环境：务必选 “Git from the command line and also from 3rd-party software”（这样 CMD、PowerShell、VS Code 都能用）

• 后续选项（HTTPS、换行符、终端模拟器）全部默认，直接 Next 到 Install

4. 验证与配置

• 打开 CMD，输入 git --version → 显示版本号（如 git version 2.xx.x）→ 成功

• 配置用户名和邮箱（不是 GitHub 账号，只是本地记录）：

  bash

  git config --global user.name "你的名字（拼音）"git config --global user.email "你的邮箱

• 检查：git config --global --list 能看到 name 和 email 即可

五、VS Code 下载与安装（可选但推荐）

1. 下载

• 打开 https://code.visualstudio.com/download

• 点击 Windows User Installer x64

2. 安装

• 双击安装包，一路 Next

• 关键勾选（若出现）：

  • Add to PATH

  • Add "Open with Code" to context menu

  • Register Code as an editor for supported file types

• 完成后桌面会有 VS Code 图标

六、Codex 安装（三种方式，新手任选）

方式一：Codex App（最省心）

• 打开 https://developers.openai.com/codex/app

• 找到 Windows 入口（通常跳转 Microsoft Store）

• 下载安装后，登录 ChatGPT 账号，选择项目文件夹即可使用

• 适合：怕命令行的纯小白

方式二：Codex CLI（开发者常用）

• 点击开始菜单，搜索 PowerShell，右键“以管理员身份运行”

• 输入以下命令，回车：

  bash

  npm install -g @openai/codex

• 等待安装（出现一堆英文没关系，只要最后没有红色报错）

• 验证：codex --version → 显示版本号 → 成功

• 启动：输入 codex，首次运行会提示登录 ChatGPT 账号或使用 API Key，新手选登录账号即可

方式三：VS Code 插件

• 在 VS Code 左侧扩展商店搜索 “Codex”

• 认准 OpenAI 官方发布的插件（不要装名字很像的第三方）

• 也可从官方快速开始页找到 IDE 插件入口

七、第一次如何打开项目并让 Codex 工作？

很多新手装好了 Codex，但不知道怎么让它“看到自己的项目”。
核心操作：先进入项目文件夹，再运行 Codex。

假设你的项目在桌面，文件夹名为 my-project：

cd Desktopcd my-project
codex

更简单的方法：打开项目文件夹，在文件夹地址栏里输入 cmd 并回车，直接在该路径打开命令行，省去 cd 步骤。

启动后第一句话建议：

“请先分析这个项目的目录结构，告诉我这个项目是做什么的，以及如何启动。先不要修改代码。”

务必加上“先不要修改代码” ——这是安全底线。

八、让 Codex 改代码前，一定先做备份（保命操作）

Codex 很强，但新手最怕它改完无法恢复。
用 Git 拍个快照，只需三步：

git status # 查看当前状态git init # 如果还不是 Git 仓库，先初始化git add . # 把所有文件加入暂存git commit -m "backup before codex" # 存档

之后 Codex 改完，你可以用 git diff 查看它具体改了哪些地方，不满意还能用 git checkout 恢复。

九、新手常见问题速查

1. npm 不是内部或外部命令

• 原因：Node.js 未装好，或 PATH 未生效

• 解决：重启 CMD → 检查 node -v、npm -v → 重启电脑 → 重装 Node.js（保持默认）

2. codex 不是内部或外部命令

• 解决：重新执行安装命令 npm install -g @openai/codex，然后关闭 PowerShell 重新打开，再试 codex --version

3. 下载太慢怎么办？

• 换稳定网络，多刷新几次。切勿用第三方镜像或来路不明的安装包，安全第一。

4. 登录 Codex 失败

• 检查：ChatGPT 账号能否正常登录；账号是否有 Codex 权限；网络是否畅通；浏览器是否拦截跳转；安装的是否为官方版本。

5. 完全不会代码，能用 Codex 吗？

• 可以，但别一上来就大改。先让它“像教新手一样解释项目结构和每个文件夹的作用，先不修改代码”，等有点概念了再提小需求。

十、给新手的完整安装顺序（照着做就行）

1. 下载 Node.js LTS（.msi）→ 安装（保持默认，勾选 Add to PATH）→ 验证 node -v、npm -v

2. 下载 Git for Windows（.exe）→ 安装（一路 Next，PATH 选默认）→ 验证 git --version → 配置 user.name 和 user.email

3. 下载 VS Code（.exe）→ 安装（勾选 PATH 和右键菜单）

4. 打开 PowerShell（管理员）→ 运行 npm install -g @openai/codex

5. 验证 codex --version → 启动 codex → 登录 ChatGPT 账号

6. 进入你的项目文件夹（cd 或地址栏输 cmd）→ 运行 codex → 开始安全提问

最后再叮嘱一句：AI 编程助手再强大，也要养成备份习惯。按本教程一步步来，你不仅能顺利装上 Codex，还能在以后的项目里少踩很多坑。祝你编程愉快！