最近我在研究 Codex，发现很多知识工作者卡在“听过但不会用”这一步。Codex 是 OpenAI 推出的 AI Agent，默认模型是 ChatGPT，它能理解自然语言，也能直接操作文件、跑命令。这篇教程从安装开始，把界面、项目、提示词、更新和分支都讲清楚。我按原教程重走了一遍关键操作，把每一步的细节和坑都标出来，适合零基础。
00 先分清 AI、大模型和 Agent
在碰 Codex 之前，有三个概念容易混：AI（人工智能）是大范围概念；LLM（大模型）提供理解、生成和推理能力；Agent（智能体）以模型为核心，结合工具和运行机制，执行具体任务。
你可以把模型理解为“大脑”，把工具理解为“手”。Agent 收到要求后，调用工具、查看结果、再决定下一步。比如你让它修改网页标题，它能找到对应文件、改代码、运行检查；如果报错，就根据报错继续调整。这些操作不需要你每一步手动接力。
支撑这个过程的运行系统通常叫 Harness，负责连接模型与工具、传递执行反馈、管理上下文和权限。Codex 就是这样一个 Agent 产品，以编程任务为核心，也能借助工具处理其他工作。
使用它时，你既可以提问，也可以让它实际操作文件、执行任务，再由你检查结果。
01 Codex 可以做什么
你可以用自然语言给 Codex 分配任务。根据任务目标，它会通过阅读项目、修改文件、运行命令等操作来确保任务完成。
几个典型场景：
-
解释一段代码； -
修改网页上的文字； -
查找程序为什么报错； -
把多份 Excel 销售报告整理成一个可交互的数据看板，或整合到一张大表里。
只要在电脑上能完成的操作，Codex 大多可以替你完成。但要注意，它不是万能：指令模糊时容易跑偏，复杂任务需要你检查中间结果。
02 安装和登录
直接去 OpenAI 官网下载 Codex，注意域名一定是 openai.com 开头，别下到山寨版本。
使用前需要登录 ChatGPT 账号，也可以配置 API 访问，但本篇只演示登录账号的方式。按提示登录后，就进入 Codex 界面。初次看到界面不用慌，下面拆开讲。
03 认识界面：三个区域
Codex 界面可以分成三块：
- 项目区
：进行项目管理； - 对话区
：发出要求，同时指定工作空间、权限等； - 预览区
：预览生成的文件、网站等内容。
对话区里的关键设置
项目：Codex 要求你指定一个项目，其实就是电脑上的一个文件夹。你可以手动创建文件夹然后添加为工作目录，也可以直接设置项目名称让 Codex 帮你创建。一个项目对应一个文件夹，Codex 可以读取里面的文件，也能在里面创建新文件。
工作位置：对话区右边有“此计算机”按钮，指定项目的工作环境。默认是本地，也有云端环境（OpenAI 提供），本篇不涉及云端，先用本地。
选择模型：对话框右下角可以选择不同模型，还有一个滚动条切换思考强度。思考强度越高，模型考虑越全面，但 Token 消耗更多、执行时间更长。左上角闪电标志打开后触发 1.5 倍速度，但 Token 消耗会非常多。Codex 默认还提供语音输入，很实用。
添加功能：左下角 + 号可以添加文件和文件夹、读取当前打开的网页、启动“目标”或“计划”模式。
-
添加文件/文件夹：Codex 会在回答前读取参考文件信息。处理一堆 Excel 时可以直接拖进对话框，它也会默认读取项目文件夹下的文件。 -
附加：读取当前打开的网页，方便讨论网页操作。 -
目标（/goal）：针对长任务的模式。提示词特别复杂、预估时间特别长时使用，Codex 会先分析目标、拆分任务、制定计划，提高运行效率。 -
计划模式（/plan）：只做计划，不修改任何内容。规划任务时打开，满意后再进行下一步。
插件也会显示在这里，比如 GitHub 相关操作。
权限：对话框里可以设置权限，有三种模式：
- 请求批准
：Codex 在联网或编辑文件时询问你。 - 帮我批准
：Codex 自动审批哪些操作需要申请、哪些直接执行。 - 完全访问权限
：Codex 不受限制。
建议：任务和项目不涉及敏感数据、且你确信编辑删除操作不会影响你时，可以打开完全访问权限；否则不要选择这个模式。
项目区
点开左边的 🏠 可以管理所有项目。一个项目可以有多个会话，每个会话共享同一个工作区域，但上下文独立，不会看到彼此的全部聊天记录。上下文就是 AI 回答你时能参考的信息。
从上往下依次是空间（管理所有文件）、定时任务（比如每天 11:00 帮你搜集 AI 选题）、自定义（管理插件和 Skill）。这些本篇先不展开。
预览区
点开右上角加号，会打开一个类似浏览器的界面。你可以在这里打开文件、访问终端，或者像浏览器一样直接访问网页。如果项目里已经有文件输出，右上角会总结输出内容。
比如预览生成的图片，右下角有对话框，不满意可以继续要求修改。
04 创建第一个项目
如果只是简单对话，可以在左上角切换为 ChatGPT 模式，不需要创建项目。但如果接下来要围绕同一批文件反复工作，就要选择 Codex 进行项目管理。
流程：创建本地文件夹 → 添加到 Codex 中 → 信任文件夹 → 开始和 Codex 对话。
这里添加本地的 Codex 练习文件夹，然后创建项目。信任文件夹就是给 Codex 操作权限。为了确认工作目录，可以发送一个简单问题：
这次对话的工作目录在哪里？请列出该目录中的文件。先不要修改任何内容。
一个简单演示：手里有多份销售报告需要汇总并在周会上报告，可以让 Codex 做这个任务。它能读取这些 Excel，生成一个数据看板。通过这个例子可以看到 Codex 如何帮我们完成日常工作。市面上其他 Agent 也可以用同样方法调用。
后续还可以用 Codex 做个人网站、制作并上架第一款 App，这些会在后续教程里展开。
05 如何向 Codex 提要求
现在 Codex 已经很聪明，不需要复杂提示词，但你要尽量说清楚：要处理什么、希望怎么改、哪些地方有要求。
单说“帮我优化一下”，Codex 很难知道你想优化什么。可以换成：
请阅读“介绍.md”，把其中比较生硬的句子改得自然一点。保留原有事实和数字，不增加新的经历。修改结果另存为“介绍-修改版.md”。
如果还没想好怎么改，可以先讨论：
我觉得这段介绍不够清楚，但还没想好怎么改。你先指出难理解的地方，给我两个修改方向，暂时不要改文件。
不必第一次就把所有细节想清楚。可以先得到一个小范围的结果，再继续补充要求。
06 怎么让它看到文件和截图
需要 Codex 参考文件时，可以直接说：
阅读当前项目里的“介绍.md”，先概括它的内容。
Codex 有多模态能力，可以读取你上传的图片或视频。比如：
请看这张截图，底部按钮的文字显示不完整。先分析可能原因，不要修改其他页面。
你可以把文件和截图放在项目文件夹里，也可以直接拖到对话框中。
07 如何更新要求
发现自己指令有错误或想更新时，直接在对话框输入新要求。如果 Codex 已经处于执行状态，对话框上方会出现一个引导按钮。点击引导按钮，就可以立即插入新的指令。
例如，最开始要整理一个 Markdown 文件，后来希望变成 PDF。点击引导按钮，Codex 接收最新指令，生成 PDF。
发出消息后，先观察它是在解释问题、执行操作，还是等待你补充信息，再决定下一步。
08 分支功能
AI 回答的对话下方有一个分支按钮。点击分支会在项目中开启一个新会话，同时保留截至分支位置的对话记录。
分支很适合这些场景：
- 比较不同方案
：已经讨论好文章主题，原对话尝试“新手教程”，分支里尝试“个人经验分享”，最后比较哪个更合适。 - 把相关工作拆开
：课程大纲确定后，分出一个对话写公众号文章，另一个做视频脚本，都能接上之前的讨论。 - 深入研究一个问题
：写教程时想详细研究 Harness，可以分支出去讨论，让原对话继续围绕教程展开。
总结
到这里，你掌握了 Codex 的基础用法：安装、认识界面、开启第一个项目、提要求、处理文件和截图、更新要求、使用分支。
这是教程系列的第一篇。接下来会分享更多 AI 进阶用法：制作个人网页、设计工作流、控制浏览器、让 Agent 进行网页操作。