Codex App 从0到1：给小白的超级工作台入门教材

0. 先说结论

Codex App 不是一个“更会聊天的聊天框”。

更准确地说，它是一个把 AI Agent 放进你电脑里的工作台。

普通 ChatGPT 更像“你问，它答”。Codex App 更像“你说目标，它看资料、调用工具、生成文件、检查结果，然后把过程展示给你看”。

图注：这张 imagegen 语义图把 Codex App 拆成四件事：对话、文件、工具、产物。小白先记住这个模型就够了。

这节课你要学会三件事：

1. 看懂 Codex App 的界面。
2. 知道普通对话、项目、插件、自动化、MCP、Git 是什么。
3. 学会用低风险路线第一次上手。

1. Codex App 到底是什么

可以先把它理解成：

一个更偏“做事”的 ChatGPT。

它能做的事情包括：

• 和你聊天，解释概念，写文章。
• 读取你允许它读取的本地文件。
• 搜索公开网页。
• 打开内置浏览器，查看网页和本地页面。
• 生成图片、文档、PPT、网页、代码。
• 通过插件连接 Gmail、GitHub、Google Drive、Slack 等工具。
• 设置自动化任务，让它稍后或定期继续工作。

真正重要的不是“它有多少功能”，而是你要知道它什么时候在本地电脑做事，什么时候在云端做事，什么时候只是普通聊天。

给医护同学的类比

你可以把 Codex App 想成一个“AI 版工作站”。

就像麻醉监护仪不是只显示一个数字，而是把心率、血压、血氧、呼吸、趋势都放在同一个工作界面里。Codex App 也不是只给你一句回答，它会把对话、文件、来源、预览、代码变化、结果都放在一个工作现场里。

2. 第一次打开：先看三块区域

原帖强调，第一次打开 Codex App，最容易懵的原因不是它难，而是入口太多。

你先不用细看每个按钮，只看三块：

图注：原帖中的整体界面图。先看布局，不要急着研究每个小按钮。

一句话记忆：

左边找入口，中间说需求，右边看结果。

图注：原帖用插件页说明整体布局。很多时候右侧区域会根据任务出现预览、来源或文件变化。

3. 下载和登录：只从官方入口开始

Mac 用户建议从 OpenAI 官方入口下载：

https://openai.com/codex/

基础安装路线：

1. 下载 Codex App。
2. 打开安装包。
3. 把 Codex 拖进“应用程序”。
4. 从启动台或应用程序打开。
5. 使用 ChatGPT 或 OpenAI 账号登录。

4. 三个容易混淆的东西：ChatGPT、Codex App、云端 Codex

很多人卡在这里，是因为名字太像。

小白判断标准：

• 普通问答，用 ChatGPT 或 Codex 普通对话。
• 要处理本地文件或项目，用 Codex App 里的项目。
• 要让任务在远程持续运行，用云端 Codex。

5. 左侧导航栏：从这里进入不同工作流

左侧导航栏就是 Codex 的入口区。

图注：原帖中的左侧导航栏截图。它负责把不同类型的工作分开。

常见入口可以这样理解：

6. 搜索：找回你之前做过的事

搜索不是网页搜索，而是找回你在 Codex 里做过的东西。

图注：原帖中的搜索浮层截图。它适合找历史对话、项目任务和上下文。

它能帮你找：

• 历史对话。
• 之前跑过的项目任务。
• 忘记名字的上下文。
• 曾经让 Codex 生成过的东西。

课堂小练习：

1. 新建一个普通对话，问一个简单问题。
2. 退出这个对话。
3. 用搜索找回它。

成功标志：你能用关键词找到刚才那次对话。

7. 插件、连接器、Skill、MCP：不要被名词吓到

原帖把这些词放在一起讲，原因很简单：小白第一次看到会觉得很技术。

先看插件页：

图注：原帖中的插件页。插件就是给 Codex 装能力包。

几个词翻译成人话：

小白先记一句：

插件是能力包，连接器是接账号，Skill 是工作流说明书，MCP 是接工具的通道。

刚开始不要急着装很多插件。等你明确知道“我要让 Codex 连接哪个工具”，再去找对应插件。

8. 自动化：让 Codex 稍后或定期帮你做事

自动化就是提前写好一个任务，让 Codex 在某个时间点或按固定频率执行。

图注：原帖中的自动化页面。它适合“定时检查”“稍后继续”“定期总结”这类任务。

常见场景：

• 每天早上整理某个项目状态。
• 每周检查一个仓库有没有新问题。
• 半小时后继续当前线程。
• 定期监控某个网页、邮箱或任务列表。
• 自动生成日报、周报、复盘。

9. 右侧结果区：Codex 交作业的地方

右侧结果区会随着任务变化。

图注：原帖中的右侧区域截图。这里会展示产物、来源、预览或改动。

它可能显示：

• 生成出来的文件。
• 搜索来源。
• 网页预览。
• 图片预览。
• PDF 或文档预览。
• 内置浏览器。
• 代码差异。
• Git 变化。

你可以把右侧理解成：

Codex 交作业的地方。

中间对话告诉你“它做了什么”，右边结果区让你检查“它做出来了什么”。

10. 设置页：小白不必全改，但要知道管什么

设置页看起来复杂，但不用每个都改。

先记原则：

第一次使用，先看懂，不急着改。

10.1 常规设置

图注：原帖中的常规设置页。这里影响 App 的基础使用习惯。

常规设置常见内容：

• 工作模式。
• 默认权限。
• 自动审核。
• 完全访问权限。
• 默认打开目标。
• 语言。
• 菜单栏显示。
• 防止系统休眠。
• 长文本发送快捷键。

小白最要关注四件事：

1. 工作模式：非程序员优先选更偏日常工作的模式。
2. 权限：权限越大，能力越强，风险也越高。
3. 发送方式：长文本是否需要 Command + Enter 发送，避免误触。
4. 语音输入：看自己是否需要全局语音输入。

图注：原帖中的语音输入相关设置。适合喜欢口述需求的人。

10.2 外观设置

图注：原帖中的外观设置页。它影响看界面的舒适度，不直接决定任务能力。

外观通常管：

• 主题。
• 字体。
• 颜色。
• 代码展示样式。
• 差异对比样式。
• 字号或界面密度。

图注：原帖中的外观相关示例。外观设置可以后面慢慢调，不是第一天必须完成的事。

10.3 配置设置

图注：原帖中的配置设置页。新手阶段一般保持默认即可。

这类设置通常更偏技术。刚开始先别乱改。

10.4 个性化设置

图注：原帖中的个性化设置页。这里可以告诉 Codex 你希望它怎么回答。

个性化适合写：

• 我更喜欢中文回答。
• 我不是程序员，请少用术语。
• 给我教程时要写成功标志和排查步骤。
• 修改代码前先解释影响。
• 涉及隐私文件时先提醒我。

可以复制这个模板：

复制请默认用中文回答。
如果涉及代码，请先用大白话解释目的，再给具体操作。
如果要修改文件、运行命令、访问外部账号，请明确告诉我风险。
教程类内容请写成小白能照着做的步骤，并标注成功标志。

不要写：

• API Key。
• 密码。
• Cookie。
• 身份证、银行卡、公司机密。
• 互相矛盾的规则。

11. MCP、Git、浏览器、电脑操控：这些是高级能力

这些功能很强，但新手不需要第一天就全会。

11.1 MCP

图注：原帖中的 MCP 设置页。MCP 可以理解为让外部工具接入 Codex 的通道。

MCP 对小白来说可以先这样理解：

让 Codex 能连接更多工具的一条通道。

刚开始，如果内置插件已经够用，就不需要手动添加 MCP。

11.2 Git

图注：原帖中的 Git 设置页。Git 是代码世界里的版本记录系统。

如果你不是程序员，先把 Git 理解成：

项目的时间机器，记录每次改了什么。

你需要知道的不是所有 Git 命令，而是这几件事：

• 它改了哪些文件。
• 哪些是新增。
• 哪些是删除。
• 能不能回退。
• 要不要提交。

11.3 环境和工作树

图注：原帖中的环境和工作树相关设置。新手阶段保持默认即可。

这些设置更偏工程开发。非程序员第一次使用，先不要把重点放在这里。

11.4 浏览器使用和电脑操控

图注：原帖中的浏览器使用和电脑操控相关设置。这是很强也很需要边界感的能力。

浏览器使用可以让 Codex：

• 打开网页。
• 搜索资料。
• 登录某些网站。
• 查看本地网页。
• 测试前端页面。
• 截图或检查页面效果。

电脑操控可以让 Codex 操作 Mac 上的应用，比如点击按钮、读取界面、完成可视化流程。

但它可能碰到微信、邮箱、浏览器、文件管理器、付费软件、公司工具和私人资料。

所以新手第一次用电脑操控，建议只让它操作无风险 App，并把边界说清楚。

12. 已归档对话：不是删除，是收起来

图注：原帖中的已归档对话页。归档更像把旧对话收起来，不等于删除。

适合归档的内容：

• 已经完成的任务。
• 暂时不用的项目对话。
• 不想占用左侧列表的旧记录。
• 需要保留但不常看的过程。

13. 权限确认：这节课最重要的安全点

Codex App 能做事，所以权限一定要看懂。

图注：这张 imagegen 语义图把权限从低到高排成阶梯。越往右越需要确认。

权限可以这样理解：

看到权限确认时，不要机械地点“允许”。

看不懂就问：

复制这个权限具体会让你做什么？
有什么风险？
我是小白，应该允许吗？

更谨慎一点可以问：

复制这个权限会让你访问什么？
为什么这个任务需要它？
有没有更低风险的做法？

14. 第一次上手路线：按低风险顺序来

不要第一天就让 Codex 改你的真实项目。

更稳的路线是：

图注：这张 imagegen 语义图展示了推荐上手顺序：先打开，再普通对话，再看设置，再做演示项目。

推荐顺序：

1. 打开 App，先熟悉左侧导航。
2. 新建一个普通对话，问一个低风险问题。
3. 打开设置页，只看不改。
4. 建一个干净演示项目，不要用私人项目。
5. 让 Codex 读取项目，并生成一个简单 Markdown。
6. 看右侧结果区。
7. 让它解释它做了什么。
8. 再尝试插件页和自动化页。
9. 最后再碰 Git、MCP、电脑操控这些高级功能。

建议你第一次输入这个：

复制用小白能听懂的话，解释一下 Codex App 和 ChatGPT 的区别。

成功标志：

• Codex 能用中文解释。
• 你能继续追问。
• 你能看懂它的回答。

15. 常见踩坑和排查

15.1 Codex 一直在跑，不知道是不是卡了

先看任务状态。

如果还在转圈，通常说明任务没结束。

如果已经停止，就可以让它总结当前结果。

15.2 它请求权限，我不知道能不能点

不要直接点。

先问：

复制这个权限会让你访问什么？为什么这个任务需要它？有没有更低风险的做法？

15.3 它改了项目，我看不懂

让它解释 Git diff：

复制请按文件逐个解释这次改动，用非程序员能懂的话说。

15.4 生成结果不满意

不要马上重开。

基于当前结果继续改：

复制保留现在的结构，但把语言改得更口语化，并补充每一步的成功标志。

15.5 插件太多，不知道装哪个

先别装。

先用官方内置能力。等你明确知道“我要让 Codex 连接某个工具”，再去插件页找。

15.6 自动化跑偏

通常是任务描述太泛。

把自动化写清楚：

• 什么时候执行。
• 执行对象是什么。
• 输出什么。
• 不要做什么。
• 遇到问题怎么处理。

16. 课堂练习

练习 1：普通对话

任务：

复制请用医护人员能听懂的方式，解释 Codex App 和普通 ChatGPT 的区别。

成功标志：

• 回答没有太多专业术语。
• 能讲清楚“聊天”和“做事”的区别。

练习 2：低风险文件任务

准备一个空文件夹，里面放一个 test.md。

让 Codex 做：

复制请读取这个文件夹，只总结里面有哪些文件，不要修改任何文件。

成功标志：

• 它只读文件。
• 它没有改文件。
• 它能说明读到了什么。

练习 3：权限解释

当 Codex 请求权限时，先不要点。

输入：

复制请解释这个权限的作用、风险，以及是否有更低风险的替代方案。

成功标志：

• 你能听懂它为什么需要权限。
• 你能判断是否继续。

17. 一页复习卡

18. 给讲课时的串讲稿

你可以这样开场：

很多人第一次打开 Codex App，会觉得“这界面怎么这么多东西”。这很正常。因为它不是一个单纯聊天框，而是一个 AI 工作台。我们今天不追求把所有按钮记住，只记住一件事：左边找入口，中间说需求，右边看结果。

讲到权限时，可以这样提醒：

Codex App 最大的魅力，是它能真的帮你做事。最大风险也来自这里。它能读文件、运行命令、操作浏览器和电脑，所以你要养成一个习惯：看不懂权限，就让它先解释。不要为了图快直接点确认。

结尾可以这样收束：

第一节课不要追求高级玩法。你只要完成三个动作：普通对话、看懂设置、做一个干净演示项目，就已经入门了。等你知道它在做什么，再逐步尝试插件、自动化、MCP、Git 和电脑操控。