心态准备
在动手装工具之前,先把三件事在脑子里捋清楚:Codex 跟其他 AI 工具的不同,你和它的协作边界,以及零基础读者最容易栽进去的三个误区。这一章不让你做任何事——只让你心里有数。
1.1 为什么是 2026 年才能这样做
以前你对 AI 说“帮我做一个落地页”,它可能会给你一大段代码。看起来很厉害,但你不知道把代码放哪、怎么打开、哪里错了、怎么上线。结果就是:代码有了,产品没有。
现在的变化在于,Codex 不只是“回答代码”。它可以在你的项目文件夹里读文件、改文件、运行命令、看错误、再修一轮。它更像一个能动手的助手。
这就是为什么零基础读者现在可以先做出东西。你不需要一开始懂所有技术细节,但你需要学会把任务说清楚,并用工具提供的安全边界一点点推进。
1.2 三个根本性误解
开始前,先把三个常见误解拆掉。
误解一:我得先学会 HTML/CSS/JS
不用。至少在这本教程里不用。
你现在要做的不是参加程序员面试,而是做出一个可用页面。你只需要能看懂大概结构:哪块是标题、哪块是按钮、哪块是价格、哪块是表单。细节交给 Codex 写,你负责判断效果是不是你要的。
误解二:AI 会出错,所以不能用
AI 确实会出错。问题不是“它会不会出错”,而是“出错后能不能发现、能不能回退、能不能修”。
这本教程会反复教你三件事:让 Codex 每次只改一小块,改完看 diff,满意后提交保存点。这样即使它改坏了,也只是小范围问题,不是灾难。
误解三:我必须有 Mac
不用。Mac 和 Windows 都可以。Mac 在很多教程里出现更多,只是因为开发者常用,不是因为 Windows 做不了。
如果你是 Windows 用户,前面新加的 App 教程更适合作为入口。桌面端 App 可以减少你直接面对命令行的压力。后面 CLI 章节也会尽量给出 Windows 路径。
1.3 工具选择:为什么是 Codex CLI 而不是 Cursor / Copilot
你可能听过 Cursor、GitHub Copilot、ChatGPT、Claude Code。它们都能帮你写代码,但体验不一样。
| 工具 | 更像什么 | 适合谁 |
|---|---|---|
| Codex App | 带界面的项目工作台 | 完全零基础,想先看得见改动的人。 |
| Codex CLI | 终端里的动手助手 | 愿意学一点终端,想跑完整开发流程的人。 |
| Cursor / Copilot | 编辑器里的智能副驾驶 | 已经在写代码,需要边写边补全的人。 |
| 普通聊天 AI | 坐在旁边解释的人 | 问概念、写文案、想方案很适合,但不直接操作项目。 |
这本 CLI 教程选择 Codex CLI,是因为它能把“说话”和“真实项目操作”连起来。你在当前目录启动它,它就知道自己应该围绕这个项目工作。
但这不代表 App 不重要。恰好相反:零基础读者可以先读 App 教程,等知道项目、线程、diff、权限这些概念后,再来学 CLI 会舒服很多。
1.4 你是导演,Codex 是剧组
这是整本教程最重要的心智模型。
你不是“向 AI 求作业答案的人”。你是导演。Codex 是剧组。剧组会摄影、灯光、剪辑,但它不知道你想拍喜剧还是纪录片,不知道你喜欢克制还是热闹,也不知道哪些东西对你不能动。
所以你给 Codex 的话,最好包含三类信息:
- 我要什么:做一个什么页面、解决什么问题。
- 我不要什么:不要复杂后端、不要花哨动画、不要改其他文件。
- 怎么验收:手机能看、按钮能点、链接能打开、文案更口语。
当 Codex 问你问题时,不要慌。很多时候它不是不懂,而是在提醒你:这里需要你这个导演做决策。
1.5 安全感来自哪里
新手最怕的是“我让它一改,电脑会不会坏了”。安全感来自三道防线。
沙盒会限制 Codex 能碰哪里。默认情况下,它主要在当前项目范围里工作,不是随便翻你整台电脑。
当 Codex 要做更敏感的事,比如联网、安装、访问项目外目录,它应该停下来问你。
Git 像游戏存档。改坏了可以回到上一个保存点,所以你不必把每次修改都看成生死决定。
当然,防线不是让你闭眼乱批。看到权限提示时,先问自己:这件事和当前任务有没有关系?如果没有,就拒绝或让 Codex 解释。
1.6 最稳的协作节奏
零基础读者最适合用“四拍节奏”:
- 先说目标:我要做什么,给谁用。
- 先要计划:让 Codex 列三步,你确认。
- 小步执行:一次只改一个区域或一个问题。
- 看完保存:浏览器看效果,Review 看改动,满意就提交。
不要一上来让 Codex “帮我做完整官网、顺便部署、顺便买域名、顺便写 SEO”。这不是效率高,这是把所有风险打包成一个盲盒。
拿你第 00 章写下的小项目,把它拆成三步。比如“做一个课程报名页”可以拆成:写出页面结构、填入课程文案、加报名按钮。