先明确一个核心原则:要让AI替你彻底跑完一个项目,关键在于启动它的“自主模式”。这个模式并非默认开启,而是隐藏在一个特定的触发指令背后,并且对版本有严格的门槛要求。

整个过程,本质上是在将一个完整、具象的目标“封装”成一个AI可执行的任务包,然后交由它去自动拆解、实施、验证,直至交付。听起来很理想,但如果不满足前置条件,所有的输入和指令都可能石沉大海。
启动Codex自主项目模式
首要且不可跳过的步骤,是版本确认。在终端执行 codex --version,必须确保返回值是 v1.0.3 或更新的版本。如果显示的是v1.0.2或更低,系统根本不具备接收复杂任务指令的能力,后续所有操作都将无效。此时,运行 codex update 更新并重启终端是唯一选择。
只有版本达标后,你才能进入核心操作阶段:在Codex的聊天窗口中,准确地输入 /goal(注意是英文斜杠,不含多余空格)。回车后,一个标准的任务定义模板框便会弹出。如果没出现,基本可以断定是版本不符或输入有误。
接下来的目标定义环节,是整个流程的灵魂。这里的语言必须足够“具象”,且包含明确的“验收标准”。比如,你不能只说“做个登录页”,而应该这样描述:“复刻 [目标网址] 的登录页面,要求HTML结构语义化、CSS采用Flex布局实现居中、表单提交需拦截默认跳转并异步处理、密码输入框需具备显示/隐藏切换功能,并确保所有交互在Chrome和Firefox的最新版本中测试通过”。这种描述为AI提供了清晰的行为边界和验证依据。
完成描述后,点击“确认执行”。剩下的事情就交给Codex了:它会自动进行任务拆解、生成代码文件、启动本地开发服务器进行预览、甚至会进行截图比对来验证UI还原度。过程中若有失败,它会自行重试,直至所有验收标准通过后才会向你发出完成通知。至此,一个完整的项目周期在无需人工介入的情况下闭环。
为Codex设定项目长期规则
对于需要跨多个任务保持一致性的项目,让Codex记住一些全局规则是提升效率的关键。目前主要有两种方式。
第一种,是在项目根目录创建一个名为 agents.md 的文件。这个文件应以纯文本形式,清晰罗列三类信息:项目愿景(一句话概括)、技术栈要求(例如“Next.js 14.2 + TypeScript 5.4 + Tailwind CSS v4.0”)、以及关键开发约定(比如“所有API调用必须封装在src/lib/api.ts中,禁止在组件内直接使用fetch”)。
第二种方法更轻量:在任意现有文件的头部添加一行注释 。Codex会优先读取并缓存该文件的内容,将其作为后续对话的长期上下文背景。
值得注意的是,agents.md 文件的内容需要保持精炼。经验表明,当文件内容超过300字时,Codex对其中规则的引用准确率会出现显著下降。因此,务必删去所有修饰性语句,只保留最核心、最硬的约束条件。
批量生成免确认操作
当面对大批量、重复性的生成任务时,比如一次性创建十几个组件骨架,或为几十个API端点补全类型定义,逐一手动确认显然是不可接受的。
这时,批量化操作的流程就体现出价值。第一步永远是预览:使用 --dry-run 参数来模拟执行。例如,执行 codex generate --dry-run --from ./src/pages --to ./src/components/ui 命令,Codex会列出所有将要生成的内容概览,但并不会实际创建文件。
在预览结果确认无误后,才进入第二步:正式执行。在命令中加上 --yolo 参数,例如 codex generate --yolo --from ./src/pages --to ./src/components/ui。这个指令会命令Codex跳过所有中间确认弹窗,直接生成所有目标文件。
需要强调的是,--yolo 模式虽然高效,但必须与 --dry-run 预览紧密结合使用。因为它是一次性、不回头的操作,一旦指令本身有误,可能导致意料之外的文件结构,而缺乏直接的撤销机制。安全预览,是批量操作前必不可少的保险栓。
