写在前面
这是一份非传统意义上的"编程教程"——你不会被要求记住语法、变量、循环。你会被要求把脑中的想法说清楚,然后交给一个名叫 Codex 的助手去把它变成可用的代码。
0.1 这本教程是给谁看的
这本教程是写给“我有想法,但我不会写代码”的人看的。
你可能是独立创作者、小店老板、自由职业者、运营、设计师、产品经理,或者只是心里有一个小项目一直没做出来。你不想先学半年编程,你想先看到一个能打开、能分享、能慢慢改的东西。
这本教程默认你会做几件普通电脑操作:下载安装软件、打开网页、复制粘贴、按步骤读完一节。除此之外,不要求你会 HTML、CSS、JavaScript,也不要求你知道 Git、DNS、Vercel 是什么。
它不太适合三类需求:第一,你想立刻做复杂 SaaS,有用户登录、支付、数据库、权限后台;第二,你完全不想动手,只想看概念;第三,你想系统学习传统编程语法。这些都可以以后做,但不是这本教程的第一目标。
0.2 你 7 天后会拥有什么
如果你按顺序走完核心章节,你会拥有四样东西:
一个可访问的产品官网
不是脑图,不是想法,而是浏览器里真的能打开的一页网站。
一个自己的域名
类似 yourname.com 的地址,可以发给朋友、客户或第一批用户。
一套修改流程
你知道怎么让 Codex 改文案、改样式、修问题、重新部署。
一套提需求的语言
你会把“我想要那个感觉”翻译成 Codex 能执行的任务。
这四样东西比“学会一点代码知识”更重要。知识会忘,但一旦你跑通过一次从想法到上线的闭环,你以后就知道路在哪里。
0.3 "口语化编程"到底是什么
口语化编程不是“随便说一句,AI 就完美实现”。更准确地说,它是把你的意图用自然语言讲清楚,让 Codex 去读文件、写代码、跑命令、检查结果。
你可以把自己想成导演,Codex 像剧组。导演不一定会架灯、调焦、剪片,但导演必须知道这场戏要什么感觉,不能什么都交给剧组猜。
在这套工作方式里,你的职责有三件:
- 说清目标:我要做什么,给谁用,解决什么问题。
- 做选择:两个方案里选一个,看到效果后说喜欢哪里、不喜欢哪里。
- 守边界:不让 Codex 一次改太多,不让它碰不该碰的文件或权限。
Codex 的职责也有三件:理解项目、执行修改、解释结果。你不用假装自己是程序员,但你要始终记得:你是甲方,它是执行者。
0.4 关于网络环境的现实提醒
这本教程会用到 OpenAI、GitHub、Vercel、Cloudflare 等服务。它们的访问情况会因地区、网络、账号和时间变化而变化。
我不会在教程里教你绕过网络限制,也不会假装问题不存在。你需要自行确保能正常访问你要使用的服务。一个简单判断是:如果你的浏览器能稳定打开 ChatGPT、GitHub 和 Vercel,那你大概率可以顺利走完整套流程。
0.5 三种学习节奏建议
你可以按自己的时间选一种节奏。
周六读 00-05,做出网站骨架;周日读 08-09,部署并绑定域名。适合你已经有明确项目想法。
每天 45-90 分钟,一晚一章。节奏更稳,适合边读边消化。
如果你已经打开了 Codex App,可以先看 App 教程 A0-A3,再回来走 CLI 的 02、05、08、09 四章。
无论哪种节奏,核心闭环都一样:装好工具,学会说需求,做出页面,部署上线,绑定域名。
0.6 怎么使用这本教程
这本教程里有几种固定组件,你先认识一下:
- 代码块:给终端或文件里的内容。看到“复制”按钮时,可以直接复制。
- 提示词卡片:给 Codex 说的话。你可以照抄,也可以按自己的项目改。
- 动手试试:这一节真的要做,不要只读。它是把知识变成肌肉记忆的地方。
- 常见踩坑:卡住时先看这里,很多问题不用重新问一遍。
- 附录:像工具箱,忘了命令、术语或模板时再翻。
最重要的一条:不要因为看不懂代码就停下。你现在要学的是“如何和 Codex 协作把东西做出来”,不是马上成为软件工程师。
- 用一句话写出你想做什么。
- 写出它给谁用。
- 写出你希望 7 天后能发给别人的链接长什么样。