必须在项目根目录启动Codex或手动绑定根路径，否则所有操作将偏离目标目录；CLI方式需cd至根目录后运行codex，桌面端可通过Projects添加或拖拽文件夹，并确认右上角路径与pwd一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让 Codex 立刻开始处理你当前正在开发的项目，而不是从空对话或错误路径起步，就必须让它准确识别并绑定到你的项目根目录——这一步错了，后续所有文件读写、命令执行都会偏离目标位置，甚至在错误文件夹里生成一堆无用文件。
用 CLI 在项目根目录启动 Codex
打开终端（Windows PowerShell / macOS Terminal / Linux bash），cd 进入你的项目根目录，例如：cd /Users/you/dev/my-api 或 cd D:\projects\frontend。
输入 codex 并回车。Codex 会自动将当前路径识别为 Project 根目录，并加载 .git、package.json、pyproject.toml 等标识性文件来理解项目结构。
这一步不能跳过：如果直接在桌面或用户主目录下运行 codex，它会把那个路径当作项目根，后续所有操作都发生在错误位置，【修改、新建、删除都将作用于非目标目录】。
桌面客户端中手动绑定项目根目录
方法一：点击左侧边栏「Projects」→「+ Add Project」→ 选择你的项目文件夹（必须是含源码的顶层目录，不是子文件夹）。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法二：拖拽整个项目文件夹到 Codex 主窗口空白区，松手即完成绑定。
注意：绑定后右上角会显示项目路径，确认它和你终端里 pwd 输出的路径完全一致。路径末尾多一个斜杠或少一个字母，都可能导致 AGENTS.md 读取失败或 sandbox 权限拒绝写入。
首次启动时自动识别失败怎么办
第一步：检查当前目录是否真的包含项目标识文件，比如 package.json（JS）、requirements.txt（Python）、.git 文件夹（Git 仓库）。
第二步：如果存在但未识别，手动创建 .codex/config.toml 文件，在其中写入：sandbox_mode = "workspace-write"project_root = "/your/absolute/path/to/project"（Windows 用双反斜杠或正斜杠均可，如 D:/dev/my-app）。
第三步：重启 Codex 客户端，或在 CLI 中重新运行 codex。此时它会强制以 config.toml 中声明的路径为唯一工作区，不再依赖自动探测。
