大家好,我是云途。
这是 Codex 系统教学的第一节。我们先认识 Codex,再判断什么任务适合交给它。下载安装会放到下一节。
Chat、Work 和 Codex 都在 ChatGPT 桌面应用里,但适合处理的事情不同。入口选错以后,你可能只得到一段建议,也可能让 Codex 过早修改还没有想清楚的内容。
学完这一节,你应该能看着一项真实工作,判断应该先讨论、先整理资料,还是直接进入项目执行。
文章中还会解释“项目”“工作区”“任务”和“证据”。这些词后面会经常出现,每个词都会配一个具体例子。
这节课要完成什么
这一节我们会依次完成六件事:
- 通过一个真实问题,理解 Codex 与普通问答的区别;
- 认识当前 Chat、Work 和 Codex 三个入口各自更适合做什么;
- 分清项目、工作区和一次任务分别指什么;
- 用“读取、执行、验证、报告”理解 Codex 怎样完成任务;
- 把一句模糊愿望改写成有范围、有验收的可执行任务;
- 打开一个安全练习文件夹,完成第一次不修改文件的工作区盘点。
这节课不要求你懂编程。我们先把工具的位置和责任边界弄清楚,下一节再正式完成安装、登录和第一个项目的准备。
先从一个真实问题开始
假设你现在有一个网站项目。你想知道首页为什么在手机上出现横向滚动,并希望有人找到原因、修改代码、重新打开页面检查,最后告诉你改了哪些文件。
如果是在普通对话里,你可能会得到一些常见原因:固定宽度、图片溢出、定位元素超出屏幕,或者某个组件没有正确换行。这些建议可能有用,但它并没有看见你的真实项目,也不能证明问题究竟出在哪里。
Codex 的不同之处,是它可以进入你授权的项目环境:
- 读取项目规则和相关文件;
- 找到真正造成问题的代码;
- 在允许范围内修改文件;
- 运行检查或打开页面验证;
- 把改动、证据和仍未覆盖的风险交给你复核。
Codex 可以进入你指定的项目,使用工具完成工作,并把结果交给你检查。目标是什么、哪些内容不能碰,以及高风险操作是否允许,仍然需要由你决定。
你提出目标与边界
↓
Codex 读取工作区与项目规则
↓
Codex 调查现状并说明计划
↓
Codex 在允许范围内执行
↓
测试 / 页面 / 文件证明结果
↓
你根据证据完成最终判断现在的 Chat、Work 和 Codex 分别是什么
当前的 ChatGPT 桌面应用把 Chat、Work 和 Codex 放在了同一个应用里。你可以把它们理解成三种工作入口。
先讨论和理解
适合快速提问、解释概念、梳理想法和讨论判断,不一定需要进入真实项目执行。
处理通用复杂工作
适合围绕资料、网页和办公成果研究信息,生成文档、表格、演示文稿或网站。
进入持续存在的项目
适合读取真实环境、修改文件、运行工具、验证结果,并按照项目规则持续推进。
Codex 会围绕一个明确的工作区读取现状、使用工具、改变结果,并留下可以检查的记录。它能写代码,也能整理长期存在的内容项目。
因此,不会编程的人同样可以使用 Codex。你不需要亲自写出每一行代码,但必须能够说明自己想得到什么、哪些东西不能碰,以及怎样判断结果是否可信。
同一个主题,也可能从不同入口开始
先在 Chat 里讨论“学习中心应该有哪些板块”,把目标用户和内容边界想清楚。
在 Work 里整理调研材料,形成课程结构、比较表或完整研究报告。
进入 Codex,让它读取 v4 项目、修改对应页面、运行检查并提供截图证据。
先分清项目、工作区和任务
这三个词听起来接近,但它们决定了 Codex 在哪里工作、能看到什么,以及本轮究竟要完成哪一件事。
项目:长期存在的工作对象
项目可以是一套网站源码、一个桌面软件、一个课程资料库,也可以只是一个包含几份文档的文件夹。它通常会跨越多次对话持续存在。
工作区:本次授权给 Codex 的范围
当你选择一个文件夹或代码仓库时,这个位置就成为 Codex 判断路径和读取现状的起点。工作区太大,会混入无关资料;选错工作区,后面的任务说明写得再清楚,也可能改到错误项目。
任务:这一轮要得到的具体变化
“继续建设官网”是长期目标;“让学习中心的四个入口直接进入对应内容区,并验证 390px 手机布局”才是一项可以完成和验收的任务。
项目决定在哪里长期工作,工作区决定这次能看到哪里,任务决定这一轮做到哪里停下。
用四个动作理解 Codex
以后看到 Codex 完成一项任务,可以先不管界面上有多少功能,只看它是否完成了下面四个动作。
先看真实文件、规则、目录与运行状态。
在允许范围内修改文件、运行命令或使用工具。
重新读取、测试或重复真实操作,证明改变发生。
说明改动、结果、检查、未覆盖范围与剩余风险。
“已经修改”只是在描述动作;“页面在手机尺寸下不再出现横向滚动,并且其他三个尺寸没有受到影响”才接近结果。
四个动作分别留下什么证据
完整路径、目录结构、相关文件、项目说明和当前运行状态。
修改了哪些文件、运行了哪些命令、哪些对象明确没有触碰。
测试结果、真实页面状态、文件差异、截图或可重复的操作步骤。
已完成结果、证据位置、未覆盖范围、剩余风险与下一步选择。
用户、Codex 和证据,各自负责什么
你负责目标和边界
你需要说明最终想得到什么,哪个项目是本次真源,哪些对象可以修改,哪些动作必须先停下来确认。
Codex 负责调查、执行和说明
Codex 应先核对环境,再在授权范围内工作。遇到证据不足、范围冲突或高风险动作时,它应该说明问题,而不是替你猜一个决定。
证据负责证明结果
无论 Codex 的解释多么有信心,最终都要回到真实文件、运行结果、页面状态或可重复的操作。
这份结论,是由什么证据证明的?
三类任务,应该从哪里开始
我还没想清楚
例如:“我想给公司做一套学习中心,但不知道应该有哪些板块。”先从 Chat 或 Work 开始,重点是研究内容、讨论结构和形成判断。
我已经知道结果,需要进入真实项目
例如:“只修改这个 v4 实验项目,把已经确认的四个学习板块做成可进入的页面,不要修改正式官网。”这适合进入 Codex。
我要处理通用文件或完成一份办公成果
如果只是完成一份独立报告,Work 往往已经足够;如果它属于一个长期内容工程,需要项目规则、运行环境和持续状态,Codex 会更合适。
选择入口时,可以问自己:这次只需要讨论和整理,还是已经需要进入真实项目执行并检查结果?
把一句愿望变成可执行任务
Codex 可以帮助你调查不确定的原因,但它仍然需要知道本轮的目标、允许范围和停止条件。下面两段话都在表达“优化网站”,它们能产生的执行质量却完全不同。
【只有愿望】
帮我看看这个网站,感觉不太对,你优化一下。
【可以执行的任务】
目标:修复学习文章在 390px 手机宽度下的横向滚动。
范围:只修改 v4 实验项目的学习文章样式。
不要做:不改正式官网,不改正文,不更换品牌字体。
验收:390px、768px、1440px 均无横向溢出;标题不被裁切。
交付:列出修改文件、验证尺寸与仍未覆盖的风险。这里最重要的是把“感觉”翻译成能够观察的结果。例如“更高级”需要结合参考页面、字体、间距、亮度和交互状态继续拆解;“没有横向滚动”则可以直接在明确尺寸下验证。
第一次练习:先不让 Codex 修改任何东西
准备一个不包含私人资料、客户数据或生产配置的练习文件夹。里面可以只有一个 README.md,写上一两句说明。
Codex-First-Practice/
└── README.md我第一次使用 Codex。请先不要修改任何文件,也不要安装软件。请告诉我:当前工作区的完整路径、你能看到的文件、这个目录现在是什么状态、你可以帮助我完成哪些低风险任务,以及哪些动作需要我确认。最后只推荐一个十分钟内能完成的练习,不要直接执行。
这次练习不追求做出作品,只观察四件事:
- 它有没有说清当前工作区;
- 它有没有遵守“先不修改”;
- 它提出的练习是否足够小、结果可见、可以恢复;
- 它有没有把需要你决定的事情留给你。
一份合格的回答应该把事实、动作和建议分开。你可以用下面的示例检查它有没有只给结论,却没有给证据。
当前工作区:/Projects/codex-first-practice
读取到的内容:
└── README.md
本轮动作:只读检查,没有创建、修改或删除文件。
证据:
- README.md 内容与用户描述一致
- 修改时间未变化
- 未运行安装或写入命令
下一步建议:在 README.md 末尾增加一行练习目标,并在修改前保留原文。不要只回答“看懂了”
- 我能说出 Chat、Work 和 Codex 的主要区别;
- 我能分清项目、工作区和一次任务;
- 我知道 Codex 可以进入工作区、使用工具并完成任务;
- 我知道读取、执行、验证和报告是一次完整交付的四个动作;
- 我能把一句模糊愿望写成带范围与验收的任务;
- 我知道目标与风险决定仍然由我负责;
- 我完成了一次不修改文件的工作区盘点。