用 Codex 修改真实项目时，经常会遇到一种情况：

同一条命令，自己在终端里能正常执行，交给 Codex 却一直失败。

常见表现包括：

• npm test 提示找不到命令；

• Python脚本无法启动；

• 项目明明存在，却提示找不到文件；

• 安装依赖时报权限错误；

• Windows能运行的命令，换个环境就失败；

• Codex修改完代码，却无法完成最后的测试验证。

这种问题不一定是代码写错了。

很多时候真正出问题的是：

工作目录、Shell环境、权限或者环境变量。

一、先确认Codex当前在哪个目录

这是最容易忽略的问题。

例如项目实际目录是：

/project/web-app

但命令却在：

/project

执行。

这时候运行：

npm test

就可能找不到 package.json。

遇到命令失败，可以先确认：

pwd

然后检查当前目录里是否真的存在：

package.json
pyproject.toml
requirements.txt
pom.xml

不要看到“命令失败”就立刻怀疑依赖。

先确认：

命令是不是在正确目录执行。

---

二、Shell不同，命令写法也可能不同

开发环境里常见的 Shell 包括：

• Bash；

• Zsh；

• PowerShell；

• CMD。

有些命令在 Linux/macOS 中正常：

export API_KEY=test

到了 PowerShell 就需要使用不同写法。

路径也是一样。

例如：

./scripts/test.sh

在某些 Windows 环境中可能无法直接执行。

所以如果自己电脑能跑、Codex执行失败，可以先检查：

两边是不是使用了不同的Shell。

不要直接把某个系统里的命令原样复制到另一种环境。

---

三、出现“command not found”先查环境

如果看到：

command not found

不一定意味着工具没有安装。

还可能是：

PATH没有正确加载。

例如开发者自己的终端启动时会自动加载：

.zshrc
.bashrc
profile

其中可能配置了：

Node；

Python；

pnpm；

其他开发工具。

但Agent运行命令的环境未必加载了完全相同的配置。

可以先检查：

node -v
python --version
pnpm -v

确认真正运行的是哪个版本。

---

四、环境变量缺失也会导致命令失败

有些项目启动依赖：

DATABASE_URL
API_KEY
NODE_ENV

如果缺少这些变量，代码可能能成功编译，但启动或测试直接失败。

例如出现：

Missing DATABASE_URL

这时候继续修改业务代码没有意义。

应该先检查：

• .env 是否存在；

• .env.example 有哪些必需字段；

• 测试环境是否有独立配置；

• 当前Shell是否加载了环境变量。

尤其不要把：

环境配置错误

误判成：

代码错误。

---

五、权限错误不要直接使用最高权限解决

如果出现：

Permission denied

先确认到底是哪一步没有权限。

可能是：

• 脚本没有执行权限；

• 目录不能写入；

• 文件属于其他用户；

• 当前工具不允许访问某个路径。

例如Shell脚本可能只是缺少执行权限。

这和程序逻辑完全无关。

需要注意的是：

不要一看到权限问题就直接使用高权限命令强行解决。

先确认具体文件和目录，再选择最小范围的处理方式。

---

六、优先使用项目已经定义好的脚本

如果 package.json 已经提供：

npm run test
npm run lint
npm run build

最好优先使用这些项目脚本。

不要自己猜：

jest
eslint .
tsc

因为项目脚本里可能已经包含：

• 特殊参数；

• 环境变量；

• 配置文件；

• 前置命令。

直接运行底层工具，有时反而和项目真正的执行方式不一致。

---

七、命令失败后不要连续换命令碰运气

有一种很常见的情况：

第一条命令失败；

马上换第二条；

第二条失败；

再尝试第三条。

最后执行了一堆命令，却还不知道根因。

更好的方式是先检查错误信息：

如果提示文件不存在

检查工作目录和路径。

如果提示命令不存在

检查工具安装和PATH。

如果提示权限不足

检查文件权限。

如果提示配置缺失

检查环境变量。

先判断错误属于哪一类，再处理。

---

八、一个比较稳定的排查顺序

Codex执行命令失败时，可以按这个顺序检查：

第一步：确认当前工作目录。

先看命令到底在哪里执行。

第二步：确认项目使用什么Shell和包管理器。

避免命令写法不兼容。

第三步：检查工具版本。

确认Node、Python、pnpm等是否存在。

第四步：检查环境变量。

看项目启动需要哪些配置。

第五步：检查权限。

确认脚本和目录是否允许执行。

第六步：优先运行项目自带脚本。

不要随意改成其他命令。

---

最后

Codex执行命令总是失败，很多时候并不是AI不会使用终端。

真正的问题通常是：

它运行命令的环境，和开发者平时使用的环境并不完全一样。

所以遇到问题时，不要只盯着：

这条命令为什么报错？

还要继续确认：

在哪里运行、用什么Shell、加载了什么环境变量、当前拥有什么权限。

把这些基础环境确认清楚以后，很多所谓的“Codex命令失败”都会很快找到真正原因。

---

持续更新 Codex、大模型开发与 AI 编程实战内容，更多技术内容欢迎搜索关注「仙逆GPT」。