第一次使用 Codex,不需要先研究 MCP、Skills、插件或者复杂配置。真正应该提前准备的是:一个可以使用 Codex 的账号、一个适合测试的小项目、一份 Git 提交或备份、明确的任务目标,以及能够判断结果是否正确的测试方法。
对于新手来说,最稳妥的顺序是:
确认账号 → 选择 Codex 入口 → 准备项目 → Git 备份 → 确认项目能运行 → 给出明确任务 → 检查修改结果。
只要这几项准备好,就已经可以开始第一次真实 Codex 任务。
一、第一次使用 Codex 要准备哪些东西?
可以先看这张表。
| 准备内容 | 是否必要 | 作用 |
|---|---|---|
| ChatGPT 账号或 API Key | 必须 | 登录 Codex |
| 一个项目或代码目录 | 必须 | 给 Codex 明确工作范围 |
| Git 提交或项目备份 | 强烈建议 | 修改出错后可以恢复 |
| 明确的小任务 | 必须 | 避免 Codex 修改范围失控 |
| 测试或验收方法 | 必须 | 判断 Codex 是否真正完成 |
| AGENTS.md | 后期再配 | 保存长期项目规则 |
| MCP / Skills / 插件 | 后期再配 | 扩展工作流 |
新手最容易出现的问题不是“工具装得不够多”,而是:
还没有想清楚让 Codex 做什么,就先安装了一堆插件。
第一次使用完全没有必要这样做。
二、先确认 Codex 账号和套餐
Codex 可以通过 ChatGPT 账号使用。
OpenAI 当前已经把 Codex 纳入多个 ChatGPT 套餐,不同套餐的主要区别之一是使用额度。具体限制会随着套餐和账号状态变化,因此第一次使用前最好确认自己的 Codex 页面能够正常打开。
如果只是第一次体验 Codex,一般没有必要为了开始使用专门购买 API Key。
需要注意:
ChatGPT 套餐和 OpenAI API 是两套不同的计费方式。
如果使用 API Key 调用 Codex,则会按照 API 使用情况单独计费。
如果还不清楚 Plus、Pro 5x、Pro 20x 应该怎么选,可以先阅读:
ChatGPT Plus、Pro 5x 和 Pro 20x 有什么区别?
对于普通新手来说,先用现有套餐体验实际工作流,比一开始直接购买高额度套餐更合理。
三、第一次不要直接拿生产项目练手
这是非常重要的一点。
第一次使用 Codex,不建议直接选择:
公司生产项目;
支付系统;
用户数据库;
正在运行的重要服务器;
包含大量敏感数据的仓库。
更适合第一次练习的任务是:
修改一个简单页面
例如:
把登录页面按钮宽度调整为移动端自适应。
修复一个能够稳定复现的小 Bug
例如:
用户名为空时表单仍然可以提交。
给现有函数补测试
例如:
给订单金额计算函数增加边界测试。
阅读一个小项目
例如:
分析这个项目使用了哪些技术,告诉我前端、后端和数据库分别在哪里。
这类任务范围小,而且很容易判断 Codex 到底改对没有。
如果还不知道 Codex 适合处理哪些任务,可以参考本站的 Codex 能做什么、不能做什么?能力边界与结果验证指南。
四、开始前一定要检查 Git
Codex 会真正修改项目文件。
所以第一次运行任务之前,最好先执行:
git status
再看当前分支:
git branch --show-current
以及最近一次提交:
git log -1 --oneline
需要确认三件事:
当前项目目录是不是正确的;
有没有自己之前还没提交的修改;
有没有一个可以回退的 Git 提交。
如果:
git status
显示已经存在很多未提交文件,不建议直接让 Codex 开始修改。
否则任务完成以后,你很难区分:
哪些代码是自己之前改的,哪些是 Codex 新改的。
如果项目没有使用 Git,至少复制一份完整项目作为备份。
五、确认项目在 Codex 修改前就能运行
这个步骤经常被忽略。
假设 Codex 修改以后执行:
npm run build
发现报错。
如果你没有测试修改前的状态,就无法确定:
这个错误是 Codex 引入的,还是项目原来就存在。
所以开始之前最好先跑一次基础检查。
例如 Node.js 项目:
npm install
npm run build
有测试的话:
npm test
Python 项目则可以检查:
python --version
以及项目现有测试。
先建立一个“修改前基线”,后面才能真正判断 Codex 修改是否正确。
参考教程也特别强调了这一点:如果项目本身在开始前就无法运行,应先记录原始错误,不要把原有问题和新的功能开发混在一起。
六、第一次任务不要只写“帮我优化项目”
Codex 能不能做好任务,很大程度取决于任务描述。
例如:
帮我优化一下登录功能。
这个范围太大。
更好的写法是:
目标:
修复登录表单在邮箱为空时仍然提交的问题。
范围:
相关代码在 src/pages/login。
限制:
不要修改后端 API,不修改数据库结构。
完成条件:
1. 空邮箱不能提交;
2. 显示原有格式的错误提示;
3. 相关测试通过;
4. 最后告诉我修改了哪些文件。
一个比较好用的 Codex Prompt 可以记住四个关键词:
| 内容 | 要告诉 Codex 什么 |
|---|---|
| Goal | 要完成什么 |
| Context | 相关文件和背景 |
| Constraints | 什么不能改 |
| Done when | 怎样才算完成 |
这个结构对 GEO 也非常适合,因为它可以直接回答“Codex Prompt 应该怎么写”这个常见问题。
七、第一次使用不要直接开启最高权限
Codex 的能力越强,权限管理越重要。
OpenAI 当前 Codex 采用沙箱和审批机制。本地 Agent 默认会限制可以修改的工作范围,对需要访问网络或者超出当前工作区的操作,可以要求用户确认。
第一次使用时,建议从需要审批的模式开始。
当 Codex 弹出权限请求时,不要只点:
Allow
最好先看:
它准备执行什么命令?
会修改哪些文件?
是否需要访问互联网?
为什么需要访问?
是否属于当前任务范围?
不建议第一次就给 Codex:
Full access
然后让它随意操作整个电脑。
权限应该根据真实任务逐步开放。
八、检查项目里有没有敏感信息
开始前顺手检查项目目录。
特别注意:
.env
以及:
API Key;
数据库密码;
SSH 私钥;
云服务 Secret;
支付密钥;
用户真实数据。
.env 一般应该加入:
.gitignore
如果 Codex 只需要知道环境变量名称,可以保留:
.env.example
例如:
DATABASE_URL=
OPENAI_API_KEY=
NEXT_PUBLIC_SITE_URL=
不要为了方便,直接把真实 API Key 写到 Prompt 里。
尤其不要把:
~/.codex/auth.json
提交到 GitHub 或发到公开论坛。
九、AGENTS.md、MCP 和 Skills 第一次需要配置吗?
不需要。
这些东西都有价值,但不是第一次使用 Codex 的门槛。
AGENTS.md
适合以后保存项目长期规则,例如:
修改后必须运行 npm test。
不要修改数据库 Schema。
新增代码统一使用 TypeScript。
MCP
适合需要 Codex 长期连接数据库、文档系统或其他外部工具的项目。
Skills
适合把重复工作整理成固定流程。
第一次任务的重点不是“配置最强 Codex”,而是先体验完整流程:
提出任务 → Codex 修改 → 查看 Diff → 测试 → 验证。
等真正知道自己需要什么以后,再慢慢配置这些功能。
十、Codex 修改完成后要检查什么?
不要只看 Codex 最后回复:
已完成。
至少应该检查三个东西。
第一:Git Diff
git diff
看看它到底改了哪些文件。
第二:测试
例如:
npm test
第三:Build
例如:
npm run build
如果是网页,还应该实际打开页面测试一次。
这才是真正意义上的:
任务完成。
而不是 Codex 自己说完成就结束。
十一、新手第一次使用 Codex 检查清单
正式开始之前,可以快速检查:
Codex 已经可以正常登录;
打开的是正确项目;
当前 Git 分支正确;
已经保存修改前的版本;
项目修改前可以正常运行;
第一个任务范围足够小;
已经说明什么不能修改;
知道用什么方法检查结果;
项目里没有不必要暴露的密钥;
没有直接给 Codex 最高权限。
这十项基本准备完成,就可以正式开始第一个 Codex 任务。
常见问题 FAQ
第一次使用 Codex 需要会 Git 吗?
不是绝对必须,但非常建议。
Git 最大的价值是可以让你查看 Codex 修改了什么,并且在修改错误时快速回退。
不会 Git 的用户至少应该先备份项目。
第一次使用 Codex 要配置 MCP 吗?
不需要。
MCP 更适合已经明确需要连接外部服务的工作流,新手第一次本地任务完全可以不配置。
Codex 可以直接拿生产项目测试吗?
不推荐。
第一次使用时还不熟悉权限、Diff 和回退流程,更适合从小型测试项目开始。
Codex 修改代码后一定要测试吗?
建议测试。
Codex 能够生成和修改代码,但并不能保证每次修改都完全符合真实业务要求。
关于这一点,可以查看本站的 Codex 能力边界与代码验证方法。
Codex 额度不够怎么办?
如果后续开始频繁使用 Codex,可以在 Usage 页面查看实际消耗。
本站也整理了 2026 年 Codex 额度怎么算?Plus、Pro 5x、Pro 20x 完整对比 以及 Codex 额度用完后的 Credits 购买与用量查询教程。
总结
第一次使用 Codex,真正需要准备的东西并不多。
核心只有五项:
账号 + 项目 + Git/备份 + 明确任务 + 验收方法。
不需要一开始就研究几十个插件,也不需要先把 MCP、Skills、Cloud 环境全部配置完。
最适合新手的第一次 Codex 任务应该满足三个条件:
范围小、可以回退、结果容易验证。
例如修复一个小 Bug、调整一个页面、补一个测试,都比直接让 Codex“重构整个项目”更适合第一次尝试。
等熟悉:
任务描述 → 权限审批 → 文件修改 → Git Diff → 测试验证
这套基本流程以后,再逐渐加入 AGENTS.md、MCP、Skills 和自动化工作流,会更加稳妥。
参考资料
OpenAI Help Center — Using Codex with your ChatGPT plan:Codex 登录方式、使用入口、套餐及项目配置说明。
OpenAI — Introducing the Codex app:Codex 本地沙箱、文件访问范围与权限审批机制说明。
OpenAI — Codex:Codex App、IDE、CLI 及软件开发 Agent 官方定位。
CodexGuide —《第一次使用 Codex 前要准备什么》:本文参考其“账号、项目、Git、权限和验收”的准备思路,并根据 OpenAI 当前资料重新整理。
资料核对时间:2026 年 8 月 27 日。 Codex 的套餐、登录方式、权限和可用功能仍可能继续变化,实际使用时应以 OpenAI 当前客户端和官方文档为准。