全网最详细的Codex入门教程，手把手教你玩转Vibe Coding

Vibe Coding这个词最近火得不行。

简单说就是：你用自然语言描述你想要什么，AI帮你把代码写出来。你只负责"感觉"，AI负责"实现"。

而OpenAI最新推出的Codex，就是目前Vibe Coding体验最完整的工具之一。

这篇文章把Codex从是什么、怎么用、到怎么用好，全部讲清楚。认真看完，直接上手。

一、Codex是什么

OpenAI Codex是2025年推出的云端AI编程代理，集成在ChatGPT里面。

注意，这不是2021年那个老的Codex API（已经下线了），这是全新的产品。

它的工作方式和其他AI编程工具不一样：

关键区别：Codex是在云端独立干活的。

你给它一个任务，它会在云端启动一个独立环境，读你的代码仓库，自己写代码、跑测试、修bug，全部搞定后把结果（代码改动）交给你审核。

你可以理解为：你雇了一个远程程序员，给他需求，他做完了提交给你review。

二、谁能用

目前Codex的使用条件：

• ▸ChatGPT Pro用户（$200/月）：完整使用
• ▸ChatGPT Plus用户（$20/月）：有限额度
• ▸ChatGPT Team/Enterprise用户：可用

打开方式：登录ChatGPT → 左侧边栏找到"Codex"入口

如果你还没看到入口，可能还在灰度中，等几天就有了。

三、基本使用流程

▸ 第一步：连接你的GitHub仓库

进入Codex页面后，首先要关联你的GitHub：

1. 1点击"Connect Repository"
2. 2授权GitHub访问
3. 3选择你要让Codex操作的仓库

Codex会把你的仓库代码拉到云端沙盒里，后续所有操作都在沙盒中进行，不会直接改你的仓库。

▸ 第二步：配置环境（可选但推荐）

你可以设置一个setup.sh脚本，告诉Codex怎么初始化你的项目环境：

#!/bin/bash# 安装依赖npm install# 设置环境变量export NODE_ENV=development# 其他初始化操作cp .env.example .env

这样Codex每次启动任务时，都会先跑这个脚本把环境准备好。

▸ 第三步：给任务

在输入框里用自然语言描述你要做什么：

给用户注册接口加上邮箱格式校验，如果格式不对返回400错误，写好之后跑一下现有的测试确保没有break。

然后选择模式：

• ▸Coding：让它写代码、改代码
• ▸Ask：只问问题，不改代码

点击提交，Codex就开始干活了。

▸ 第四步：等它做完

Codex会在云端：

1. 1读取你的代码库
2. 2理解项目结构
3. 3写代码或修改代码
4. 4运行测试验证
5. 5把结果打包好

整个过程你可以实时看到它的思考过程和操作日志。

▸ 第五步：审核结果

做完后，Codex会展示：

• ▸它改了哪些文件
• ▸每个文件具体改了什么（diff视图）
• ▸测试运行结果

你有三个选择：

• ▸Accept：满意，接受改动
• ▸Request Changes：不满意，让它继续改
• ▸Create PR：直接创建一个Pull Request到你的GitHub仓库

四、Codex能做什么

▸ 写新功能

给博客系统加一个标签功能：- 文章可以打多个标签- 可以按标签筛选文章- 标签管理的CRUD接口用现有的技术栈（Express + Prisma）实现

▸ 修Bug

issue #42 报告说用户上传头像后，个人主页不显示新头像。帮我定位问题并修复，修完跑一下测试。

▸ 写测试

给 src/services/payment.ts 写完整的单元测试，覆盖正常支付、余额不足、网络超时三种情况。

▸ 重构

src/controllers/ 目录下的所有controller都在直接操作数据库，帮我抽出一个service层，controller只负责处理请求和响应。

▸ 代码审查

看看 src/auth/ 模块有没有安全隐患，重点检查：SQL注入、XSS、token处理是否安全。

▸ 写文档

给 src/api/ 下的所有接口生成 OpenAPI 3.0 格式的文档。

五、什么是Vibe Coding，怎么用Codex做Vibe Coding

Vibe Coding这个概念是Andrej Karpathy提出的，核心思想是：

💡

你不用精确地写代码，只需要描述你的"感觉"和"意图"，AI来实现。

用Codex做Vibe Coding的正确姿势：

▸ 1. 描述你想要的结果，而不是具体实现

❌ 不好的方式：

在 src/routes/user.ts 第45行后面加一个 if 判断，检查 req.body.email 是否匹配 /^[^\s@]+@[^\s@]+\.[^\s@]+$/ 这个正则

✅ 好的方式：

用户注册时需要校验邮箱格式，格式不对就返回错误提示

你说意图，让Codex决定怎么实现。这就是Vibe Coding。

▸ 2. 用场景描述代替技术描述

❌ 不好的方式：

写一个middleware，用jsonwebtoken库验证Authorization header里的Bearer token

✅ 好的方式：

需要保护API接口，只有登录用户才能访问。未登录的请求返回401。

▸ 3. 迭代式开发

Vibe Coding不是一次性把所有需求说完。而是：

第一轮：帮我搭一个博客的基础框架，能发文章就行第二轮：加上用户系统，要能注册登录第三轮：文章加上评论功能第四轮：加个简单的后台管理页面

每轮做完，看看效果，再提下一个需求。像聊天一样把产品做出来。

▸ 4. 用"感觉"来反馈

这个页面感觉太空了，内容区域再宽一点，加点间距这个报错信息太技术了，换成普通用户能看懂的话这个接口响应太慢了，帮我优化一下

不需要精确说"把max-width改成1200px"，说感觉就行，Codex会理解。

六、AGENTS.md：给Codex立规矩

和Claude Code的CLAUDE.md类似，Codex用的是AGENTS.md文件。

在项目根目录创建这个文件，写上你的项目规范：

## 项目概述这是一个Next.js 14的电商项目，使用TypeScript + Prisma + PostgreSQL。## 代码规范- 所有代码用TypeScript，开启strict模式- 组件用函数式组件 + hooks- 样式用Tailwind CSS，不要写自定义CSS- API接口统一用 src/lib/api.ts 里的封装方法## 测试要求- 新功能必须写单元测试- 测试框架用Jest- 测试文件放在对应目录的 __tests__ 文件夹下## 注意事项- 不要修改 src/legacy/ 目录- 数据库migration要用 prisma migrate- 环境变量不要硬编码## 常用命令- 安装依赖：npm install- 跑测试：npm test- 构建：npm run build- 启动开发服务器：npm run dev

写好这个文件，Codex每次执行任务都会先读它，相当于给它一份"员工手册"。

七、实战案例

▸ 案例1：从零搭建一个项目

第一轮对话：

帮我创建一个待办事项应用的后端API：- 用Express + TypeScript- 数据库用SQLite（开发方便）- 要有：创建待办、列出所有待办、标记完成、删除- 加上基本的输入校验

Codex会在云端创建整个项目结构，写好代码，跑通测试，然后把结果给你。

第二轮对话：

加上用户系统：- 注册、登录（用JWT）- 每个用户只能看到自己的待办- 加上认证中间件保护所有待办接口

第三轮对话：

加上分页和搜索：- 列出待办支持分页，每页20条- 支持按标题关键词搜索- 支持按状态筛选（全部/未完成/已完成）

三轮对话，一个完整的后端API就出来了。

▸ 案例2：修复线上Bug

线上有用户反馈：连续快速点击"提交订单"按钮会创建重复订单。帮我：1. 找到订单创建的相关代码2. 分析为什么会重复3. 加上防重复提交的机制4. 写测试验证修复有效

▸ 案例3：性能优化

src/services/report.ts 里的 generateMonthlyReport 函数执行很慢，大概要30秒才能返回结果。帮我分析瓶颈在哪，优化到5秒以内。

八、使用技巧

1. 任务描述要有验收标准

不要只说"加个功能"，要说清楚"做到什么程度算完成"：

加上邮箱验证功能。验收标准：- 注册后发送验证邮件- 点击邮件里的链接完成验证- 未验证用户不能发帖- 验证链接24小时过期

2. 让它跑测试

每次任务都加一句"做完跑一下测试确保没问题"，这样Codex会自己验证，减少你review的工作量。

3. 复杂任务拆开提

一个大功能拆成3-5个小任务分别提交，比一次性提一个巨大的需求效果好很多。

4. 善用Ask模式

不确定怎么做的时候，先用Ask模式问问：

我想给这个项目加上WebSocket实时通知功能，你觉得应该怎么设计？有哪些方案？各自的优缺点是什么？

了解清楚再让它动手。

5. 看它的思考过程

Codex执行任务时会展示思考日志，看看它的思路对不对。如果方向不对，及时喊停，重新描述需求。

九、Codex vs 其他AI编程工具

Codex的独特优势：

• ▸可以并行处理多个任务，你提交3个需求，它同时做
• ▸在隔离环境运行，不会搞乱你的本地环境
• ▸自带测试验证，交付质量更高
• ▸通过PR交付，天然适合团队协作流程

Codex的劣势：

• ▸不是实时的，提交任务后要等
• ▸需要GitHub仓库，纯本地项目不方便
• ▸价格较高（Pro $200/月才能完整使用）
• ▸对网络有要求

建议组合：

• ▸日常写代码：Copilot或Cursor做实时补全
• ▸复杂调试和重构：Claude Code在本地处理
• ▸完整功能开发：Codex在云端异步完成
• ▸三个不冲突，按场景切换

十、费用和额度

如果你是个人开发者，先用Plus试试，额度不够再考虑升Pro。

如果你是团队，Team方案性价比更高。

十一、常见问题

代码安全吗？

代码会上传到OpenAI的云端沙盒处理。OpenAI声明不会用API/付费用户数据训练模型。企业用户有额外的数据保护协议。敏感项目使用前评估一下合规要求。

支持私有仓库吗？

支持，授权GitHub时选择对应的私有仓库就行。

支持GitHub以外的平台吗？

目前主要支持GitHub。GitLab、Bitbucket的支持可能后续会加。

任务执行要多久？

看任务复杂度，简单的几分钟，复杂的可能十几分钟。可以同时提交多个任务并行处理。

支持哪些语言？

主流语言都支持：Python、TypeScript/JavaScript、Go、Rust、Java、C#等。

能处理前端项目吗？

能。React、Vue、Next.js、Svelte都可以。但因为是云端环境，没法实时预览UI效果，需要你本地拉下来看。

十二、总结

Codex代表的是AI编程的一个新方向：异步、自主、交付式。

你不需要坐在电脑前盯着AI写每一行代码，而是像给团队成员分配任务一样，描述清楚需求，让它自己去做，做完了你来review。

这就是Vibe Coding的终极形态：你负责想，AI负责做。

上手建议：

1. 1先连一个小项目试试水
2. 2从简单任务开始，比如写测试、加校验
3. 3熟悉了再给复杂任务
4. 4写好AGENTS.md，让它了解你的项目规范
5. 5养成"描述意图而非实现"的习惯

觉得有用就收藏，后续会更新Codex的高级玩法和团队协作实践。有问题评论区聊。