Codex 项目配置
Codex 项目目录怎么选:工作范围、资料位置与 AGENTS.md
项目目录决定 Codex 从哪里开始理解任务。把代码、说明和任务资料放在同一个清楚的项目范围内,后续检查修改、复现问题和交接都会容易一些。
更新:2026-10-18
以一个能独立检查的项目为起点
代码项目通常选择包含 README、构建配置和源码的仓库根目录。资料处理任务可以另建一个工作目录,按 input、output 和 notes 分别放输入副本、生成结果与处理说明。先确认这些文件属于同一个任务,再开始会话。
例如整理工艺试验记录,可以准备脱敏的原始记录副本、字段说明和预期输出样表。原件留在既有资料库,工作目录保存本次允许使用的副本;这样既能复查处理过程,也能明确哪些内容尚未纳入任务。
启动时明确指定目录
在 PowerShell 中,先用 Test-Path 确认目录存在,再通过 -C 指定工作根目录。下面的路径是示例,需要替换为自己的实际项目位置;带空格或中文的路径保留双引号。
会话开始后核对界面显示的目录,并让 Codex 先说明已找到的项目文件和任务入口。目录选错时先纠正位置,避免基于其他项目的说明继续修改。-C 负责设置工作目录,具体读写范围还取决于沙箱、审批设置及组织策略。
Test-Path "D:\Projects\process-records"
codex.cmd -C "D:\Projects\process-records"把项目约定写进 AGENTS.md
在项目根目录的 AGENTS.md 中写清任务目标、可处理资料、输出位置、检查命令和需要人工确认的事项。例如约定保留原始记录、输出到 output、缺少单位时列出疑问、修改后运行项目已有检查。内容应短而明确,便于维护。
Codex 会按目录层级读取适用的项目说明,子目录约定可能覆盖上层要求。AGENTS.md 是工作指导,不能替代文件系统权限;.gitignore 主要控制版本管理,也不能单独当作敏感文件的访问隔离措施。
通过一次可复核任务确认目录安排
首次任务可以只要求解释一个样例文件,并指出字段来源与待确认问题。需要修改时,先保存 Git 检查点或输入备份;完成后核对差异、输出文件和检查结果,再扩大任务范围。
小蓝助手的复杂任务也需要清楚的资料和成果目录。涉及工艺研发、脚本与跨应用操作时,应在交接记录中写明输入版本、工具条件、输出清单和复核责任,便于下一次接续。