Appearance
Codex 是什么？App、CLI 和 IDE 怎么选
假设购物车出了一个小问题：商品总价 10 元，用掉 15 元优惠券后，页面居然显示应付 -5 元。你知道结果不对，却不知道该改哪个文件。
Codex 可以帮你读项目、找到计算逻辑、修改代码并运行测试。与单纯问“这段代码怎么改”相比，你可以直接把任务交给它，让它在你允许的项目范围内动手。
但业务规则仍需要你决定：优惠后应付最低是 0 元，还是允许负余额？你说清目标和边界，Codex 执行，你检查结果。 本系列会用小项目带你走完这个过程，不需要先准备真实业务代码。
先选入口，不必一次装齐
三个入口不是三种编程语言，也不是必须依次学习的等级。
| 你的习惯 | 建议从哪里开始 | 你主要看到什么 |
|---|---|---|
| 希望用窗口管理项目、对话和变更 | 桌面 App 的 Codex 入口 | 项目、任务对话、变更视图 |
| 已经在终端运行项目，想保留命令和输出 | Codex CLI | 终端里的任务、命令、反馈 |
| 日常在编辑器里读写代码 | IDE 集成 | 打开的文件、选区、旁边的 Codex 面板 |
已经熟悉一个入口，就先用它完成一件小事。不确定选哪个、想跟着本系列操作，就选 CLI：后面的命令都在 macOS 终端里演示。
本系列命令示例以 macOS 终端为主。 概念可以帮助理解其他入口，但按钮、快捷键、安装和权限设置不能原样套到每个平台。
想用 App 或 IDE？再看入口区别
App：注意你选的是哪个工作模式
本次核对的官方 Quickstart 在 ChatGPT 桌面应用里区分 Chat、Work 与 Codex。软件开发任务应进入 Codex；一般研究、文档或表格任务不自动等于 Codex 工作流。界面随版本变化，请对照官方当前入口说明。
如果实际界面与旧教程不同，先核对工作模式和当前官方说明，不要只按旧按钮名称寻找。
CLI：终端就是操作窗口
CLI 是命令行界面。你在项目目录启动 codex，再用自然语言交代任务。项目原来的 Node.js、Python、测试工具仍需存在；装了 Codex 不等于所有项目依赖也装好了。
适合先做小范围、可检查的任务，例如：“说明这几个文件的调用关系，不修改代码”。不建议第一次就要求“把整个公司系统重构好并上线”。
IDE：让当前代码成为上下文
IDE 指代码编辑环境。官方文档说明 VS Code 及兼容编辑器使用扩展，Xcode、JetBrains 有各自集成方式。因此，“安装一个扩展，所有编辑器都一样”并不准确。
打开相关文件和选区有助于提供上下文，但不代替说明目标。只打开一个函数，也可能缺少它的调用者、测试和业务约束。
一个任务里，你和 Codex 分别负责什么
以刚才的购物车为例：
| 环节 | 你要做的事 | Codex 可以做的事 |
|---|---|---|
| 开始前 | 说明负金额现象、最低为零的规则 | 读取相关源码和测试，定位原因 |
| 修改时 | 限定范围，例如不改测试、不接支付接口 | 修改计算逻辑，运行测试 |
| 完成后 | 看实际测试结果和代码差异 | 解释改了哪里、为什么改、还没覆盖什么 |
如果它只说“已修复”，却没有测试结果或文件差异，这个任务还没交代完整。可以追问：“请给出实际执行的测试命令、结果和改动文件。”
现在不需要学什么
第一次读懂项目、修一个本地 Bug，通常不需要先接 MCP、安装一堆 Skill 或配置定时任务。它们分别服务于外部工具、重复流程和调度，等你遇到相应需求再学。
同样，不要把“为了更方便”理解成关闭所有安全限制。只理解项目时，先限制为不修改；需要修改时再在明确范围内授权。
第一件事，从“解释”开始
暂时不动代码，先让 Codex 解释一笔订单为什么是 13 元。你能算出答案，就能判断它有没有读对。下一课准备 CLI，随后用本站提供的四个文件开始这个任务。
参考资料
- Quickstart：入口与产品模式。
- Codex CLI：终端工作方式与起步流程。
- Codex IDE extension：编辑器上下文与不同 IDE 入口。