### [02｜在 Windows 安装 Codex CLI：Node.js、npm 与 PowerShell](https://www.escai.cn/docs/18)

**Published:** 2026-07-31T15:38:31

**Author:** 奕商创

**Excerpt:** 在 Windows 安装 Node.js 与 Codex CLI，并解决 npm.ps1、PATH 和同名命令冲突等常见问题。

Codex 桌面应用适合交互式协作；CLI 则适合在项目目录中直接运行任务。本篇以 Windows 为例，完成 CLI 安装并排查最常见的终端问题。

![Codex 快速上手第二篇封面：安装 Codex CLI](https://wp.escai.cn/wp-content/uploads/2026/07/codex-quickstart-02.jpg)

第二步：准备 Node.js，安装 CLI，并验证终端命令。

## 1\. 安装前准备

Codex CLI 通过 npm 安装，因此需要先安装 Node.js LTS。安装完成后，关闭当前 PowerShell 并重新打开，再执行：

```
node --version
npm --version
```

两个命令都应返回版本号。若提示找不到命令，通常是安装未完成或新终端尚未读取更新后的 PATH。

## 2\. 安装 Codex CLI

```
npm install -g @openai/codex
```

安装完成后验证：

```
codex --version
```

如果显示版本号，说明 CLI 已可用。之后进入项目目录，运行 `codex` 即可开始终端任务。

## 3\. PowerShell 阻止 npm.ps1 怎么办

有些 Windows 环境会显示“禁止运行脚本”并阻止 `npm.ps1`。这是 PowerShell 的执行策略造成的入口限制，不代表 npm 没有安装。优先使用：

```
npm.cmd install -g @openai/codex
```

`npm.cmd` 不依赖 PowerShell 脚本入口，通常可以避免为了安装一个工具而修改全局安全策略。

## 4\. codex 命令找不到或无法执行

-   重新打开 PowerShell，确认 npm 的全局命令目录已加入 PATH。
-   先运行 `npm.cmd install -g @openai/codex`，确认安装没有报错。
-   如果系统命中了同名但不可执行的程序，可直接使用 npm 全局目录中的 `codex.cmd`。

## 5\. 最小验证流程

```
node --version
npm --version
codex --version
codex
```

前三行验证运行环境，最后一行启动交互式 CLI。第一次进入项目时，先要求它阅读项目说明和推荐验证命令，再让它执行修改。

## 下一篇

下一篇将连接第一个 MCP 服务，并说明如何安全保存令牌、验证工具连接和控制写入范围。



---