1. 先别急着重装command not found 到底卡在哪一步codex: command not found这个报错本质上是 shell 在 PATH 列出的所有目录里翻了一遍没找到名叫codex的可执行文件。它跟 Codex CLI 本身能不能跑、模型能不能调通完全是两码事——命令都还没被找到后面的逻辑根本没机会执行。Codex CLI 是通过 npm 分发的命令行工具安装时 npm 会做两件事在全局 bin 目录放一个入口脚本同时拉取对应平台的原生二进制。这两件事任何一件没落地你敲codex都会得到 command not found。所以排查思路就三条线索npm 全局 bin 目录在哪、这个目录有没有进 PATH、原生二进制有没有真的下载下来。适合谁看刚用npm install -g openai/codex装完却发现命令用不了的开发者在 CI 或公司内网环境装完同样报错的同学以及混用过 npm、pnpm、yarn 导致环境混乱的人。下面按顺序走一遍基本能定位到你的具体原因。2. 用 TaoToken 把 Codex CLI 跑起来的前置准备Codex CLI 装好之后要真正干活得有一个能调模型的入口。我这边习惯用 TaoToken 做统一接入它的 API 地址是https://taotoken.net/api兼容常见的 OpenAI 风格调用方式Codex CLI 这类工具配置起来比较省事。在动手排查 PATH 之前建议先把两样东西准备好一个是可用的 API Key另一个是确认你的 Node.js 和 npm 版本别太老。Node 建议 18 以上npm 建议 9 以上老版本 npm 的全局目录行为和现在差异较大容易让排查更绕。获取 Key 的入口在控制台的 API Keys 页面登录后新建一个即可。如果你还没决定用哪种方式接入可以先到模型对话页面体验一下调用是否通顺确认账号和额度没问题再回到本地折腾 CLI。这样能避免把「命令找不到」和「Key 无效」两类问题混在一起排查。提示先把 Key 拿到手再排查 PATH是因为 PATH 修好之后你马上要验证codex能不能真正发起请求两步连着做效率最高。3. 可复制的排查与修复配置3.1 确认 npm 全局 bin 目录并检查 PATH第一步永远是看 npm 把全局命令放哪了npm config get prefix这个命令会输出一个路径Linux/macOS 下全局可执行文件通常在prefix/binWindows 下通常在prefix本身。拿到路径后看它在不在 PATH 里echo $PATH如果输出里没有prefix/bin那 command not found 的原因就找到了。把它追加进 shell 配置echo export PATH$(npm config get prefix)/bin:$PATH ~/.zshrc source ~/.zshrc用 bash 的话把~/.zshrc换成~/.bashrc。改完新开一个终端再敲which codex验证which codex能打印出路径就说明 shell 已经能找到它了。3.2 检查原生二进制是否下载完整PATH 没问题但执行仍然异常就要看包目录里的原生二进制在不在npm root -g ls $(npm root -g)/openai/codex正常应该能看到入口脚本和对应平台的二进制文件。如果目录里空荡荡或者缺了平台相关的文件说明安装时的下载环节没完成。可以手动触发重建npm rebuild -g openai/codex3.3 排查 postinstall 脚本是否被跳过有些环境会全局设置ignore-scripts导致依赖原生二进制的 postinstall 脚本被跳过安装日志看着成功实际关键文件没落地npm config get ignore-scripts如果返回true临时关掉再重装npm config set ignore-scripts false npm install -g openai/codex3.4 统一包管理器避免混装pnpm 和 yarn 的全局目录跟 npm 不一样混用很容易出现「装了但找不到」。先逐个卸载再统一用 npm 重装npm uninstall -g openai/codex pnpm remove -g openai/codex yarn global remove openai/codex npm install -g openai/codex3.5 配置 Codex CLI 指向 TaoToken命令能找到之后把模型接入配好。Codex CLI 一般通过环境变量读取 API 地址和 Keyexport OPENAI_API_KEY你的 TaoToken Key export OPENAI_BASE_URLhttps://taotoken.net/api想让它长期生效把这两行也写进~/.zshrc或~/.bashrc。如果你更习惯用 Coding Plan 的方式管理长期编码任务可以在控制台里对应配置思路是一样的——把地址和凭证交给 CLI。4. 验证请求与成功结果配置完成后先确认命令本身可用codex --version能打印版本号说明 PATH 和二进制都没问题。接着发一个最小请求验证链路codex 用一句话解释什么是递归如果模型正常返回内容说明从 CLI 到 TaoToken 的整条链路是通的。这一步很关键因为它把「命令找不到」和「请求失败」两类问题彻底分开了——前者是环境问题后者是配置或网络问题。实测下来大部分 command not found 在 3.1 那一步就解决了剩下的小部分集中在 postinstall 被跳过和包管理器混用上。验证通过后建议把codex --version加进你的环境初始化脚本新机器一装完就跑一次早发现早处理。5. 本篇常见错排查改了 .zshrc 但没生效确认你改的是当前 shell 对应的配置文件。用echo $SHELL看默认 shellzsh 改.zshrcbash 改.bashrc。改完必须source或新开终端。Windows 下提示无法识别除了 PATH还要确认全局目录里生成了.cmd或.ps1脚本。PowerShell 执行策略可能拦截.ps1这类报错通常是「找到了但拒绝执行」跟纯 command not found 不同需要单独处理执行策略。Docker 构建时找不到命令构建容器的网络环境跟主机不同npm install -g那一层可能没真正下载成功。在 Dockerfile 里加一行RUN codex --version让问题在构建阶段就暴露而不是等到运行容器才发现。之前能用突然不行了某些软件安装会重写 shell 配置文件把 PATH 覆盖掉。检查.zshrc的最近修改时间确认 PATH 那行还在不在。安装日志一堆 warning 但显示成功重点看 warning 里有没有 postinstall 失败或网络超时的字样这类警告往往是后续 command not found 的前兆出现就主动重装一次确认。6. 把 Codex CLI 接进日常编码流程命令能跑通只是起点。真正提升效率的做法是让 Codex CLI 承担日常的代码补全、重构建议和脚本生成把重复劳动交出去。我一般会在项目根目录放一个简短的说明写清楚团队统一用 npm 安装、统一走 TaoToken 接入新成员照着做就能少踩环境坑。如果你打算长期在编码和 Agent 场景里用可以了解下 Coding Plan 的配置方式把额度和管理集中起来只是临时验证模型效果模型对话页面就够用。接入过程中遇到 Key 或地址相关的问题接入文档里有更细的参数说明配合 API Keys 页面一起看会更快定位。最后留一个自检习惯每次换机器或重装环境先跑npm config get prefix、which codex、codex --version这三条三十秒就能确认环境是否健康比等到写代码时才发现命令用不了要从容得多。
【Bug已解决】Codex CLI 报 command not found：从 npm 全局路径到 PATH 的排查与修复
1. 先别急着重装command not found 到底卡在哪一步codex: command not found这个报错本质上是 shell 在 PATH 列出的所有目录里翻了一遍没找到名叫codex的可执行文件。它跟 Codex CLI 本身能不能跑、模型能不能调通完全是两码事——命令都还没被找到后面的逻辑根本没机会执行。Codex CLI 是通过 npm 分发的命令行工具安装时 npm 会做两件事在全局 bin 目录放一个入口脚本同时拉取对应平台的原生二进制。这两件事任何一件没落地你敲codex都会得到 command not found。所以排查思路就三条线索npm 全局 bin 目录在哪、这个目录有没有进 PATH、原生二进制有没有真的下载下来。适合谁看刚用npm install -g openai/codex装完却发现命令用不了的开发者在 CI 或公司内网环境装完同样报错的同学以及混用过 npm、pnpm、yarn 导致环境混乱的人。下面按顺序走一遍基本能定位到你的具体原因。2. 用 TaoToken 把 Codex CLI 跑起来的前置准备Codex CLI 装好之后要真正干活得有一个能调模型的入口。我这边习惯用 TaoToken 做统一接入它的 API 地址是https://taotoken.net/api兼容常见的 OpenAI 风格调用方式Codex CLI 这类工具配置起来比较省事。在动手排查 PATH 之前建议先把两样东西准备好一个是可用的 API Key另一个是确认你的 Node.js 和 npm 版本别太老。Node 建议 18 以上npm 建议 9 以上老版本 npm 的全局目录行为和现在差异较大容易让排查更绕。获取 Key 的入口在控制台的 API Keys 页面登录后新建一个即可。如果你还没决定用哪种方式接入可以先到模型对话页面体验一下调用是否通顺确认账号和额度没问题再回到本地折腾 CLI。这样能避免把「命令找不到」和「Key 无效」两类问题混在一起排查。提示先把 Key 拿到手再排查 PATH是因为 PATH 修好之后你马上要验证codex能不能真正发起请求两步连着做效率最高。3. 可复制的排查与修复配置3.1 确认 npm 全局 bin 目录并检查 PATH第一步永远是看 npm 把全局命令放哪了npm config get prefix这个命令会输出一个路径Linux/macOS 下全局可执行文件通常在prefix/binWindows 下通常在prefix本身。拿到路径后看它在不在 PATH 里echo $PATH如果输出里没有prefix/bin那 command not found 的原因就找到了。把它追加进 shell 配置echo export PATH$(npm config get prefix)/bin:$PATH ~/.zshrc source ~/.zshrc用 bash 的话把~/.zshrc换成~/.bashrc。改完新开一个终端再敲which codex验证which codex能打印出路径就说明 shell 已经能找到它了。3.2 检查原生二进制是否下载完整PATH 没问题但执行仍然异常就要看包目录里的原生二进制在不在npm root -g ls $(npm root -g)/openai/codex正常应该能看到入口脚本和对应平台的二进制文件。如果目录里空荡荡或者缺了平台相关的文件说明安装时的下载环节没完成。可以手动触发重建npm rebuild -g openai/codex3.3 排查 postinstall 脚本是否被跳过有些环境会全局设置ignore-scripts导致依赖原生二进制的 postinstall 脚本被跳过安装日志看着成功实际关键文件没落地npm config get ignore-scripts如果返回true临时关掉再重装npm config set ignore-scripts false npm install -g openai/codex3.4 统一包管理器避免混装pnpm 和 yarn 的全局目录跟 npm 不一样混用很容易出现「装了但找不到」。先逐个卸载再统一用 npm 重装npm uninstall -g openai/codex pnpm remove -g openai/codex yarn global remove openai/codex npm install -g openai/codex3.5 配置 Codex CLI 指向 TaoToken命令能找到之后把模型接入配好。Codex CLI 一般通过环境变量读取 API 地址和 Keyexport OPENAI_API_KEY你的 TaoToken Key export OPENAI_BASE_URLhttps://taotoken.net/api想让它长期生效把这两行也写进~/.zshrc或~/.bashrc。如果你更习惯用 Coding Plan 的方式管理长期编码任务可以在控制台里对应配置思路是一样的——把地址和凭证交给 CLI。4. 验证请求与成功结果配置完成后先确认命令本身可用codex --version能打印版本号说明 PATH 和二进制都没问题。接着发一个最小请求验证链路codex 用一句话解释什么是递归如果模型正常返回内容说明从 CLI 到 TaoToken 的整条链路是通的。这一步很关键因为它把「命令找不到」和「请求失败」两类问题彻底分开了——前者是环境问题后者是配置或网络问题。实测下来大部分 command not found 在 3.1 那一步就解决了剩下的小部分集中在 postinstall 被跳过和包管理器混用上。验证通过后建议把codex --version加进你的环境初始化脚本新机器一装完就跑一次早发现早处理。5. 本篇常见错排查改了 .zshrc 但没生效确认你改的是当前 shell 对应的配置文件。用echo $SHELL看默认 shellzsh 改.zshrcbash 改.bashrc。改完必须source或新开终端。Windows 下提示无法识别除了 PATH还要确认全局目录里生成了.cmd或.ps1脚本。PowerShell 执行策略可能拦截.ps1这类报错通常是「找到了但拒绝执行」跟纯 command not found 不同需要单独处理执行策略。Docker 构建时找不到命令构建容器的网络环境跟主机不同npm install -g那一层可能没真正下载成功。在 Dockerfile 里加一行RUN codex --version让问题在构建阶段就暴露而不是等到运行容器才发现。之前能用突然不行了某些软件安装会重写 shell 配置文件把 PATH 覆盖掉。检查.zshrc的最近修改时间确认 PATH 那行还在不在。安装日志一堆 warning 但显示成功重点看 warning 里有没有 postinstall 失败或网络超时的字样这类警告往往是后续 command not found 的前兆出现就主动重装一次确认。6. 把 Codex CLI 接进日常编码流程命令能跑通只是起点。真正提升效率的做法是让 Codex CLI 承担日常的代码补全、重构建议和脚本生成把重复劳动交出去。我一般会在项目根目录放一个简短的说明写清楚团队统一用 npm 安装、统一走 TaoToken 接入新成员照着做就能少踩环境坑。如果你打算长期在编码和 Agent 场景里用可以了解下 Coding Plan 的配置方式把额度和管理集中起来只是临时验证模型效果模型对话页面就够用。接入过程中遇到 Key 或地址相关的问题接入文档里有更细的参数说明配合 API Keys 页面一起看会更快定位。最后留一个自检习惯每次换机器或重装环境先跑npm config get prefix、which codex、codex --version这三条三十秒就能确认环境是否健康比等到写代码时才发现命令用不了要从容得多。
