01 · OpenAI Codex 入门指南：它不是“会写代码的聊天框”，而是会动手的编程代理
适合读者：第一次听说 Codex，或只用过 ChatGPT 写代码，但还没用过 AI 编程代理的人。
本文目标：先建立整体认知，不急着安装。读完后，你应该能判断：Codex 是什么、适合做什么、四种入口该选哪一个。
注：Codex 的界面、套餐、模型和命令会持续更新。具体安装方式、价格和功能边界，请以 OpenAI 官方文档为准。
先说结论：Codex 更像“能操作项目的工程师助手”
很多人第一次听到 Codex，会把它理解成“更会写代码的 ChatGPT”。这个理解不算错，但还不够准确。
ChatGPT 更像一个坐在旁边的顾问。你问它“这个函数怎么写”“这个报错是什么意思”，它会给你解释、方案或代码片段。接下来怎么把代码放进项目、怎么改文件、怎么跑测试，通常还要你自己完成。
Codex 的重点不只是“回答”，而是“执行”。你把任务交给它，它可以读取你的项目文件，理解目录结构，修改代码，运行命令和测试，再把改动结果交给你检查。
换句话说：
- ChatGPT 更擅长帮你想清楚。
- Codex 更擅长帮你把事情落到项目里。
- 你仍然是负责人，Codex 是执行搭档。
这就是 Codex 和普通“代码问答工具”的关键差别：它能形成一个从理解到修改再到验证的工作闭环。
一、先搞懂一个词：什么是编程代理？
你会在 Codex 相关资料里经常看到一个词：Agent，中文通常叫“代理”或“智能体”。
这个词听起来有点抽象。放到编程场景里，可以简单理解成：
它不是只回答问题，而是会根据目标自己拆步骤、调用工具、完成任务。
比如你说：
帮我给登录接口补上错误密码的测试。
一个普通聊天模型可能会直接给你一段测试代码。
Codex 更可能这样做：
- 先找登录接口在哪里。
- 再找项目现有测试怎么写。
- 判断测试框架是 Jest、pytest 还是别的。
- 新增或修改测试文件。
- 运行相关测试。
- 如果测试失败，再继续定位问题。
- 最后告诉你改了什么、怎么验证。
这就是“代理”的价值。它不只是给建议，而是能沿着任务往前推进。
不过也正因为它能动手，使用时要更注意边界。你不能把它当成“绝对正确的自动程序员”。更稳妥的心态是：让它做繁琐执行，你负责方向、判断和最终验收。
为了更好地理解编程代理的工作流程，可以参考下面的示意图：
二、Codex 适合做哪些事？
如果你刚入门，可以先从低风险任务开始。下面这些场景比较适合 Codex：
| 场景 | 你可以怎么说 | 为什么适合 Codex |
|---|---|---|
| 解释陌生项目 | “先不要改文件，帮我解释这个项目怎么运行。” | 它可以读多个文件，帮你建立地图 |
| 修小 bug | “这个命令报错如下，请定位原因并做最小修复。” | 它能结合报错和源码查问题 |
| 补测试 | “参考现有测试风格，为这个函数补 3 个边界用例。” | 它能模仿项目已有写法 |
| 改文档 | “把 README 改成新手能看懂的版本。” | 它适合整理结构和降低阅读门槛 |
| 小功能开发 | “给 CLI 增加一个 --json 参数。” |
范围明确，容易验证 |
| 代码审查 | “只看当前 diff，找可能导致 bug 的问题。” | 它能快速扫描遗漏和边界条件 |
新手不建议一开始就让它做这些：
- “重构整个项目”
- “帮我优化所有代码”
- “把这个系统改成微服务”
- “自动修完所有报错并提交”
这些任务太大，Codex 可能会做很多你没预料到的改动。你也很难判断它到底改得对不对。
更好的做法是：把大任务切成小任务，一次只让它完成一块。
三、四种入口：不是四个 Codex，而是四种使用姿势
Codex 容易让新手困惑的地方，是入口比较多。你可能会看到桌面应用、命令行、IDE 插件、网页版。它们看起来像四个东西，其实可以理解成同一个能力的四种打开方式。
入口总览
| 入口 | 你在哪里用 | 更适合谁 | 典型场景 |
|---|---|---|---|
| 桌面 App | 独立图形界面 | 不想一直待在终端的人 | 同时管理多个任务、查看改动、做代码审查 |
| CLI 命令行 | 终端里 | 熟悉命令行的人 | 在项目目录里快速派活、跑脚本、自动化 |
| IDE 插件 | VS Code 等编辑器里 | 日常在编辑器写代码的人 | 边看文件边让 Codex 改、解释、补测试 |
| Web / Cloud | 浏览器里 | 想把任务放到云端跑的人 | 长任务、并行任务、GitHub PR |
可以把它们画成这样：
这里有一个很重要的区别：本地入口和云端入口。
桌面 App、CLI、IDE 插件通常更贴近你的本地项目。它们可以在你的电脑上读文件、改文件、运行命令。优点是反馈直接，你也更容易看到发生了什么。
Web / Cloud 更像把任务交给一台远程工作机。它适合跑比较久的任务，也适合从 GitHub 仓库生成 PR。缺点是：它不一定能看到你电脑上没有提交的临时文件、本地数据库或私有环境。
四、新手到底该从哪个入口开始？
如果你没有特殊偏好，可以按下面的方式选。
1. 完全不熟命令行：先用桌面 App
桌面 App 的好处是直观。你能看到会话、任务、改动和一些操作按钮，不需要一上来记命令。
适合你，如果你是：
- 刚接触 AI 编程代理
- 不想在终端里折腾
- 想同时开几个任务
- 更喜欢可视化查看结果
2. 每天都用 VS Code：优先试 IDE 插件
如果你的主要工作都在编辑器里，IDE 插件会比较顺手。你不用频繁切换窗口，可以边看代码边让 Codex 解释或修改。
适合你，如果你经常这样想：
- “帮我解释当前文件”
- “帮我改这个函数”
- “按这个报错定位一下”
- “给这段逻辑补测试”
3. 熟悉终端：CLI 会更快
CLI 适合已经习惯在终端里工作的用户。你进入项目目录，启动 Codex，就可以直接让它读项目、改文件、跑命令。
适合你，如果你经常：
- 用 Git、npm、pytest、make 等命令
- 在远程服务器或容器里工作
- 想把 Codex 接进脚本或自动化流程
4. 想让任务后台跑：用 Web / Cloud
云端入口适合耗时任务，比如让 Codex 在 GitHub 仓库里修复 CI、补测试、整理文档、生成 PR。
适合你，如果你需要：
- 任务跑很久，不想占着本机
- 多个任务并行处理
- 让 Codex 直接基于 GitHub 仓库工作
- 和团队一起审 PR
一句话建议：
新手先用桌面 App 或 IDE 插件建立手感；熟悉后再用 CLI 和 Cloud 提高效率。
五、Codex 和 ChatGPT、Claude Code 有什么区别？
这个问题很多人会问。可以分两层看。
Codex vs ChatGPT
它们都来自 OpenAI，但定位不同。
ChatGPT 更像通用助手。它可以帮你解释概念、写方案、讨论设计、生成代码片段。它适合“想问题”。
Codex 更像编程代理。它面向项目工作，可以读文件、改文件、跑命令、整理 diff。它适合“做事情”。
实际使用时，两者并不冲突。你可以先用 ChatGPT 讨论思路，再让 Codex 在项目里执行；也可以直接在 Codex 里边讨论边修改。
Codex vs Claude Code
Codex 和 Claude Code 都属于 AI 编程代理。它们都能理解项目、修改文件、运行命令，也都有自己的项目说明机制。
你可以先抓住这几个差异：
| 对比点 | Codex | Claude Code |
|---|---|---|
| 所属公司 | OpenAI | Anthropic |
| 项目说明文件 | AGENTS.md |
CLAUDE.md |
| 常见入口印象 | App、CLI、IDE、Cloud 都比较突出 | 终端体验很强 |
| 使用建议 | 适合想要多入口、可视化和云端任务的人 | 适合重度命令行用户 |
不用急着判断谁“更强”。更实际的做法是：拿同一个小任务分别试一次，看哪个更适合你的工作习惯。
为了更直观地对比这三者的定位和适用场景，可以参考下面的对比图：
六、第一次使用前，先记住三个安全习惯
Codex 能动手改项目，这既是优势，也是风险。新手一定要先养成这三个习惯。
习惯一：先让它只读解释
第一次打开项目，不要马上说“帮我改”。先说：
请先阅读这个项目，不要修改文件。告诉我项目是做什么的、怎么运行、主要目录分别负责什么。
这样你能确认它是否理解项目，也能顺便帮自己建立项目地图。
习惯二：改动前先有 Git 存档
如果项目还没有 Git，至少先初始化并提交一次。这样 Codex 改坏了，你还能看 diff 或回退。
git status
git diff
这两个命令很重要。git status 看哪些文件变了，git diff 看具体改了什么。
习惯三：提交前必须 review
不要因为 Codex 最后说“完成了”，就直接相信。你至少要看三件事：
- 它改了哪些文件？
- 有没有改到你没要求的地方？
- 测试或验证有没有跑过？
Codex 生成的是高质量候选，不是最终责任人。最终点头的人还是你。
这三个安全习惯可以形成一个完整的工作流程，确保使用Codex时的安全性：
七、可以直接复制的第一条提示词
如果你已经装好 Codex，可以打开一个练习项目，然后发这段：
请先只读分析这个项目，不要修改任何文件。
我刚开始学习 Codex，请用新手能听懂的话回答：
1. 这个项目大概是做什么的？
2. 入口文件或主要目录在哪里？
3. 我应该用什么命令运行或测试它？
4. 如果我要做第一个小改动，你建议从哪里开始？
5. 在修改前，我需要注意哪些风险？
这条提示词的好处是：它不会让 Codex 立刻动手，而是先帮你建立全局认知。对新手来说，这比直接让它写代码更稳。
八、这一节你真正要带走什么？
读完这篇，你不用记住所有入口和功能。先记住下面几句话就够了：
- Codex 是会动手的编程代理，不只是聊天问答。
- 它能读项目、改文件、跑命令，但结果必须由你检查。
- 新手先从只读解释和小改动开始，不要一上来交给它大重构。
- 桌面 App 和 IDE 插件更适合入门，CLI 和 Cloud 更适合效率提升。
- Git、diff、测试，是和 Codex 协作时最基本的安全带。
下一节再进入更细的概念：代理、上下文、沙箱、审批这些词到底是什么意思。
参考资料说明
本文参考 OpenAI Codex 官方文档中的以下主题整理：
- Codex overview：Codex 是什么
- Codex CLI：命令行入口
- Codex IDE Extension：编辑器插件入口
- Codex App：桌面应用入口
- Codex Cloud：云端任务入口
📢 关注「Harry技术」公众号
获取更多 AI 编程工具、技术前沿资讯与实战技巧，一起走在技术浪潮的最前面。
Agent 垂直技术社区，欢迎活跃、内容共建。
更多推荐
11
0- 0
已为社区贡献2条内容
所有评论(0)