/init
为当前项目生成一个 AGENTS.md 脚手架。
/init 会为当前项目或目录生成一个 AGENTS.md 骨架文件。AGENTS.md 用来记录 Codex 在每次会话中都会自动读取的项目专属说明和上下文——相当于 Claude Code 中的 CLAUDE.md。根据文档,这个文件记录的是你当前所在仓库或子目录的持久性指令。
/init 同时被记录在纯终端 CLI 命令列表和 Codex 通用命令参考中,且功能完全一致——因此与 /worktree 或 /cloud 不同,它不是桌面应用独占功能,而是常规的终端 CLI 命令。这个命令只会生成基础骨架;项目规则、编码规范、测试命令等具体内容,之后需要你自己补充,或者有针对性地让 Codex 来填写。
✅ 什么时候用?
为 Codex 设置一个新项目
/init
在仓库结构发生较大变化后重新梳理项目规则
调用 /init,然后手动为生成的骨架补充新的测试命令
⛔ 什么时候不该用?
AGENTS.md 已经存在且维护良好
/init 会生成一个全新的骨架,可能会覆盖已经悉心维护的项目笔记。
更好的选择: 直接编辑现有的 AGENTS.md,而不是重新生成
来源
- Codex CLI 文档:Slash Commands ↗ learn.chatgpt.com
更多命令 · Codex CLI