把 Codex 用成队友:从零上手到敢让它改真实仓库
很多人第一次用 Codex 的经历是这样的:装好、进到自己的项目、敲下一句”帮我优化一下这个项目”,然后看着终端里滚过十几个文件的改动,最后一个都不敢合并,默默关掉窗口,回去手写。
这不是模型不够聪明。真正的原因是三件事没交代清楚:它能动什么(边界)、这个项目的规矩是什么(规则)、做到什么程度算完成(验收)。一个人类新同事入职第一天如果只收到”帮我优化一下这个项目”这句话,交付物同样不敢合。
这份教程要解决的就是这三件事。
学习路径按这个顺序展开:先建立认知(第1章),再上手跑通(第2、3章),然后立刻处理安全边界(第4章),接着把规则和表达方式固化(第5、6、7章),再谈扩展与团队化(第8、9章),最后用一个完整的实战任务验收(第10章)。
阅读本教程需要的前置条件很低:你会用终端、用过 Git、写过至少一个项目就够了。不需要事先了解”AI 代理”是什么。
读完之后你应该能够
- 在自己的机器上装好 Codex 并完成登录
- 用只读模式安全地摸清一个陌生仓库
- 打开受控的写权限,让 Codex 完成一次你敢合并的改动
- 用 AGENTS.md 把项目规矩写成文件,不必每次重复交代
- 用 config.toml 固化常用配置,用 profile 在不同工作模式间切换
- 把 Codex 接进代码评审、CI 和云端任务,让它从个人玩具变成团队流程的一环
- 用一张自检表判断一次交付到底合不合格
适合谁有基本命令行与 Git 经验的开发者
前置要求会用终端、会用 Git、写过至少一个项目;不要求了解 AI 代理概念
章节目录
10 章 · 约 63 分钟- 01 Codex 不是补全,是一个会自己动手的同事 Codex CLI 是什么?它和代码补全的差别不在生成代码,而在谁做决策、谁执行、谁验证。六个官方入口的分工,以及新手该从哪个开始。 5 min
- 02 二十分钟:装好、登录、跑通第一个只读任务 Codex CLI 安装教程:四种安装方式怎么选、首次登录流程,再用一个全程只读的任务跑通第一次会话,不动你任何一个文件。 9 min
- 03 一次会话的生命:开始、跑偏、拉回、留档 Codex CLI 会话是有状态的:常用斜杠命令的实际用途、跑偏时从轻到重的三种拉回手段,以及 resume、fork、archive 怎么把过程留档。 5 min
- 04 两个旋钮:审批策略与沙盒决定它能闯多大祸 Codex CLI 的权限由两个旋钮决定:沙盒管它技术上能碰什么,审批管它什么时候问你。三档乘三档,四种常见场景分别该怎么配。 6 min
- 05 AGENTS.md:把"我们这儿的规矩"写成文件 AGENTS.md 怎么写:把仓库结构、构建命令、工程约定和完成的定义落成文件,以及多个 AGENTS.md 之间的叠加顺序与优先级规则。 6 min
- 06 把任务讲清楚:四要素提示词与计划模式 写给 Codex 的任务描述要含四个要素:目标、上下文、约束和完成标准。改动一大就先要计划,以及提示词和项目规则各管什么。 5 min
- 07 config.toml:把每次都要敲的参数固化下来 Codex 的 config.toml 怎么写:配置生效的四层覆盖顺序、最值得先设的几个键,以及用 profile 在只读分析和放手开发之间切换。 5 min
- 08 扩展能力:MCP 接系统,技能沉淀流程 什么时候该给 Codex CLI 接 MCP:两种服务器形态、接入前必须问清的三个安全问题,以及怎么把重复的提示词沉淀成可复用的技能。 6 min
- 09 从个人工具到团队流水线 把 Codex 变成团队流水线的一环:提交前的本地评审、PR 上的 @codex review、codex exec 接 CI,以及云端并行任务怎么组合才不重复。 9 min
- 10 实战演练:一个可验收的完整任务 Codex CLI 实战演练:用一个完整任务串起前九章,从任务描述、权限设置到验收走查,配一张自检评分表和三个失败信号,判断交付合不合格。 7 min
常见问题
需要付费的 ChatGPT 账号吗?
教程里会说明每个入口对应的账号要求与登录方式,并区分哪些能力属于付费档位。命令与配置以官方文档当日版本为准。
可以跳着读吗?
第 1 到 4 章建议按顺序。第 4 章讲权限模型,是全篇最重要的一章,跳过它后面所有实操都会缺一层安全底座。第 5 章之后可以按需取用。
教程会跟着工具更新吗?
会。工具类内容变化快,每次更新会在封面页和章节页标注日期,你可以订阅 RSS 获知更新。