codex 项目结构可通过桌面版项目树、cli tree 命令或 agents.md 自动生成三种方式快速查看。桌面版需确保项目根目录含 .git/.codex/config.toml/agents.md；cli 需安装并运行 codex tree --depth=2；agents.md 需明确声明目录用途以支持语义化结构分析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想快速看清 Codex 当前项目里有哪些文件、目录怎么组织、哪些是关键配置，而不是靠手动一层层点开或 ls 列表猜路径。
在 Codex 桌面版中直接查看项目树
打开 Codex 桌面客户端 → 左侧导航栏默认显示「项目」面板 → 点击当前已加载的项目名称（如 my-api-service）→ 展开后即可看到完整的文件树视图，包括 .codex/、app/、config/、AGENTS.md 等核心项。
这一步不需要任何命令或插件，只要项目已正确加载，树状结构就实时渲染。如果树为空或只显示根目录名，说明你没从仓库根目录启动 Codex —— 【必须确保当前项目路径下存在 .git 或 AGENTS.md 或 .codex/config.toml】，否则 Codex 不会识别为有效项目。
用 CLI 快速输出扁平化目录结构
在终端中进入项目根目录 → 运行：codex tree --depth=2。
该命令会以缩进格式列出最多两层深度的目录和关键文件，比原生 tree 更聚焦 Codex 关注的路径（自动过滤 node_modules/、.git/ 等无关内容）。若提示 command not found，说明未安装 Codex CLI 或未加入 PATH；此时请改用桌面版或先运行 curl -sS https://get.codex.dev | sh 安装。
通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
通过 AGENTS.md 自动生成结构快照
方法一：在项目根目录确认存在 AGENTS.md 文件 → 用 Codex 发送指令：“生成当前项目的目录结构快照，并标注每个目录的典型用途”。Codex 会读取 AGENTS.md 中的项目描述与技能定义，结合实际文件系统，输出带语义注释的结构图。
方法二：若 AGENTS.md 尚未编写，可临时创建一个最小化版本：
```markdown
# Project Overview
## Core Directories
- `app/`: 主业务逻辑
- `config/`: 全局配置文件
- `.codex/`: Codex 运行时配置与技能缓存
```
保存后重新加载项目，Codex 即可据此增强结构理解。
注意：Codex 对目录用途的理解高度依赖 AGENTS.md 的明确声明，空文件或仅写“本项目是一个 API 服务”会导致结构分析流于表面。
检查项目加载状态的三步验证法
第一步：确认 Codex 左上角显示的项目路径是否为你预期的仓库根目录（例如 /Users/you/projects/viewport-lab）；
第二步：点击右上角「设置」图标 → 查看「Project Info」页签 → 核对「Detected Root」字段是否匹配；
第三步：在对话框输入 “list project files”，观察 Codex 是否能准确返回 package.json、.env、skills/ 等真实存在的条目。
只要三步全部通过，文件结构视图就是可信的；任一环节失败，都意味着 Codex 没有真正“看见”你的项目全貌，后续所有基于结构的操作（如修改 config/database.php 或调用 deploy-dev-machine 技能）都会出错。
