打开对的地方
知道 Codex 能看哪些文件，不能看哪些文件。
CODEX · ZERO TO ONE
第一次用 Codex，
先别学代码。
从“会提需求”到“能验收结果”的纯小白入门课
90 分钟24 个场景桌面 App 为主线
学习承诺
今天只练一件事：
独立完成一条真实任务。
说清要的结果
不学提示词魔法，只把目标、材料、边界说清楚。
检查完成证据
路径、测试、页面、回执，必须至少看到一种。
A better mental model
Codex 是能在边界内动手的工作搭档。
你
→
上下文
→
Codex
→
结果 + 证据
先看地图
同一个 Codex，有四个工作入口。
桌面 App
聊天、文件、Review、终端、浏览器都在一个界面。
CLI
在终端工作，适合已经习惯命令行的人。
IDE
贴着代码编辑器工作，适合开发者边写边改。
Cloud
在隔离的云环境执行任务，不等于直接控制你的电脑。
第一次设置
第一次开始，只做三件事。
安装并登录
打开桌面 App，用 ChatGPT 账号登录。官方入口：
learn.chatgpt.com/docs/app
选择 Codex
新建任务时选择 Codex。普通聊天只回答问题，Codex 可以在授权范围内动手。
打开练习文件夹
按 Cmd/Ctrl + O，先用一个可复制、可恢复、没有秘密的小文件夹。
The six zones
界面不用全背：先认六个区域。
② 当前工作区④ 权限
③ 对话与执行过程
⑤ Review终端浏览器
⑥ 在这里描述任务、拖入文件、继续追问
零基础词典
听懂 8 个词，你就不会迷路。
Task一次明确成果
Chat完成任务的对话记录
Project相关任务与资料的容器
Workspace这次允许工作的文件范围
Repo用 Git 管理的项目文件夹
Diff修改前后发生了什么
Tool读写、命令、浏览器等能力
Approval越过边界前向你申请
最重要的第一步
选错文件夹，后面的努力全会跑偏。
Macintosh HD
└── Users
└── 整个主目录
├── Documents
├── Photos
└── Secrets
└── Users
└── 整个主目录
├── Documents
├── Photos
└── Secrets
Desktop
└── Codex-Practice
├── source.txt
├── images/
└── output/
└── Codex-Practice
├── source.txt
├── images/
└── output/
不用背咒语
第一条提示词，写四块就够了。
目标最终要得到什么
材料看哪些文件或页面
边界什么不能改、不能做
验收什么证据算完成
把 source.txt 整理成一份新手能读懂的单页 HTML。保留原文事实，不修改 source.txt；输出到 output/index.html。完成前检查页面能打开、没有控制台错误，并告诉我文件路径。
Plan before action
不会描述，就先让 Codex 采访你。
/plan
1你最终要给谁使用？
2哪些内容必须保留，哪些不能碰？
3看到什么结果，你才愿意确认完成？
它在后台做什么
Codex 在跑一条闭环，不是在变魔术。
01检查读文件、看目录、理解现状
02计划决定改什么、先后顺序
03执行写文件、运行工具、调用能力
04验证测试、预览、读回、对比
05交付结果路径、证据、未完成边界
先安全，再自动
权限弹窗不是报错，是边界在工作。
Sandbox
技术边界：它能读写哪里、命令能不能联网。
Approval
决策边界：什么时候必须停下来请你批准。
Ask for approval · 新手推荐
Approve for me · 自动审查
Full access · 先别用
Evidence over confidence
“完成了”不算完成；证据才算。
✓文件结果
/absolute/path/output.html✓代码结果
tests: 18 passed · lint: clean✓网页结果
exact URL · rendered · console 0 errors✓外部操作
ID · status · readback✓未完成边界
blocked / skipped / needs approval不用会写代码，也能看修改
Review 面板是你验收文件的地方。
BEFORE
- 标题：欢迎来到我们的网站 正文：这里是产品介绍。AFTER
+ 标题：3 分钟看懂你的成本 正文：这里是产品介绍。只改标题，正文保持原样 ✓一个看过程，一个看结果
终端和浏览器，是两种不同的验收窗口。
$ npm test
✓ 18 tests passed
$ npm run build
✓ build completed
✓ 18 tests passed
$ npm run build
✓ build completed
http://localhost:3000
页面已真实渲染 ✓
把材料给对，比提示词华丽更重要
上下文有三种：文件、图片、互联网。
文件
文档、PDF、表格、代码。说明看哪一部分、输出什么格式。
图片
截图、设计稿、报错画面。指出要看哪个区域，不要只扔一张图。
互联网
需要最新事实时明确说“搜索、给出处、标注日期”。
可交付：Documents · PDF · Sheets · Slides · HTML · Sites · Visualizations · Images
Choose the right layer
一次指令、长期规则、重复流程、外部工具，不是一回事。
Prompt只影响当前任务“这次不要发布，只生成草稿。”
AGENTS.md项目长期规则目录结构、测试命令、禁止事项、完成标准
Skill可重复的方法把同一套步骤、模板和校验封装起来
Plugin可安装能力包可以包含 Skills、连接器、MCP、界面资源
MCP / App外部数据与动作连接 GitHub、Drive、Figma 等真实系统
自动化顺序
先手工跑通，再交给自动化。
→
→
Skills 定义“怎么做”；Scheduled 定义“什么时候做”。
Git 项目的安全并行
Worktree 让后台任务不碰你正在改的文件。
你正在工作的版本
继续打开、运行、修改你手上的文件。
HANDOFF
⇄
⇄
Codex 的独立副本
并行修改，不干扰本地当前工作；确认后再交接回来。
Four expensive mistakes
新手最容易犯的不是技术错，是范围错。
×
打开了太大的文件夹资料噪音大，误改范围也大。
×
只说“帮我优化一下”目标、边界、验收全部缺失。
×
一开始就给 Full access还没看懂流程，就扩大了后果。
×
相信“已完成”却不验收本地文件、预览地址、真实发布被混为一谈。
小白排错梯子
失败时按这个顺序查，别一上来重装。
工作区对吗？目标文件是不是根本不在当前文件夹。
权限够吗？写入、联网、浏览器、系统控制是否被拦截。
登录和连接有效吗？Plugin、MCP、网站账号是否真的授权。
环境能运行吗？依赖、命令、端口、服务器是否存在。
事实是最新的吗？价格、规则、版本、页面是否需要联网核对。
验收标准清楚吗？它可能做了事，但没有做到你真正要的结果。
Practice 01 · 非技术任务
练习一：整理一个安全的测试文件夹。
20MINUTES
先盘点当前文件夹，只读，不要移动或删除。按“文件名、类型、大小、建议分类”做成 inventory.md。列出重复或可疑文件，但不处理。完成前核对文件数量，并告诉我清单路径。
Practice 02–03 · 构建与审计
再做两个练习，你就真正入门了。
做一个能打开的页面
把一份文字做成单页 HTML。必须本地预览、检查手机尺寸、控制台零错误，并保留源文件。
做一次只读审计
检查一个项目“做到了什么、没做到什么、证据在哪里”。先不修复，只交付问题清单。