#4. 进入项目

#项目选择

Codex 可以在任何目录下运行，但在 Git 仓库中运行效果最好。Git 不仅让你可以安全回退任何改动，也让 Codex 能理解项目的版本历史和分支结构。

打开终端，进入你想要 Codex 操作的项目根目录，然后启动 Codex

如果你用的是 Codex 桌面应用，可以点击添加新项目进入项目目录。

#代码读取

Codex 启动后会自动扫描当前目录的文件结构。它不会一次性读取所有文件（这不现实也没必要），而是在需要时按需检索相关文件。你可以通过 @ 符号在输入框中引用特定文件——输入 @ 后会出现模糊搜索，按 Tab 或 Enter 插入文件路径。

如果你的项目仓库里有 AGENTS.md 文件，Codex 会在每次启动时自动读取它。这个文件的作用就像是给 Codex 的一份"新人入职指南"——告诉它项目的结构、使用的技术栈、如何运行测试、有哪些需要遵守的规范。后面会详细介绍如何编写这个文件。

#初始检查

进入项目后，建议先做一次简单的确认对话：

请帮我看一下这个项目的整体结构，用了什么技术栈，入口文件在哪里。

这样做的目的是验证 Codex 是否正确理解了你的项目，同时也帮你建立一个初始上下文。如果 Codex 的理解有偏差，你可以在这个阶段纠正，避免后面的操作跑偏。