跳转到内容
Codex 使用说明

Codex Agent 是什么：它不是聊天机器人

Codex Agent 不是拿来闲聊的。它更像一个能进入项目目录的开发同事：会读文件、提出计划、修改代码、运行命令、展示 diff，然后等你决定是否保留这些改动。

你需要学的也不是“怎么和 AI 聊天”，而是怎么把一件工作交给 agent，并且让结果可检查、可撤回、可复用。

它真正能帮你做什么

Section titled “它真正能帮你做什么”
任务新手怎么交给 Codex成功标志
读项目“先只读，不要改文件，告诉我入口、运行方式和风险文件”输出具体文件名，而不是泛泛建议
改小功能“最多改 1-3 个文件，先写计划，再执行”diff 范围小，能说清为什么改
修报错“按错误类型分类，只做下一步最小排查”不乱升级依赖，不乱删文件
补测试“先读现有测试风格，再补最小用例”新测试覆盖一个明确行为
做代码审查“按严重程度列 bug、风险、缺测试，不要只夸”能指出文件和可复现风险
沉淀经验“把这次流程整理成 Memory 或 Skill 草稿”下次遇到同类任务能复用

第一条指令怎么写

Section titled “第一条指令怎么写”

如果你不知道怎么开始，直接复制这段：

请把自己当作 coding agent，而不是聊天助手。


当前目标：{我想完成的小任务}


第一步只读项目，不要修改文件，不要运行写入命令。


请输出：
1. 你需要先看哪些文件，为什么
2. 这个任务是否适合新手第一小时完成
3. 最小交付版本是什么
4. 可能修改哪些文件
5. 哪些范围今天不碰
6. 完成后怎么验证

这段指令的重点不是措辞漂亮，而是把 agent 限制在“先理解、再计划、再小改、再验证”的节奏里。

什么时候必须人工确认

Section titled “什么时候必须人工确认”

看到这些情况，不要继续点同意：

  • Codex 要删除文件、批量移动文件、清空目录。
  • Codex 要读取或修改 .env、密钥、cookie、Token。
  • Codex 要连接真实支付、数据库、生产服务器。
  • Codex 要安装你不认识的全局依赖或社区脚本。
  • Codex 没说明验证方式，只说“应该可以工作”。

这时可以回复：

先停。请不要继续执行。


请只根据当前 diff 做风险审查：
1. 哪些改动和目标直接相关
2. 哪些改动可能无关
3. 是否涉及密钥、删除、安装、联网或生产资源
4. 如何回到更小的改动范围

新手应该怎么理解权限

Section titled “新手应该怎么理解权限”

Codex 不是“知道答案就输出答案”的网页聊天框。它会在你的工作区里读文件、改文件、运行命令，所以权限边界比聊天更重要。

可以记住这三句话：

  1. 只读阶段：先让它看项目，不要让它动手。
  2. 最小修改：一次只让它做一个小目标。
  3. diff 验收：不看 diff，不算完成。

下一步

Section titled “下一步”