codex项目目录设置错误会导致找不到agents.md等关键文件，执行任务时静默失败或报“file not found”。需先确认工作目录是否为含agents.md和src/的根目录，用codex --debug status检查working directory字段；若不正确，可用--working-dir参数、cd至根目录启动或配置default_working_dir修复；注意避免符号链接、相对路径及mac访达路径陷阱；最后用codex read --project .验证是否成功索引文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex项目目录设置错误会导致它找不到AGENTS.md、.codex/config.toml或源码文件，执行任务时静默失败、报错“file not found”或反复扫描空目录。
确认当前工作目录是否正确
在终端中进入你认为的项目根目录（即包含AGENTS.md和src/的那层），运行：
codex --debug status
观察输出中的Working Directory字段。如果显示路径不是你预期的项目根目录，说明Codex没在正确位置启动——【这是所有后续操作的前提】。不要跳过这步直接改配置，否则可能越修越偏。
强制指定项目根目录的三种方法
方法一：用--working-dir参数临时覆盖
在任意路径下，执行：codex --working-dir /full/path/to/your/project "fix login bug"
方法二：在项目根目录下启动（推荐）
cd /full/path/to/your/project → codex "fix login bug"
这比加参数更可靠，因为Codex会自动向上查找最近的AGENTS.md作为项目锚点。注意：路径必须是绝对路径，不能用~/或./开头。
方法三：设为默认工作目录（仅限CLI v0.9.3+）
编辑~/.codex/config.toml，在[project]段落下添加：
default_working_dir = "/full/path/to/your/project"
保存后重启终端。此后所有未显式指定--working-dir的命令都以此为准。
修复因符号链接或相对路径引发的解析错误
第一步：检查当前目录是否存在符号链接
执行 pwd -P，对比输出与pwd结果。若不一致，说明你正处在软链接目录中。Codex对符号链接解析不稳定，容易丢失上下文。
第二步：切换到真实物理路径
cd "$(pwd -P)" → 再次运行codex status确认Working Directory已更新为真实路径。
第三步：避免在启动命令中使用../等相对路径
错误写法：codex --working-dir ../my-project
正确写法：codex --working-dir /home/user/my-project（Linux/macOS）或 codex --working-dir C:\Users\user\my-project（Windows）
【相对路径在Docker或CI环境中极易失效】
Mac用户特别注意访达路径陷阱
打开Codex后点击「项目」→「打开文件夹」，访达弹出窗口时，立刻按 Command+Shift+H 回到用户主目录，再手动在地址栏输入完整路径（如/Users/yourname/Desktop/my-project），不要用左侧边栏点击“桌面”——该入口常带隐藏的.DS_Store和iCloud冲突文件，Codex加载时会卡死或跳过整个目录。
粘贴路径后回车，Codex会立即尝试读取AGENTS.md。若仍失败，说明该路径下确实没有AGENTS.md，需手动创建。
验证修复是否生效
在修正后的目录下运行：
codex read --project .
等待输出出现“Context built: X files indexed, Y modules resolved”。若卡在“scanning node_modules”，立即中断并补加--ignore node_modules参数——这一步成功，才算真正锚定了项目边界。
