第四章 让 Codex 帮你读/改代码
Codex 的入门
•
Codex 可以理解为“会进入代码项目工作的 AI 编程助手”。
你可以用自然语言告诉它任务，例如：
✍️
•
请解释这个项目是做什么的。
•
请找出这个 bug 的原因，并做最小修改。
•
请为这个函数补一个单元测试。
它会读取项目文件、分析代码、必要时修改文件、运行命令或测试，然后把结果和修改差异展示给你。
更简单地说：ChatGPT 更像是在聊天窗口里回答你，Codex 更像是坐在你的项目目录里一起干活。
Codex 的基本工作流
这里最关键的是最后一步：你仍然要审查结果。
Codex 很强，但它不是“自动上线机器”。新手最稳的用法，是把它当成一个能干活的助手，而不是一个不需要检查的自动驾驶。
画板
图 1：Codex 欢迎 / 登录界面
第一次打开 Codex App 时，可以看到欢迎页面，通常可选择使用 ChatGPT 账号继续，或输入 API key。
图 2：选择项目文件夹
Codex 不是只和你闲聊，它通常需要知道自己要在哪个项目里工作。你可以选择一个项目文件夹或 Git 仓库。
图一 Codex欢迎界面
图二 选择项目文件夹
图 3：第一次输入任务
选择项目后，就可以在输入框里告诉 Codex 要做什么。第一次建议先让它解释项目，不要急着改代码。
图 4：Codex App 主界面：线程、项目、修改预览
Codex App 是桌面端工作台，可以并行处理多个线程，也能配合 worktree、自动化和 Git 功能使用。
图三 输入任务
50%
图四 Codex主界面
50%
图 5：Local / Worktree / Cloud 模式
Codex App 中，一个线程可以选择不同模式：Local、Worktree、Cloud。
•
Local：直接在当前项目目录工作；
•
Worktree：把改动隔离到新的 Git worktree；
•
Cloud：在配置好的云环境中远程运行。
图 6：Git 提交面板
Codex App 内置 Git 工具，可以展示 diff，也可以 stage、commit、push、创建 PR。
图五 选择模式
58%
图六 Git提交面板
42%
图 7：内置终端
每个线程可以使用内置终端，常见用途包括：
代码块
Bash
git status
npm testpnpm run lint
图 8：App 内置浏览器
做前端项目时，Codex 可以借助 App 内置浏览器预览本地页面、检查页面元素，或验证 UI 修复。
图 9：VS Code / Cursor / Windsurf 中的 Codex 扩展
如果你已经使用 VS Code、Cursor、Windsurf 或 VS Code 兼容编辑器，可以用 Codex IDE 扩展。
图 10：IDE 中切换权限模式
Codex IDE 扩展支持 Chat、Agent、Agent Full Access 等模式。新手建议先用 Chat 或普通 Agent 模式，不要一开始就给 Full Access。
图 11：CLI 终端界面
Codex CLI 是在终端里运行的 coding agent，更适合已经习惯命令行的开发者。
图 12：GitHub 中请求 Codex Review
当 Codex Cloud / GitHub 集成设置好后，可以在 GitHub PR 评论中使用 @codex review 请求代码审查。
图 13：Codex 在 GitHub PR 中发布 review
Codex 会在 PR 上留下 review comment，指出具体代码位置和问题说明。
零基础先理解 5 个关键词
如果你现在只想记一个词，那就是 diff。
Codex 改完文件后，不要只看它的总结。一定要看 diff，因为 diff 才是它真正改了什么。
选择入口：App、IDE、CLI、Web 怎么选
Codex 有多个入口。零基础用户最容易卡住的地方，就是不知道该从哪里开始。
评论 (0)
画板内评论
0 个结果
我的建议很简单：
小白优先 Codex App；开发者优先 IDE 扩展；命令行熟练后再用 CLI；GitHub 项目需要后台跑任务时再看 Web / Cloud。
第一次使用：推荐从 Codex App 开始
5.1 账号与计划
Codex 的可见入口、额度和功能，会受你的 ChatGPT 计划、workspace 权限和登录方式影响。
如果你使用 Codex App，通常可以用 ChatGPT 账号登录，也可以使用 OpenAI API key。需要注意的是，用 API key 登录时，某些 Cloud 相关功能可能不可用。
5.2 下载、打开、登录
建议小白按这个顺序：
安装 Codex App。
选择一个练习项目文件夹。
使用 ChatGPT 账号登录。
第一次先选择 Local。
第一次任务只让 Codex 解释项目，不要让它改代码。
5.3 第一次推荐输入
代码块
Plain Text
请先不要修改任何文件。请用中文解释这个项目：
1. 这个项目大概是做什么的？
2. 主要文件夹分别有什么作用？
3. 入口文件可能在哪里？
4. 如果我要运行它，通常要执行哪些命令？
5. 你有哪些不确定的地方？请明确说“不确定”，不要猜。
这条 prompt 的核心是：先读项目，不改项目。
第一次提问：先让 Codex 读项目，不要急着改代码
新手最容易犯的错误，是第一次就说：
代码块
Plain Text
帮我重构整个项目。
代码块
Plain Text
帮我做一个完整网站。
代码块
Plain Text
把所有 bug 都修了。
这些任务范围太大，你很难判断 Codex 改得对不对。
更好的顺序是：
0 个结果
画板
第一次可以这样问：
代码块
Plain Text
请先不要修改文件。请解释这个项目的结构，并告诉我新手应该先读哪些文件。
等你确认 Codex 对项目理解基本正确，再进入下一步。
第一次改代码：只改一个小地方
等你确认 Codex 已经大致理解项目后，再让它做一个很小的修改。
推荐从 README 开始：
代码块
Plain Text
请只修改 README.md，新增一个“小白如何启动项目”的小节。
要求：
- 不要修改其他文件
- 不要安装新依赖
- 不要改代码
- 改完后告诉我你改了哪里
- 如果项目里没有明确启动命令，请说明“不确定”，不要编造
改完后，你要看两件事：
代码块
Bash
git status
git diff
如果你用的是 Codex App，也可以直接看 review pane 或 diff pane。
看 diff 时重点看什么？
•
有没有改到你没让它改的文件；
•
有没有新增你不认识的依赖；
•
有没有删除关键配置；
•
文案或代码是不是符合你的需求；
•
它说“已完成”的事情，diff 里是否真的体现了。
新手不要怕看不懂全部代码。先从“它到底改了哪些文件”开始，就已经能避免很多风险。
提示词模板：直接复制就能用
8.1 万能结构
代码块
Plain Text
目标：
我想让你完成什么？
这个结构不复杂，但很有用。它能减少 Codex 自己猜。
8.2 读项目模板
代码块
Plain Text
8.3 修 bug 模板
代码块
Plain Text
我遇到一个 bug，请帮我定位并修复。
现象：
[粘贴报错或描述现象]
复现步骤：
1. [第一步]
8.4 新增功能模板
代码块
Plain Text
请帮我新增一个小功能。
功能目标：
[描述你要的功能]
范围：
8.5 代码审查模板
代码块
Plain Text
请审查当前未提交的修改。
8.6 带截图做 UI 的模板
Codex 支持图片输入。做 UI 时，可以把截图、设计稿或报错截图一起发给它。
代码块
Plain Text
请根据我附上的截图实现一个页面。
安全使用：权限、沙盒、审批、隐私
Codex 能读文件、改文件、运行命令，所以安全边界很重要。
9.1 小白推荐权限
0 个结果
画板
9.2 审批弹窗怎么选
当你看到 Codex 请求批准时，先看它要做什么。
谨慎对待这些行为：
代码块
Bash
rm -rf
代码块
Bash
sudo
代码块
Bash
curl ... | sh
代码块
Bash
代码块
Plain Text
访问系统目录或项目外目录
如果你不确定，就选更窄的批准方式，或者直接拒绝，让 Codex 解释为什么需要这个命令。
9.3 不要把这些内容交给 Codex
不要把以下内容直接放进项目、prompt、日志或截图里：
•
API key
•
数据库密码
•
生产环境 token
•
客户隐私数据
•
身份证、银行卡、手机号等敏感信息
•
公司未授权共享的内部材料
•
生产数据库连接字符串
尤其要注意：很多错误日志里会带 token、cookie、URL 参数或数据库连接信息。粘贴前先看一眼。
9.4 每次改代码前先做 Git checkpoint
在项目目录里执行：
代码块
Bash
git status
git add .
git commit -m "checkpoint before codex task"
Codex 改完后执行：
代码块
Bash
git status
git diff
如果改坏了，可以用 Git 回退。
如果你还不会 Git，至少先做到一点：不要在没有备份的情况下，把 Codex 放进很重要的生产项目里大改。
7 天小白练习路线
第 1 天：只读项目，不改文件
代码块
Plain Text
请不要修改文件。请解释这个项目的用途、目录结构、入口文件和运行方式。
目标：知道项目大概是什么。
第 2 天：让 Codex 写项目说明
代码块
Plain Text
目标：练习让 Codex 生成文档。
第 3 天：只改 README
代码块
Plain Text
请只修改 README.md，补充“安装依赖”和“启动项目”说明。
不要修改其他文件。
目标：练习看 diff。
第 4 天：修一个小 bug
代码块
Plain Text
目标：学会提供现象和复现步骤。
第 5 天：补测试
代码块
Plain Text
请为刚才修复的问题补一个最小测试。
要求：
目标：不要只让 Codex 改代码，也要让它验证。
第 6 天：让 Codex 审查你的改动
代码块
Plain Text
请审查当前未提交修改，重点看 bug、边界情况、回归风险和是否需要测试。
先不要修改文件，只输出审查意见。
目标：把 Codex 当第二双眼睛。
第 7 天：尝试 Worktree 或 Cloud
代码块
Plain Text
请在隔离分支或 worktree 中尝试实现这个小功能：[功能描述]
目标：学会在隔离环境里尝试更复杂的改动。
进阶：AGENTS.md 让 Codex 更懂你的项目
当你经常使用 Codex，可以在项目根目录添加 AGENTS.md。
可以把它理解成“给 AI Agent 看的项目说明书”。Codex 开始工作前会读取这些项目指导，帮助它理解团队约定。
示例：
代码块
Markdown
# AGENTS.md
## 项目约定
适合写进 AGENTS.md 的内容包括：
•
项目启动方式；
•
测试、构建、lint 命令；
•
代码风格；
•
不能改的目录；
•
发布流程；
•
PR 要求；
•
数据库和接口兼容性要求。
一个好用的原则是：当你第二次提醒 Codex 同一件事，就应该考虑把它写进 AGENTS.md。
常见问题 FAQ
Q1：我完全不会代码，可以用 Codex 吗？
可以，但建议从“解释项目”“整理文档”“读报错”“写学习路线”开始，不要一上来让它做大范围重构。
你可以把 Codex 当成辅助学习工具，但它修改文件后仍然需要你审查 diff 和验证结果。
Q2：Codex App、IDE、CLI、Web 到底选哪个？
小白优先用 Codex App；已经每天用 VS Code、Cursor 或 Windsurf，就用 IDE 扩展；会终端再用 CLI；项目在 GitHub 上且想让 Codex 后台处理任务、生成 PR 时，用 Web / Cloud。
Q3：Codex 改错了怎么办？
先看 diff，不满意就让它继续改；如果项目已经被改乱，使用 Git 回滚。
如果你还没学 Git，建议先用练习项目，不要直接在重要项目上大范围改动。
Q4：Codex 要求批准命令，我该点同意吗？
看懂命令再同意。
涉及删除文件、安装依赖、访问项目外目录、联网下载、运行脚本的命令尤其要谨慎。
看不懂时，可以直接问：
代码块
Plain Text
请解释这个命令要做什么、为什么必须执行、有没有更安全的替代方式。
Q5：需要 API key 吗？
不一定。
Codex App 可以使用 ChatGPT 账号或 OpenAI API key 登录。但使用 API key 时，部分功能例如 cloud threads 可能不可用。
Q6：Codex 能直接替我上线吗？
不建议让 Codex 在无人审查的情况下直接操作生产环境。
更安全的流程是：
代码块
Plain Text
最后总结
Codex 的正确入门方式不是：
代码块
Plain Text
帮我一次性做完整项目。
而是：
代码块
Plain Text
先解释项目
把任务拆小、把权限收紧、把验证写清楚，你就可以从零基础开始，安全地使用 Codex 帮你读代码、改代码和审查代码。🚀