Codex 用文件路径限定上下文
本页目标
学完本页，你能让 Codex 只围绕一个指定目录做分析，并得到一份可以逐项核对的“实际读取文件”清单。
验证范围（2026-07-11） 路径上下文和
-C参数已对照 OpenAI 官方文档；制作环境未完成 CLI 实机回放。路径提示不是安全隔离，实际可访问范围仍以当前 Sandbox 和审批设置为准。
开始前
先选一个不大的目录，并确认路径真实存在。若终端当前不在项目中，可以运行 codex -C {项目目录} 设置起始工作目录。
这里要特别注意：提示词中的“只读取这个目录”是任务边界，不是安全权限。-C 也只是设置工作目录。真正的文件访问限制仍由 Sandbox、审批和项目配置控制。
跟着做
- 选定一个目标目录，例如
src/components/tutorial。 - 在项目根目录启动 Codex，先不要要求它修改代码。
- 把提示词中的
{目标目录}换成真实相对路径后提交。 - 根据回答里的“实际读取文件”逐项检查路径和用途。
Codex · 可复制提示词
只分析一个目录
请只读分析 {目标目录}。
目标：说明这个目录的入口、主要职责和文件之间的调用关系。
范围：只读取该目录及其直接引用的本地文件。若必须查看范围外文件，请先列出路径和理由，等我确认，不要自行扩大范围。
输出：先列出“实际读取文件”，再用表格说明每个文件的职责和证据。
边界：不要修改文件，不要运行会改变项目状态的命令；无法确认的内容请标为“待确认”。预期结果
回答集中在目标目录，并单独说明任何必要的范围外文件
结果检查
目标目录中的文件应真实存在，职责说明应能在代码中找到依据。若回答出现范围外路径，却没有单独解释理由，本次结果不合格，可以要求它缩小范围后重答。
最后运行 git status --short，确认没有新增改动。即使结果看起来合理，也要抽查至少两个文件，不能把路径清单直接当成事实。
练习
动手练习
把范围缩小到一个文件
选择一个组件文件，只让 Codex 说明它的输入、输出和直接依赖。
完成标准：回答引用目标文件和直接依赖；其他路径均被列入待确认，而不是悄悄扩展范围。
本页小结
明确文件路径能减少无关上下文，让回答更容易核对。但路径提示只是任务边界，不是权限系统；重要项目仍要配合合适的 Sandbox 和审批设置。