要在Agent Space中让Codex稳定读取项目文件,需完成Session初始化、上下文注入和AGENTS.md联动三步:①cd进项目根目录且project_id与目录名严格一致;②调用create_session绑定上下文;③确保AGENTS.md存在并含强制规则,再/reload context生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Agent Space中让Codex稳定读取项目文件,关键不是反复发送“请读这个文件”,而是通过Session初始化、上下文注入和AGENTS.md联动三步建立可执行的读取路径。项目根目录选错、project_id不匹配或AGENTS.md缺失任一环节,Codex都会跳过文件扫描直接进入泛化响应。
启动前必须完成的三项硬性准备
第一步:在终端中cd进入项目根目录,确保当前路径下存在package.json、pyproject.toml或requirements.txt等标识文件。Codex不会向上逐级查找,【project_id必须与该目录名完全一致】,例如目录名为“fscloud-v2”,则project_id只能是“fscloud-v2”。
第二步:调用create_session(project_id="fscloud-v2", user_id="u_7a9b")。这一步必须在首次发送任何用户消息前执行,否则已产生的对话记录无法绑定到该项目上下文。
第三步:确认项目根目录存在AGENTS.md。若不存在,Codex将退化为无规则模式,连入口文件都可能漏读。可用命令快速生成基础模板:codex /init。
让Codex主动读取文件的两种触发方式
方法一:显式指令驱动
在Agent Space对话框中输入:/code src/main.py。Codex会立即加载该文件全文并返回摘要。支持相对路径,但不支持通配符(如/code src/*.js会报错)。
方法二:结构化上下文注入
调用session.inject_context("file_list", ["README.md", "src/api/client.ts", "tests/integration.spec.ts"])。此操作会将文件列表写入Session Memory,Codex后续所有任务将自动优先读取这些文件——但注意,【该注入仅在当前Session有效,关闭窗口即丢失】。
强制Codex读取architecture.md的强约束写法
第一步:打开项目根目录下的AGENTS.md
第二步:在文件开头插入明确规则段落,格式如下:
```markdown
## 强制读取规则
- 涉及模块划分、接口定义、数据流变更时,必须先读取./ARCHITECTURE.md第3.1~3.4节
- 修改/src/目录下任意文件前,需确认ARCHITECTURE.md中“依赖约束”章节未被违反
- 若ARCHITECTURE.md中声明了“禁止跨域调用”,则所有生成代码必须包含跨域检查逻辑
```
第三步:保存AGENTS.md后,在Agent Space中发送/reload context。Codex会重新解析该文件,并将上述三条转为不可绕过的执行前提,而非可选参考。


















