Appearance
01 · Codex 是什么
📚 系列导航：这是整套教程的起点。读完你会明白 Codex 到底是什么、能干什么不能干什么，以及和 ChatGPT / Claude Code 的本质区别。
01 先给结论
Codex 是 OpenAI 官方出品的 AI 编程代理。你给它一个目标，它能读你的整个项目、直接改文件、跑命令、跑测试，把活儿干完交给你验收，而不只是在聊天框里回你一段代码。
OpenAI 就是做 ChatGPT 那家公司。Codex 是它专门为「写代码」这个场景做的工具。
关键区分：ChatGPT 像个参谋——你把代码复制粘贴给它，它给你出主意，但改代码得你自己动手。Codex 像个能空降到项目的特种兵——你说「这个报错帮我查根因修了」，它自己翻文件、定位、改、验证，一条龙干完。
02 四种入口
Codex 有四种入口，你从任意一个进都行，底层是同一个 Codex：
| 入口 | 形态 | 跑在哪 | 适合谁 |
|---|---|---|---|
| 桌面 App | 独立应用，图形界面 | 你本机 | 不想碰命令行、喜欢点界面 |
| CLI | 终端里敲 codex | 你本机 | 习惯终端、要写脚本自动化 |
| IDE 扩展 | VS Code 等侧边栏插件 | 你本机 | 泡在编辑器里写代码的人 |
| 云端 Web | 浏览器打开，任务在云上跑 | 云端 | 起长任务挂后台、并行跑 |
TIP
四个入口配置能打通——你写的 AGENTS.md、定义的 Skill，在桌面 App / CLI / IDE 扩展之间复用。新手建议从桌面 App 起步（图形界面最稳），习惯终端的直接上 CLI。
03 它能干什么
| 类别 | 具体能力 |
|---|---|
| 写代码 | 你描述要什么，它顺着项目已有结构和风格生成代码 |
| 读代码 | 理解整个项目，回答「这个函数干嘛的」「这块为什么报错」 |
| 审代码 | 找潜在 bug、漏掉的边界条件、逻辑错误 |
| 调试修复 | 把报错甩给它，它顺着代码追根因、定位、给修复 |
| 自动化杂活 | 重构、补测试、做迁移、配环境 |
不能做的事：
- 不能替你做业务决策。选架构、定方向——判断和决策是你的活。
- 不能保证代码 100% 没 bug。它给的是高质量候选，不是绝对正确答案，改完必须你 review。
- 不能猜你没说清的需求。你没讲明白的业务逻辑，它只能瞎猜。
04 Codex vs ChatGPT vs Claude Code
| 维度 | Codex | ChatGPT | Claude Code |
|---|---|---|---|
| 定位 | 能动手的特种兵 | 出主意的参谋 | 能动手的编程搭档 |
| 出身 | OpenAI | OpenAI | Anthropic |
| 能否直接改文件 | 能 | 不能 | 能 |
| 四种入口 | 桌面/CLI/IDE/云端 | 网页/App | 终端/IDE/桌面/网页 |
| 默认气质 | 桌面 App 图形界面友好 | 对话式 | 终端原生 |
| 项目说明文件 | AGENTS.md | 无 | CLAUDE.md |
实际搭配建议：Codex 和 Claude Code 是同类不同家，骨架像、血统和默认气质不同。按活儿派工，别二选一。
05 确认你的电脑认不认识它
bash
codex --version两种情况都正常：
- 蹦出版本号（如
codex-cli 0.139.0）——已装过 - 报错
command not found: codex——还没装，下一篇解决
06 小结
| 要点 | 一句话记住 |
|---|---|
| 它是什么 | OpenAI 官方的 AI 编程代理，你给目标它动手干完 |
| 四种入口 | 桌面/CLI/IDE/云端，同一套 Codex |
| 能做什么 | 写代码、读代码、审代码、调试、自动化 |
| 不能做什么 | 拍板、保证没 bug、猜你没说的需求 |
| 和 ChatGPT 的区别 | 参谋 vs 特种兵 |
| 和 Claude Code 的区别 | 同类不同家，按活儿派工 |
NOTE
下一篇：02 安装、登录与运行形态：正式动手，把它装到你的电脑上，跑通第一次登录。