Codex App 从 0 到 1 完整入门教程：第一次打开也别慌，照着这篇把界面、设置、项目和自动化跑明白
本文基于 Mac 版 Codex App 实测整理。
本机截图版本：Codex 26.429.30905。
Codex App 更新很快，你看到的按钮名称和位置可能会有一点变化，但核心逻辑基本一样。
最近我发现，很多人第一次打开 Codex App 的反应不是“哇，好强”，而是：
这玩意儿到底从哪开始？
左边一堆入口，中间是聊天，右边又会弹出网页、图片、文档、来源、代码变化。设置里还有一堆看起来很技术的东西。
作为小白，最容易卡的不是“AI 不会用”，而是：
我不知道自己现在在什么地方。
所以这篇文章不写成官方说明书。
我会按一个普通人的使用路线来讲：
- Codex App 到底是什么。
- 本地 App、云端 Codex、普通 ChatGPT 的区别。
- 打开 App 后，左边、中间、右边分别是干什么的。
- 设置页每个目录到底管什么。
- 普通对话和项目对话有什么区别。
- 插件、技能、MCP、自动化、Git 这些词怎么理解。
- 哪些地方小白最容易点错。
读完以后，你不一定立刻变成程序员。
但至少你会知道：
- 哪些入口是给普通人用的。
- 哪些入口是给写代码的人用的。
- 哪些权限要谨慎点。
- 哪些结果算成功。
- Codex 到底适合拿来干什么。
不用纠结术语，照着看就行。
一、Codex App 到底是什么
一句话：
Codex App 是一个把 AI Agent 放进你电脑里的工作台。
说白了，它不只是一个聊天框。
普通聊天框更像你问一句，它答一句。
Codex App 更像你找了一个助理，它可以：
- 和你聊天。
- 读你指定的项目文件。
- 搜索网页。
- 打开内置浏览器。
- 生成图片、文档、网页、代码等结果。
- 在项目里修改文件。
- 跑命令、看报错、改代码。
- 用插件连接 Gmail、GitHub、Google Drive、Slack 等外部工具。
- 设置自动化，定期帮你检查、总结或继续任务。
如果你是非程序员，可以先把它理解成：
一个更偏“做事”的 ChatGPT。
它不是只回答“怎么做”，而是很多时候可以直接帮你“做一遍”。
但也正因为它能做事，所以你必须理解它的界面和权限。不然你会不知道它到底是在本地电脑上做事，还是在云端任务里做事，也不知道它什么时候会碰到你的文件。
先看一张打开后的整体界面。
这张图先不用看细节。
你只要记住：左边是入口，中间是你和 Codex 对话的地方，右边有时会出现结果、来源、预览和代码变化。
这就是 Codex App 和普通聊天框最大的差别：
它不是只有“问答”，它还有“工作现场”。
二、下载、登录和第一次打开
Mac 用户建议只从 OpenAI 官方入口下载 Codex App。
不要从网盘、论坛、别人发你的安装包里下载。
原因很简单：
Codex App 会接触你的项目、文件、浏览器、第三方账号连接。它不是一个普通小工具，来源一定要干净。
安装方式和普通 Mac App 差不多：
- 下载 Codex App。
- 打开安装包。
- 把 Codex 拖进“应用程序”。
- 从启动台或应用程序里打开 Codex。
- 用你的 ChatGPT / OpenAI 账号登录。
成功标志：
- 你能在 Mac 的“应用程序”里看到
Codex.app。 - 打开后不再卡在登录页。
- 左侧能看到“新对话、搜索、插件、自动化”等入口。
- 中间能输入任务。
小白这里最容易忽略一个事：
截图不要把邮箱、头像、API Key、Token、私人项目路径截进去。
你后面如果要把 Codex 使用过程做成教程，先养成一个习惯：
能截干净界面，就截干净界面；截不到，就打码。
三、本地 Codex App、云端 Codex、普通 ChatGPT 有什么区别
这一步必须先讲，不然后面一定乱。
很多人会把三个东西混在一起：
| 名字 | 大白话解释 | 适合做什么 |
|---|---|---|
| ChatGPT 普通对话 | 一个网页或 App 里的聊天助手 | 问问题、写文案、解释概念 |
| Codex App 本地版 | 装在你电脑上的 AI 工作台 | 读本地项目、生成文件、看结果、跑本地任务 |
| 云端 Codex | 在云端环境里跑的 AI Agent | 长任务、代码任务、远程环境、和 GitHub 项目协作 |
说白了：
ChatGPT 像“顾问”。
Codex App 像“工作台”。
云端 Codex 像“远程打工人”。
本地 Codex App 的好处是，它离你的电脑最近。它可以看到你允许它访问的本地项目，可以在本机跑命令，可以展示本地生成的图片、网页、PDF、代码差异。
云端 Codex 的好处是，它可以把任务放到远程环境里跑。你可以让它处理一个项目，稍后回来查看结果。某些任务不需要一直占着你的本机窗口。
小白先记住一个判断标准就够了：
- 只是问问题：用普通对话。
- 要处理本地文件或项目：用 Codex App 里的项目。
- 要让 Codex 在远程环境里持续跑任务：用云端 Codex。
你能说清楚一句话，就算过关：
我现在是在聊天，还是在让 Codex 操作一个项目？
只要能分清这个，后面就不会乱。
四、主界面地图：左边、中间、右边
第一次打开 Codex App，不要急着点。
先把它当成一张地图。
整个界面大致可以分成四块：
| 区域 | 它是干什么的 | 小白最常用的动作 |
|---|---|---|
| 左边导航栏 | 找入口、找项目、找历史对话 | 新对话、搜索、打开项目、看插件和自动化 |
| 中间对话区 | 你和 Codex 真正交流的地方 | 输入需求、看过程、确认权限 |
| 右边结果区 | 展示证据和产物 | 看来源、预览网页/图片/PDF、看代码变化 |
| 底部状态区 | 显示当前环境和任务状态 | 判断任务是否还在跑、是否需要你确认 |
下面这张图是插件页，但它很适合看 Codex 的整体布局：左边是导航，中间是主要内容，右边这次没有打开额外预览。
你以后看到任何页面，都可以按这个方式拆：
- 我现在在哪个入口？
- 中间这块让我做什么？
- 右边有没有打开结果或预览？
- 底部有没有权限、模型、停止按钮、运行状态？
这个习惯比背按钮名字重要。
五、左侧导航栏：你从这里进入不同工作流
左边是 Codex 的入口区。
常见入口包括：
| 入口 | 大白话解释 | 什么时候点 |
|---|---|---|
| 新对话 | 开一个新的聊天任务 | 不想污染旧上下文时 |
| 搜索 | 找历史对话、命令或文件 | 忘了之前聊过什么时 |
| 插件 | 给 Codex 增加外部能力 | 想连接 Gmail、GitHub、Drive、Slack 等工具时 |
| 自动化 | 让 Codex 定期或稍后执行任务 | 想每天总结、定期检查、过一会儿继续时 |
| 项目 | 让 Codex 针对某个文件夹或代码仓库工作 | 需要它读文件、改文件、跑命令时 |
| 普通对话 | 不绑定项目的聊天 | 问概念、写内容、整理思路时 |
先看一个新对话界面。
这里中间会问你：
要在某个项目中构建什么？
这句话很重要。
它说明 Codex 不只是问答，它默认希望你把任务放进一个“场地”里。
如果你只是想问一个概念，可以直接输入。
如果你想让它处理某个文件夹，最好先选项目。
普通对话和项目对话的区别
这里最容易误会。
普通对话更像 ChatGPT。
项目对话才像“请你进入这个文件夹，帮我做事”。
如果你只是问：
Codex App 是什么？
普通对话就够了。
如果你问：
帮我把这个教程整理成 Markdown 文件，并保存到这个项目里。
那就应该进入项目。
大白话版区别：
| 类型 | 能不能读项目文件 | 能不能改文件 | 能不能跑命令 | 适合谁 |
|---|---|---|---|---|
| 普通对话 | 通常不读 | 不改 | 通常不跑 | 写文案、问问题、整理思路 |
| 项目对话 | 可以 | 可以 | 可以 | 改代码、整理文件、生成项目产物 |
小白建议：
刚开始不要一上来就把私人项目丢进去。
先建一个干净演示文件夹，里面放一两个无隐私文件，让 Codex 练手。
六、搜索：找回你之前做过的事
点左侧“搜索”，会弹出一个搜索浮层。
它的作用很简单：
- 找历史对话。
- 找之前跑过的项目任务。
- 找你忘记名字的上下文。
如果你经常用 Codex，搜索会非常重要。
因为 Codex 不是普通聊天记录，它可能包含：
- 某次项目改动。
- 某个自动化设置。
- 某次网页调研。
- 某个生成结果。
- 某次报错排查过程。
小白怎么用：
你不需要记完整标题。
只要记得关键词，比如：
教程Git报错自动化截图某个项目名
就可以搜。
注意：
搜索结果里可能出现你的私人路径、项目名、对话内容。公开截图时一定要打码。
七、插件：给 Codex 装能力包
点左侧“插件”，会进入插件页。
这一页小白最容易看懵。
其实你可以这样理解：
插件就是给 Codex 装能力包。
比如：
- Browser Use：让 Codex 操作内置浏览器。
- Computer Use：让 Codex 操作 Mac 上的 App。
- Spreadsheets：让 Codex 处理表格。
- Presentations：让 Codex 做演示文稿。
- GitHub：让 Codex 和 GitHub 工作流配合。
- Gmail / Google Drive / Slack 这类：让 Codex 连接外部账号。
这里顺便把几个词讲清楚。
| 名词 | 大白话解释 | 例子 |
|---|---|---|
| Plugin 插件 | 给 Codex 装一个能力包 | 装了表格插件，它就更会处理表格 |
| Connector 连接器 | 连接外部账号或服务 | 连接 Gmail、GitHub、Google Drive |
| Skill 技能 | 一套固定工作流说明书 | “写教程时按我的风格来写” |
| MCP | 一种让外部工具接入 Codex 的方式 | 让 Codex 调用某个本地服务或工具 |
小白不用纠结 MCP 协议细节。
你只需要知道：
插件是能力包，连接器是接账号，技能是工作流说明书，MCP 是接工具的通道。
什么时候需要插件？
- 你想让 Codex 读 Gmail。
- 你想让 Codex 操作浏览器。
- 你想让 Codex 做 PPT、表格、文档。
- 你想让 Codex 和 GitHub、Slack、Linear 等工具协作。
什么时候不要乱装？
- 你不知道这个插件要访问什么数据。
- 你不确定它会不会连接私人账号。
- 你只是想普通聊天。
小白建议：
刚开始只用内置插件，不要急着装一堆。
先把 Browser Use、Computer Use、Documents、Spreadsheets、Presentations 这些常见能力搞懂就够了。
八、自动化：让 Codex 稍后或定期帮你做事
点左侧“自动化”，会看到自动化页面。
自动化不是“魔法按钮”。
它的本质是：
让 Codex 在某个时间点，或按某个频率，自动执行一件你提前说清楚的事。
常见场景：
- 每天早上帮你整理某个项目状态。
- 每周检查一次某个仓库有没有问题。
- 半小时后继续当前线程。
- 定期监控某个网页、邮箱、任务列表。
- 定时生成日报、周报、复盘。
这里有两种思路：
| 类型 | 大白话解释 | 适合什么 |
|---|---|---|
| 稍后继续 | 让当前对话过一会儿醒来 | 你想让 Codex 等一段时间再接着做 |
| 定期任务 | 按固定时间反复执行 | 日报、周报、监控、巡检 |
小白最适合从“提醒”和“稍后继续”开始。
比如你可以说：
30 分钟后提醒我回来检查这个任务结果。
或者：
每天早上 9 点帮我总结昨天这个项目的进展。
注意：
自动化最好写得非常具体。
不要写：
每天帮我看看。
要写：
每天早上 9 点检查这个项目目录里的最新 Markdown 文件，总结昨天新增内容、未完成事项、下一步建议。
越具体，Codex 越不容易跑偏。
九、右侧结果区：不是装饰，是证据区
Codex 的右侧区域非常重要。
很多小白只看中间回复，忽略右边。
但右边经常是最有价值的地方。
右边可能出现：
- 生成出来的文件。
- 搜索来源。
- 网页预览。
- 图片预览。
- PDF / 文档预览。
- 内置浏览器。
- 代码差异。
- Git 变化。
你可以把右侧理解成：
Codex 交作业的地方。
中间告诉你“我做了什么”，右边让你看“证据和产物”。
再看一张对话和右侧面板同时打开的状态。
这类界面最适合检查：
- Codex 有没有真的打开文件。
- 它引用的来源在哪里。
- 它生成的内容是不是你要的。
- 它有没有改错地方。
- 右边预览是否正常。
小白习惯：
只要 Codex 说“已完成”“我生成了文件”“我根据来源整理了”，你就去右边看一眼。
不要只相信文字。
十、设置入口：不要怕，但也别乱改
左下角有“设置”入口。
设置页是小白最容易紧张的地方。
因为里面有权限、Git、环境、MCP、浏览器、电脑操控这些词。
其实不用怕。
你只需要按一个原则：
不知道是什么，就先保持默认；真的遇到问题，再回来改。
下面按这次实测界面里看到的 11 个目录逐项讲。
十一、设置页 1：常规
常规管的是 App 的基础使用习惯。
常见内容包括：
- 工作模式：更偏日常工作，还是更偏编程。
- 默认权限。
- 自动审核。
- 完全访问权限。
- 默认打开目标。
- 语言。
- 菜单栏显示。
- 运行时防止系统休眠。
- 长文本发送快捷键。
小白最应该关注三个地方。
第一个是工作模式。
如果你不是程序员，优先选更偏“日常工作”的模式。这样 Codex 的表达会少一点工程黑话。
第二个是权限。
权限越大，Codex 能做的事越多，但风险也越大。
如果你还不熟，别一上来就开最大权限。
第三个是发送方式。
长文本是否需要 Command + Enter 发送，这个会影响你写长需求时会不会误触。
小白建议：
刚开始保持默认就行。
什么时候要改？
- 你觉得 Codex 太技术化。
- 你经常误按回车发送。
- 你希望任务运行时电脑不要睡眠。
- 你明确知道某个项目需要更高权限。
哪些别乱动？
- 完全访问权限。
- 自动审核。
- 任何看起来会减少确认步骤的权限设置。
十二、设置页 2：外观
外观管的是界面长什么样。
常见内容包括：
- 主题。
- 字体。
- 颜色。
- 代码展示样式。
- 差异对比样式。
- 字号或界面密度。
这个页面基本不影响 Codex 能不能完成任务。
它只影响你看得舒不舒服。
小白什么时候需要改？
- 你觉得字太小。
- 你觉得代码差异看不清。
- 你喜欢深色模式。
- 你录教程或截图时，需要界面更清晰。
哪些别纠结？
主题颜色、代码样式，不影响能力。
我建议：
如果你要写教程，尽量用浅色模式截图。
原因很简单：浅色截图在公众号、知识库、PDF 里更清楚。
十三、设置页 3：配置
配置页更偏“Codex 怎么运行”。
你可能会看到：
- 配置文件路径。
- 当前配置来源。
- 某些默认参数。
- 和 Codex CLI / 项目配置有关的内容。
这页对小白来说，不是每天都要碰。
你可以把它理解成：
Codex 的说明书和默认规则放在哪里。
什么时候需要看？
- 你装过 Codex CLI。
- 你想知道全局配置在哪里。
- 你发现 App 和命令行行为不一致。
- 你需要排查某个规则为什么一直生效。
哪些别乱动？
- 配置文件路径。
- 你看不懂的 JSON / TOML / 系统配置。
- 和权限、命令执行有关的默认规则。
小白建议：
先只看，不改。
真正需要改配置时，直接让 Codex 帮你解释：
这个配置页每一项是什么意思？哪些适合小白改，哪些不要动？
十四、设置页 4：个性化
个性化管的是 Codex 怎么理解你。
这里通常会出现类似：
- 个人偏好。
- 自定义说明。
- 记忆或偏好相关设置。
- 让 Codex 按某种风格回答的规则。
这页很重要。
因为 Codex 不只是一次性聊天，它会越来越像你的工作台。
你可以在这里写：
- 我更喜欢中文回答。
- 我不是程序员，请少用术语。
- 给我教程时要写成功标志和排查步骤。
- 修改代码前先解释影响。
- 涉及隐私文件时先提醒我。
小白建议写这种：
请默认用中文回答。
如果涉及代码，请先用大白话解释目的，再给具体操作。
如果要修改文件、运行命令、访问外部账号，请明确告诉我风险。
教程类内容请写成小白能照着做的步骤，并标注成功标志。哪些别乱写？
- 不要把 API Key、密码、Cookie 写进去。
- 不要把私人身份证、银行卡、公司机密写进去。
- 不要写太多互相矛盾的规则。
个性化规则不是越多越好。
越清楚越好。
十五、设置页 5：MCP 服务器
MCP 对小白来说听起来很吓人。
其实你可以这样理解：
MCP 是让 Codex 连接外部工具的一条通道。
比如某个工具提供了 MCP，Codex 就可以通过它读取数据、调用功能、执行操作。
常见场景：
- 连接数据库。
- 连接浏览器工具。
- 连接企业内部系统。
- 连接本地脚本或服务。
- 连接知识库、项目管理、设计工具。
什么时候需要改？
- 你明确知道某个工具要求配置 MCP。
- 你在安装某个插件或工具时，对方让你添加 MCP 服务器。
- 你正在搭建更高级的工作流。
什么时候不要碰？
- 你只是普通聊天。
- 你不知道某个 MCP 服务器来源。
- 你看不懂它会访问什么。
小白排雷：
MCP 权限可能很大。
如果它能访问文件、数据库、浏览器、企业系统，那就不是小事。
只加你信任的 MCP。
十六、设置页 6：Git
Git 是代码世界里的“版本记录系统”。
如果你不是程序员，可以先这样理解：
Git 像一个项目的时间机器，记录每次改了什么。
Codex 做项目任务时，Git 很重要。
因为你需要知道：
- 它改了哪些文件。
- 哪些改动是新增的。
- 哪些改动是删除的。
- 能不能回退。
- 要不要提交。
Git 设置页通常会影响：
- Codex 怎么展示代码变化。
- 是否自动处理某些 Git 操作。
- 提交信息怎么生成。
- 是否允许某些 Git 行为。
小白先记住四句话：
- 看不懂改动，不要急着提交。
- 私人项目先别让 Codex 自动乱提交。
- 提交前一定看 diff，也就是变化对比。
- 如果你不是程序员，先让 Codex 用中文解释“每个文件改了什么”。
你可以直接问：
这次 Git 变化用小白能懂的话解释一下，每个文件改了什么，有没有风险？
什么时候需要进 Git 设置？
- 你经常让 Codex 改代码。
- 你想调整差异展示方式。
- 你想让 Codex 帮你写 commit message。
- 你想控制是否自动提交。
哪些别乱动？
- 自动提交。
- 自动推送。
- 任何你不理解的 Git 行为。
十七、设置页 7：环境
环境可以理解成：
Codex 做事时使用的工具箱和运行场地。
比如一个项目可能需要：
- Node.js。
- Python。
- 依赖安装。
- 本地数据库。
- 特定命令。
- 特定环境变量。
如果环境没配好，Codex 可能会遇到：
- 命令找不到。
- 依赖不存在。
- 测试跑不起来。
- 项目打不开。
- 生成结果失败。
小白什么时候需要关心？
- Codex 说某个命令不存在。
- Codex 说项目依赖没安装。
- Codex 一直跑测试失败。
- 你想让 Codex 在特定环境里运行任务。
什么时候不用管？
- 你只是写文案。
- 你只是整理 Markdown。
- 你只是让 Codex 解释概念。
小白建议：
如果遇到环境问题，不要自己乱配。
直接把报错给 Codex：
这个环境报错是什么意思？我是小白，请告诉我应该怎么修，哪些命令安全，哪些命令不要随便跑。
十八、设置页 8：工作树
工作树这个词比较技术。
你可以先理解成：
给同一个项目开一个临时副本，让不同任务互不打架。
比如你有一个项目。
你想让 Codex 同时做两个方向：
- 一个任务改首页。
- 一个任务改登录页。
如果都在同一个文件夹里改，可能互相覆盖。
工作树就是给不同任务隔离出不同工作现场。
小白什么时候需要它？
- 你让多个 Codex 任务同时改同一个项目。
- 你想试一个方案，但不确定要不要保留。
- 你想让 Codex 做实验，不影响主项目。
什么时候不用纠结？
- 你刚开始用 Codex。
- 你一次只跑一个任务。
- 你只是写文档或普通对话。
小白建议：
前期不用主动配置工作树。
等你开始让多个任务同时改项目，再回来理解它。
十九、设置页 9：浏览器使用
浏览器使用管的是 Codex 能不能操作内置浏览器。
这个功能非常实用。
Codex 可以用它来：
- 打开网页。
- 搜索资料。
- 登录某些网站。
- 查看本地网页。
- 测试前端页面。
- 截图或检查页面效果。
但是它也有风险。
因为浏览器里可能有：
- 登录态。
- Cookie。
- 私人网页。
- 公司后台。
- 支付页面。
- 账号设置页。
小白建议：
让 Codex 操作浏览器时，需求要说清楚：
只打开这个网页，不要点击登录、付款、删除、发送消息等敏感按钮。
什么时候可以放心用？
- 打开公开网页。
- 查看官方文档。
- 测试本地网页。
- 检查页面有没有显示正常。
什么时候要谨慎？
- 网页里有账号。
- 网页里有订单、付款、删除、私信、发布按钮。
- 你不确定点一下会发生什么。
二十、设置页 10：电脑操控
电脑操控比浏览器使用更进一步。
浏览器使用主要是在浏览器里。
电脑操控是让 Codex 操作 Mac 上的应用。
比如：
- 打开某个 App。
- 点击按钮。
- 查看界面。
- 处理一些可视化任务。
- 帮你在软件里完成固定流程。
这功能很强。
但也更需要谨慎。
因为它可能碰到：
- 微信。
- 邮箱。
- 浏览器。
- 文件管理器。
- 付费软件。
- 公司工具。
- 私人资料。
小白建议：
第一次用电脑操控，最好只让它操作无风险 App。
比如：
打开一个本地演示网页，检查按钮有没有显示。
不要一上来就让它：
- 发消息。
- 删文件。
- 付款。
- 改账号设置。
- 操作私人聊天软件。
一句话：
电脑操控是高级功能。
能不用就先不用；要用就把边界说清楚。
二十一、设置页 11：已归档对话
已归档对话就是被你收起来的历史对话。
它不是删除。
更像是：
这个对话我暂时不想在列表里看到，但以后可能还要找回来。
适合归档的内容：
- 已经完成的任务。
- 暂时不用的项目对话。
- 不想占用左侧列表的旧记录。
- 需要保留但不常看的过程。
小白注意：
归档不等于清空隐私。
如果你想真正处理敏感内容，要看 Codex 的数据控制、账号设置、组织策略等相关入口。不要以为归档了就没人能看到。
二十二、跑一个普通对话：先从低风险任务开始
刚开始用 Codex，不建议直接让它改项目。
先跑一个普通对话。
比如输入：
用小白能听懂的话，解释一下 Codex App 和 ChatGPT 的区别。成功标志：
- Codex 能正常回复。
- 你能继续追问。
- 不需要你授权访问文件。
- 不会出现复杂的项目状态。
普通对话适合：
- 问概念。
- 写文案。
- 整理思路。
- 做教程大纲。
- 翻译和润色。
- 分析一段你手动贴进去的内容。
普通对话不适合：
- 让它自动读取你电脑里的文件。
- 让它修改项目。
- 让它跑代码。
- 让它提交 Git。
如果你发现自己在说：
帮我打开这个文件夹。
或者：
帮我改这个项目。
那就该切到项目任务了。
二十三、跑一个项目任务：让 Codex 真正开始做事
项目任务是 Codex App 的核心。
它适合这种需求：
请读取这个项目，帮我整理 README，并把缺失的使用步骤补上。或者：
请检查这个网页项目为什么启动失败，修好后告诉我改了哪些文件。项目任务和普通对话最大的区别是：
项目任务会进入一个真实文件夹。
它可能会：
- 读取文件。
- 修改文件。
- 新建文件。
- 运行命令。
- 查看 Git 变化。
- 生成结果。
所以你一定要会看权限。
如果 Codex 请求访问文件、终端、浏览器、第三方账号，你不要闭眼点。
先问自己：
- 这个任务真的需要这个权限吗？
- 它要访问的是哪个文件夹？
- 这个文件夹里有没有隐私？
- 它要运行的命令我能不能看懂？
- 不懂的话，能不能让 Codex 先解释？
小白可以直接要求：
在你修改任何文件之前，请先告诉我你准备改哪些文件，以及为什么要改。或者：
如果需要运行命令，请先用小白能懂的话解释这个命令会做什么。这两句话非常有用。
二十四、权限确认：不是吓你，是让你别误伤自己
Codex 可能会请求不同权限。
你可以这样理解：
| 权限类型 | 意味着什么 | 小白怎么判断 |
|---|---|---|
| 文件访问 | Codex 要读或改某个文件夹 | 看清楚路径是不是你允许的项目 |
| 终端命令 | Codex 要在电脑上运行命令 | 不懂就让它先解释 |
| 浏览器 | Codex 要打开网页或操作网页 | 避免付款、删除、发布类操作 |
| 第三方账号 | Codex 要连接 Gmail、GitHub 等 | 看清楚授权范围 |
| 电脑操控 | Codex 要操作 Mac App | 边界一定要说清楚 |
小白最容易犯的错：
看到确认按钮就点。
不要这样。
如果你看不懂，就问：
这个权限具体会让你做什么？有什么风险？我是小白，应该允许吗？Codex 本身也可以帮你解释权限。
二十五、Git 变化：小白只要先看懂这三件事
如果你让 Codex 改项目，最后经常会看到 Git 相关内容。
不用怕。
先看懂三件事：
- 改了哪些文件。
- 每个文件改了什么。
- 这些改动要不要保留。
你可以让 Codex 用这种格式总结：
请用小白能懂的话总结这次 Git 变化：
1. 改了哪些文件；
2. 每个文件为什么改；
3. 有没有风险；
4. 我下一步应该检查什么。什么时候可以提交？
- 你看懂了改动。
- 项目能正常运行。
- 测试通过。
- 没有误删文件。
- 没有把密码、Token、私人路径提交进去。
什么时候别急着提交？
- 你看不懂改动。
- Codex 没跑验证。
- 你发现它改了无关文件。
- Git 里出现账号、密钥、Cookie。
- 你只是想实验一下。
小白记一句：
提交不是保存，提交是给项目历史盖章。
盖章前先看清楚。
二十六、图片、视频、PDF、网页预览怎么看
Codex App 的右侧预览区可以打开很多东西。
比如：
- 图片。
- 视频。
- PDF。
- Markdown。
- 网页。
- 代码文件。
- 生成结果。
这对非程序员特别重要。
因为你不用去终端里找文件，也不用自己翻目录。
Codex 生成结果以后，你先看右侧预览。
判断标准：
- 图片有没有正常显示？
- PDF 是否能打开？
- 网页是否空白？
- 文档格式是不是乱了？
- 内容有没有遮挡、乱码、错位？
- 生成文件是不是你要的那个？
如果不对，直接继续说：
右侧预览里这个结果不对，请根据预览继续修改。这就是 Codex App 比纯命令行更适合小白的地方：
它把很多结果可视化了。
二十七、常见踩坑和排查
1. 不知道该开普通对话还是项目对话
判断方法：
- 问问题、写内容：普通对话。
- 读文件、改文件、跑命令：项目对话。
2. Codex 一直在跑，不知道是不是卡了
先看底部状态。
如果它显示正在运行、正在调用工具、正在等待命令，那可能还没结束。
如果很久没动，可以问：
你现在卡在哪一步？请总结当前状态，并告诉我下一步怎么继续。3. 它请求权限，我不知道能不能点
不要直接点。
让它解释：
这个权限会让你访问什么？为什么这个任务需要它？有没有更低风险的做法？4. 它改了项目，我看不懂
让它解释 Git diff：
请按文件逐个解释这次改动，用非程序员能懂的话说。5. 生成结果不满意
不要重开。
直接基于结果继续改：
保留现在的结构，但把语言改得更口语化，并补充每一步的成功标志。6. 插件太多，不知道装哪个
先别装。
先用内置能力。
等你明确知道“我要让 Codex 连接某个工具”，再去插件页找。
7. 自动化跑偏
大概率是你的任务描述太泛。
把任务写成：
- 什么时候执行。
- 执行对象是什么。
- 输出什么。
- 不要做什么。
- 遇到问题怎么处理。
二十八、我的推荐使用路线
如果你是第一次用 Codex App，我建议按这个顺序来：
- 打开 App，先熟悉左侧导航。
- 新建一个普通对话，问一个低风险问题。
- 打开设置页，只看不改。
- 建一个干净演示项目，不要用私人项目。
- 让 Codex 读取项目，并生成一个简单 Markdown。
- 看右侧结果区。
- 让它解释它做了什么。
- 再尝试插件页和自动化页。
- 最后再碰 Git、MCP、电脑操控这些高级功能。
这条路线的好处是：
你不是一上来就把最高权限、最复杂项目、最难任务全扔给 Codex。
你是在逐步建立信任。
工具越强，越要这样用。
二十九、这篇教程里所有截图总览
如果你想检查整套截图是否齐，可以看下面两张总览图。
第一张是全部 clean 截图总览。
第二张主要是主界面和设置页总览。
这两张不一定要放在公开文章正文里。
它们更适合作为你自己检查素材时用：
- 有没有漏掉某个设置页。
- 有没有重复截图。
- 有没有打码不完整。
- 哪张图适合放在哪个章节。
三十、写在最后
Codex App 真正难的地方，不是按钮多。
而是它跨了好几个世界：
- 聊天。
- 文件。
- 项目。
- 网页。
- 浏览器。
- 自动化。
- Git。
- 第三方账号。
- 本地电脑权限。
所以小白第一次打开会懵，很正常。
你不用一上来把它当成“全自动程序员”。
更好的方式是：
先把它当成一个能做事的助手。
一开始让它做低风险任务，观察它怎么读文件、怎么解释过程、怎么展示结果。等你能看懂它的工作方式，再慢慢把项目、插件、自动化、Git 加进来。
记住这几个原则：
- 不知道在哪，就先看左侧导航。
- 不知道它做了什么，就看中间过程。
- 不知道结果对不对，就看右侧预览。
- 不知道权限能不能给，就让它先解释。
- 不知道 Git 能不能提交，就先让它总结变化。
Codex App 不是一个需要你一次性掌握的工具。
它更像一个工作台。
你用得越多，越会知道哪些按钮该碰，哪些按钮先别碰。
不用急。
先跑通一次，就已经赢了一大半。