Codex 现在指什么
2025 年后，人们说的 Codex 通常不再只是当年那个补全模型名字，而是 OpenAI 面向写代码的一套 Agent 产品：你可以在 ChatGPT 里派它改仓库，也可以在终端用 Codex CLI，还可以在 VS Code 一类编辑器里用官方扩展。三层界面共享同一套工作习惯：仓库说明书、可复用技能、以及 MCP 工具。
它要解决的问题很具体：你把任务说清楚，Agent 去读文件、跑命令、改代码、再把 diff 交给你看。它不是又一个聊天框里贴代码的页面，也不等于随便哪个编辑器插件。
本教程只写公开、可核对的用法。订阅档位、地区可用性、精确版本号会变，文中遇到会写以官方页面为准，不会编造价格或截图。
把三个入口当成工作界面，而不是三套不同的 AI。你在 CLI 里开始的任务，仍然受同一份 AGENTS.md 约束，ChatGPT 里的 Codex 也一样。变的是复查方式：终端回滚、侧栏 diff，或云端会话日志。
- ChatGPT Codex：在网页或桌面应用里对仓库下长任务。
- Codex CLI：在终端里会话，适合已经住在 shell 的人。
- IDE 扩展：在编辑器侧栏看 diff、改当前工作区。
- 配置与记忆通常落在本机 Codex 主目录（常见是 ~/.codex）。
这套教程写给谁
给你已经会 git、会开终端、想让 Agent 在自己仓库里干活的人。不要求你先背完提示词工程。
如果你只想在网页里问问语法，用普通 ChatGPT 就够。如果你的主力是 Cursor 或其他编辑器，也可以读本系列：对照章会说明重叠和差异，不必改宗。
如果你只要一行片段、从不打开仓库，可以跳过本系列。如果你会批准或丢掉一份改了你文件的补丁，就留下。
- 要在本机仓库跑可复查改动的应用开发者。
- 已经写过 README，想把约定写进 Agent 能读的文件的人。
- 需要把 issue、文档或浏览器接到 Agent 上的人（后面的 MCP 章）。
- 团队里要统一 Agent 不准做什么的人。
三个界面，一份配置习惯
官方文档把 CLI、IDE 扩展和桌面或网页 Codex 写成同一产品的不同入口。登录态、config.toml、AGENTS.md 和技能目录常常是共用的。换窗口不等于换一套完全不同的 Agent。
选界面看你待的时间：整天在终端就用 CLI；要看文件树和内联 diff 就用扩展；人在浏览器、仓库已连接时，就用 ChatGPT 里的 Codex。本教程每章都按先 CLI、再对照其他入口来写。
实用规则：先在一扇门上完成登录，再用同一扇门做第一章任务。只有出现一份可复查的 diff 之后，才打开第二个界面。
- 先装一个入口并完成登录，不要三个一起配。
- 同一仓库用同一份 AGENTS.md，不要按客户端复制三份互相矛盾的规矩。
- 技能和 MCP 配好后，通常三个入口都能用到，具体路径以当前官方文档为准。
建议学习顺序
短 MCP 介绍带不来搜索流量，也带不来会用的人。下面八章按依赖排：先搞清产品，再安装，再做一件能复查的小事，然后才写说明书、技能和外部工具。
每章有多节、清单和 FAQ，章末有上一章和下一章。不必一天读完。卡在登录或进程时，直接跳排错章，再回来。
若 CLI 已经能跑，安装章可以略读，直接去做第一个任务。若登录已经坏了，先跳排错章，再回来。
- Codex 是什么：分清三个入口和它不是什么。
- 安装与登录：CLI、扩展或 ChatGPT，并做一次无害自检。
- 第一个任务：小范围改动、看 diff、回退。
- AGENTS.md：仓库级、始终生效的约定。
- 技能：按任务加载的可复用剧本。
- MCP：只有仓库外的系统才接线。
- 和 Cursor 怎么选：按工作界面选，而不是按热搜。
- 排错：登录、PATH、MCP 卡住、技能找不到、乱改文件。
这套教程实际要花多久
一个专注的下午，通常够装通、做一件小事、写一页 AGENTS.md。技能和 MCP 更适合第二次坐下来，那时你已经有一份信得过的 diff。
不要把“学完 Codex”排成周末重写生产应用。这是习惯课：小任务、写禁区、一次只接一个工具。
- 安装加只读自检：网络和账号顺利时通常一小时内。
- 第一个可复查任务：再一小时，大部分时间在看 diff。
- AGENTS.md 初稿：三十分钟写事实，不写形容词。
- 一个技能加一条只读 MCP：留到后面一个晚上。
先用谨慎的口气看一眼 CLI
公开安装页描述过全局包和官方安装脚本。本机 PATH 里已经有二进制时，人们常先跑版本或帮助命令。可执行文件名和参数曾经改过；从你今天打开的页面抄，不要从旧 gist 抄。
典型的第一次会话是：进入仓库目录、启动 Agent、问一个只读问题、然后离开。若命令找不到，那是安装或 PATH，不是模型。安装章会带着保留语气走这条路。
- 在当天的文档里核对官方包名或脚本名。
- 装完新开终端，让 PATH 刷新。
- 先问当前目录，再谈写权限。
这页总览想挡住的错
昂贵的错是协作上的，不是语法上的：第一天接十条 MCP、让 Agent 直接提交、以及以为 ChatGPT 里的 Codex 能看见笔记本上还没同步的文件。
更安静的错是克隆别人的 AGENTS.md。说明书里写着另一个团队的测试命令，Agent 会很自信地失败。
- 三扇门都装了，却没有一扇能列出文件。
- 第一次对话就贴生产令牌。
- 因为演示视频看起来简单，就跳过第一个任务章。
- 把 AGENTS.md 写成小说，而不是三条硬禁区。
进入第一章前的总览清单
不需要完美环境。你需要一个自己的仓库、一种回退办法，以及先用哪扇门的决定。
- 选定一扇门：CLI、官方扩展，或 ChatGPT 里的 Codex。
- 确认这份仓库允许送进外部 Agent。
- 能跑 git status，并有回退计划。
- 另开标签页收藏当天的官方 Codex 文档。
- 门选定了再打开下一章。
本教程怎么写、怎么读
正文是本站原创概述，不是官方文档的粘贴。命令示例只用常见公开装法。包版本、菜单文案、订阅名称请打开当天的官方 Codex 文档核对。
本站同时提供中文默认 URL 和英文前缀版。章节会链到本站 MCP 和技能目录，那些页面是元数据，不会在浏览器里替你执行安装。
本系列插图是为本教程生成的示意图。它们是真正的 img 标签，不是 CSS 背景，搜索引擎和读屏都能看见。
- 不编造星标、价格、内部功能名。
- 不要求你同时打开写权限和十条 MCP。
- 密钥只放环境变量或系统钥匙串，不写进仓库。
- 官方文档与本教程冲突时，以官方和你本机实测为准。
读完总览接下来做什么
先去下一章，把产品边界说清再安装。若三扇门你已经分得清，可以直接去安装章。
把这页总览留作目录。每章结尾都有上一章、下一章，以及八课清单。