最近Codex的热度非常高，如果你对 AI 挺感兴趣，但还没真正用 AI 做过一个能跑的小东西，这篇可以当作你的第一份上手笔记。

我尽量不讲概念，只带你把最关键的几步跑通：装好、登录、选文件夹、发第一条靠谱指令，再学会看它到底改了什么。

Codex 不是那种只会陪你聊天的 AI。它更像一个能在你电脑文件夹里干活的助手。你告诉它要做什么，它可以读文件、写文件、运行命令、看报错，然后继续修。

---

1. 使用前先准备好这 4 样东西

别急着下载，先确认手边有这些东西。不然装到一半卡住，会很影响心情。

• 一台电脑：Windows 或 macOS 都可以
• 一个 ChatGPT 账号
• 一个能正常访问 ChatGPT / OpenAI 的网络环境
• 一个专门练手的空文件夹

如果你还没有 ChatGPT 账号，先去这里注册：

• https://chatgpt.com

注册方式一般可以选邮箱、Google、Microsoft 或 Apple 账号。注册完再回来装 Codex。（梯子这个大家自己想办法解决了）

---

2. 安装：直接去官网下 Codex

Codex的额度是跟你的ChatGPT会员相关的，可以免费体验，但是有条件的话最好开个 Plus 会员（每月 20 美刀），额度更充裕，也足够日常使用了。

直接去官网下载安装 Codex App：

• https://chatgpt.com/zh-Hans-CN/codex/

（Linux 用户可以使用命令行版本的 Codex CLI，可参考开发者文档：https://developers.openai.com/codex/app）

---

3. 登录：用你的 ChatGPT 账号

打开 Codex App 后，它会让你登录。

点击登录后，浏览器会打开 ChatGPT 授权页面，选择你的 ChatGPT 账号，授权完成后，回到 Codex App

额度这块也顺手说一下：Codex 的使用通常跟你的 ChatGPT 订阅有关。不同账号、不同套餐能用多少不一定一样，别听别人说“我这里能用多少”就当成固定规则，最后以你自己账号页面显示为准。

---

4. 打开后先认界面

第一次打开 Codex，大概率会有点懵：左边一堆列表，中间一个对话框，右下角还有模型、权限之类的东西。

先记住这 4 个区域就够了。

• 左侧栏：管理对话和项目
• 中间：你和 Codex 聊天、看它执行任务
• 输入框：你写需求的地方
• 权限/模型：控制它能做多少事、用什么模型做

别急着把每个按钮都研究明白。会新建项目、会发消息、会看结果，就已经够你开始用了。

---

5. 对话和项目有什么区别？

这里是最容易混的地方，我第一次给别人讲 Codex，基本都会先讲这个。

你可以简单记成这样：

• 只问问题、写文案、做计划：用“对话”
• 要读本地文件、改代码、生成网页：用“项目”

---

6. 第一次练手：千万别选重要项目

第一次练手，我建议你先新建一个空文件夹，比如：

codex-demo

里面放一个简单文件：

# 我的第一个 Codex 练习

我想用 Codex 做一个简单个人主页。

为什么非要这么麻烦？

• 文件少，你看得懂
• 改错了，不心疼
• Codex 做了什么，你能一眼看出来

等这个小练习跑通了，再让它碰正式项目。这个顺序稳很多。

---

7. 新手权限怎么选？

刚开始建议保守一点，尤其是你还不知道它每个操作意味着什么的时候。

如果 Codex 问你要不要允许它修改文件、运行命令，你看不懂时不要硬点同意。先让它解释：

我看不懂这个操作。
请用小白能懂的话解释：
1. 你准备做什么
2. 为什么要做
3. 会不会修改或删除我的文件

---

8. 第一句话：先让它读项目

很多人第一次会这样说：

帮我做一个网站。

这句话不是不能用，但太空了。

更推荐你这样说：

请先阅读当前项目，不要修改任何文件。
用小白能听懂的话告诉我：
1. 这个项目里有什么文件
2. 每个文件大概是做什么的
3. 如果我要做一个简单个人主页，应该从哪里开始

这一步不是为了马上产出代码，而是先让 Codex 当导游。它讲完以后，你也会更知道下一句该怎么问。

如果它说得太技术，不用装懂，直接让它重说：

你刚才说得有点技术。
请假设我是完全零基础，用生活化的话重新解释。

---

9. 第二步：打开计划模式，先规划再动手

如果任务稍微复杂一点，比如做网页、改项目、修一堆报错，我建议先让它出计划。

你可以这样说：

先不要修改文件。
请先给我一个执行计划：
1. 你准备改哪些文件
2. 每一步要做什么
3. 做完后我怎么检查结果

等我确认后你再开始。

这一步很适合新人。你先看它准备怎么干，觉得不对就拦住，别等它全改完了再头大。

---

10. 第一个实操：做一个个人主页

确认它理解项目后，再让它动手。这里不用追求一步到位，先做出来再慢慢改。

直接复制这段：

请在当前项目里创建一个最简单的个人主页。

要求：
1. 只创建必要文件
2. 不要引入复杂框架
3. 页面包含昵称、自我介绍、三个兴趣、联系方式
4. 风格清爽，不要太花
5. 完成后告诉我创建了哪些文件，以及如何打开

如果它做完后页面不好看，也很正常。第一次生成的东西经常有点“课程作业味”，继续让它改就行：

这个页面现在有点像作业。
请保持文件结构不变，只优化视觉：
1. 字体更舒服
2. 间距更松一点
3. 增加头像占位区
4. 不使用外部图片

这就是最适合新手的节奏：一次只提一个小需求，改完马上看结果。

---

11. 提示词怎么写，效果差很多

少说：

帮我优化一下。

多说：

请只优化首页样式，不改功能逻辑。
重点改善：字体、间距、按钮状态。
不要改动其他页面。
完成后告诉我改了哪些文件。

再给你一个万能格式：

请帮我完成【任务】。

背景：
【我现在的情况】

要求：
1. 【具体要求 1】
2. 【具体要求 2】
3. 【具体要求 3】

限制：
- 不要改无关文件
- 不要引入复杂依赖
- 修改前先说明计划

验收：
- 告诉我怎么检查结果

你说得越清楚，Codex 越不容易自由发挥。AI 最怕的不是任务难，而是任务太模糊。

---

12. 每次改完，都看一眼 diff

Codex 能改文件，这是它好用的地方，也是你需要多看一眼的地方。

看不懂代码也没关系，至少要问一句：

请用小白能懂的话解释刚才的改动。
重点说明：
1. 改了哪些文件
2. 每个文件为什么要改
3. 有没有可能影响已有内容

如果它改多了，就说：

这个改动范围太大了。
请只保留和当前任务相关的必要改动，其他不相关修改撤回。

这个习惯很重要。不是说新手不能让 AI 改文件，而是不要连它改了哪里都不知道就一路确认。

---

13. AGENTS.md：给 Codex 写项目规矩

AGENTS.md 可以理解成“写给 Codex 的项目说明书”。你把规矩写进去，它后面做事会更有边界。

在设置里面打开个性化：

可以直接复制大神卡帕西的模板：

行为准则，用于减少常见的 LLM 编码错误。可按需与项目特定说明合并。
**权衡： 这些准则偏向谨慎而非速度。对于简单任务，请自行判断。**

## 1. 编码前先思考

**不要假设。不要掩盖困惑。明确呈现权衡。**
实现前：

- 明确说明你的假设。如果不确定，就提问。
- 如果存在多种理解方式，把它们列出来，不要默默选择其中一种。
- 如果存在更简单的方法，说明它。必要时提出反对意见。
- 如果有不清楚的地方，就停下来。说明哪里令人困惑。提问。

## 2. 简单优先

**用最少的代码解决问题。不做推测性扩展。**

- 不添加用户未要求的功能。
- 不为一次性代码创建抽象。
- 不添加未被要求的“灵活性”或“可配置性”。
- 不为不可能发生的场景添加错误处理。
- 如果你写了 200 行，而其实 50 行就够，重写它。

问问自己：“资深工程师会认为这过度复杂吗？”如果答案是会，就简化。

## 3. 外科手术式修改

**只改必须改的地方。只清理你自己造成的问题。**
编辑现有代码时：

- 不要“顺手改进”相邻代码、注释或格式。
- 不要重构没有坏掉的东西。
- 匹配现有风格，即使你会用不同方式实现。
- 如果发现无关的死代码，提出来，不要删除它。当你的修改产生孤立代码时：
- 移除因你的修改而变成未使用的 imports / 变量 / 函数。
- 不要删除预先存在的死代码，除非用户要求。

检验标准：每一行修改都应该能直接追溯到用户的请求。

## 4. 目标驱动执行定义成功标准。

**循环直到验证通过。**
把任务转化为可验证的目标：

- “添加校验” → “为无效输入编写测试，然后让测试通过”
- “修复 bug” → “编写一个能复现它的测试，然后让测试通过”
- “重构 X” → “确保重构前后测试都通过”对于多步骤任务，说明一个简短计划：

1. [步骤] → 验证：[检查项]
2. [步骤] → 验证：[检查项]
3. [步骤] → 验证：[检查项]

强成功标准能让你独立循环推进。弱标准（“让它能用”）则需要不断澄清。
**这些准则生效的表现是： diff 中不必要的修改更少，因为过度复杂导致的重写更少，并且澄清问题发生在实现前，而不是犯错后。**

创建好以后，对 Codex 说：

请读取 AGENTS.md，并以后按里面的项目规则执行。

这个文件以后会越来越有用。你做博客项目，可以写文章风格；做网页项目，可以写设计规范；做脚本项目，可以写运行方式。它不神秘，就是把你每次都要重复交代的话提前写下来。

---

14. 新手最适合先玩这 5 件事

玩法 1：解释陌生项目

请阅读当前项目，不要修改文件。
把它当成一个陌生项目交接给新人：
1. 项目是做什么的
2. 入口文件在哪里
3. 我应该先读哪 3 个文件

玩法 2：修报错

我运行下面命令时报错：

[把命令贴这里]

报错信息是：

[把报错贴这里]

请先解释原因，再给最小修改方案。
修改前先告诉我你准备改哪些文件。

玩法 3：做小网页

请帮我做一个简单个人主页。
只用 HTML 和 CSS，不引入框架。
完成后告诉我怎么在浏览器打开。

玩法 4：改文章

请帮我润色这篇 Markdown。
保留我的口语感，不要改成官方宣传稿。
标题更吸引新手，内容更像真人写的。

玩法 5：发布前检查

请对当前项目做一次发布前检查。
只检查，不要修改。
列出明显错误、缺少步骤、以及最建议先修的 3 个问题。

---

15. 进阶功能先知道，不用急着全学

Codex 还有很多进阶能力，比如插件、Skills、浏览器操作、Computer Use、手机远程控制等。

这些东西确实很强，但第一天不用全学。你如果一口气全看，反而更容易乱。

建议顺序是：

1. 先会创建项目
2. 再会让它读项目
3. 再会让它小步修改
4. 再学 diff 和 AGENTS.md
5. 最后再研究插件和自动化

如果你想了解源码和更新，可以看 GitHub。

但真的不用第一天就研究源码。先会用，再看原理，压力会小很多。

---

参考资料

• OpenAI Codex 官网：https://chatgpt.com/zh-Hans-CN/codex/
• OpenAI Codex App 官方文档：https://developers.openai.com/codex/app
• OpenAI Codex CLI 官方文档：https://developers.openai.com/codex/cli
• OpenAI Codex GitHub 仓库：https://github.com/openai/codex
• 参考文章：https://mp.weixin.qq.com/s/5kgVdLNABViv8uAnD0M6Ag