图文教程 · 最后更新于 2026 年 7 月 11 日 ·在飞书查看原文
这篇教程适合第一次认真上手 Codex 的用户。
因为你会因为这边教程用上它，并且彻底入门
开篇概览
这篇教程会用新手能理解的方式，把视频文案整理成一篇可操作的入门指南。你不需要先懂编程，也不需要理解太多底层原理；先学会怎么给 Codex 清晰地布置任务、怎么检查结果、怎么保护项目版本，就已经能做很多事情。
一、前期准备
环境准备，codex安装、订阅，请看这篇教程（我个人实操经验整理，不代表通用性）
二、认识 Codex
一句话理解 Codex：它是 OpenAI 出品的智能体，可以在你的电脑、项目文件夹和工具生态里完成实际任务。
你可以先不用理解得太复杂，只要记住一点：你电脑里很多需要动手处理的事情，都可以交给 Codex 帮你推进。
Codex 适合做什么
- 写代码、改页面、修 bug、跑测试。
- 整理文档、写脚本、处理文件和资料。
- 调用插件完成设计、视频、数据、办公等任务。
- 创建自动化任务，让它定时帮你执行工作流。
新手先掌握什么
- 会进入项目工作。
- 会描述清楚目标和约束。
- 会用计划模式先规划再执行。
- 会检查结果，不满意就继续引导纠偏。
三、熟悉 Codex 界面
打开 Codex 后，你会看到一个很接近 ChatGPT 风格的界面：简洁、克制、专业。对新手来说，先把几个主要区域看懂就够了。
四、临时对话与项目对话
Codex 的对话大体可以分成两类：临时对话和项目对话。两者的区别非常重要，决定了 Codex 能不能围绕一个项目持续积累上下文。
| 类型 | 适合场景 | 特点 |
|---|---|---|
| 临时对话 | 问概念、写提示词、查信息、做轻量讨论。 | 聊完就结束，新开对话后不会自动知道之前聊过什么。 |
| 项目对话 | 做网页、写脚本、整理长期资料、完成一个持续推进的任务。 | 围绕项目文件夹工作，可以保留项目里的文件、规则、需求和历史上下文。 |
推荐：只要任务会产生文件、需要多轮修改，或者后续还要继续迭代，就进入项目工作。临时对话只用来处理一次性问题。
当对话框显示进入项目时，就是临时对话
对话框显示项目名称时，就是项目对话
五、项目工作基础
项目工作可以理解成给 Codex 准备一个专门的工作文件夹。你做一个网页、写一套视频脚本、研究一个课题，相关的聊天、文件、规则和需求都可以放在这个项目里。
新建或选择项目
- 点击对话框下方的“进入项目工作”。
- 如果是新项目，可以选择“添加新项目”。
- 选择“新建空白项目”，或选择电脑上已有的文件夹。
- 项目名尽量使用英文，避免中文路径带来的兼容性问题。
三种启动模式
| 模式 | 含义 | 新手建议 |
|---|---|---|
| 本地模式 | Codex 直接在当前文件夹里操作，对原始文件进行修改。 | 适合你明确知道要改当前项目的时候使用。 |
| 工作树 | 给 Codex 复制一个项目副本，让它在副本里尝试，不污染原始文件。 | 适合风险较高、想先试试看效果的任务。 |
| 关联 Codex Web | 把本地项目和网页版 Codex 的云端环境连接起来。 | 如果你同时使用网页版 Codex，可以再深入研究。 |
六、权限、模型与上下文
Codex 能力很强，但也正因为它能直接操作文件、联网、跑命令，所以权限和上下文管理一定要理解清楚。
权限模式怎么选
| 权限模式 | 说明 | 建议 |
|---|---|---|
| 请求批准 | 编辑外部文件或使用互联网时会询问。 | 最稳妥，适合刚开始熟悉 Codex 的用户。 |
| 替我审批 | 只在 Codex 判断有风险时请求批准。 | 适合已经了解基本行为、希望少被打断的用户。 |
| 完全访问 | 可以不受限制地访问互联网和电脑上的文件。 | 只建议在你清楚风险、项目隔离良好、信任当前任务时使用。 |
风险提示：不要把“完全访问”当成默认推荐。新手更适合先用“请求批准”或“替我审批”，等你知道 Codex 会怎么改文件、怎么跑命令以后，再根据任务切换权限。
模型、推理强度和速度
- 简单任务：中等推理强度通常够用。
- 复杂任务：可以选择高或超高，让模型思考更充分。
- 快速模式：速度更快，但通常也伴随更多资源消耗。
- 长任务：关注上下文占用，必要时手动压缩。
上下文压缩和语音输入
当上下文占用逐渐变高时，Codex 的响应可能会变慢，理解也可能变差。建议在上下文达到较高占用时，使用对话框里的压缩功能，把前面的工作内容整理成更紧凑的上下文。
如果你不想频繁打字，也可以使用听写模式。很多需求直接说出来，会比键盘输入更快。
七、插件与 Skills
Codex 的强大，很大一部分来自它的插件生态和 Skills。新手最容易混淆这两个概念，可以先这样理解：插件是工具，Skills 是流程。
插件是什么
插件就像给 Codex 安装的 App。装上对应插件后，Codex 就能调用更多外部能力，比如设计、视频、办公、数据、代码仓库等。
- 适合“让 Codex 使用某个工具做事”。
- 可以在插件市场安装。
- 可以在对话里通过 @插件名 调用。
Skills 是什么
Skills 更像一套操作说明或工作流，让 Codex 按某种方法做事。它不一定提供新工具，但会约束 Codex 的执行方式。
- 适合“让 Codex 按某个流程做事”。
- 有些会自动触发，有些需要手动调用。
- 手动调用时可以输入 $skill 名称。
推荐小白安装的skills
这里原文是一张在线表格，网页上无法直接显示，请到飞书原文查看。
八、自动化任务
自动化任务是 Codex 很实用的能力。你可以让它在固定时间执行某个任务，比如每天早上 8 点收集前一天 AI 圈的官方新闻，并发送到邮箱。
创建自动化任务的基本流程
- 进入自动化任务入口，选择在对话中创建。
- 用自然语言说明任务、时间、结果形式和发送渠道。
| 检查项 | 要看什么 |
|---|---|
| 任务描述 | 是否明确说明要收集什么、发给谁、什么时候执行。 |
| 状态 | 是否为活跃，是否可以暂停、启用或删除。 |
| 下次运行时间 | 是否符合你的预期时区和时间。 |
| 测试结果 | 是否真的收到邮件或产物，内容是否有来源、日期、摘要和重要性说明。 |
九、实战项目：中国美食地图网页
了解基础功能后，就可以通过一个实战项目把前面的能力串起来。这里以“中国美食地图网页”为例，从空文件夹开始，带你体验 Codex 做项目的完整过程。
1. 从空文件夹开始
所有从 0 到 1 的项目，都建议从一个干净的空文件夹开始。文件夹名尽量用英文，例如 deliciouschina。
- 新建一个空文件夹。
- 在 Codex 中进入项目工作。
- 选择“添加新项目”。
- 选择“使用现有文件夹”，并选中刚刚创建的文件夹。
2. 先给 AI 立规矩：AGENTS.md
正式开始干活前，建议先让 Codex 生成项目规则文件，也就是 AGENTS.md。它会告诉 Codex 在这个项目中必须遵守哪些规则，避免跑偏。
| 规则类型 | 关键要求 |
|---|---|
| 数据真实性 | 主地图只展示已核验、已定位的数据，不凭空编造节目中没出现过的美食。 |
| 版权素材 | 不要随意下载节目截图、视频片段或音频；没有授权素材时使用可替换占位资源。 |
| 技术栈 | 使用 Vite、React、TypeScript、Mapbox GL JS，第一版不需要后端。 |
| 交互体验 | 地图是页面主角，点击省份后居中放大，展示城市和美食卡片。 |
| 验收标准 | 页面能启动，地图能显示，省份能点击，美食卡片和详情弹窗能正常工作。 |
3. 全局规则与项目规则的区别
除了项目里的 AGENTS.md，还有一个更高层级的全局规则，可以放你的语言偏好、代码纪律、验证标准等长期习惯。
- 全局规则：适用于这台电脑上的所有 Codex 任务。
- 项目规则：只适用于当前项目，更适合写具体技术栈、数据来源、验收方式。
4. 用 Git 管理版本
新手只需要掌握四件事：
以下全都可以交给codex让他帮你操作：
1.项目开始时初始化 Git 并提交干净版本；
2.每完成一个阶段就提交；
3.需要时让 Codex 查看历史版本；
4.不满意时让 Codex 回退到某个历史版本。
5. 把需求说清楚
不要只对 Codex 说“做一个中国美食地图网页”。这类需求太模糊，AI 只能按自己的理解做一个基础版本。更好的方式是先把你想要的效果讲清楚，再让 Codex 整理成规范 PRD。
你不会只对装修公司说“帮我装修一个房子，要好看一点”。你会说房子面积、风格、预算、工期、厨房要不要开放式、客厅要不要投影。面对 AI 做项目也是同样的逻辑。
你可以把首页效果、点击省份后的交互、美食卡片样式、地图风格、数据来源、部署目标都先描述出来。剩下的结构化工作交给 Codex。
6. 用计划模式先规划再执行
需求整理好以后，打开计划模式，让 Codex 先提出实现方案，再执行。计划模式的价值在于：它会先问清楚关键选择，减少需求没理解就直接开干导致的返工。
- 把 PRD 或完整需求交给 Codex。
- 打开计划模式。
- 让 Codex 先输出开发计划。
- 如果它询问风格、技术方案、优先级，就按你的目标选择。
- 计划确认后再执行。
7. 检查第一版页面并引导纠偏
第一版页面出来后，不要只看 Codex 说“完成了”。要用内置浏览器打开实际页面，检查页面是否正常显示、交互是否符合预期、控制台有没有明显报错。
如果页面有地方不满意，可以用页面上的点选能力，直接点中要修改的元素，再输入修改要求。例如“删掉这里”“这个模块不要”“这块改得更宽”。Codex 会把你的视觉反馈转成代码修改。
8. 管理上下文和并行任务
项目做久以后，上下文会越来越长。上下文占用过高时，Codex 可能会变慢，也可能出现理解偏差。
建议超过50%后手动输入/压缩，来压缩上下文。
但不要在同一个聊天里无限压缩。
如果当前任务在执行，你还可以新开一个对话做不冲突的事情。例如一边让 Codex 调整前端页面，一边让另一个对话联网整理《舌尖上的中国》出现过的美食数据。
| 技巧 | 适用场景 |
|---|---|
| 上下文压缩 | 当前对话很长、Codex 开始变慢或答非所问。 |
| 并行任务 | 两个任务互不冲突，例如一个改页面，一个整理数据。 |
| 及时纠偏 | 发现 Codex 往错误方向走时，立刻用引导打断并改方向。 |
9. 补充数据和图片素材
当页面结构跑通后，可以继续让 Codex 把整理好的美食数据同步到页面。没有授权照片时，不要随便抓节目截图或网络图片，可以先用占位图，后续再替换为授权素材。
如果你需要临时生成示意图片，也可以让 Codex 调用 imagegen 等能力生成图片，但正式发布前仍然要检查图片质量、版权和风格是否符合项目要求。
10. 部署上线
本地网页只能在你自己的电脑上看。如果想发给朋友，就需要把代码部署到云端。
这个阶段同样建议打开计划模式，让 Codex 先说明它准备怎么部署、需要什么授权、会改哪些配置。
- 确认本地页面已经能正常运行。
- 让 Codex 制定部署计划。
- 按提示完成必要授权。
- 部署完成后打开线上链接检查功能是否正常。
- 确认地图、卡片、详情弹窗和跳转链接都可用。
十、总结
通过这篇教程，你应该已经知道 Codex 不只是一个聊天工具，而是可以围绕真实项目持续执行的智能体。
| 你学到的能力 | 对应价值 |
|---|---|
| 认识 Codex 和界面 | 知道在哪里对话、在哪里切项目、在哪里打开工具。 |
| 项目对话 | 让 Codex 围绕一个文件夹持续推进任务。 |
| 权限和模型选择 | 在效率和安全之间做更清楚的选择。 |
| 插件和 Skills | 让 Codex 使用工具，并按固定流程工作。 |
| 自动化任务 | 让 Codex 定时替你完成重复工作。 |
| 实战项目流程 | 从立规矩、写需求、计划执行、纠偏迭代，到最后部署上线。 |
下一步：找一个你真正想做的小项目，从一个空文件夹开始，按这篇教程的顺序走一遍。你会发现，只要需求说清楚、规则立明白、过程勤检查，Codex 能帮你完成的事情会比想象中多很多。