GPT中转文档站

主题

Win安装 ​

安装前说明 ​

这篇文档教你在 Windows 电脑上安装 Codex CLI。

Codex CLI 是命令行工具，需要在 PowerShell 或 CMD 里使用。

如果你完全不想使用命令行，可以先看“APP安装”文档。

Windows 也可以使用 WSL，但小白用户建议先使用 PowerShell 方式，步骤更直接。

安装 Codex CLI 前，需要先安装 Node.js。

Node.js 会一起提供 npm，后面安装 Codex CLI 就要用到 npm。

Node.js 官方下载地址：

text
https://nodejs.org/

请下载 LTS 长期支持版，不要随便下载奇怪来源的安装包。

第一步：下载 Node.js ​

打开浏览器，进入 Node.js 官方网站：

text
https://nodejs.org/

进入页面后，选择 LTS 长期支持版。

Windows 用户一般下载 Windows Installer。

下载完成后，先不要关闭浏览器，接着安装 Node.js。

第二步：安装 Node.js ​

找到刚才下载好的 Node.js 安装包。

双击打开安装包。

安装时一般一路点击“Next”或“下一步”即可。

如果看到“Install”或“安装”，继续点击。

安装完成后，点击“Finish”或“完成”。

安装完成后，请关闭已经打开的 PowerShell 或 CMD，再重新打开一个新的 PowerShell 或 CMD。

这样 Windows 才能识别刚刚安装好的 node 和 npm 命令。

第三步：打开 PowerShell 或 CMD ​

如果你不知道 PowerShell 在哪里，可以这样打开：

  1. 点击 Windows 开始菜单
  2. 搜索 PowerShell
  3. 点击打开 Windows PowerShell

也可以按 Win + R，输入 cmd，然后按回车打开 CMD。

后面的命令在 PowerShell 或 CMD 里执行都可以。

第四步：检查 Node.js 是否安装成功 ​

复制下面这行命令，粘贴到 PowerShell 或 CMD 里，然后按回车：

bash
node -v

这个命令用来查看 Node.js 版本。

如果看到类似 v20.x.x、v22.x.x 这样的版本号，说明 Node.js 已经安装成功。

如果提示 node 命令不存在，先关闭 PowerShell 或 CMD，再重新打开一次。

如果重新打开后还是不行，可能是 Node.js 没有加入环境变量，需要重新安装 Node.js，或者检查 Windows 的 PATH 设置。

第五步：检查 npm 是否可用 ​

复制下面这行命令，粘贴到 PowerShell 或 CMD 里，然后按回车：

bash
npm -v

这个命令用来查看 npm 版本。

如果看到一串版本号，说明 npm 可以正常使用。

如果 node -v 正常，但 npm -v 不正常，可以重新安装 Node.js LTS 长期支持版。

第六步：使用 npm 安装 Codex CLI ​

确认 node -v 和 npm -v 都正常后，再安装 Codex CLI。

复制下面这行命令，粘贴到 PowerShell 或 CMD 里，然后按回车：

bash
npm i -g @openai/codex

这行命令的意思是：使用 npm 在电脑上安装 Codex CLI。

安装过程可能需要等待一会儿，请不要中途关闭窗口。

如果安装很慢，通常是网络原因，可以先等待几分钟。

第七步：检查 Codex 是否安装成功 ​

安装完成后，复制下面这行命令，粘贴到 PowerShell 或 CMD 里，然后按回车：

bash
codex --version

这个命令用来查看 Codex CLI 版本。

如果能看到版本号，说明 Codex CLI 已经安装成功。

如果提示 codex 命令不存在，先关闭 PowerShell 或 CMD，再重新打开一次。

如果还是不行，可能是 npm 全局安装目录没有加入 PATH。

第八步：第一次启动 Codex ​

建议先进入你要处理的项目文件夹，再启动 Codex。

如果你还不知道项目文件夹在哪里，可以先打开项目所在位置，再在地址栏输入 cmd 打开终端。

复制下面这行命令，粘贴到 PowerShell 或 CMD 里，然后按回车：

bash
codex

这个命令会启动 Codex。

第一次启动时，终端可能会提示你登录。

按照终端里的提示一步一步操作即可。

常见问题 ​

PowerShell 在哪里打开？ ​

点击 Windows 开始菜单，搜索 PowerShell，然后点击打开。

也可以按 Win + R，输入 cmd，按回车打开 CMD。

node 命令不存在怎么办？ ​

先关闭 PowerShell 或 CMD，然后重新打开。

如果还是提示找不到 node，说明 Node.js 可能没有安装成功，或者没有加入环境变量。

建议重新从 Node.js 官网下载 LTS 长期支持版并安装。

npm 命令不存在怎么办？ ​

正常情况下，安装 Node.js 后会自动带上 npm。

如果 npm -v 不可用，可以重新安装 Node.js LTS 长期支持版。

安装完成后记得重新打开 PowerShell 或 CMD。

npm 安装很慢怎么办？ ​

安装慢通常是网络原因。

可以先等待几分钟，不要反复关闭窗口。

如果一直没有进度，可以换一个网络环境后再试。

codex 命令不存在怎么办？ ​

先确认安装命令是否执行成功：

bash
npm i -g @openai/codex

然后关闭 PowerShell 或 CMD，重新打开后再执行：

bash
codex --version

如果还是不行，可能是 Node.js 或 npm 的环境变量没有配置好。

安装完成后下一步做什么？ ​

进入你要处理的项目文件夹。

然后复制下面这行命令，粘贴到终端里并按回车：

bash
codex

启动后按照 Codex 的提示登录并开始使用。