OpenAI Codex 新手使用教程：从第一次提问到安全交付

发布于

写给新手的 OpenAI Codex 入门教程：理解 Codex 能做什么、选择合适入口、写好提示词、处理权限、检查代码变更，并建立可复用的工作流。

#OpenAI #Codex #AI coding #workflow

Codex 是什么

OpenAI Codex 可以理解为一个“会使用开发工具的编程助手”。它不只是回答代码问题，还可以在你指定的项目目录里读取文件、修改代码、运行命令、解释报错、写测试、做代码审查，并把过程展示给你确认。

对新手来说，最重要的不是一上来让 Codex 写一个完整系统，而是先把它当成一个耐心的结对程序员：你描述目标，它帮你拆步骤、找文件、改代码、验证结果；你负责判断方向、确认权限和最终验收。

先选对使用入口

Codex 有多个使用入口，不同入口适合不同场景：

如果你完全是小白，建议先从 Codex App 或 IDE 扩展开始。等你熟悉了文件、命令、Git 和测试，再逐渐尝试 CLI 或云端任务。

第一次使用前要准备什么

新手常见问题不是“Codex 不会写”，而是“项目环境没有准备好”。开始前建议先确认四件事：

怎样写一个好提示词

给 Codex 的提示词不需要华丽，但要具体。一个稳定的格式是：目标、背景、限制、完成标准。

目标：给博客新增一篇文章页面。
背景：当前项目是静态 HTML，样式在 css/style.css，文章由 build_site.py 生成。
限制：保持现有设计风格，不要引入新框架。
完成标准：生成页面、更新首页和 sitemap，并本地预览确认没有链接错误。

这个格式的好处是，Codex 不需要猜你的意图，也更容易判断什么时候算完成。

适合新手的 6 类任务

刚开始不建议把“做一个完整 App”这种大任务直接丢给 Codex。更适合从下面这些小任务练起：

当你发现 Codex 对项目越来越熟悉，再逐步让它做更大的功能。

为什么 Codex 会问你要权限

Codex 运行在有安全边界的环境里。它读取文件、写文件、运行命令、联网、访问系统资源时，可能需要你确认。新手看到权限弹窗不要紧张，重点看三件事：

例如，运行测试、启动本地开发服务器、推送 Git 通常是合理的；删除目录、重置 Git 历史、上传私密文件则需要非常谨慎。看不懂时，可以先拒绝，然后问 Codex：“这个命令会做什么？有没有更安全的方式？”

推荐工作流：先计划，再修改，再验证

新手最容易犯的错误，是看到 Codex 写完代码就立刻复制上线。更稳的流程是：

  1. 让 Codex 先读项目：了解目录、框架、已有风格。
  2. 让 Codex 给计划：复杂任务先问它准备改哪些文件。
  3. 小步修改：一次只做一个明确目标。
  4. 本地验证：运行测试、打开页面、检查报错。
  5. 看 diff：确认它只改了该改的内容。
  6. 再提交：通过 Git commit 保存稳定版本。

如果任务很模糊，可以先说：“先不要改代码，先问我 3 个问题，把需求澄清后再动手。”这比事后返工更省时间。

把重复要求写进 AGENTS.md

如果你每次都要提醒 Codex“不要乱改样式”“先运行测试”“中文回答”，说明这些要求应该沉淀成项目规则。Codex 支持用 AGENTS.md 保存仓库级指导。

一个简单的 AGENTS.md 可以这样写：

# 项目规则
- 修改前先阅读相关文件，不要凭空猜结构。
- 保持现有代码风格，不引入新框架。
- 改完后运行生成脚本或测试命令。
- 不要提交 .env、缓存、临时文件。
- 最终说明改了哪些文件，以及如何验证。

它不需要很长。短而准确的规则，比一大堆空泛要求更有用。

常见坑

一个完整示例

假设你要给博客新增文章，可以这样对 Codex 说：

请帮我给这个博客新增一篇文章。
题目：OpenAI Codex 新手使用教程
目标读者：完全没用过 Codex 的新手
风格：白话、实用、不要太技术黑话
要求：
1. 先看当前项目结构
2. 按现有博客样式新增文章
3. 更新首页、标签、RSS 和 sitemap
4. 生成后本地预览
5. 最后告诉我部署命令
不要提交 .env、缓存或临时文件。

这类提示词清楚、可验证、边界明确，Codex 的成功率会高很多。

结论

Codex 对新手最有价值的地方，不是让你完全不用学习编程，而是把“看不懂项目、不会定位错误、不知道怎么改、不会验证”的过程变得可对话、可拆解、可复查。

最好的使用方式是：把 Codex 当成会动手的同事，而不是神奇按钮。你给目标和边界，它做阅读、修改和验证；你负责判断、确认和最终发布。这样用，Codex 才会真正提高效率，而不是制造新的混乱。

官方资料：