Codex 安装完整教程

一、安装前准备

CLI 方式需要 Node.js 和 npm。先打开 PowerShell、Windows Terminal 或系统终端，分别执行下面两条命令。能看到版本号，再继续下一步。

如果提示“不是内部或外部命令”，先到 Node.js 官方网站安装 LTS 版本。安装完成后关闭当前终端窗口，再开一个新的窗口，让系统重新加载 PATH。

二、安装 Codex CLI

确认 npm 可用后，执行官方 CLI 的安装命令：

安装过程需要联网。如果 npm 报权限错误，不要随便使用来路不明的“绿色版”替代。先看常见报错排查页，确认是权限、网络还是 Node.js 环境问题。

三、登录

安装完成后，执行：

按照终端给出的官方登录流程完成认证。登录时不要把密码、验证码或私密令牌发给任何人。人工协助安装时，也只需要看命令输出，不需要你提供账号凭证。

四、验证安装

先确认命令已经在 PATH 中：

能正常输出版本信息，说明 CLI 已经安装成功。接着进入一个你允许 Codex 读取的项目目录：

macOS 或 Linux 的路径写法不同，例如：

五、安装后应该做什么

打开 Codex 后，先让它说明当前项目结构，再给一个范围小、结果容易验证的任务。例如“检查首页移动端是否有横向滚动，并告诉我涉及哪些文件”。做完后查看 diff 和测试结果，再决定是否接受改动。

如果你想看完整的第一次使用流程，继续阅读怎么使用 Codex 完成第一个任务。