必须先进入项目根目录并以只读模式启动codex cli，确认其准确识别入口文件、模块依赖与测试位置后，才能安全执行后续修改。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让 Codex CLI 真正理解当前项目结构，而不是靠复制粘贴代码片段——只有它准确识别出入口文件、模块依赖和测试位置，后续改 Bug 或加功能才不会误伤无关代码。
启动前确认项目根目录
打开终端，cd 进入你项目的最外层文件夹，确保该目录下有 package.json、pyproject.toml、Cargo.toml 或 Makefile 等标志性文件。Codex CLI 的上下文完全由当前工作目录决定，【一旦在错误目录启动，它读到的就是空目录或无关文件】。
执行 pwd 命令核对路径，别凭记忆判断——很多开发者误在子目录（比如 src/ 或 backend/）里启动，结果 Codex 只看到局部代码，漏掉配置和路由入口。
用只读模式首次加载项目
在项目根目录下运行：codex -s read-only。
这会强制 Codex 进入只读分析状态，不写任何文件、不执行命令、不修改配置。它会自动扫描目录树，识别语言类型、框架特征和关键路径。如果你跳过这步直接输入“帮我修登录页”，Codex 可能从 node_modules 里找错入口，或把 .gitignore 里的构建产物当成源码来分析。
等终端出现 “Project analysis complete” 提示后，再问：“列出所有与用户鉴权相关的文件路径”，它返回的结果才可信。
验证它是否真读懂了项目
第一步：让它指出项目主入口文件。例如 Node.js 项目问“main 入口是哪个文件”，Python 项目问“__main__.py 在哪”，Rust 问“lib.rs 还是 main.rs 是程序起点”。
第二步：让它定位一个已知模块。比如你清楚 auth 目录下有 jwt.py，就问“jwt.py 文件里定义了哪些函数”，如果它能准确列出 decode_token、verify_signature 等函数名，说明已成功解析 AST 而非仅做字符串匹配。
第三步：交叉验证影响范围。问“修改 utils/date.py 会影响哪些测试文件”，它若能返回 test_date_format.py 和 test_api_timestamps.py，而非笼统说“可能影响全部”，说明已建立模块依赖图。
三项全通过，才代表 Codex 真正载入了项目语义，不是在猜。
避免常见加载失败场景
方法一：遇到 “Failed to list files” 错误，先检查当前目录是否有读取权限。Linux/macOS 下执行 ls -la，确认 .git、src、tests 等目录没有被 chmod 000 锁死；Windows 上注意路径是否含中文或超长路径（>260 字符），此时需启用 LongPathsEnabled 或改用 WSL。
方法二：如果 Codex 返回 “No project structure detected”，大概率是缺少语言标识文件。Python 项目缺 pyproject.toml 或 setup.py，JS 项目缺 package.json，就手动补一个最小化文件——哪怕只写一行 {"name":"temp"}，也能触发正确解析器。
方法三：大项目首次加载慢（>90 秒），不是卡死。Codex 默认扫描前两层目录并索引关键文件，不遍历 node_modules 或 target/。如需加速，可在 ~/.codex/config.toml 中添加 skip_dirs = ["node_modules", "venv", ".git"]。
