Codex EPERM 操作被拒绝错误处理用 Codex 改项目代码时偶尔会遇到EPERM: operation not permitted、permission denied、operation not permitted, unlink这类错误。最常见的场景是Codex 想创建、修改、删除某个文件但当前进程没有权限或者文件正被系统、编辑器、杀毒软件、构建进程占用。排这个问题不要一上来重装 Codex先看两件事报错路径是哪一个文件以及 Codex 当前是以什么用户、什么工作目录运行的。多数问题都能从这里定位。一、常见错误现象典型报错大概是下面几种### token云桥中转 0029.org ### EPERM: operation not permitted, open C:\project\demo\src\index.tsEPERM: operation not permitted, unlink /Users/dev/project/node_modules/.cache/xxxError: permission denied, mkdir /workspace/.codex如果是在 Windows 上unlink、rename报 EPERM 很常见通常表示文件被占用或者目录受保护。如果是在 macOS/Linux 上更多是目录属主不对、执行用户不对、文件权限不够。二、先判断是哪类原因1. 当前目录没有写权限比如项目目录是从别的用户复制来的或者之前用sudo执行过安装命令导致部分文件归root所有。Codex 后续用普通用户运行自然无法修改。Linux/macOS 下先看目录属主pwd ls -la ls -la src重点看报错文件所在目录的属主和权限。如果看到文件属主是root而你当前用户不是 root就基本对上了。查看当前用户whoami2. 文件被占用或锁定Windows 上比较常见。比如项目正在运行 dev server、测试进程、打包进程或者 VS Code 插件、杀毒软件正在扫描文件。Codex 想删除或重命名文件时就可能报 EPERM。可以先停掉开发服务Ctrl C如果是 Node 项目也可以查一下是否还有残留进程tasklist | findstr node需要结束时taskkill /F /IM node.exe3. 项目放在受保护目录不要把项目放在C:\Program Files、系统盘根目录、受企业策略保护的目录里。Windows 推荐放到用户目录下例如C:\Users\你的用户名\Projects\demomacOS/Linux 推荐放在自己的 home 目录下/Users/dev/projects/demo /home/dev/projects/demo4. Codex 的工作目录不对有时不是权限问题而是 Codex 在错误目录里执行修改。比如你在上级目录启动它尝试写入一个不存在或无权限的路径。启动前确认目录cd /path/to/your/project pwd ls在 Windows PowerShell 里cd D:\Projects\demo Get-Location dir三、逐步修复方法步骤 1确认报错文件能否手动写入不要直接猜先手动测试一下。Linux/macOSecho test ./codex-permission-test.txt rm ./codex-permission-test.txtWindows PowerShelltest | Out-File .\codex-permission-test.txt Remove-Item .\codex-permission-test.txt如果这个测试都失败说明不是 Codex 的问题而是当前目录本身不能写。步骤 2修复目录属主Linux/macOS 下如果项目文件被 root 或其他用户占用可以把项目目录改回当前用户。注意只对自己的项目目录操作不要对系统目录乱执行。sudo chown -R $(whoami) /path/to/your/project然后再检查ls -la /path/to/your/project如果只是某个目录没有写权限可以补充写权限chmod -R urw /path/to/your/project一般不建议直接chmod -R 777虽然短时间看起来能解决但会留下安全和协作问题。步骤 3清理被占用的缓存和构建目录Codex 修改项目时报错路径如果在node_modules、.next、dist、build、.cache里优先考虑停进程后清缓存。rm -rf node_modules/.cache rm -rf dist build .nextWindows PowerShellRemove-Item -Recurse -Force .\dist, .\build, .\.next -ErrorAction SilentlyContinue Remove-Item -Recurse -Force .\node_modules\.cache -ErrorAction SilentlyContinue如果 Windows 删除仍然失败先关掉 VS Code、终端、浏览器预览进程再试一次。实在不行重启后第一时间删除通常能处理文件锁。步骤 4避免用 sudo 运行包管理命令很多 EPERM 是前面埋下的坑安装依赖时用了sudo npm install后面普通用户就改不了生成的文件。推荐修复 npm 全局目录而不是长期 sudomkdir -p ~/.npm-global npm config set prefix ~/.npm-global然后把下面内容加入 shell 配置例如~/.zshrc或~/.bashrcexport PATH~/.npm-global/bin:$PATH重新加载source ~/.zshrc步骤 5检查 Codex 配置目录如果报错路径指向.codex、用户配置目录或缓存目录也要检查这些目录权限。比如ls -la ~/.codex ls -la ~/.config修复方式同样是把属主改回当前用户sudo chown -R $(whoami) ~/.codex ~/.config如果你在公司网络或受限环境里使用 Codex经常还会同时遇到接口连接失败、超时、鉴权异常等问题。我的习惯是先把本地权限问题排干净再考虑网络和 API 通道。需要稳定中转时可以了解一下 token云桥AI中转站 0029.org适合做接口连通性验证和备用通道不要把本地 EPERM 和网络问题混在一起排。四、修复后的验证方式权限修完后不建议直接让 Codex 大范围改代码。先做小动作验证。1. 验证当前目录写入echo ok codex-write-check.txt cat codex-write-check.txt rm codex-write-check.txtWindows PowerShellok | Out-File .\codex-write-check.txt Get-Content .\codex-write-check.txt Remove-Item .\codex-write-check.txt2. 验证依赖和构建如果刚清理过缓存或构建目录重新安装和构建一次npm install npm run buildpnpm 项目pnpm install pnpm build如果构建能正常跑说明文件读写基本恢复。3. 让 Codex 做一次小改动例如只让它修改 README 或加一行注释。确认不会再出现 EPERM 后再让它处理复杂任务。这样可以避免一次失败后留下半改状态。五、避免复发的几个习惯项目放在用户目录不放系统保护目录。不要混用管理员终端和普通终端修改同一个项目。尽量不要用sudo npm install、sudo pnpm install。Codex 操作前先停掉 dev server、测试监听、打包进程。Windows 上遇到删除失败优先怀疑文件占用而不是马上重装工具。把node_modules、dist、.next这类生成目录排除在不必要的扫描和同步之外。总结Codex 的 EPERM 本质上多数是文件系统权限或文件占用问题。排查顺序建议固定下来先看报错路径再测当前目录写入再查属主和占用最后清缓存、修权限、重新验证。不要一开始就重装 Codex也不要随手给全目录777。按路径和权限一步步查通常很快能定位到真正原因。