npm 安装 @openai/codex 后无法调用 codex 命令的完整解决过程：‘codex‘ 不是内部或外部命令，也不是可运行的程序或批处理文件。

小杨勇敢飞2026-03-12 17:11

一个典型的「环境配置 + 认知偏差」双重坑：明明 npm install -g @openai/codex 显示安装成功，却始终提示 'codex' 不是内部或外部命令。经过一步步排查，终于彻底解决问题，现将完整过程复盘，帮同类型场景的开发者避坑。

刚开始出现安装失败

解决方案：换一个镜像地址

安装成功，命令却无法执行

管理员身份运行 CMD 终端，核心操作及报错如下：

复制代码

# 全局安装 @openai/codex，提示安装成功
C:\Windows\System32>npm install -g @openai/codex
changed 2 packages, and audited 3 packages in 1s
found 0 vulnerabilities

# 尝试调用 codex 命令，持续报错
C:\Windows\System32>codex
'codex' 不是内部或外部命令，也不是可运行的程序或批处理文件。

即便多次重新安装，问题依旧。初步判断：要么是包本身无 CLI 功能，要么是系统环境配置存在问题。

验证 @openai/codex 是否真的提供 CLI 命令

首先推翻「包本身无 CLI 功能」的假设。通过 npm bin -g 命令查看全局 npm 包的可执行文件路径：

复制代码

C:\Windows\System32>npm bin -g
C:\Users\admin\AppData\Roaming\npm
npm ERR! bin (not in PATH env variable)

问题：npm 全局可执行路径未加入系统环境变量 PATH。

解决方法：

将 npm 全局路径添加到系统环境变量（永久生效）

按下 Win + R，输入 sysdm.cpl 回车，打开「系统属性」窗口；
切换至「高级」选项卡，点击右下角「环境变量」；
在「系统变量」列表中找到 Path 变量，双击打开编辑界面；
点击「新建」，粘贴路径：npm的路径，点击「确定」；
关键步骤：关闭所有已打开的 CMD 终端，重新以管理员身份启动（环境变量需重启终端才会生效）。