2ueo1watoQ
全程无专业术语,照着点就能成,解决 99% 新手安装难题
如果你最近刷到 “Codex 能写代码、改项目、修 Bug”,却被 Node.jsGitnpm 这些词直接劝退,这篇就是为你量身定做的。我们不讲原理,只讲 “点哪个按钮、输什么命令”,一步一步带你从 0 到 1 装好 Codex,还会教你第一次用怎么不踩坑、不搞坏代码。

一、先搞懂:Codex 到底能帮你干什么?

普通 AI 只会 “告诉你怎么做”,Codex 是直接进你电脑里帮你做。它能读取你的项目文件夹、看懂代码结构、修改文件、运行命令,相当于一个 24 小时在线的编程助理。
举几个新手最常用的场景:
下载了一个开源项目,不知道怎么启动?让它帮你看
想改首页文字,不知道文件在哪?让它帮你找
运行报错看不懂英文?让它翻译成中文并给出解决方案
想加个搜索框、登录按钮?让它帮你写完整代码
不会写项目说明文档?让它一键生成

二、前置准备:3 个必须装的基础软件(官网正版)

⚠️ 重要安全提示:所有软件只从官网下载,绝对不要用 “国内版”“免安装版”“一键破解版”。Codex 会接触你的全部项目代码,来路不明的软件可能导致源码泄露、账号被盗。

软件名称 作用 官网下载地址 推荐版本
Node.js 提供 npm 工具,用来安装 Codex CLI https://nodejs.org/en/download LTS 稳定版(v22.17.0)
Git 代码备份工具,Codex 改错了能一键恢复 https://Git-scm.com/install/windows 最新版(2.54.0)
VS Code 代码编辑器,搭配 Codex 插件体验最好 https://code.visualstudio.com/download Windows User Installer x64

三、第一步:安装 Node.js(5 分钟搞定)

3.1 为什么要装 Node.js
不用管它是什么,你只需要知道:装完 Node.js,电脑里就有了 npm,而 npm 是安装 Codex 的唯一官方工具。

3.2 下载与安装步骤
打开 Node.js 官网,直接点页面最上方的LTS按钮(不要点 Current 最新版,LTS 更稳)
Windows 用户自动下载node-v22.17.0-x64.msi,下载完成后双击打开
全程点Next,看到协议页面勾选 “I accept...”
关键步骤:安装选项页面,确保这三个选项都勾选(默认就是勾好的,不要取消)
Node.js runtime
npm package manager
Add to PATH(这个最重要,没勾上后面会报错)
点 Install,等待安装完成后点 Finish

3.3 验证是否安装成功
按Win+R,输入cmd回车打开黑窗口,依次输入这两个命令:


node -v
npm -v

如果显示类似下面的版本号,就说明装好了:


v22.17.0
10.9.2

3.4 常见报错解决
如果提示 “node 不是内部或外部命令”:
关闭所有命令行窗口,重启电脑
重新打开 CMD 再试一次
还是不行就重新安装 Node.js,全程保持默认选项

四、第二步:安装 Git(代码安全必备)

4.1 为什么要装 Git
Git 是你的 “代码时光机”。让 Codex 改代码之前,先用 Git 拍一张 “快照”,万一改坏了,一键就能恢复到之前的状态。不装 Git 也能用 Codex,但绝对不建议新手这么做。

4.2 下载与安装步骤
打开 Git 官网,页面会自动识别你的系统,点 “Click here to download the latest x64 version of Git for Windows”
双击下载的Git-2.54.0-64-bit.exe,全程点Next
关键步骤 1:选择默认编辑器时,如果你已经装了 VS Code,就选 “Use Visual Studio Code as Git's default editor”,否则保持默认
关键步骤 2:PATH 选项页面,选第一个 “Git from the command line and also from 3rd-party software”
后面所有选项全部保持默认,点 Install 等待完成

4.3 验证与基础配置
打开 CMD,输入git --version,显示git version 2.54.0.windows.1就说明成功
配置用户名和邮箱(只是本地记录,不用注册账号):


Git config --global user.name "你的名字"
Git config --global user.email "你的邮箱@example.com"

五、第三步:安装 VS Code(可选但强烈推荐)

VS Code 是目前最好用的免费代码编辑器,搭配 Codex 官方插件,不用来回切换窗口,直接在编辑器里就能让 AI 帮你写代码。

5.1 下载与安装步骤
打开 VS Code 官网,Windows 用户选 “Windows User Installer x64”
双击安装包,关键步骤:勾选这四个选项(其他保持默认)
Add to PATH
添加 “通过 Code 打开” 到右键菜单
注册 Code 为受支持文件类型的编辑器
自动更新
点 Install,等待完成后启动 VS Code

六、第四步:安装 Codex(3 种方式,选最适合你的)

Codex 提供三种使用方式,新手优先选方式一(Codex App),完全不用碰命令行;想体验开发者常用方式选方式二(CLI);平时用 VS Code 写代码选方式三(插件)。

方式一:Codex App(纯小白首选)
打开官方页面:https://developers.OpenAI.com/Codex/app
点击 “Download for Windows”,会跳转到微软商店自动下载
安装完成后打开 Codex App,用你的 ChatGPT 账号登录(所有 ChatGPT 套餐都包含 Codex
点击 “Open Folder”,选择你的项目文件夹,就可以开始用了

方式二:Codex CLI(开发者常用)
按Win+R输入powershell回车,打开 PowerShell
输入安装命令,回车等待完成:


npm install -g @OpenAI/Codex

验证安装:输入codex --version,显示版本号就说明成功
输入codex启动,按提示用 ChatGPT 账号登录即可

方式三:VS Code Codex 插件(日常编码首选)
打开 VS Code,点击左侧边栏的扩展图标(四个方块)
搜索 “Codex”,认准OpenAI 官方发布的插件,点击安装
安装完成后,左侧会出现 Codex 图标,点击后用 ChatGPT 账号登录
打开你的项目文件夹,直接在聊天框输入指令即可

七、第一次用 Codex:安全又正确的打开方式

很多新手装完 Codex 就直接让它改代码,结果改坏了不知道怎么恢复。记住这个黄金流程,永远不会出大问题:

7.1 第一步:进入项目文件夹
用 App:直接点 “Open Folder” 选择你的项目
用 CLI:打开项目文件夹,在地址栏输入cmd回车,然后输入codex
VS Code 插件:直接打开项目文件夹即可

7.2 第二步:先备份代码(最重要)
在项目文件夹的命令行里输入这三行命令,给代码拍一张 “快照”:


Git init
Git add .
Git commit -m "备份:Codex修改前"

7.3 第三步:第一次提问这么说
绝对不要一上来就让它改代码,先让它帮你分析项目:
请先分析这个项目的目录结构,告诉我这个项目是做什么的,用了什么技术栈,以及如何启动。先不要修改任何文件。
等它分析完,你对项目有了基本了解,再让它做小的修改,比如 “帮我把首页的标题改成‘我的第一个项目’”。

7.4 第四步:检查修改内容
Codex 改完后,在命令行输入:


Git diff

它会显示所有修改的地方,你可以一行一行检查,确认没问题再保存。如果改坏了,输入下面的命令一键恢复:


Git reset --hard HEAD

八、新手最常见的 10 个问题及解决方法

npm 不是内部或外部命令:关闭所有命令行,重启电脑;还是不行就重新安装 Node.js,确保勾选 Add to PATH
Codex 不是内部或外部命令:重新执行npm install -g @OpenAI/Codex,然后关闭 PowerShell 重新打开
下载速度很慢:换手机热点试试,不要用校园网或公司内网;绝对不要下载第三方镜像
登录 Codex 失败:检查你的 ChatGPT 账号是否能正常登录;确认网络能访问 OpenAI 服务
Codex 看不到我的文件:确保你是在项目文件夹里启动的 Codex,而不是根目录
改完代码运行报错:先执行git reset --hard恢复到备份状态,再让 Codex 重新修改
提示没有权限:右键点击命令行,选择 “以管理员身份运行”
Node.js 版本太低:卸载旧版本,重新安装官网最新的 LTS 版本
Git 命令报错:确保你在项目文件夹里执行命令,并且已经执行过git init
VS Code 插件不显示:重启 VS Code;检查插件是否启用;重新安装插件

九、终极安装顺序总结(照着抄就行)

安装 Node.js LTS 版 → 用node -v和npm -v验证
安装 Git → 用git --version验证 → 配置用户名和邮箱
安装 VS Code(可选)
安装 Codex(App/CLI/VS Code 插件三选一)
进入项目文件夹 → 用 Git 备份代码
第一次提问:先分析项目,不要修改代码
检查修改内容 → 确认无误后保存
最后再提醒 3 句
所有软件只从官网下载,第三方整合包 100% 有风险
任何时候让 Codex 改代码之前,先执行git commit备份
新手从小修改开始,不要一上来就让它重构整个项目

本文最后更新于2026年5月21日,若涉及的内容可能已经失效,直接留言反馈补链即可,我们会处理,谢谢
声明:本站所有内容均由互联网收集整理、网友上传,并且以计算机技术研究交流为目的,仅供大家参考、学习,请勿用于任何商业目的与商业用途,如需商用请支持正版!如亲下载后改变其用途与使用方式,与本站无任何关系,本站已经进行告知义务!我们只做安全认证测试如果资源侵犯了您的版权利益,请联系站长邮箱:17606723350@163.com