乐于分享
好东西不私藏

Windows 小白 Codex 安装教程速查表

Windows 小白 Codex 安装教程速查表

第一次用,照这个顺序来就够了

第一次在 Windows 上安装 Codex,很多人卡住的地方,其实不是 Codex 本身。真正容易出问题的,往往是前面的基础环境。

比如 Node.js 没装好,npm 命令找不到;Git 没安装,项目改坏以后不好回退;VS Code 打开了,却不知道该从哪里让 Codex 介入项目。

所以,对 Windows 新手来说,最稳的方式不是一上来就追求高级玩法,而是先把环境装对、路径跑通、备份做好,再让 Codex 真正进入项目。

一、先看一张速查表

二、先准备 4 个东西

在正式使用 Codex 之前,建议先准备好这 4 个东西:Node.js、Git、OpenAI / ChatGPT 账号或 Codex 访问权限、VS Code 或你常用的终端。

这里面,Node.js 主要是为了让 npm 能正常使用;Git 是为了管理代码版本;VS Code 是为了更方便地打开和查看项目;Codex 则是最后真正帮你写代码、改代码、解释代码的 AI 编程助手。

小提示

不要一上来就跑 Codex。先确认 node、npm、git 这些命令都能正常返回版本号。

三、Node.js 别乱选版本

Windows 新手安装 Node.js,建议优先选择 LTS 版本。LTS 可以理解为长期支持版本,稳定性通常更适合日常使用。安装时如果看到 “Add to PATH” 之类的选项,不要随便取消。

安装完成后,打开终端,输入:

node -v

npm -v

如果能看到版本号,说明 Node.js 和 npm 基本装好了。如果提示“不是内部或外部命令”,先重启电脑,再重新打开终端试一次。

四、Git 不是必须,但强烈推荐

Git 最大的意义,不只是多人协作,而是让你有机会回到上一个安全版本。尤其是第一次让 Codex 修改项目时,最好先做一次 Git 提交。

安装 Git 之后,可以在终端输入:

git --version

真正开始修改项目之前,建议先在项目目录里执行:

git status

git add .

git commit -m "backup before using codex"

这一步看起来麻烦,但对新手非常重要。因为 AI 写代码很快,改代码也很快。越是快,越需要有一个可以回退的安全点。

五、第一次打开终端并登录 Codex

准备好 Node.js 和 Git 之后,就可以进入 Codex 的安装和登录环节。在 Windows 上,可以按 Win + R,然后输入 cmd 或 powershell 打开终端。

如果使用 Codex CLI,OpenAI 官方文档介绍 Codex CLI 是可以在本地终端运行的编码代理,能在选中的目录中读取、修改并运行代码。

Windows 上也可以通过原生 Codex App、CLI 或 IDE 扩展使用 Codex。桌面 App 更适合新手,CLI 更适合终端用户,IDE 扩展则适合在 VS Code 等编辑器里边写边改。

安装或启动 Codex 以后,通常需要先完成登录授权。常见流程是:打开终端 → 执行登录命令 → 跳转浏览器 → 登录账号 → 授权成功 → 回到终端继续使用。

六、让 Codex 开始为你干活

很多新手第一次使用,容易直接说:“帮我优化这个项目。”这个问题太大了。Codex 当然可以开始分析,但它很难知道你想先改哪里,也很难判断你的项目目标。

更安全的做法是,从小任务开始。比如先让它解释项目目录结构,再让它说明启动方式,最后再让它修复一个具体 bug。

先帮我解释这个项目的目录结构,不要修改代码。

告诉我这个项目应该如何启动,先不要修改代码。

帮我找出可能需要优化的地方,先只给建议。

帮我修复一个 bug,并说明你准备修改哪些文件。

小提示

第一次使用时,建议在提问最后加一句:“先不要修改代码。”等它解释清楚项目结构、启动方式和修改方案之后,再让它动手。

七、最常见的两个问题

问题一:登录失败

登录失败通常有几个原因:网络不稳定、浏览器授权没有完成、账号没有对应权限,或者终端会话超时。遇到这种情况,不要反复乱输命令。先检查网络,然后重新打开终端,再按提示登录一次。

问题二:命令找不到

比如你输入 node -v,结果提示找不到 node;或者输入 codex --version,结果提示找不到 codex。这种情况通常不是 Codex 本身的问题,而是环境变量或安装路径没有生效。

可以按这个顺序排查:先确认 Node.js 是否安装成功,再确认 npm 是否可用,然后重新打开终端,必要时重启电脑。

八、安装完成后,立刻做这 4 个检查

装完之后,不要马上打开项目开干。先在终端里依次检查:

node -v

npm -v

git --version

codex --version

如果这些命令都能正常返回版本号,就说明基础环境基本没问题。如果某一条命令失败,就先解决这一条,不要跳过。很多后续问题,本质上都是这里没有检查清楚。

九、Windows 新手最该避开的坑

·一上来就让 Codex 大改项目:建议先解释,再修改。

·没有安装 Git:哪怕不是程序员,也建议学会最基础的 git status、git add、git commit。

·命令出错就乱搜索、乱复制:先看报错里到底是 node、npm、git 还是 codex 找不到。

·把权限给出去之后不看 diff:每次修改之后,最好检查它改了哪些文件、改了哪些行。

·不知道项目怎么启动就让它优化:先让 Codex 解释启动方式,再让它修改功能。

十、一句话记住

在 Windows 上使用 Codex,不要急着让它直接写代码。先把 Node.js、Git、终端和账号授权准备好,再用小任务测试它。

对 Windows 新手来说,最稳的顺序是:先装环境,再做备份,最后让 Codex 进项目。这样上手会快很多,也安全很多。

最后

AI 编程工具真正提高效率的方式,不是让你完全不管代码,而是把重复、繁琐、试错成本高的部分降下来。第一次用 Codex,先给它一个清晰、安全、可回退的工作环境。

按顺序装好环境,确认命令能跑,先让它解释,再让它修改,这就是 Windows 小白最稳的入门方式。