小白别再瞎问 AI 写代码了:Codex 这样用才真正有效

下面是从gpt官方提炼出来的 Codex 入门内容，非常适合小白使用，建议收藏起来慢慢看。

1. 先让 Codex 读懂你的项目

小白最容易犯的错是：一上来就让 Codex 改代码，但 Codex 还不知道你的项目结构。

可以先问：

请先阅读这个项目，告诉我：1. 这个项目是做什么的2. 主要文件夹分别有什么用3. 如果我要改首页，应该看哪些文件4. 如果我要运行项目，需要哪些命令

这个用法适合刚接手项目，或者看不懂别人代码的时候。

2. 用agents.md给 Codex 写“项目说明书”

agents.md可以理解成给 Codex 的小抄。每次 Codex 进项目时，都会先看它。

里面可以写：

# 项目说明这是一个 Next.js 项目。## 常用命令- 安装依赖：npm install- 启动项目：npm run dev- 运行测试：npm test- 检查代码：npm run lint## 注意事项- 修改代码后必须运行测试- 不要随便改动 package.json- 前端组件放在 components 文件夹- 页面文件放在app 文件夹

小白很需要这个，因为你不用每次都重新解释项目规则。

3. 不要直接说“帮我改”，要指定文件

比较差的说法：

帮我优化这个页面。

更好的说法：

请查看 app/page.tsx 和 components/Hero.tsx帮我优化首页的按钮样式。不要改其他页面。改完后告诉我你改了哪些地方。

这样 Codex 不容易乱改，也更容易找到正确文件。

4. 先让 Codex 制定计划，再让它动手

小白不要一上来就让它写代码。可以先让它分析。

先不要修改代码。请先阅读相关文件，然后告诉我你会怎么实现这个功能。请把任务拆成 3-5 个小步骤。

确认思路没问题后，再说：

按照上面的计划开始实现。每完成一步后检查是否有问题。

这个方法很适合功能比较复杂的时候。

5. 让 Codex 帮你修 bug：直接贴报错

如果项目报错，不要只说“它坏了”。

直接贴完整报错：

这是我运行项目时的完整报错：[把报错粘贴在这里]请帮我：1. 判断问题原因2. 找到相关文件3. 修改代码4. 告诉我怎么验证是否修好了

完整报错比你自己描述更有用。

6. 让 Codex 自动加测试

很多小白不会写测试，可以这样问：

请查看我刚刚修改过的文件。

帮我补充必要的单元测试。

重点测试：1. 正常情况2. 空数据情况3. 用户输入错误的情况请使用项目里现有的测试方式。

这样可以避免代码“看起来能跑”，但实际有隐藏问题。

7. 让 Codex 做代码审查

这个很实用。你改完代码后，可以让 Codex 检查。

请审查我当前未提交的代码。重点检查：1. 有没有明显bug2. 有没有会影响生产环境的问题3. 有没有重复代码4. 有没有不符合项目风格的地方。只指出重要问题，不要给太多小建议。

这个适合提交作业、提交 PR、或者交给老板/同事前自查。

8. 让 Codex 帮你写文档

文档是小白很容易忽略的地方，但很有用。

可以问：

请根据当前项目，帮我写一个简单的README。内容包括：1. 项目是做什么的2. 如何安装3. 如何启动4. 常用命令5. 项目结构说明

或者：

请为这个功能写一段说明文档。要求简单清楚，让新同事能看懂。

9. 用截图告诉 Codex 你想改哪里

如果你很难描述页面问题，可以直接截图。

然后说：

请看这张截图。我想把截图中这几个按钮的背景色改成橙色。请找到对应代码并修改。不要影响其他按钮。

这个对前端小白非常有用，因为你不用准确说出文件名或组件名。

10. 让 Codex 根据 TODO 自动实现功能

你可以在代码里写：

// TODO: 添加一个下载按钮，点击后下载当前页面内容然后让Codex：请查找项目里的TODO。并实现这个功能。实现后删除对应TODO

适合你先把想法写在代码里，再让 Codex 补实现。

11. 让 Codex 画项目流程图

如果项目很复杂，可以问：

请帮我生成一个 Mermaid sequence diagram说明这个项目中用户从打开页面到提交表单的流程。

它会生成流程图代码。你可以放到支持 Mermaid 的文档里看图。

12. 让 Codex 帮你重构重复代码

如果你发现很多地方代码很像，可以问：

请检查这个项目中是否有重复代码。如果有，请告诉我哪些地方可以抽成通用组件。先不要修改代码，只给我重构建议。

然后再说：

请按照建议，把重复代码抽成一个通用组件。保持原来的功能不变。

13. 用codex resume回到之前的对话

如果你之前让 Codex 做了一半，退出了，不用重新开始。

可以用：

codex resume

它可以回到之前的 Codex 会话。这对长任务很有用，比如修 bug、重构、写测试。

14. 用自定义命令减少重复输入

如果你经常让 Codex 写测试，可以建一个固定提示词文件，比如：

请为所有修改过的文件生成单元测试。使用项目现有测试框架。不要大改项目结构。保持改动最小。

以后就不用每次重复写一大段。

15. 小白最推荐的使用顺序

刚开始不要用太高级的功能。建议按这个顺序练：

• 让 Codex 解释项目
• 让 Codex 找相关文件
• 让 Codex 制定修改计划
• 让 Codex 实现一个小功能
• 让 Codex 检查代码
• 让 Codex 写测试
• 让 Codex 写 README 或说明文档

这样不容易把项目改乱。

可以直接复制的万能提示词

请先阅读这个项目，不要急着修改代码。我的目标是：[写你的目标]请你先告诉我：1. 需要改哪些文件2. 每个文件为什么要改3. 实现步骤是什么4. 有什么风险5. 改完后应该如何测试等我确认后，你再开始修改。

这个提示词对小白最安全。它能让 Codex 先解释，再动手。