普通人 AI 实战手册

Appearance

01 · 认识 Codex 与四种入口 ​

这一篇先解决一个最基础的问题：

Codex 到底是什么？我第一次用，应该从哪个入口开始？

你不用先理解一堆技术名词。先把 Codex 想成一个能进入项目现场的 AI 助手：它可以看文件、改文件、运行检查、解释报错，也可以和你一起把一个想法推进成真实结果。

Codex 工作流示意图

开始前先做这 3 件事 ​

这篇不用安装任何东西。 你只需要带着 3 个问题往下看：

  1. 我现在最适合从哪个入口开始？
  2. 我是想让 Codex “解释项目”，还是“直接改项目”？
  3. 如果第一次用，我应该怎么避免一上来就把任务搞大？

如果你现在还不确定，先选桌面 App。 它最直观，也最适合小白先建立感觉。

这一篇你要搞懂什么 ​

看完这一篇，你只需要搞懂 3 件事：

  1. Codex 和普通聊天 AI 有什么区别。
  2. Codex 常见的 4 个入口分别是什么。
  3. 小白第一次应该选哪个入口。

不要急着安装，也不要急着写代码。先选对入口，后面会顺很多。

第一步：先理解 Codex 在帮你做什么 ​

普通聊天 AI 更像一个老师。

你问它：

text
我想做一个网站，应该怎么做？

它会告诉你一堆建议：学 HTML、CSS，选框架，买服务器，部署上线。

这些建议可能都对，但小白听完经常还是不知道下一步点哪里。

Codex 不一样。Codex 更像你把一个懂技术的人请到电脑前：

text
这是我的项目文件夹。请你先看看里面有什么文件，不要修改。
然后告诉我这个项目现在是什么状态，下一步最小动作是什么。

它的价值不只是回答问题，而是围绕真实文件继续推进。

普通聊天和 Codex 的区别

第二步：认识 Codex 的四种入口 ​

你可以从不同地方使用 Codex。先不用都学，知道它们分别适合什么场景就行。

入口适合谁一句话理解
桌面 App小白、新手、想看得见过程的人最像“AI 工作台”，适合第一站
命令行 CLI愿意用终端、想更高效的人用文字命令启动 Codex
IDE 扩展已经在 VS Code 等编辑器里写东西的人在编辑器里边看代码边让 Codex 帮忙
云端 Codex Cloud想把任务放到云端跑的人任务可以离开本机继续处理

如果你现在不知道这些词是什么意思，没关系。先记住下面这个选择：

完全小白，优先从桌面 App 开始。

原因很简单：桌面 App 更直观，你能看到对话、文件、修改过程和结果，不容易迷路。

第三步：小白怎么选入口 ​

按你的情况选：

情况一：我完全不会编程 ​

先选：

text
桌面 App

你要练的是：打开项目文件夹、让 Codex 先解释、看它准备改哪里、再确认执行。

情况二：我会一点点命令行 ​

可以试：

text
CLI

CLI 更快，但也更容易因为路径、命令、权限搞混。新手用 CLI 时，一定要先确认当前文件夹。

情况三：我平时用 VS Code ​

可以试：

text
IDE 扩展

它适合你一边看代码，一边让 Codex 帮你解释、修改、补测试。

情况四：我想让任务在云端跑 ​

再了解：

text
Codex Cloud

云端适合更长时间的任务，但第一次学习不建议从这里开始。你先在本地把基本流程跑通，再学云端会更稳。

第四步：第一次打开 Codex 应该说什么 ​

不要一上来就说：

text
帮我做一个网站。

这句话太大，Codex 很难知道你要什么、从哪里开始、第一版做到什么程度。

更适合小白的第一句话是：

text
我是 Codex 新手，不会编程。

请你先不要修改任何文件，先帮我看一下当前项目。

请按下面格式回复：
1. 你看到了哪些主要文件和文件夹
2. 这个项目大概是做什么的
3. 你还不确定哪些信息，需要我补充
4. 如果我要继续做下去，下一步最小、最安全的动作是什么

这段话里最重要的是：

  1. 先声明自己是新手。
  2. 先限制它不要改文件。
  3. 让它先解释现状。
  4. 让它给最小下一步。

第五步：知道哪些事适合交给 Codex ​

Codex 适合帮你做这些事：

你想做的事适合让 Codex 怎么帮
看不懂项目文件夹让它先解释目录结构
想做一个教程网站让它先问需求，再列计划
页面文案不好让它只改某一段文案
出现报错把报错给它，让它解释原因
想改代码让它先说明准备改哪个文件
做完不知道对不对让它运行检查并总结结果

Codex 不适合一上来做这些事：

不建议的新手操作为什么
直接让它做完整大项目范围太大，你看不懂过程
让它随便清理电脑文件有误删风险
复制执行看不懂的命令可能删除、覆盖、移动文件
不看 diff 就接受修改你不知道它到底改了哪里

第六步：记住后面所有章节的学习节奏 ​

后面每一篇，你都按这个节奏学：

  1. 先知道这一篇解决什么问题。
  2. 再照着步骤做。
  3. 中间遇到不懂的词，先不用停太久。
  4. 做完以后看检查清单。
  5. 最后知道下一篇学什么。

这个手册不是百科，不适合跳来跳去背概念。

第一遍最好的方式是：顺着做。

常见错误 ​

错误一：把 Codex 当普通聊天工具。

更好的做法：让它围绕项目文件工作，而不是只问抽象问题。

错误二：四个入口一起学。

更好的做法：小白先学桌面 App，再慢慢了解 CLI、IDE 和云端。

错误三：第一次任务太大。

更好的做法：先让它解释项目，再做一个小修改。

错误四：不限制它的动作范围。

更好的做法：每次都说清楚“先不要修改”或“只修改某个文件”。

检查清单 ​

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

  • 我知道 Codex 不是普通聊天 AI。
  • 我知道 Codex 可以围绕项目文件工作。
  • 我知道 Codex 有桌面 App、CLI、IDE 扩展、云端四种常见入口。
  • 我知道小白优先从桌面 App 开始。
  • 我知道第一次提问要先让它读项目，不要直接乱改。

小结 ​

你现在只要记住一句话：

Codex 是能进项目现场干活的 AI 助手，小白先从桌面 App 开始。

下一篇我们再把“项目、文件、任务、上下文、diff”这些核心概念拆开讲。先把入口选对，后面上手才不会乱。