第 1 章 · 先认界面
认清界面
先把 Codex App 的界面看懂：左边入口、中间对话、右边结果，再翻一遍设置页。
Codex App 从0到1完整入门教程：把这个超级APP的每一个细节抽丝剥茧讲清楚
最近我发现，很多人第一次接触 Codex App 的反应不是“哇，好强”，而是：
这玩意儿到底从哪开始使用？需不需要我配置一大堆东西？
左边一堆入口，中间是聊天，右边又会弹出网页、图片、文档、来源、代码变化。设置里还有一堆看起来很技术的东西。
作为小白，困住你的大概率不是不想用Codex，而是压根不知道如何第一次上手Codex。
所以这篇文章不是技术类文章，我会按一个普通人的使用路线抽丝剥茧地来讲清楚：
Codex App 到底是什么。
本地 App、云端 Codex、普通 ChatGPT 的区别。
打开 App 后，左边、中间、右边分别是干什么的。
设置页每个目录到底管什么。
普通对话和项目对话有什么区别。
插件、技能、MCP、自动化、Git 这些词怎么理解。
哪些地方小白最容易点错。
本文基于 Mac 版 Codex App 实测整理。
Codex版本：Codex 26.429.30905。
Codex App 更新很快，你看到的按钮名称和位置可能会有一点变化，但核心逻辑基本一样。
Codex App 到底是什么
一句话：Codex App 是一个把 AI Agent 放进你电脑里的工作台，它可以在当前版本、认证方式和已授权能力允许的范围内协助完成任务；结果仍要由你检查。
说白了，它不是一个你问一句，它答一句的普通聊天框。Codex App 更像是你的助理，它可以：
和你聊天。
读你指定的本地文件。
搜索网页。
打开内置浏览器。
生成图片、文档、PPT、网页、代码等结果。
用插件连接 Gmail、GitHub、Google Drive、Slack 等外部工具。
设置自动化，定期帮你检查、总结或继续任务。
如果你是非程序员，可以先把它理解成：
一个更偏“做事”的 ChatGPT。
它不是只回答“怎么做”，而是很多时候可以直接帮你“做一遍”。
但也正因为它能做事，所以你必须理解它的界面和权限。不然你会不知道它到底是在本地电脑上做事，还是在云端任务里做事，也不知道它什么时候会碰到你的文件。
先看一张打开后的整体界面。
这张图先不用看细节。你只要记住：左边是导航栏，中间是你和 Codex 对话的地方，右边有时会出现结果、来源、预览和代码变化。
这就是 Codex App 和普通聊天框最大的差别：它不是只有“问答”，它还有“工作现场”。
下载和登录
先选清楚本次接入方式：本站服务使用本站 API 密钥或令牌；官方 ChatGPT 账号登录使用官方账户的权限与额度。两者不能互相代替。
还没安装的用户，先到安装包入口选择系统和芯片。Windows 按对应安装说明操作；Mac 打开安装包并将应用放入“应用程序”。下载与安装成功只说明客户端已经就绪。
使用本站服务：先完成注册与准备，再按Codex 接入教程配置实际使用的 CLI、桌面应用或 IDE 扩展，最后做第一次调用验证。已经接通的用户不用重新登录或覆盖配置。
使用官方账号：按官方认证说明登录。官方方案与功能条件以账户页面为准，不把官方免费额度当作本站额度。
本地 Codex App、云端 Codex、普通 ChatGPT 有什么区别
在开始介绍Codex App之前，我把Codex App和云端Codex以及普通Chatgpt的区别先理一下，因为很多人一直没搞清楚这三者的区别。
| 名字 | 大白话 | 适合做什么 |
|---|---|---|
| ChatGPT | 普通对话 | 问问题、写文案、解释概念、生成文件和图片 |
| Codex App | 装在电脑上的工作台 | 可在授权范围内处理本地项目；功能取决于当前版本与认证方式 |
| 云端 Codex | 在官方服务器上跑任务 | 云端环境准备并发布后，可在服务端执行任务；需满足官方账号与功能条件 |
小白先记住一个判断标准就够了：
一般任务：用普通对话。
要处理本地文件或项目：用 Codex App 里的项目。
要让 Codex 在远程环境里持续跑任务：用云端 Codex。
主界面地图：左边、中间、右边
第一次打开 Codex App，可能有点懵逼，因为上面的功能还是有点多的，毕竟人家是“超级工作台”嘛！
| 区域 | 干什么 | 最常用 |
|---|---|---|
| 左边导航 | 找入口、项目、对话 | 新对话、切对话、插件、自动化 |
| 中间对话 | 你和 Codex 交流 | 输入需求、开始工作 |
| 右边结果 | 展示证据和产物 | 看来源、预览、看代码变化 |
下面这张是正在工作的界面：左边导航，中间对话，右边是预览和结果。
左侧入口：搜索、插件、自动化
左边是 Codex 的入口区。
常见入口包括：
- 新对话
大白话：开一个全新的聊天任务
适用时机：不想沿用旧上下文、清空之前聊天记录重新提问时
- 搜索
大白话：查找历史对话、命令以及相关文件
适用时机：忘记之前聊过的内容，需要回溯查看记录时
- 插件
大白话：给 Codex 增加外部拓展能力
适用时机：需要连接 Gmail、GitHub、Drive、Slack 等第三方工具时
- 自动化
大白话：让 Codex 定时或延后自动执行任务
适用时机：想要每日自动总结、定期检查内容、延后继续处理任务时
- 项目
大白话：让 Codex 针对指定文件夹、代码仓库开展工作
适用时机：需要它读取文件、修改文件、运行本地命令时
- 普通对话
大白话：不绑定已有项目的新对话；可用工具与权限仍需查看当前设置
适用时机：查询概念、撰写文案、梳理思路、日常简单提问时
搜索：找回你之前做过的事
点左侧“搜索”，会弹出一个搜索浮层。
它的作用很简单：
找历史对话。
找之前跑过的项目任务。
找你忘记名字的上下文。
插件：给 Codex 装能力包
点左侧“插件”，会进入插件页。
插件其实就是给 Codex 装能力包。
比如：
Browser Use：让 Codex 操作内置浏览器。
Computer Use：让 Codex 操作 Mac 上的 App。
Spreadsheets：让 Codex 处理表格。
Presentations：让 Codex 做演示文稿。
GitHub：让 Codex 和 GitHub 工作流配合。
Gmail / Google Drive / Slack 这类：让 Codex 连接外部账号。
这里顺便把几个词讲清楚。
| 名词 | 大白话 | 例子 |
|---|---|---|
| 插件 | 能力包 | 装了表格插件，更会处理表格 |
| 连接器 | 接外部账号 | Gmail、GitHub、Drive |
| 技能 | 固定工作流说明书 | 写教程时按我的风格 |
| MCP | 接外部工具的通道 | 调用某个本地服务 |
小白不用纠结这些名词的具体细节，只需要大概理解：
插件是能力包，连接器是接账号，技能是工作流说明书，MCP 是接工具的通道。
什么时候需要插件？
你想让 Codex 读 Gmail。
你想让 Codex 操作浏览器。
你想让 Codex 做 PPT、表格、文档。
你想让 Codex 和 GitHub、Slack、Linear 等工具协作。
小白建议：刚开始只用官方已经内置好的插件，不要急着装一堆，后续熟练了可以慢慢添加
自动化：让 Codex 稍后或定期帮你做事
点左侧“自动化”，会看到自动化页面。
自动化就是让 Codex 在某个时间点，或按某个频率，自动执行一件你提前设置好的任务。
常见场景：
每天早上帮你整理某个项目状态。
每周检查一次某个仓库有没有问题。
半小时后继续当前线程。
定期监控某个网页、邮箱、任务列表。
定时生成日报、周报、复盘。
右侧结果区：产出物
Codex 的右侧区域可能出现：
生成出来的文件。
搜索来源。
网页预览。
图片预览。
PDF / 文档预览。
内置浏览器。
代码差异。
Git 变化。
你可以把右侧理解成：Codex 交作业的地方。
中间告诉你“Codex到底做了什么”，右边让你看“Codex到底产出了什么”。
设置页：从常规到归档
左下角有“设置”入口，这里面可能有很多小白陌生的设置，但是挨个认真看完，其实也能设置好，把Codex设置的更加好用。下面逐个介绍：👇
1：常规
常规管的是 App 的基础使用习惯。
常见内容包括：
工作模式：更偏日常工作，还是更偏编程。
默认权限。
自动审核。
完全访问权限。
默认打开目标。
语言。
菜单栏显示。
运行时防止系统休眠。
长文本发送快捷键。
小白最应该关注四个地方。
第一个是工作模式。
如果你不是程序员，优先选更偏“日常工作”的模式。这样 Codex 的表达会少一点工程黑话。
第二个是权限。
权限越大，Codex 能做的事越多，但风险也越大。
首次使用保留默认权限，只选择独立练习目录。出现额外授权时核对动作和路径；连通模型不需要开启完全访问权限。
第三个是发送方式。
长文本是否需要 Command + Enter 发送，这个会影响你写长需求时会不会误触，因为很多朋友不小心点击Enter就会发送，比如我。。。
第四个是语音输入
这个相当于全局键，打开了之后，不止是在Codex App内部，可以在电脑上任意一个对话框调用Codex的语音输入法。但是如果习惯了比如Typeless、豆包输入法的朋友就没有必要切换了。
2：外观
外观管的是界面长什么样。
常见内容包括：
主题。
字体。
颜色。
代码展示样式。
差异对比样式。
字号或界面密度。
这个页面基本不影响 Codex 能不能完成任务，它只影响你看界面UI的时候舒不舒服。
但是有个新功能大家也许会感兴趣：可以在这个界面选择一只桌宠，然后再Codex对话框输入/宠物就能唤起一只陪伴大家工作的小可爱！
3：配置
已经完成本站接入时，保留已验证的提供方与认证配置；还没接通先按本站接入教程操作。不要为了对齐配图覆盖整份配置。
4：个性化
个性化管的是 Codex 怎么理解你。
这里通常会出现类似：
个人偏好。
自定义说明。
记忆或偏好相关设置。
让 Codex 按某种风格回答的规则。
你可以在这里写：
我更喜欢中文回答。
我不是程序员，请少用术语。
给我教程时要写成功标志和排查步骤。
修改代码前先解释影响。
涉及隐私文件时先提醒我。
小白建议写这种：
哪些别乱写？
不要把 API Key、密码、Cookie 写进去。
不要把私人身份证、银行卡、公司机密写进去。
不要写互相矛盾的规则。
5：MCP 服务器
MCP 对小白来说第一次听见会有点懵，但是简单理解就是MCP 是让 Codex 连接外部工具的一条通道，大概意义和插件没啥区别。
比如某个工具提供了 MCP，Codex 就可以通过它读取数据、调用功能、执行操作。
初次练习不需要添加 MCP。需要外部能力时再检查当前版本是否支持、插件来源与授权范围；本站文本请求成功不代表插件和账号连接已经可用。
6：Git
Git 是代码世界里的“版本记录系统”。
如果你不是程序员，可以先这样理解：
Git 像一个项目的时间机器，记录每次改了什么。
因为你需要知道：
它改了哪些文件。
哪些改动是新增的。
哪些改动是删除的。
能不能回退。
要不要提交。
但是总而言之，这些都是技术相关，小白第一次上手把这页的设置保持默认即可，不需要改变。
7和8：环境和工作树
小白保持默认即可！
9和10：浏览器使用和电脑操作
浏览器使用是指 Codex 能操作内置浏览器，这个功能非常实用，Codex 可以用它来：
打开网页。
搜索资料。
登录某些网站。
查看本地网页。
测试前端页面。
截图或检查页面效果。
直接在Codex App内部就完成相关操作，不需要再跳转到别的网页，十分便捷。
10：电脑操控
电脑操控是让 Codex 操作 Mac 上的应用。
比如：
打开某个 App。
点击按钮。
查看界面。
处理一些可视化任务。
帮你在软件里完成一些流程。
这功能很非常非常强，可以说是我觉得Codex App最牛逼的一个功能，前端时间我才让它帮我从零到一写了一份法律检索报告（我只完成了登录几个网站的操作，别的搜索、探究网站内部结构、点击、整理资料全是它一次性完成），但是，也更需要谨慎。
因为它可能碰到：
微信。
邮箱。
浏览器。
文件管理器。
付费软件。
公司工具。
私人资料。
小白建议：第一次用电脑操控，最好只让它操作无风险 App，特别记住不要操作社媒账号和微信！！！！！
11：已归档对话
已归档对话就是被你收起来的历史对话，它不是删除，更像是：把对话从常用列表中收起。它不是文件备份；保留期限与恢复能力以当前产品和工作区设置为准。
适合归档的内容：
已经完成的任务。
暂时不用的项目对话。
不想占用左侧列表的旧记录。
需要保留但不常看的过程。
跑一个普通对话：先从低风险任务开始
权限确认：非常重要！
Codex 可能会请求不同权限，你可以这样理解：
| 权限 | 意味着什么 | 怎么判断 |
|---|---|---|
| 文件访问 | 要读或改某个文件夹 | 路径是不是你允许的项目 |
| 终端命令 | 要在电脑上运行命令 | 不懂就先让它解释 |
| 浏览器 | 要打开或操作网页 | 避开付款、删除、发布 |
| 第三方账号 | 要连接 Gmail、GitHub 等 | 看清授权范围 |
| 电脑操控 | 要操作电脑上的 App | 边界先说清楚 |
小白最容易犯的错：看到确认按钮就点。千万不要这样，如果你看不懂，就问：
先不要执行。请说明这次操作要访问哪个路径或账号、会改什么、为什么需要这项权限，以及不授权时能否继续。
看清动作与范围再决定；解释不清楚时可以拒绝，不必为了继续教程批准所有请求。
常见踩坑和排查
- Codex 一直在跑，不知道是不是卡了
先看左边对话状态，是在转圈还是蓝色的不动的点
如果它显示转圈，那就是没有结束。
状态图标随版本变化，蓝点也可能只是未读提示。查看最后一条结果、错误或待确认信息；任务停止不等于交付已经通过验收
- 它请求权限，我不知道能不能点
不要直接点，让它解释：
先不要执行。说明要做的动作、目标路径和所需权限，等我确认。
- 它改了项目，我看不懂
先停止继续修改，让它解释 Git diff；没有使用 Git 时，对照练习前保存的副本：
列出已改动文件、每项改动原因和核对方法。先不要继续改，也不要自动回退或删除。
- 生成结果不满意
同一份材料的小修改可以继续当前对话；材料或目标已变时先整理摘要，再开新对话。
直接基于结果继续改：
保留已经正确的数字和事实，只修改我指出的这一段。完成后说明改了什么。
- 插件太多，不知道装哪个
先别装，先用官方内置能力。
等你明确知道“我要让 Codex 连接某个工具”，再去插件页找。
- 自动化跑偏
大概率是你的任务描述太泛，把任务精细化描述一下：
什么时候执行。
执行对象是什么。
输出什么。
不要做什么。
遇到问题怎么处理。
我的推荐使用路线
如果你是第一次用 Codex App，我建议按这个顺序来：
打开 App，先熟悉左侧导航。
新建一个普通对话，问一个低风险问题。
打开设置页，只看不改。
建一个干净演示项目，不要用私人项目。
让 Codex 读取项目，并生成一个简单 Markdown。
看右侧结果区。
让它解释它做了什么。
再尝试插件页和自动化页。
最后再碰 Git、MCP、电脑操控这些高级功能。