名字为什么容易混
早期 Codex 常被当成补全模型的名字。现在搜索结果里的 Codex，多半指 OpenAI 的编程 Agent：它能读仓库、跑命令、提交改动建议。旧文章和新产品页说的不是同一件事。
你不需要背内部研发代号。你只需要知道：今天装的是面向任务的 Agent，不是只在光标处补三行的插件。
若同事说“我用 Codex”，先问他用的是 ChatGPT 里的云端任务、本机 CLI，还是编辑器扩展。三个入口任务形状不同，配置却常常共用。
若搜索结果还在讲用于补全的 Codex 模型，把它当历史。本教程写的是你能从 ChatGPT、终端或编辑器扩展打开的编程 Agent 产品。
三个入口各自擅长什么
ChatGPT 里的 Codex 适合你已经在浏览器、仓库已连接的时候下较长任务。CLI 适合你本来就在终端里看日志和测试。扩展适合你要盯着文件树和 diff 点选。
官方材料把它们写成同一产品的不同门。登录、config 文件、AGENTS.md 和技能目录经常是一份。换窗口通常不是换大脑。
初学只选一扇门。三套同时配，排错时你分不清是登录坏了、PATH 坏了，还是仓库说明书没被读到。
云端任务和本机 CLI 会话都能改已连接的仓库，但不一定看见同一批文件。笔记本上未提交的改动，在你同步或进入该目录之前，仍是本地的。
- 浏览器或桌面应用：适合远程工作区和较长的云端任务。
- CLI：适合已经在仓库目录里开着终端的人。
- IDE 扩展：适合要看内联 diff、点文件的人。
不逛街的情况下怎么选第一扇门
先问自己会在哪看第一份 diff。答案是终端，就从 CLI 开始。答案是文件树旁边的侧栏，就从扩展开始。人已经在连着仓库的 ChatGPT 工作区，就从那里开始。
以后再换，比同时调试三个半成品登录便宜。安装章不会要求你把每扇门都配齐。
- 先 CLI：你已经在 shell 里跑测试。
- 先扩展：你住在文件树和内联 diff 里。
- 先 ChatGPT：工作区已经连上仓库。
说明书、技能、MCP 怎么叠
AGENTS.md 是仓库或用户级的常驻说明：语言、测试命令、禁区。技能是按任务才加载的剧本。MCP 是仓库外的手：issue、文档站、浏览器。
先写短说明书，再抽重复任务成技能，最后才接线。反过来会先得到一个会乱调外部系统、却不懂你仓库的 Agent。
把这三层想成：始终在、按需、以及仓库外。把它们混进同一份文件，说明书就会长到没人读。
- AGENTS.md：始终在，保持短。
- 技能：点名或匹配任务时加载。
- MCP：只给仓库里没有的能力。
Codex 不是什么
它不是自动把生产密钥写进仓库的借口，也不是不经 diff 就合并的机器人。你还是作者，Agent 是会跑命令的助手。
它也不等于 Cursor、Claude Code 或其他编辑器。那些产品可以很好，但配置路径和模型选择不同。对照章再谈取舍。
它也不能代替代码评审，或你们团队的威胁模型。一个会跑命令的 Agent，比聊天框更能干，也更危险。
- 不是不用看 diff 的自动合并。
- 不是官方安全审计。
- 不是本站浏览器里一键安装器。
什么时候值得打开它
任务能写成“在这些文件里做这件事，用这个命令验证”，就值得。只是问一句语法，用普通对话更快。
仓库越大，越要先写 AGENTS.md。没有说明书的大仓库，Agent 会用平均互联网习惯改你的代码。
第一周适合的任务：补测试、修类型错误、更新清单、起草 PR 说明。不适合的：轮转生产凭证、重写构建，或顺便把仓库整理一下。
- 值得：加测试、修类型错误、按清单开 PR。
- 先别：生产数据迁移、不经人工看的权限变更。
第一次看 CLI 大概长什么样
安装后，官方文档常展示版本或帮助命令，然后从仓库目录开交互会话。这里不钉补丁号。若文档里的帮助命令能打出用法，说明二进制已在 PATH。
若 shell 说找不到命令，停在下一章。不要从随机博客再发明第二种安装器。
- 新终端里跑帮助或版本。
- 先进入临时或练习仓库。
- 第一天只读问题比写入强。
关于产品的常见混淆
有人把 Codex 收成 ChatGPT 里的那个模型。这会藏掉本机 CLI、配置目录，以及 MCP 是跑在你机器上的进程。
另一种混淆是把 IDE 扩展当成另一套有另一份说明书的 Agent。通常不是。跨入口互相矛盾的规矩能浪费一周。
- 在扩展市场装非官方发布者。
- 假设云端任务能看见未同步文件。
- 因为 README 很长就跳过 AGENTS.md。
离开这一章时你该知道
你应该能说出准备装哪扇门，以及这周不会让 Agent 做什么。
- 用自己的话点名三扇门。
- 为安装选定一扇门。
- 写下你已经知道的一条禁区（密钥、生产数据、强制推送）。
- 打开官方文档，再读下一章。
下一步：只装一扇门
安装章会选门、登录、做无害自检。仍然不会接 MCP。
若账号里完全看不到 Codex，停下来看产品页。本教程不能帮你打开地区或档位。