Codex 实战指南
Codex 与普通补全工具不同,它能进入项目读取、修改文件、运行测试、解释报错,充当“会干活的 AI 搭档”。文章首先说明它最适合处理需要上下文理解的任务,如阅读陌生代码库、定位 Bug、补充测试、实现小功能等,并比较 IDE 插件、CLI 与云端三种使用方式,建议新手先从 IDE 或 CLI 入手。随后提供 macOS Homebrew 安装、账号或 API Key 登录步骤,并示例第一次只读分析项目结构,以低风险任务起步。针对 Prompt 编写,文章提出四要素(要解决的问题、修改范围、约束条件、验证方式),强调先让 Codex 写计划、提供充分上下文、要求自行运行测试并迭代修复。为统一项目规范,推荐在仓库根目录放置 AGENTS.md,记录依赖、lint、测试等规则,并通过 sandbox 参数控制只读、工作区写入或全访问权限。接着列举解释代码库、修复 Bug、实现筛选功能、补充测试、代码审查等常见场景,并说明使用 codex exec 实现自动化生成 release notes、总结 CI 失败等。云端任务适合大规模或并行操作,但仍需人工 Review。最后总结最佳工作流为只读分析→制定计划→小步修改→运行测试→人工 Review,提醒勿盲目信任结果,及时设定项目规则与权限,以让 Codex 成为提升效率而非取代程序员的可靠助手。