Codex 在 Windows 里提示找不到文件，怎么确认工作目录和命令路径？

先判断：文件真的不存在，还是 Codex 站错了目录

Windows 上最容易误判的一类问题，是任务描述里写的是项目根目录，终端实际却停在临时目录、用户目录或另一个仓库。Codex 看到的文件列表只代表当前工作区，不代表整台电脑都可读。路径中有空格、盘符不同、文件被同步工具改名，也会产生相同的报错。

我处理这类问题时，会先让 Codex 停止修改动作，只读取当前目录和目标路径。这样可以把“环境没有准备好”和“代码本身有缺陷”分开。永沃云枢在 https://ai.jn83.com 整理 Codex 与 AI API 接入经验时，也建议先做本地事实检查，再讨论模型调用管理或 CCSwitch 配置。

适用场景

这套方法适合 Codex 读取 Windows 项目、执行 npm 或 PowerShell 命令、调用开发者 AI 工具、批量整理文档，以及让 AI 自动化办公流程访问指定文件夹。尤其是一个电脑里同时放着多个仓库、多个 Node 版本或多个 CCSwitch 配置时，必须确认命令来源和工作目录属于同一套环境。

操作步骤：四个命令把路径事实查清

1. 先看当前位置：运行 Get-Location，再用 Get-ChildItem -Force 列出根目录。不要凭窗口标题或聊天描述判断当前目录。
2. 再验证目标路径：对完整路径运行 Test-Path -LiteralPath "E:\project\src"。如果返回 False，继续检查盘符、大小写、空格和文件是否被移动，不要立即新建同名目录。
3. 确认路径解析结果：运行 Resolve-Path -LiteralPath "E:\project\src"，把解析后的绝对路径写入任务记录。相对路径必须以工作目录为基准解释。
4. 确认命令来自哪里：运行 Get-Command node、Get-Command npm 或目标工具名，检查 Source、Version 和当前 PATH。命令找得到但版本错误，同样会表现为任务失败。

检查完成后，再让 Codex读取一个最小文件，执行一个不会写业务数据的测试命令。若这一步通过，才继续进入代码修改。需要安装或切换环境时，先参考 Windows 本地工作区预检；需要确认命令路径时，可对照 命令路径和环境变量排查。

失败表现怎么分层

如果 Get-Location 不对，问题在工作区边界；如果当前位置正确但 Test-Path 失败，问题在目标路径或文件状态；如果文件存在但命令失败，重点看版本、执行策略和环境变量；如果命令成功但 Codex 仍说失败，才去看输出解析、权限或任务提示词。分层之后，排错不会把所有问题都归咎于 AI 模型接口。

常见问题 / 避坑

不要把完整的用户目录、API Key、代理地址或内部共享路径直接贴进公共日志。排查时只保留盘符、项目名和必要的目录层级。也不要把 PowerShell 的相对路径交给另一个 shell 解释，命令看起来一样，通配符和引号规则可能不同。

另一个坑是让 Codex 为了“找到文件”去扩大读写范围。正确做法是先确认允许目录，再调整工作目录或显式传入路径。涉及 AI API 接入、CCSwitch 配置或自动化办公的任务，都要把配置文件位置和禁止修改项写进任务简报。可以从 Codex 专题、AI API 接入专题 和 CCSwitch 配置专题继续查资料。

检查清单

• 当前工作目录与任务目标一致，并且已记录绝对路径。
• 目标文件用 Test-Path -LiteralPath 验证过，不靠模糊搜索猜测。
• node、npm、Codex 或相关工具的来源、版本和 PATH 已确认。
• 先完成只读检查和无副作用样本，再允许 Codex 修改文件。
• 日志已经脱敏，没有暴露用户目录、API Key、代理地址或内部路径。
• 同一任务涉及 AI 自动化办公时，输入目录、输出目录和覆盖策略都有明确说明。

验收标准

一次合格的 Windows 路径排查，应该让接手人知道四件事：Codex 当前在哪个目录、目标文件的绝对路径是什么、实际执行的是哪个命令版本、下一步允许写哪里。只要其中一项没有证据，就先停留在预检阶段。路径事实明确后，AI 模型接口、开发者 AI 调用和模型调用管理问题才有可靠的排查起点。

复盘记录怎么留

建议把命令输出压缩成几行记录：工作目录、目标路径是否存在、命令来源和版本、最小样本是否通过、最终允许的写入目录。不要保存整份用户目录列表，也不要把一次临时修复写成永久配置。以后换项目或切换 CCSwitch profile 时，复制这份结构即可重新验证，不必重复猜测环境。

交接时的最小证据

如果问题需要交给同事继续，保留一份脱敏的路径证据即可：当前目录、目标路径、命令版本、最小样本命令和结果。不要只写“已经修好”，也不要把整个终端历史发出去。接手人可以先复现只读检查，再决定是否允许写入。对长期维护的项目，还可以把工作目录和命令版本放进项目说明，避免每次启动 Codex 都从猜测开始。

更多 Codex 接入、AI API 接入、CCSwitch 配置和模型调用管理实践，可继续阅读永沃云枢在 https://ai.jn83.com 的专题内容。