第一次打开 Codex App,很多人不是惊喜,而是发懵。
左边一排入口,中间是聊天框,右边还会弹出网页、图片、文档、代码变化。再点进设置页,一堆权限、插件、MCP、Git、自动化,看起来像是给程序员准备的驾驶舱。
但它真正厉害的地方也在这里:Codex App 不是一个只会回答问题的聊天框,而是一个能在电脑里帮你做事的工作台。
下面就按普通用户第一次上手的顺序,把 Codex App 从界面、设置、权限到使用路线讲清楚。示例以 Mac 版为主,版本为 Codex 26.429.30905。应用更新很快,按钮名字和位置可能会有小变化,但核心逻辑基本一致。
Codex App 到底是什么
一句话理解:Codex App 是把 AI Agent 放进你电脑里的工作台。
普通 ChatGPT 更像“问答助手”,你问一句,它答一句。Codex App 更像“执行助手”,它不仅能回答,还能围绕你的电脑、文件、网页和工具开始做事。
它可以做这些事:
• 和你聊天,解释概念,整理思路 • 读取你指定的本地文件 • 打开内置浏览器,搜索和查看网页 • 生成图片、文档、PPT、网页、代码等结果 • 通过插件连接 Gmail、GitHub、Google Drive、Slack 等工具 • 通过自动化,让任务在指定时间或周期里继续执行
如果你不是程序员,可以先把它理解成:一个更偏“动手做事”的 ChatGPT。
但也正因为它能做事,你必须理解两个问题:它什么时候在本地电脑上工作,什么时候在云端工作;它什么时候可能读取文件、运行命令、操作网页或调用第三方账号。
先看整体界面。

不用急着看细节。先记住这个大框架:左边是导航栏,中间是你和 Codex 对话的地方,右边会在需要时展示结果、来源、预览和代码变化。
这就是 Codex App 和普通聊天框最大的区别:它不只有“问答”,还有一个真实的“工作现场”。
下载和登录:先从官方入口开始
Mac 用户建议只从 OpenAI 官方入口下载 Codex App。
安装方式和普通 Mac App 差不多:下载安装包,把 Codex 拖进“应用程序”,再从启动台或应用程序里打开。登录时使用 ChatGPT / OpenAI 账号即可,普通账号也会有一定免费额度。
第一次用,不要急着改设置,也不要急着让它碰你的重要项目。先登录、熟悉界面,再逐步放开能力。
先分清三件事:ChatGPT、Codex App、云端 Codex
很多人刚开始会把这三个混在一起。
可以这样理解:
• ChatGPT:普通对话助手,适合问问题、写文案、解释概念、生成图片和文件 • Codex App:装在电脑上的 AI 工作台,适合读取本地文件、处理本地项目、配合电脑环境工作 • 云端 Codex:跑在远程环境里的 AI Agent,适合让任务离开本地电脑也能继续执行
最简单的判断标准是:
• 一般问题,用普通 ChatGPT 或 Codex 普通对话 • 要处理本地文件或本地项目,用 Codex App 里的项目 • 要让任务在远程环境里持续跑,用云端 Codex
小白一开始不用记太多,只要记住:本地文件相关的事,不要随便交给普通对话;持续后台任务,也不要误以为本地 App 关了还能继续跑。
主界面地图:左边、中间、右边
第一次打开 Codex App,功能入口确实有点多。先按三块区域理解就够了。
• 左边导航栏:找入口、找项目、找对话 • 中间对话区:真正输入需求,让 Codex 开始工作 • 右边结果区:看来源、预览网页/图片/PDF、查看代码变化和产物
下面这张图虽然是插件页,但很适合理解整体布局:左边是导航,中间是主要内容,右边在需要时会出现预览或结果。

左侧导航栏:所有工作流都从这里开始
左边是 Codex 的入口区。

常见入口可以这样记:
新对话:开一个全新的聊天任务。不想沿用旧上下文时用它。
搜索:查历史对话、命令和相关文件。忘了之前做过什么时,从这里找。
插件:给 Codex 增加外部能力,比如连接 Gmail、GitHub、Drive、Slack。
自动化:让 Codex 在某个时间或某个周期自动执行任务。
项目:让 Codex 针对一个指定文件夹或代码仓库工作。它可能会读文件、改文件、运行命令,所以要谨慎给权限。
普通对话:不绑定任何项目的纯聊天模式,适合查概念、写文案、整理思路。
第一次使用时,建议先从普通对话开始,不要一上来就让它接管项目。
搜索:找回你之前做过的事
点左侧“搜索”,会弹出一个搜索浮层。

它的作用很直接:找历史对话、找之前跑过的项目任务、找你忘记名字的上下文。
如果你经常让 Codex 帮你做不同任务,搜索会很重要。因为很多时候你不是要重新开始,而是要把某个旧任务、旧结论、旧过程找回来继续用。
插件:给 Codex 装能力包
点左侧“插件”,会进入插件页。

插件可以理解成 Codex 的能力包。
比如:
• Browser Use:让 Codex 操作内置浏览器 • Computer Use:让 Codex 操作 Mac 上的 App • Spreadsheets:让 Codex 处理表格 • Google Drive:让 Codex 访问你的云盘文件 • GitHub:让 Codex 和代码仓库协作 • Gmail:让 Codex 读取或辅助处理邮件 • Slack:让 Codex 连接工作沟通环境
这里要注意:插件不是装得越多越好。插件越多,Codex 能碰到的外部系统越多,权限边界也越复杂。
刚开始最稳的策略是:只用官方内置能力,等你明确知道“我需要连接某个工具”时,再去插件页开启。
自动化:让 Codex 定时或稍后做事
点左侧“自动化”,会看到自动化页面。

自动化就是让 Codex 在某个时间点,或按某个频率,自动执行提前设好的任务。
常见场景包括:
• 每天早上整理某个项目状态 • 每周检查一次某个仓库有没有问题 • 半小时后继续当前线程 • 定期汇总网页、文件或项目变化
自动化很强,但也容易跑偏。任务描述不要只写“帮我看看”,要写清楚:什么时候执行、看什么对象、输出什么结果、不要做什么、遇到问题怎么处理。
右侧结果区:Codex 交作业的地方
Codex 工作时,右边经常会出现结果区。
它可能展示:
• 网页预览 • 图片预览 • PDF / 文档预览 • 内置浏览器 • 代码差异 • Git 变化

可以把右侧理解成:Codex 交作业的地方。
中间告诉你“它做了什么”,右边让你看“它产出了什么”。尤其在处理网页、图片、文件和代码时,右侧区域非常重要。
设置入口:先看懂,再决定要不要改
左下角有“设置”入口。里面的选项对小白来说会有点密,但不需要害怕。先看懂每一类管什么,再决定要不要动。
常规:影响基础使用习惯
常规页管的是 App 的基础行为。

常见内容包括工作模式、默认权限、自动审核、发送方式、语音输入等。
权限这里要特别注意。
不同使用方式会带来不同风险:读文件、改文件、跑命令、操作浏览器、连接账号,都不是一回事。刚开始不熟时,不建议一上来就开最大权限。等你明确知道自己常用哪些能力,再逐步放开,会稳很多。
发送方式也值得看一下。比如长文本是否需要 Command + Enter 才发送,会影响你写长需求时会不会误触。
语音输入则更像一个全局输入能力。

打开后,不只在 Codex App 内部,你也可能在电脑上的其他输入场景调用它。如果你已经习惯 Typeless、豆包输入法之类的工具,就不用急着切换。
外观:只影响看起来舒不舒服
外观页管的是界面长什么样。

这里通常会有主题、字体、颜色、差异对比样式、字号或界面密度。
这部分基本不影响 Codex 能不能完成任务,只影响你看界面时舒不舒服。
有个比较有趣的小功能:可以在外观相关设置里选择桌宠,然后在 Codex 对话框里输入 /宠物,唤起一只陪你工作的“小伙伴”。

配置:不懂就先保持默认
配置页对普通用户来说,第一次不用急着改。

如果你不知道某个配置项意味着什么,最好的选择不是乱试,而是先让 Codex 解释:这个设置会影响什么?开了有什么风险?不开有什么限制?
个性化:决定 Codex 怎么理解你
个性化页管的是 Codex 怎么理解你的偏好。

这里通常会出现个人偏好、自定义说明、记忆或偏好相关设置。
可以写什么?
• 你常用的表达风格 • 你希望它默认怎么解释问题 • 你不想重复强调的工作习惯 • 你经常使用的工具和边界
不要写什么?
• API Key、密码、Cookie • 身份证、银行卡、私人敏感信息 • 公司机密 • 互相矛盾的规则
个性化不是“越长越好”。写太多,反而会让它抓不到重点。真正有用的是稳定、清晰、少量的长期偏好。
MCP 服务器:连接外部工具的一条通道
MCP 第一次听起来会有点陌生。

简单理解:MCP 是让 Codex 连接外部工具的一条通道。某个工具如果提供 MCP,Codex 就可以通过它读取数据、调用功能或执行操作。
对小白来说,一开始不用急着配 MCP。很多日常工作,用 Codex 内置插件已经够了。等你明确知道某个工具必须通过 MCP 接入,再回来研究这页。
Git:项目的时间机器
Git 是代码世界里的“版本记录系统”。

如果你不是程序员,可以先这样理解:Git 像一个项目的时间机器,记录每次改了什么。
为什么它重要?因为当 Codex 改项目时,你需要知道:它改了哪些文件、改了什么、能不能回退、要不要提交。
如果你第一次用 Codex App,不建议一上来就让它碰真实项目。可以先建一个干净的演示文件夹,让它生成一个 Markdown 或小页面,练习看右侧结果区和 Git diff。
环境和工作树:小白保持默认即可
环境和工作树属于更偏技术的设置。

第一次上手可以保持默认。等你需要处理多个项目目录、隔离不同任务环境、或者让 Codex 在特定工作树里操作时,再回来认真看。
浏览器使用和电脑操作:强,但要设边界
浏览器使用是指 Codex 能操作内置浏览器。

它可以打开网页、搜索资料、登录某些网站、查看本地网页、抓取信息或辅助完成网页任务。
电脑操作更强,意味着 Codex 可能会操作 Mac App。
这类能力很实用,但边界要说清楚。尤其不要一开始就让它碰:
• 付款流程 • 删除操作 • 发布操作 • 社交账号 • 微信 • 公司工具 • 私人资料
第一次使用电脑操控,最好只让它操作无风险 App,并且明确告诉它:不要付款、不要删除、不要发布、不要发送消息。
已归档对话:不是删除,是收起来
已归档对话就是被你收起来的历史对话。

它更像一个没有时间限制的回收站,不会自动过期。以后想找回来,还可以再打开。
适合归档的内容包括:已经完成的任务、暂时不用的项目对话、不想占用左侧列表的旧记录、需要保留但不常看的过程。
第一次真正使用:先跑低风险任务
刚开始用 Codex,不建议直接让它改项目。
先开一个普通对话,比如:
用小白能听懂的话,解释一下 Codex App 和 ChatGPT 的区别。如果是更复杂的任务,可以先打开计划模式,让它先梳理步骤,再开始做。
这个习惯很重要:先让它计划,再让它执行。
权限确认:看不懂就不要直接点
Codex 可能会请求不同权限。
可以这样判断:
• 文件访问:它要读或改某个文件夹,看清楚路径是不是你允许的项目 • 终端命令:它要在电脑上运行命令,不懂就让它先解释 • 浏览器:它要打开网页或操作网页,避免付款、删除、发布类操作 • 第三方账号:它要连接 Gmail、GitHub 等,看清楚授权范围 • 电脑操控:它要操作 Mac App,边界一定要说清楚
小白最容易犯的错是:看到确认按钮就点。
不要这样。
如果你看不懂,就直接问:
这个权限具体会让你做什么?有什么风险?我是小白,应该允许吗?Codex 本身也可以帮你解释权限。让它先说清楚,再决定点不点。
常见踩坑和排查
1. Codex 一直在跑,不知道是不是卡了
先看左侧对话状态。如果还在转圈,说明没有结束;如果变成蓝色不动的点,通常代表任务已经结束。
2. 它请求权限,我不知道能不能点
不要直接点。让它解释:
这个权限会让你访问什么?为什么这个任务需要它?有没有更低风险的做法?3. 它改了项目,我看不懂
让它解释 Git diff:
请按文件逐个解释这次改动,用非程序员能懂的话说。4. 生成结果不满意
不要立刻重开。直接基于结果继续改:
保留现在的结构,但把语言改得更口语化,并补充每一步的成功标志。5. 插件太多,不知道装哪个
先别装。先用官方内置能力。等你明确知道“我要让 Codex 连接某个工具”,再去插件页找。
6. 自动化跑偏
大概率是任务描述太泛。把任务说细:什么时候执行、执行对象是什么、输出什么、不要做什么、遇到问题怎么处理。
推荐上手路线
如果你是第一次用 Codex App,建议按这个顺序来:
1. 打开 App,先熟悉左侧导航 2. 新建一个普通对话,问一个低风险问题 3. 打开设置页,只看不改 4. 建一个干净演示项目,不要用私人项目 5. 让 Codex 读取项目,并生成一个简单 Markdown 6. 看右侧结果区 7. 让它解释自己做了什么 8. 再尝试插件页和自动化页 9. 最后再碰 Git、MCP、电脑操控这些高级功能
这条路线不快,但安全。
账号额度怎么选
免费额度可以体验,但经不起频繁折腾。
如果只是想试试,Plus 更适合入门;如果你每天高强度使用、经常跑复杂任务,再考虑 Pro。
这里最重要的不是“买哪个最贵”,而是先搞清楚自己会不会真的把它用起来。对多数小白来说,先用 Plus 熟悉界面、权限和项目工作流,会更稳。
最后:先把它当成工作台,而不是魔法
Codex App 很强,也确实比纯 CLI 更适合普通人上手。它能聊天、读文件、处理项目、打开网页、用浏览器、跑自动化、接插件、看 Git、调用本地电脑能力。
但它不是魔法。
你越清楚地告诉它边界,它越可靠;你越理解它在哪个区域工作,它越不容易吓到你。
第一次打开会懵很正常。真正的上手方式不是一次性看懂所有按钮,而是从低风险任务开始,慢慢给它加插件、加技能、加自动化,最后把它培养成适合你自己的超级助手。
如果只记住一句话:先用普通对话练手,再用项目处理文件,最后再开启更高权限。
——END——
点点关注,一起学习~
夜雨聆风