一句话结论

Codex App 是新手最推荐的入口，图形界面最完整，登录后选项目目录、开 thread、输任务、看 diff 就能完成第一个网页。

Codex App 安装与上手 （新手最为推荐，也是功能最强的）

下载与安装

macOS 安装

如果你使用的是 Mac，先确认自己的芯片类型。

点击电脑左上角的 Apple 图标，选择「关于本机」。

如果显示的是：

• Apple M1 / M2 / M3 / M4：选择 Apple Silicon 版本
• Intel：选择 Intel 版本

进入 Codex App 官方页面后，根据自己的芯片下载对应版本。下载完成后，打开安装包，把 Codex 拖进「应用程序」文件夹。

安装完成后，在「应用程序」里打开 Codex。

第一次打开时，系统可能会提示：

「这是从互联网下载的应用，是否确认打开？」

选择「打开」即可。

Intel Mac 与 Apple Silicon 的区别

Mac 主要分两种芯片：

类型	常见机型	应该下载
Apple Silicon	M1 / M2 / M3 / M4 Mac	Apple Silicon 版本
Intel Mac	老款 Intel 芯片 Mac	Intel 版本

最简单的判断方法：

打开「关于本机」，看芯片信息。

如果写的是 Apple M 系列，就是 Apple Silicon。

如果写的是 Intel Core i5、Intel Core i7、Intel Core i9，就是 Intel Mac。

这个地方不要选错。选错版本可能会导致无法安装、打不开，或者运行不稳定。

Windows 安装

如果你使用的是 Windows，进入 Codex App 官方页面，选择 Windows 版本。

Windows 版一般会跳转到 Microsoft Store 安装。

安装步骤：

1. 打开 Codex App 官方页面
2. 点击 Windows 下载入口

3. 跳转到 Microsoft Store

4. 点击「获取」或「安装」（这里我已经安装过了所以显示的是打开）
5. 打开 Codex App
6. 到这里Codex App已经安装完成

第一次打开 Codex App

选择项目目录

第一次打开 Codex App 后，登录完成，系统会让你选择一个项目目录。

这里的「项目目录」，可以理解成：

Codex 要进入哪个文件夹工作。

比如你想让 Codex 帮你做一个网页，就可以提前新建一个文件夹：
[code]
hello-codex
[/code]

然后在 Codex App 里选择这个文件夹。

新手建议第一次选择一个干净的练习目录，不要直接 C 盘，也不要一上来就选择重要工作项目。

推荐目录结构：
[code]
AI-Codex-Projects
└── hello-codex
└── index.html
[/code]

选择项目目录后，Codex 才知道自己应该读哪些文件、改哪些文件、在哪个地方运行命令。

理解项目列表

进入 Codex App 后，左侧通常会看到项目列表。

你可以把项目列表理解成：

你交给 Codex 的不同代码文件夹。

比如：
[code]
hello-codex
ai-first-page
[/code]

每一个项目，都对应你电脑上的一个本地文件夹，或者一个 Git 仓库。

如果你之前在 Codex App、Codex CLI、Codex IDE Extension 里打开过项目，这些项目也可能会出现在列表里。

小白要记住一点：

项目列表不是聊天记录列表，而是「代码项目列表」。

你点进不同项目，Codex 看到的文件范围也不一样。

理解 thread（对话）

Thread 可以理解成：

同一个项目里的一个任务对话。

比如你在 hello-Codex 这个项目里，可以开多个 thread：
[code]
Thread 1：做一个首页
Thread 2：修复按钮点击无反应的问题
Thread 3：优化移动端样式
Thread 4：帮我写 README
[/code]

每个 thread 都有自己的上下文。

也就是说，你在 Thread 1 里让 Codex 做首页，它会围绕这个任务持续理解和修改。

你在 Thread 2 里让它修 bug，它就围绕另一个任务工作。

小白可以简单理解：

• 项目 = 一个公司
• thread = 公司里面的员工

不要把所有事情都塞进同一个 thread。

更好的做法是：

一个清楚的任务，开一个 thread。

比如：
[code]
请帮我做一个个人主页
[/code]

这是一个 thread。
[code]
请检查为什么移动端布局错位
[/code]

这是另一个 thread。

这样项目不会乱，Codex 也更容易理解任务边界。

理解任务窗口

任务窗口就是你和 Codex 对话、安排工作的地方。

你可以在这里输入任务，比如：
[code]
请帮我做一个简单网页，黑色背景，中间显示 Hello, Codex。
[/code]

也可以继续追问：
[code]
请把这个页面改得更像科技产品首页。
[/code]

任务窗口里通常会出现这些内容：

内容	作用
你的任务描述	告诉 Codex 要做什么
Codex 的计划	它准备怎么做
Codex 的执行过程	它正在看文件、改文件、运行命令
Codex 的总结	它最后改了什么
后续输入框	你可以继续让它修改

第一次使用时，不要写太复杂的任务。

不推荐：
[code]
帮我做一个完整的 AI 工具平台，要有登录、支付、数据库、后台管理。
[/code]

推荐：
[code]
请帮我做一个简单的产品介绍页，只用 HTML 和 CSS。
[/code]

任务越清楚，Codex 越容易做好。

理解 review pane

Review pane 可以理解成：

检查 Codex 改了什么的地方。

Codex 改完文件后，你不要只看它的文字总结，而是要打开 review pane 看实际改动。

它会告诉你：

• 哪些文件被修改了
• 哪些地方新增了代码
• 哪些地方删除了代码
• 哪些改动可以接受
• 哪些改动可以退回

小白可以把 review pane 理解成：

Codex 的「作业检查区」。

你不是让 Codex 写完就直接相信，而是要在这里检查它到底交了什么作业。

如果你看到某一行代码不满意，可以在对应位置留下评论，让 Codex 按照你的评论继续修改。

比如你可以评论：
[code]
这里的按钮颜色太亮了，改成更克制的深蓝色。
[/code]

或者：
[code]
这段代码太复杂，请改成新手更容易理解的写法。
[/code]

理解 diff

Diff 是代码改动对比。

小白可以这样理解：
[code]
绿色 = 新增内容
红色 = 删除内容
[/code]

比如 Codex 原来没有写标题，后来加了一行：
[code]

Hello, Codex

[/code]

这行就会显示为新增。

如果 Codex 删除了一段旧代码，那段就会显示为删除。

Diff 的作用是让你看清楚：

Codex 到底改了什么。

不要只看最终页面，也不要只看 Codex 的总结。

真正重要的是看 diff。

因为 Codex 有时候可能会：

• 顺手改了你没要求改的地方
• 删除了某些你还需要的代码
• 把简单代码改复杂
• 修改了多个文件但没有说清楚

所以第一次上手就要养成习惯：
[code]
每次 Codex 完成任务后，先看 diff，再决定要不要接受。
[/code]

第一次打开后的推荐操作流程

第一次打开 Codex App，可以按这个顺序操作：
[code]
1. 登录 ChatGPT
2. 选择一个练习项目目录
3. 新建或选择一个 thread
4. 在任务窗口输入一个简单任务
5. 等 Codex 修改文件
6. 打开 review pane
7. 查看 diff
8. 确认没有问题后再继续修改
[/code]

推荐第一个任务：
[code]
请帮我做一个简单网页，要求：
1. 黑色背景
2. 页面中间显示大字 Hello, Codex
3. 字体白色
4. 页面整体水平和垂直居中
5. 只使用 HTML 和 CSS
[/code]

这个任务足够简单，适合用来熟悉 Codex App 的基本流程。

小白需要记住的几个概念

概念	简单理解
项目目录	你公司的地址
项目列表	你公司的项目部门
thread	一个项目部门的员工
任务窗口	给员工下指令的地方
review pane	检查改动的地方
diff	新增和删除的代码对比

Codex App 的基础使用

基础布局

可以看到 Codex App 是经典的三栏布局

左侧是任务列表

中间是对话窗口

右侧是多功能区域

新对话

使用项目

我们可以开启一个新对话来执行一个新的任务

开启新对话后需要选择新对话属于哪个项目

当然我们也可以直接在项目右侧的小按钮那里点击，直接开启对应项目的一个新对话。

不使用项目

点击不使用项目，对应的会话会显示在对话里面，可以作为想问和项目无关的问题

搜索

后期任务对话太多了，但是只记得一些关键次找不到对应的任务对话了，可以直接在搜索这里，搜关键词，就会查找到对应的任务对话了

插件

功能较多，后续再讲

自动化

功能较多，后续再讲

项目

创建项目

可以在Codex中直接创建一个新项目，也可以使用现有的项目

创建或选择好的项目会出现在项目栏里面，方便后续的管理

thread

thread 是一个项目里的「单独任务对话」

比如你有一个项目叫：
[code]
hello-codex
[/code]

你可以在这个项目里开多个 thread：

Thread	代表的任务
Thread 1	做一个首页
Thread 2	修复按钮点击没反应
Thread 3	优化移动端样式
Thread 4	帮我写 README
Thread 5	检查项目有没有报错

你可以这样理解：
[code]
Project 项目 = 一个代码文件夹
Thread = 这个项目里的一个具体任务
[/code]

比如：
[code]
项目：小红书封面生成器
Thread 1：做首页
Thread 2：修复上传图片失败
Thread 3：优化手机端布局
Thread 4：写项目说明文档
[/code]

为什么要有 thread？

因为不同任务最好分开做。

如果你把“做首页、修 bug、改样式、写文档”全塞进一个对话里，Codex 容易上下文混乱，你也不好检查它到底改了什么。

更好的用法是：
[code]
一个明确任务 = 一个 thread
[/code]

比如你要做页面：
[code]
请帮我做一个 AI 工具介绍页。
[/code]

这是一个 thread。

后面你发现按钮有问题，再新开一个 thread：
[code]
请检查为什么首页按钮点击后没有反应。
[/code]

一句话总结：

Thread 就是 Codex App 里的任务对话，一个 thread 专门处理一个具体任务。

等待批准

在我们 Codex 执行任务的时候，很多时候都会需要用户进行权限的批准

并且会在对应的对话处提示等待批准的标签

点击对应的对话后，再点击允许，Codex 就会继续进行接下来的工作了

归档

归档 Archive，可以理解成把一个已经完成、暂时不用继续处理的 thread 收起来。

它的作用不是删除代码，也不是合并代码，而是让你的任务列表更干净。

比如你做完了这些任务：
[code]
Thread 1：优化移动端样式
Thread 2：做一个首页
Thread 3：做一个首页

[/code]

其中 Thread 2、Thread 3 已经完成了，Thread 1 你也不打算用了，就可以把它们归档。

归档后，它们不会继续占据当前任务列表的位置，你的项目界面会更清爽。

取消归档，当然你也可以在设置里面找到已归档对话，将其还原回来

设置

剩余额度

在这里可以看到当前账号的额度、速率限制或使用情况。

不同套餐、工作区、模型和版本显示的限制可能不一样；具体能用多久、什么时候恢复、是否能购买额外额度，都以 Codex 当前界面和官方说明为准。

对话窗口

权限控制

沙盒（Sandbox）

要知道权限控制必须先知道一个沙盒（Sandbox）的概念

你可以把它理解成：

Codex 可以在围栏里面干活，但不能随便跑到围栏外面乱动你的电脑。

因为 Codex App 不是普通聊天工具，它可以读文件、改文件、运行命令，所以必须有一个“围栏”限制它能碰哪里、能不能联网、能不能改项目外的文件。官方文档里，Codex 的 sandbox 模式包括 read-only、workspace-write、danger-full-access 这几类，用来控制文件系统和网络访问边界。

简单来说

假设你的项目文件夹是：
[code]
D:\AI-Codex-Projects\hello-codex
[/code]

如果开启沙盒，Codex 正常只能在这个项目文件夹范围内工作，比如：
[code]
可以看 index.html
可以改 style.css
可以运行 npm run dev
[/code]

但如果它想做这些事，就可能需要你批准：
[code]
访问桌面文件
读取下载文件夹
修改项目外的文件
联网下载东西
运行高风险命令
[/code]

所以：
[code]
Sandbox = 给 Codex 设置工作边界
[/code]

三大权限

[code]
请求批准
替我审批
完全访问权限
[/code]

可以这样对应理解：

你看到的选项	和 Sandbox 的关系
请求批准	有沙盒限制，越界操作先问你
替我审批	让系统帮你自动判断一部分审批
完全访问权限	放开沙盒，可以在电脑上执行任何操作，风险最高

新手建议开启：

请求批准或自动审批类选项 。如果你是新手，优先选择不会放开项目边界的模式：让 Codex 可以在当前项目内工作，但遇到越界、联网或高风险命令时仍然停下来让你确认。不同版本里权限选项名称可能不同，核心原则是：不要一开始就开完全访问权限。

一句话总结

Sandbox 沙盒就是 Codex 的安全围栏。

它决定 Codex 能不能：
[code]
看文件
改文件
访问项目外目录
联网
运行命令
[/code]

Model 模型选择

推理强度

可以看到推理强度分为了4档，强度越高对应的推理能力越强所花的时间和token消耗也越大

选项	简单来说	适合任务
低	想得少，速度快，省额度	改文案、改颜色、小问题
中	平衡速度和质量	普通网页、简单 bug、日常开发
高	想得更深，更适合复杂问题	多文件修改、复杂 bug、重构
超高	最认真、最慢、最耗	很难的问题、架构分析、反复修不好的 bug

模型选择

这里可以选择不同的模型。模型能力、可用范围和消耗会随账号套餐、地区、版本和模型目录变化。普通任务用默认推荐模型即可；复杂任务再考虑切换更强模型或提高推理强度。

速度

有些模型或版本会提供标准 / 快速之类的服务档位。

快速模式的速度提升、额度消耗和是否可用，都以当前界面显示为准。任务很急、额度充足时可以考虑开启；日常任务不需要默认开启。

引导

可中途插入对话

当我们在AI执行的过程中，发现AI理解错了我们的意思，就不应该让它继续执行了，这时候就应该及时进行人工引导

如果不选择引导则会排队执行，只有执行完上一个任务过后，AI才会执行你发送的下一个任务

计划模式

开启计划模式后，Codex 就不会立即上手干活，而是会先整理出一份工作计划，跟我们确认了过后再开始干活

对于所有复杂任务，建议都先开启计划模式，可以查漏补缺。

多功能区

注释

在多功能的右上角区域的注释

当我们用 Codex 内置的浏览器打开了页面过后，会发现有个注释功能

可以让AI帮我们只修改页面的具体部分

---