Codex 入门:从安装到写好 AGENTS.md
跟着 OpenAI 官方视频,在自己的小项目里装好 Codex、跑通第一个任务,写一份 AGENTS.md,再试一次 MCP 和非交互模式。
操作步骤与提示词
下方提供操作步骤、示例提示词和结果检查方法。
这次要做出什么
准备一个自己的小代码仓库(最好有测试)。最后交付:已安装并登录的 Codex、一份写清命令和规则的 AGENTS.md、一次经过你审查的代码修改,以及一条可以放进脚本的 codex exec 命令。
跟着做:5 个操作步骤
-
安装并登录
macOS / Linux 在终端运行官方安装命令
curl -fsSL https://chatgpt.com/codex/install.sh | sh(同一条命令也用于更新),Windows 按官方页面的说明安装。然后运行codex,选择 Sign in with ChatGPT 登录。视频 0:00 起演示 CLI 和 IDE 插件两种装法。检查点:终端里能打开 Codex 界面,并显示已登录的账号。
-
在小仓库里跑第一次
进入项目目录运行
codex,先让它“解释一下这个项目的结构”,再给一个小任务,例如“给 utils 里的日期函数补一个测试”。看它改了哪些文件,逐个检查后再接受。对应视频 4:00。检查点:改动范围只在你要求的地方,测试能跑通。
-
用 /init 生成 AGENTS.md 并补全
在 Codex 里输入
/init生成 AGENTS.md,再按下面的示例补上:安装和测试命令、代码风格、不许碰的目录、完成后怎么汇报。视频 8:12 讲了写法和常见做法。检查点:换一个新会话,Codex 会主动按 AGENTS.md 里的命令跑测试。
-
设好权限再放手
输入
/permissions,选择 Codex 可以自动做哪些事(读文件、改文件、运行命令)。刚开始建议改文件和运行命令都要你确认,熟悉后再放宽。视频 14:14 讲环境配置,16:26 讲让结果更稳定的提问方式。检查点:你清楚哪些操作会先问你,哪些会直接执行。
-
接一个 MCP,再试一次非交互模式
运行
codex mcp,按提示添加一个你常用的服务(例如文档或 GitHub)。然后在终端运行codex exec "总结最近一次提交改了什么",看它不进入对话界面也能完成任务。对应视频 34:59(MCP)和 46:50(headless 模式与 SDK)。检查点:codex exec 输出了结果,这条命令可以直接放进脚本或 CI。
试试这个原创示例
下面是 FindGoodAI 为练习写的示例,请按你的项目修改。
一份够用的 AGENTS.md
# 项目说明(给 Codex)
- 这是一个 Python 3.12 命令行小工具,入口是 app/main.py。
- 安装依赖:pip install -r requirements.txt
- 运行测试:pytest -q (每次改完代码都要跑)
- 代码风格:函数写类型注解;新函数配一个测试。
- 不要修改 data/ 目录下的文件,不要提交密钥。
- 改动完成后,用三句话说明改了什么、为什么、怎么验证。
结果不理想时
Codex 改了不该改的文件
在 AGENTS.md 里写明禁止修改的目录,提问时也说清“只改某个文件”。权限先设成改文件前要确认。
每次都要重复说明测试命令
把安装、测试、格式化命令写进 AGENTS.md,并写明“改完必须跑测试”。
结果时好时坏
一次只给一个明确的小任务,说清完成标准,例如“测试全部通过,并说明改了哪几行”。视频 16:26 有更多提问方法。
完成前检查
- Codex 已登录,能在项目目录正常打开。
- AGENTS.md 写清了命令、规则和禁止事项。
- 第一次代码修改你逐个看过,测试通过。
- 权限设置符合你的习惯。
- codex exec 至少成功运行一次。
视频与当前界面对照
Codex 更新很快,视频里的部分操作已经变化:官方现在推荐用安装脚本安装和更新 CLI;生成 AGENTS.md 用 /init;权限在 /permissions 里设置;MCP 用 codex mcp 添加。以 Codex CLI 官方文档为准。
视频章节:安装 CLI 和 IDE 插件(0:00)、设置仓库并跑通第一次(4:00)、写好 AGENTS.md(8:12)、配置环境(14:14)、提问方式(16:26)、CLI 和 IDE 使用技巧(27:02)、MCP 配置(34:59)、headless 模式与 SDK(46:50)、学习资源(52:02)。
视频来自 OpenAI 官方 YouTube 频道。文字步骤、示例和检查清单是 FindGoodAI 根据官方视频和文档整理的练习指南。练习时间为估计。


