Codex 实战教程：从 PRD 到 Vercel 部署完整项目开发流程

用 Codex 写了两周代码之后，我摸出了一套效率很高的开发流程：Gemini 写 PRD，Codex 跑后端和数据库，Claude Code 磨前端样式。这篇 Codex 实战教程把整个流程拆开来讲，从 PRD 文档到 Vercel 部署，一步步带你走完。

实战项目是一个提示词管理工具 PromptPal，开发完直接部署到了 Vercel 上。整个过程中踩了不少坑，也总结了几条实用的避坑技巧。

Codex 实战项目 PromptPal 部署到 Vercel 成品展示

准备工作：

Codex 还没装？先看 Codex App 上手指南：从安装到使用 Skills 教程

额度不够用？查看 Codex 额度详解与省流攻略

需要升级 ChatGPT？查看 ChatGPT Plus 国内充值教程

Codex 实战教程概述：三工具分工开发

这次 Codex 项目开发用到了三个工具，各自负责最擅长的部分：

工具	负责内容
Gemini 2.5 Pro	PRD 文档撰写
Codex	整体产品开发、后端逻辑、数据库、测试优化
Claude Code	前端页面样式优化

为什么这么分？简单说：Gemini 上下文窗口大，适合写长文档；Codex 后端逻辑处理能力强，比 Claude Code 更稳；Claude Code 前端细节打磨更到位。

具体的分工对比和协作方法，可以看我的另一篇文章 Codex 与 Claude Code 协作开发指南。这篇重点讲 Codex 在项目开发中的完整流程。

用 Gemini 撰写 PRD 文档

PRD 文档是整个 Codex 项目开发的起点。这次我专门升级了 PRD 撰写提示词，加入了 ASCII 图，让前端布局能让人和 AI 都看明白。

用 AI 写 PRD 的流程不复杂。把需求跟 AI 讲清楚就行，不用一次写完，Gemini 会一个场景一个场景来跟你确认。

用 Gemini 撰写 PRD 文档与 AI 确认需求

每个场景 AI 都会问你这里有哪些功能、样式长什么样，确认完才进入下一个场景。

Gemini AI 逐场景确认 PRD 功能与样式

全部场景确认完后，AI 会生成一份完整的 PRD 文档。直接复制粘贴到项目文件夹里就行。

Gemini 生成完整 PRD 文档包含所有场景说明

PRD 文档里每个场景都有清晰的说明，AI 拿到这份文档就能明确知道要做什么。

PRD 文档与 AI 开发的关键：场景拆分

这里有个关键点：PRD 一定要按场景拆分，比如 US-01、US-02 这样编号。后面让 Codex 开发的时候，每次只做一个场景。这能大幅降低 Bug 率，也方便逐步验收。

Codex 项目开发流程：按场景逐步推进

PRD 文档准备好之后，就可以把项目交给 Codex 了。

Codex 读取 PRD 并制定开发计划

第一步是让 Codex 阅读 PRD 文档，确认它理解了你要做什么。然后让它给出第一个场景 US-01 的开发计划，同时要求它考虑整体架构。

Codex 阅读 PRD 文档并给出项目开发计划

让 Codex 在第一个场景就把架构想清楚，后面的场景开发会顺畅很多。Codex 自己做架构设计时，基本不会搞出一个文件塞几千行代码的情况，文件结构会划分得比较清晰。

一次只开发一个场景：Codex 实战核心原则

每次只让 Codex 开发一个场景。 这是整个 Codex 项目开发流程中最重要的原则。

一个场景开发完，自己先验收。觉得没问题了，再让 Codex 开发下一个场景。

Codex 按场景逐步开发项目功能

如果一次扔给 AI 整个项目，大概率出来一堆互相依赖的 Bug，修到你怀疑人生。按场景拆分之后，每次开发范围小，Bug 也容易定位。

Codex 测试与 Bug 修复

测试过程中发现问题，直接截图或者描述给 Codex，让它去检查并修复。

Codex 接收 Bug 反馈并自动检查修复

有一点需要注意：Codex 不能像 Claude Code 那样直接在后台跑开发环境让你访问。你需要自己在终端运行对应的启动命令。可以让 Codex 给出测试指令，然后自己去终端跑。

Codex 给出项目测试启动指令

重复「开发 → 测试 → 修 Bug」这个循环，直到所有场景做完。

Codex 开发完成所有场景的最终产品页面

Codex 项目开发避坑指南

用 Codex 做项目不是扔个需求进去就能跑通的，有几个坑你大概率会踩到。

语料补充：提前准备 API 文档

PRD 里写清楚了要对接 DeepSeek 的 API，但 Codex 的训练数据里不一定有最新的 API 文档。结果就是它写出来的对接代码一堆 Bug。

解决方法：把对方的 API 文档提前下载好，开发的时候直接喂给 Codex，手动增强上下文。

为 Codex 补充 DeepSeek API 语料文档增强上下文

凡是涉及到调第三方 API 的项目，建议都这么干。提前把文档准备好，能省掉大量修 Bug 的时间。

及时更新 PRD 文档保持项目一致性

开发过程中你肯定会发现 PRD 有遗漏，或者做出来跟预期不一样。这时候可以通过对话让 Codex 调整实现，调整完之后一定要让 Codex 同步更新 PRD 文档。

Codex 在开发过程中同步更新 PRD 文档

这样 PRD 始终和项目代码对得上，不会出现文档和实现脱节的情况。

更新后的 PRD 文档与项目实现保持一致

项目越做越大的时候，PRD 和代码的一致性直接决定了 Bug 率高不高。

用 init 命令生成项目说明文件

每开发完一个版本，跑一次 init 命令。Codex 会自动生成项目说明文件，让后续的 AI 对话能更快理解项目结构。

Codex init 命令生成项目说明文件

这个习惯对长期维护的项目很有用。AI 读完说明文件之后，不用再花大量 Token 去扫描整个代码库。关于 Codex 的额度和 Token 消耗，可以参考 Codex 额度详解与省流攻略。

Codex 开发者推荐

升级 ChatGPT Plus，解锁 Codex 完整开发能力

通过 GetGPTPlus 使用支付宝/微信快速开通 ChatGPT Plus，获取 Codex 开发额度。

立即升级 ChatGPT

用 Codex 部署项目到 Vercel

项目开发完了，下一步是部署。让 Codex 给写一份 Vercel 部署教程，它对 Vercel 平台的理解还不错，输出的教程每一步都有清晰说明。

Codex 生成的 Vercel 部署教程步骤详细

按教程操作，中间遇到问题截图发给 Codex 让它帮忙排查。

Codex 帮助排查 Vercel 部署过程中的问题

修了几轮 Bug 之后，项目成功部署到 Vercel。

Codex 项目成功部署到 Vercel 在线运行

Codex 对 Vercel 的部署流程掌握得还不错。模型对平台信息理解得越全面，开发者用起来就越省事。

Codex 实战教程总结

整个 Codex 项目开发流程走下来，核心就这几步：

用 Gemini 写 PRD：按场景拆分，加 ASCII 图辅助说明布局
Codex 按场景开发：一次只做一个场景，做完验收再推进下一个
语料补充：涉及第三方 API 的项目，提前下载文档喂给 Codex
及时更新 PRD：开发中有调整就同步更新文档，保持一致性
用 init 生成项目说明：方便后续 AI 理解项目
Codex 辅助部署：让 Codex 写部署教程，遇到问题截图反馈

Codex 在后端逻辑和数据库处理上确实比较强，但前端样式这块就不是它的主场了。如果你想知道怎么搭配 Claude Code 来补上前端的短板，可以看 Codex 与 Claude Code 协作开发指南。

如果你需要升级 ChatGPT Plus 来获取 Codex 开发额度，可以通过 ChatGPT Plus代充快速充值开通，支持支付宝/微信支付。