普通人 AI 实战手册

Appearance

07 · 桌面 App 全景：小白最适合从这里开始 ​

如果你是小白，我建议你先从桌面 App 开始。

原因很简单：它最直观。

你能看到对话、项目文件夹、Codex 的计划、文件改动和检查结果。它不像命令行那样一上来就是黑色窗口，也不像 IDE 扩展那样要求你先熟悉编辑器。

Codex 桌面 App 全景示意

打开 App 后先别发大任务 ​

第一次打开桌面 App，只做一件事：

确认 Codex 看到的是正确项目。

你可以先发：

text
请告诉我当前工作区是什么。
暂时不要修改任何文件。

工作区不对，后面全都会偏。

先照着发这三句话 ​

第一次用桌面 App，可以按这个顺序发：

text
第一句：
请告诉我当前工作区是什么。暂时不要修改任何文件。
text
第二句：
请只阅读当前项目结构，用小白能听懂的话告诉我这个项目大概是做什么的。
暂时不要修改任何文件。
text
第三句：
请根据当前项目，建议一个最小练习任务。
要求只改一个文件，改完后能让我看懂 diff。

这三句话的目的，是先确认它看对地方，再让它动手。

第一步：先把桌面 App 当成工作台 ​

桌面 App 里最重要的不是按钮，而是三个区域：

  1. 工作区：Codex 当前能看到的项目文件夹。
  2. 对话线：你和 Codex 讨论任务的地方。
  3. 改动与检查：看它改了什么、跑了什么、结果如何。

第一次打开时，先不要急着发大任务。

你先确认：

text
请告诉我你当前看到的工作区是什么。暂时不要修改任何文件。

如果它说不清当前工作区，先别继续。

第二步：选择正确的项目文件夹 ​

桌面 App 的关键是工作区。

工作区选错了，后面全都会错。

比如你要做教程网站，就应该打开教程网站的项目文件夹，而不是桌面、下载目录或微信文件夹。

新手建议：

  1. 一个任务只打开一个项目文件夹。
  2. 不要打开整个电脑根目录。
  3. 不要把重要资料目录当练习目录。
  4. 第一次练习用单独的小文件夹。

可以问 Codex：

text
请先阅读当前工作区的文件结构，不要修改。
告诉我这里是否像一个项目文件夹。
如果不像，请提醒我应该重新选择什么目录。

第三步：先读项目，再让它动手 ​

桌面 App 适合交互式工作。

但你仍然要控制节奏。

推荐第一句：

text
请先阅读当前项目结构，不要修改任何文件。
用小白能听懂的话告诉我：
1. 这个项目大概是做什么的
2. 主要文件有哪些
3. 你建议下一步先做什么

这一步是为了确认 Codex 真的理解项目。

不要一上来就说“帮我全部优化一下”。

第四步：看它准备改哪里 ​

当你让 Codex 修改时，必须让它先说范围：

text
开始修改前，请先告诉我：
1. 你准备修改哪些文件
2. 每个文件为什么要改
3. 修改后我应该看到什么变化
等我确认后再动手。

如果它准备改很多文件，你可以缩小范围：

text
这次先不要改那么多。请只改一个文件，完成一个最小目标。

小白阶段，最重要的是看得懂。

第五步：学会看改动 ​

桌面 App 通常会把改动展示出来。

你重点看三件事：

  1. 它改了哪些文件。
  2. 它删掉了什么。
  3. 它新增了什么。

如果看不懂，直接问：

text
请用普通话解释这次改动。
重点告诉我：删了什么、加了什么、有没有改到我没要求的文件。

这一步比“它写得快不快”更重要。

第六步：看终端和检查结果 ​

Codex 有时会运行命令，比如构建、测试、检查页面。

你不用一开始看懂所有命令。

你先问三个问题：

text
这条命令是做什么的？
它会不会删除、覆盖或移动文件？
运行结果说明成功了，还是失败了？

如果命令失败，不要慌。

把错误信息给 Codex，让它解释：

text
请用小白能听懂的话解释这个错误。
先不要修改文件，先告诉我最可能的原因和下一步最小排查动作。

第七步：什么时候应该暂停 ​

看到这些情况，先暂停：

  1. Codex 要改很多文件。
  2. 它要执行你看不懂的命令。
  3. 它要删除、清空、覆盖文件。
  4. 它没有解释就开始动手。
  5. 它的目标和你原本说的不一样。

暂停提示词：

text
请先暂停。你刚才的动作我还没看懂。
请用普通人能听懂的话解释：你准备做什么、会影响哪些文件、有没有风险。

常见错误 ​

错误一：工作区选错。

更好的做法：第一步确认当前工作区。

错误二：让它一次做太多。

更好的做法：一次只做一个小目标。

错误三：不看改动。

更好的做法：每次都看它改了哪些文件。

错误四：看不懂也继续点确认。

更好的做法：先让它解释清楚。

检查清单 ​

读完这一篇，你应该能勾选：

  • 我知道桌面 App 适合小白入门。
  • 我知道工作区就是 Codex 当前能操作的项目文件夹。
  • 我知道开始前要确认工作区。
  • 我知道修改前要让 Codex 说明会改哪些文件。
  • 我知道看不懂改动时要暂停并让它解释。

小结 ​

桌面 App 的价值，不是按钮多，而是过程可见。

小白用它时，记住一句话：

先确认工作区，再让 Codex 读项目；先看计划，再允许修改。

下一篇讲 CLI：如果你想用命令行启动 Codex，应该怎么理解那个黑色窗口。