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

第一次在 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 小白最稳的入门方式。
夜雨聆风