01 · OpenAI Codex 入门指南：它不是“会写代码的聊天框”，而是会动手的编程代理

" 适合读者：第一次听说 Codex，或只用过 ChatGPT 写代码，但还没用过 AI 编程代理的人。 本文目标：先建立整体认知，不急着安装。读完后，你应该能判断：Codex 是什么、适合做什么、四种入口该选哪一个。 注：Codex 的界面、套餐、模型和命令会持续更新。具体安装方式、价格和功能边界，请以 OpenAI 官方文档为准。

先说结论：Codex 更像“能操作项目的工程师助手”

很多人第一次听到 Codex，会把它理解成“更会写代码的 ChatGPT”。这个理解不算错，但还不够准确。

ChatGPT 更像一个坐在旁边的顾问。你问它“这个函数怎么写”“这个报错是什么意思”，它会给你解释、方案或代码片段。接下来怎么把代码放进项目、怎么改文件、怎么跑测试，通常还要你自己完成。

Codex 的重点不只是“回答”，而是“执行”。你把任务交给它，它可以读取你的项目文件，理解目录结构，修改代码，运行命令和测试，再把改动结果交给你检查。

换句话说：

• • ChatGPT 更擅长帮你想清楚。
• • Codex 更擅长帮你把事情落到项目里。
• • 你仍然是负责人，Codex 是执行搭档。

这就是 Codex 和普通“代码问答工具”的关键差别：它能形成一个从理解到修改再到验证的工作闭环。

一、先搞懂一个词：什么是编程代理？

你会在 Codex 相关资料里经常看到一个词：Agent，中文通常叫“代理”或“智能体”。

这个词听起来有点抽象。放到编程场景里，可以简单理解成：

" 它不是只回答问题，而是会根据目标自己拆步骤、调用工具、完成任务。

比如你说：

帮我给登录接口补上错误密码的测试。

一个普通聊天模型可能会直接给你一段测试代码。

Codex 更可能这样做：

1. 1. 先找登录接口在哪里。
2. 2. 再找项目现有测试怎么写。
3. 3. 判断测试框架是 Jest、pytest 还是别的。
4. 4. 新增或修改测试文件。
5. 5. 运行相关测试。
6. 6. 如果测试失败，再继续定位问题。
7. 7. 最后告诉你改了什么、怎么验证。

这就是“代理”的价值。它不只是给建议，而是能沿着任务往前推进。

不过也正因为它能动手，使用时要更注意边界。你不能把它当成“绝对正确的自动程序员”。更稳妥的心态是：让它做繁琐执行，你负责方向、判断和最终验收。

二、Codex 适合做哪些事？

如果你刚入门，可以先从低风险任务开始。下面这些场景比较适合 Codex：

新手不建议一开始就让它做这些：

• • “重构整个项目”
• • “帮我优化所有代码”
• • “把这个系统改成微服务”
• • “自动修完所有报错并提交”

这些任务太大，Codex 可能会做很多你没预料到的改动。你也很难判断它到底改得对不对。

更好的做法是：把大任务切成小任务，一次只让它完成一块。

三、四种入口：不是四个 Codex，而是四种使用姿势

Codex 容易让新手困惑的地方，是入口比较多。你可能会看到桌面应用、命令行、IDE 插件、网页版。它们看起来像四个东西，其实可以理解成同一个能力的四种打开方式。

入口总览

可以把它们画成这样：

flowchart TB     A["我要用 Codex"] --> B{"我平时在哪里工作？"}     B -->|喜欢图形界面| C["桌面 App"]     B -->|常用终端| D["CLI"]     B -->|主要写代码在编辑器| E["IDE 插件"]     B -->|想让任务在云端跑| F["Web / Cloud"]      C --> G["本地项目"]     D --> G     E --> G     F --> H["云端环境 / GitHub 仓库"]

这里有一个很重要的区别：本地入口和云端入口。

桌面 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 能动手改项目，这既是优势，也是风险。新手一定要先养成这三个习惯。

习惯一：先让它只读解释

第一次打开项目，不要马上说“帮我改”。先说：

请先阅读这个项目，不要修改文件。告诉我项目是做什么的、怎么运行、主要目录分别负责什么。

这样你能确认它是否理解项目，也能顺便帮自己建立项目地图。

习惯二：改动前先有 Git 存档

如果项目还没有 Git，至少先初始化并提交一次。这样 Codex 改坏了，你还能看 diff 或回退。

git status
git diff

这两个命令很重要。git status 看哪些文件变了，git diff 看具体改了什么。

习惯三：提交前必须 review

不要因为 Codex 最后说“完成了”，就直接相信。你至少要看三件事：

1. 1. 它改了哪些文件？
2. 2. 有没有改到你没要求的地方？
3. 3. 测试或验证有没有跑过？

Codex 生成的是高质量候选，不是最终责任人。最终点头的人还是你。

七、可以直接复制的第一条提示词

如果你已经装好 Codex，可以打开一个练习项目，然后发这段：

请先只读分析这个项目，不要修改任何文件。

我刚开始学习 Codex，请用新手能听懂的话回答：
1. 这个项目大概是做什么的？
2. 入口文件或主要目录在哪里？
3. 我应该用什么命令运行或测试它？
4. 如果我要做第一个小改动，你建议从哪里开始？
5. 在修改前，我需要注意哪些风险？

这条提示词的好处是：它不会让 Codex 立刻动手，而是先帮你建立全局认知。对新手来说，这比直接让它写代码更稳。

八、这一节你真正要带走什么？

读完这篇，你不用记住所有入口和功能。先记住下面几句话就够了：

1. 1. Codex 是会动手的编程代理，不只是聊天问答。
2. 2. 它能读项目、改文件、跑命令，但结果必须由你检查。
3. 3. 新手先从只读解释和小改动开始，不要一上来交给它大重构。
4. 4. 桌面 App 和 IDE 插件更适合入门，CLI 和 Cloud 更适合效率提升。
5. 5. Git、diff、测试，是和 Codex 协作时最基本的安全带。

下一节再进入更细的概念：代理、上下文、沙箱、审批这些词到底是什么意思。

参考资料说明

本文参考 OpenAI Codex 官方文档中的以下主题整理：

• • Codex overview：Codex 是什么
• • Codex CLI：命令行入口
• • Codex IDE Extension：编辑器插件入口
• • Codex App：桌面应用入口
• • Codex Cloud：云端任务入口