在数字化出海与一人公司业务落地中,掌握 新手最为推荐、功能最强大的 Codex 的底层逻辑与实操细节至关重要。本文将结合一线实战经验进行全链路复盘。
2.2 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
Microsoft Store中Codex应用的页面
4. 点击「获取」或「安装」(这里我已经安装过了所以显示的是打开) 5. 打开 Codex App 6. 到这里Codex App已经安装完成
第一次打开 Codex App
选择项目目录
第一次打开 Codex App 后,登录完成,系统会让你选择一个项目目录。
这里的「项目目录」,可以理解成:
Codex 要进入哪个文件夹工作。
比如你想让 Codex 帮你做一个网页,就可以提前新建一个文件夹:
hello-codex
然后在 Codex App 里选择这个文件夹。
新手建议第一次选择一个干净的练习目录,不要直接 C 盘,也不要一上来就选择重要工作项目。
推荐目录结构:
AI-Codex-Projects
└── hello-codex
└── index.html
选择项目目录后,Codex 才知道自己应该读哪些文件、改哪些文件、在哪个地方运行命令。

理解项目列表
进入 Codex App 后,左侧通常会看到项目列表。
你可以把项目列表理解成:
你交给 Codex 的不同代码文件夹。
比如:
hello-codex
ai-first-page
每一个项目,都对应你电脑上的一个本地文件夹,或者一个 Git 仓库。
如果你之前在 Codex App、Codex CLI、Codex IDE Extension 里打开过项目,这些项目也可能会出现在列表里。
小白要记住一点:
项目列表不是聊天记录列表,而是「代码项目列表」。
你点进不同项目,Codex 看到的文件范围也不一样。
Codex App的界面左侧菜单栏
理解 thread(对话)
Thread 可以理解成:
同一个项目里的一个任务对话。
比如你在 hello-Codex 这个项目里,可以开多个 thread:
Thread 1:做一个首页
Thread 2:修复按钮点击无反应的问题
Thread 3:优化移动端样式
Thread 4:帮我写 README

每个 thread 都有自己的上下文。
也就是说,你在 Thread 1 里让 Codex 做首页,它会围绕这个任务持续理解和修改。
你在 Thread 2 里让它修 bug,它就围绕另一个任务工作。
小白可以简单理解:
– 项目 = 一个公司 – thread = 公司里面的员工
不要把所有事情都塞进同一个 thread。
更好的做法是:
一个清楚的任务,开一个 thread。
比如:
请帮我做一个个人主页
这是一个 thread。
请检查为什么移动端布局错位
这是另一个 thread。
这样项目不会乱,Codex 也更容易理解任务边界。
理解任务窗口
任务窗口就是你和 Codex 对话、安排工作的地方。
你可以在这里输入任务,比如:
请帮我做一个简单网页,黑色背景,中间显示 Hello, Codex。

也可以继续追问:
请把这个页面改得更像科技产品首页。
任务窗口里通常会出现这些内容:
| 内容 | 作用 |
|---|---|
| 你的任务描述 | 告诉 Codex 要做什么 |
| Codex 的计划 | 它准备怎么做 |
| Codex 的执行过程 | 它正在看文件、改文件、运行命令 |
| Codex 的总结 | 它最后改了什么 |
| 后续输入框 | 你可以继续让它修改 |
第一次使用时,不要写太复杂的任务。
不推荐:
帮我做一个完整的 AI 工具平台,要有登录、支付、数据库、后台管理。
推荐:
请帮我做一个简单的产品介绍页,只用 HTML 和 CSS。
任务越清楚,Codex 越容易做好。
理解 review pane
Review pane 可以理解成:
检查 Codex 改了什么的地方。
Codex 改完文件后,你不要只看它的文字总结,而是要打开 review pane 看实际改动。

它会告诉你:
– 哪些文件被修改了 – 哪些地方新增了代码 – 哪些地方删除了代码 – 哪些改动可以接受 – 哪些改动可以退回
小白可以把 review pane 理解成:
Codex 的「作业检查区」。
你不是让 Codex 写完就直接相信,而是要在这里检查它到底交了什么作业。
如果你看到某一行代码不满意,可以在对应位置留下评论,让 Codex 按照你的评论继续修改。
比如你可以评论:
这里的按钮颜色太亮了,改成更克制的深蓝色。
或者:
这段代码太复杂,请改成新手更容易理解的写法。
理解 diff
Diff 是代码改动对比。

小白可以这样理解:
绿色 = 新增内容
红色 = 删除内容
比如 Codex 原来没有写标题,后来加了一行:
Hello, Codex
这行就会显示为新增。
如果 Codex 删除了一段旧代码,那段就会显示为删除。
Diff 的作用是让你看清楚:
Codex 到底改了什么。
不要只看最终页面,也不要只看 Codex 的总结。
真正重要的是看 diff。
因为 Codex 有时候可能会:
– 顺手改了你没要求改的地方 – 删除了某些你还需要的代码 – 把简单代码改复杂 – 修改了多个文件但没有说清楚
所以第一次上手就要养成习惯:
每次 Codex 完成任务后,先看 diff,再决定要不要接受。
第一次打开后的推荐操作流程
第一次打开 Codex App,可以按这个顺序操作:
1. 登录 ChatGPT
2. 选择一个练习项目目录
3. 新建或选择一个 thread
4. 在任务窗口输入一个简单任务
5. 等 Codex 修改文件
6. 打开 review pane
7. 查看 diff
8. 确认没有问题后再继续修改
推荐第一个任务:
请帮我做一个简单网页,要求:
1. 黑色背景
2. 页面中间显示大字 Hello, Codex
3. 字体白色
4. 页面整体水平和垂直居中
5. 只使用 HTML 和 CSS
这个任务足够简单,适合用来熟悉 Codex App 的基本流程。
小白需要记住的几个概念
| 概念 | 简单理解 |
|---|---|
| 项目目录 | 你公司的地址 |
| 项目列表 | 你公司的项目部门 |
| thread | 一个项目部门的员工 |
| 任务窗口 | 给员工下指令的地方 |
| review pane | 检查改动的地方 |
| diff | 新增和删除的代码对比 |
Codex App 的基础使用
基础布局
可以看到 Codex App 是经典的三栏布局
左侧是任务列表
中间是对话窗口
右侧是多功能区域

新对话
使用项目
我们可以开启一个新对话来执行一个新的任务
开启新对话后需要选择新对话属于哪个项目

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

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

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

插件
功能较多,后续再讲
自动化
功能较多,后续再讲
项目
创建项目
可以在Codex中直接创建一个新项目,也可以使用现有的项目
创建或选择好的项目会出现在项目栏里面,方便后续的管理

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

比如你有一个项目叫:
hello-codex
你可以在这个项目里开多个 thread:
| Thread | 代表的任务 |
|---|---|
| Thread 1 | 做一个首页 |
| Thread 2 | 修复按钮点击没反应 |
| Thread 3 | 优化移动端样式 |
| Thread 4 | 帮我写 README |
| Thread 5 | 检查项目有没有报错 |
你可以这样理解:
Project 项目 = 一个代码文件夹
Thread = 这个项目里的一个具体任务
比如:
项目:小红书封面生成器
Thread 1:做首页
Thread 2:修复上传图片失败
Thread 3:优化手机端布局
Thread 4:写项目说明文档
为什么要有 thread?
因为不同任务最好分开做。
如果你把“做首页、修 bug、改样式、写文档”全塞进一个对话里,Codex 容易上下文混乱,你也不好检查它到底改了什么。
更好的用法是:
一个明确任务 = 一个 thread
比如你要做页面:
请帮我做一个 AI 工具介绍页。
这是一个 thread。
后面你发现按钮有问题,再新开一个 thread:
请检查为什么首页按钮点击后没有反应。
一句话总结:
Thread 就是 Codex App 里的任务对话,一个 thread 专门处理一个具体任务。
等待批准
在我们 Codex 执行任务的时候,很多时候都会需要用户进行权限的批准
并且会在对应的对话处提示等待批准的标签
点击对应的对话后,再点击允许,Codex 就会继续进行接下来的工作了

归档
归档 Archive,可以理解成把一个已经完成、暂时不用继续处理的 thread 收起来。
它的作用不是删除代码,也不是合并代码,而是让你的任务列表更干净。

比如你做完了这些任务:
Thread 1:优化移动端样式
Thread 2:做一个首页
Thread 3:做一个首页
其中 Thread 2、Thread 3 已经完成了,Thread 1 你也不打算用了,就可以把它们归档。
归档后,它们不会继续占据当前任务列表的位置,你的项目界面会更清爽。
取消归档,当然你也可以在设置里面找到已归档对话,将其还原回来
Codex App中“已归档对话”界面
设置
剩余额度
在这里可以看到当前账号的额度、速率限制或使用情况。
不同套餐、工作区、模型和版本显示的限制可能不一样;具体能用多久、什么时候恢复、是否能购买额外额度,都以 Codex 当前界面和官方说明为准。

对话窗口
权限控制
沙盒(Sandbox)
要知道权限控制必须先知道一个沙盒(Sandbox)的概念
你可以把它理解成:
Codex 可以在围栏里面干活,但不能随便跑到围栏外面乱动你的电脑。
因为 Codex App 不是普通聊天工具,它可以读文件、改文件、运行命令,所以必须有一个“围栏”限制它能碰哪里、能不能联网、能不能改项目外的文件。官方文档里,Codex 的 sandbox 模式包括 read-only 、 workspace-write 、 danger-full-access 这几类,用来控制文件系统和网络访问边界。
简单来说
假设你的项目文件夹是:
D:\AI-Codex-Projects\hello-codex
如果开启沙盒,Codex 正常只能在这个项目文件夹范围内工作,比如:
可以看 index.html
可以改 style.css
可以运行 npm run dev
但如果它想做这些事,就可能需要你批准:
访问桌面文件
读取下载文件夹
修改项目外的文件
联网下载东西
运行高风险命令
所以:
Sandbox = 给 Codex 设置工作边界
三大权限

请求批准
替我审批
完全访问权限
可以这样对应理解:
| 你看到的选项 | 和 Sandbox 的关系 |
|---|---|
| 请求批准 | 有沙盒限制,越界操作先问你 |
| 替我审批 | 让系统帮你自动判断一部分审批 |
| 完全访问权限 | 放开沙盒,可以在电脑上执行任何操作,风险最高 |
新手建议开启:
请求批准或自动审批类选项 。如果你是新手,优先选择不会放开项目边界的模式:让 Codex 可以在当前项目内工作,但遇到越界、联网或高风险命令时仍然停下来让你确认。不同版本里权限选项名称可能不同,核心原则是:不要一开始就开完全访问权限。
一句话总结
Sandbox 沙盒就是 Codex 的安全围栏。
它决定 Codex 能不能:
看文件
改文件
访问项目外目录
联网
运行命令
Model 模型选择
推理强度
可以看到推理强度分为了4档,强度越高对应的推理能力越强所花的时间和token消耗也越大
Codex App中“做一个首页”任务的对话窗口界面
| 选项 | 简单来说 | 适合任务 |
|---|---|---|
| 低 | 想得少,速度快,省额度 | 改文案、改颜色、小问题 |
| 中 | 平衡速度和质量 | 普通网页、简单 bug、日常开发 |
| 高 | 想得更深,更适合复杂问题 | 多文件修改、复杂 bug、重构 |
| 超高 | 最认真、最慢、最耗 | 很难的问题、架构分析、反复修不好的 bug |
模型选择
这里可以选择不同的模型。模型能力、可用范围和消耗会随账号套餐、地区、版本和模型目录变化。普通任务用默认推荐模型即可;复杂任务再考虑切换更强模型或提高推理强度。

速度
有些模型或版本会提供标准 / 快速之类的服务档位。
快速模式的速度提升、额度消耗和是否可用,都以当前界面显示为准。任务很急、额度充足时可以考虑开启;日常任务不需要默认开启。

引导
可中途插入对话
当我们在AI执行的过程中,发现AI理解错了我们的意思,就不应该让它继续执行了,这时候就应该及时进行人工引导
如果不选择引导则会排队执行,只有执行完上一个任务过后,AI才会执行你发送的下一个任务

计划模式
开启计划模式后,Codex 就不会立即上手干活,而是会先整理出一份工作计划,跟我们确认了过后再开始干活
对于所有复杂任务,建议都先开启计划模式,可以查漏补缺。

Codex App中“极简动效增强计划”的对话窗口
多功能区
注释
在多功能的右上角区域的注释
当我们用 Codex 内置的浏览器打开了页面过后,会发现有个注释功能
可以让AI帮我们只修改页面的具体部分

Codex App的界面,左侧为项目列表,右侧是“Hello, Codex.”的页面

💎 【独家资源】火儿跨境科技 VIP 资料会员:
解锁全站 500+ 实战提示词库、自动化工作流脚本、商业源码与高阶专属圈子,持续沉淀一人公司数字资产。
👉 立即开通 VIP 资料会员(月度订阅 $9.99,即刻畅享核心工具箱) | 查看会员权益与等级说明
🚀 【体系大课】火儿跨境科技 官方实战课程:
告别零散摸索,全案拆解从建站、SEO长效获客到海外广告变现的工业级闭环流水线。
👉 《谷歌SEO优化系统课程》 | 《谷歌广告全系统基础夯实课》 | 《Facebook广告投放基础夯实课》 | 查看全部实战课程专区
💡 进阶指引:本文属于《03Codex从入门到实战》系统实操专栏。如需全面掌握从零构建智能体协作开发环境与自动化工程流水线,欢迎查阅对应大盘母舰专题:AI智能体团队协同。





