0. Codex App 到底是什么
一句话：Codex App 是一个把 AI Agent 放进你电脑里的工作台。它不是普通“你问一句、它答一句”的聊天框，更像一个能读文件、看网页、生成产物、调用工具的电脑助理。
普通用户可以先把它理解成：一个更偏“做事”的 ChatGPT。它不只回答“怎么做”，很多时候可以直接帮你做一遍。
- 和你聊天、解释概念、写文案。
- 读取你指定的本地文件和项目。
- 搜索网页、打开内置浏览器、查看来源。
- 生成图片、文档、PPT、网页、代码等结果。
- 通过插件连接 Gmail、GitHub、Google Drive、Slack 等外部工具。
- 设置自动化，定期检查、总结或继续任务。
1. 安装与登录
Mac 用户建议只从 OpenAI 官方入口下载 Codex App。安装方式和普通 Mac App 差不多：
- 下载 Codex App。
- 打开安装包。
- 把 Codex 拖进“应用程序”。
- 从启动台或应用程序打开 Codex。
- 用你的 ChatGPT / OpenAI 账号登录。
2. ChatGPT、Codex App、云端 Codex 的区别
| 名字 | 大白话解释 | 适合做什么 |
|---|---|---|
| ChatGPT | 网页或 App 里的普通助手。 | 问问题、写文案、解释概念、生成文件、生成图片。 |
| Codex App | 装在你电脑上的 AI 工作台。 | 普通 ChatGPT 能做的基本都能做，最大区别是更容易读取本地文件、处理项目、调用本机能力。 |
| 云端 Codex | 在 OpenAI 云端环境里跑的 AI Agent。 | 适合电脑关机后仍要继续跑的任务，或者不依赖你本地电脑环境的远程执行。 |
小白先记住一个判断标准：
- 一般任务：用普通对话。
- 处理本地文件或项目：用 Codex App 里的项目。
- 远程持续跑任务：用云端 Codex。
3. 三栏界面怎么读
第一次打开会懵，不是你的问题，是它确实像一个“超级工作台”。先按三块理解：
| 区域 | 它是干什么的 | 小白最常用动作 |
|---|---|---|
| 左边导航栏 | 找入口、找项目、找对话。 | 新对话、切换对话、连接插件、设置自动化。 |
| 中间对话区 | 你和 Codex 真正交流的地方。 | 输入需求，让 Codex 开始工作。 |
| 右边结果区 | 展示证据、产物、预览和变化。 | 看来源、网页/图片/PDF 预览、代码差异、Git 变化。 |
4. 左侧导航：每个入口管什么
5. 插件、Connector、Skill、MCP 怎么理解
插件本质上是给 Codex 装能力包。常见例子：
- Browser Use：让 Codex 操作内置浏览器。
- Computer Use：让 Codex 操作 Mac 上的 App。
- Spreadsheets / Presentations：处理表格和演示文稿。
- GitHub：让 Codex 和 GitHub 工作流配合。
- Gmail / Google Drive / Slack：连接外部账号。
| 名词 | 大白话解释 | 例子 |
|---|---|---|
| Plugin 插件 | 给 Codex 装一个能力包。 | 装了表格插件，它就更会处理表格。 |
| Connector 连接器 | 连接外部账号或服务。 | 连接 Gmail、GitHub、Google Drive。 |
| Skill 技能 | 一套固定工作流说明书。 | “写教程时按我的风格来写”。 |
| MCP | 让外部工具接入 Codex 的通道。 | 让 Codex 调用某个本地服务或工具。 |
6. 自动化：让 Codex 定时做事
自动化就是让 Codex 在某个时间点，或按某个频率，自动执行你提前设置好的任务。
- 每天早上整理某个项目状态。
- 每周检查一次某个仓库有没有问题。
- 半小时后继续当前线程。
- 定期监控网页、邮箱、任务列表。
- 定时生成日报、周报、复盘。
7. 设置页：哪些该看，哪些先别动
7.1 常规
常规管 App 的基础使用习惯：工作模式、默认权限、自动审核、完全访问权限、默认打开目标、语言、菜单栏、运行时防休眠、长文本发送快捷键。
- 工作模式：非程序员优先选更偏日常工作的模式。
- 权限：权限越大，能做的事越多，风险也越大。新手别一上来就最大权限。
- 发送方式：建议长文本用 Command + Enter 发送，避免误触。
- 语音输入：可作为全局输入入口，不习惯就不必开。
7.2 外观
外观只影响你看得舒不舒服：主题、字体、颜色、代码展示、差异对比、字号、界面密度。基本不影响 Codex 能不能完成任务。
7.3 个性化
个性化决定 Codex 如何理解你的偏好。可以写中文偏好、术语偏好、教程格式、安全提醒等。
请默认用中文回答。
如果涉及代码，请先用大白话解释目的，再给具体操作。
如果要修改文件、运行命令、访问外部账号，请明确告诉我风险。
教程类内容请写成小白能照着做的步骤，并标注成功标志。
7.4 MCP、Git、浏览器、电脑操控
- MCP：让 Codex 连接外部工具的通道。新手一般不用手动添加。
- Git：项目的版本记录系统，像时间机器。新手先保持默认。
- 浏览器使用：让 Codex 打开网页、搜索资料、测试页面、截图。
- 电脑操控：让 Codex 操作 Mac App，很强，但风险也最高。
8. 普通对话 vs 项目对话
刚开始用 Codex，不建议直接让它改真实项目。先开启普通对话，问低风险问题，比如：
用小白能听懂的话，解释一下 Codex App 和 ChatGPT 的区别。复杂任务建议先开计划模式，让它先把思路梳理清楚，再开始执行。
| 模式 | 适合场景 | 风险 |
|---|---|---|
| 普通对话 | 概念解释、文案、学习、头脑风暴。 | 低。通常不碰本地文件。 |
| 项目对话 | 读取文件夹、修改文件、运行命令、处理代码仓库。 | 中到高。必须看清项目路径和权限。 |
9. 权限与安全：看不懂就让它解释
| 权限类型 | 意味着什么 | 小白怎么判断 |
|---|---|---|
| 文件访问 | Codex 要读或改某个文件夹。 | 看清楚路径是不是你允许的项目。 |
| 终端命令 | Codex 要在电脑上运行命令。 | 不懂就先让它解释命令目的和影响。 |
| 浏览器 | Codex 要打开或操作网页。 | 避免付款、删除、发布类操作。 |
| 第三方账号 | Codex 要连接 Gmail、GitHub 等。 | 看清授权范围。 |
| 电脑操控 | Codex 要操作 Mac App。 | 边界必须说清楚。 |
小白最容易犯的错：看到确认按钮就点。不要这样。看不懂时直接问：
这个权限具体会让你做什么？有什么风险？我是小白，应该允许吗？10. 常见卡点与处理方式
10.1 Codex 一直在跑，不知道是不是卡了
先看左侧对话状态：如果转圈，说明任务还没结束；如果是蓝色的不动点，通常代表任务已经结束。
10.2 它请求权限，我不知道能不能点
不要直接点，让它解释：
这个权限会让你访问什么？为什么这个任务需要它？有没有更低风险的做法？10.3 它改了项目，我看不懂
让它解释 Git diff：
请按文件逐个解释这次改动，用非程序员能懂的话说。10.4 生成结果不满意
不要重开，基于当前结果继续改：
保留现在的结构，但把语言改得更口语化，并补充每一步的成功标志。10.5 插件太多，不知道装哪个
先别装，先用官方内置能力。等你明确要连接哪个工具，再去插件页找。
10.6 自动化跑偏
把任务描述精细化：什么时候执行、执行对象、输出什么、不要做什么、遇到问题怎么处理。
11. 小白第一次上手顺序
来源说明
本文根据 X 用户逸尘发布的《Codex App 从0到1完整入门教程》整理重排，做了文档化分类、结构化目录和风险提示强化，便于在 docs.lsidestudio.com 阅读使用。