零基础学 AI 编程,现在最常被推荐的学习路径不是先啃三本编程书,而是先学会一套叫 Vibe Coding 的工作流。Vibe Coding 的核心是使用自然语言描述需求,让 Claude Code、Codex 这样的命令行编程助手把需求变成可以运行的项目,再通过 Superpowers 这样的技能库,把 AI 的代码生成能力约束成测试驱动、逐步重构的工程流程。这篇文章面向完全没有系统学过代码、但想用 AI 完成小工具、脚本和简单网页应用的读者。目标不是复制某个视频的演示过程,而是把一套可以反复使用的方法讲清楚:从环境准备、工具安装,到跑通第一个项目、配置技能、再处理常见报错。
如果你是从 B 站或短视频推荐里看到“2026B站推荐”“比啃书强十倍”这类标题进入这个主题,建议先放下对收益的预期。AI 编程工具确实把编码的动作门槛降得很低,但它不会替你建立调试、测试、代码审查和结构化拆解问题的能力。这篇文章要做的,是把“会看演示”变成“能复现结果”。
1. 先搞清楚 Vibe Coding 是什么,为什么它适合零基础起步
Vibe Coding 不是一个软件开发框架,而是一种人机协作的编程方式。它最核心的变化是:开发者不再逐行编写语法,而是用自然语言描述自己想要的软件行为,由 AI 负责生成实现,再由人来验证结果并继续迭代。这里的“Vibe”指的是节奏感——保持一个小步快跑的循环:描述需求、生成代码、验证输出、修正偏差、再次生成。
1.1 从自然语言到代码:Vibe Coding 的工作方式
传统的编码过程强调“输入要精确到语法”。Vibe Coding 则把重点转移到“需求要表达清楚”。同样一句“帮我写一个待办事项工具”,如果你希望 AI 生成的是命令行程序而不是网页应用,就需要在提示词里写明运行方式、数据存储方式和功能边界。
一个完整的 Vibe Coding 循环通常包含五个动作:
- 说出最终目标:你想解决什么问题,最终用户是谁。
- 限定运行环境:是命令行、Web 浏览器还是移动端。
- 指定数据和处理方式:数据存文件、数据库还是内存。
- 检查生成结果:运行程序、看输出、找异常。
- 用反馈修正:把错误信息直接贴给 AI,让它针对性地修。
这五个动作中,最容易被零基础学习者忽略的是第 4 步。很多人以为 AI 生成完代码就结束了,实际上一段代码能否运行、在边界条件下是否出错,只有运行后才能确认。AI 编程的高效,本质上来自这个“生成-验证-修正”的迭代速度,而不是来自一次性生成完美代码。
1.2 Claude Code、Codex、Superpowers 在同一条工作流里扮演什么角色
在最近的 AI 编程教程里,经常同时出现三个名词:Claude Code、Codex 和 Superpowers。它们不是同一个层级的东西,作用也不同。
| 工具 | 定位 | 典型入口 | 适合做什么 |
|---|---|---|---|
| Claude Code | Anthropic 推出的命令行编程助手 | 终端中的claude命令 | 读取项目上下文,进行多文件改造、架构调整、代码解释 |
| Codex | OpenAI 推出的命令行编程代理 | 终端中的codex命令 | 自动化执行变更,运行测试,批量修改代码 |
| Superpowers | 社区维护的开源技能库 | 安装在 Claude Code 或 Codex 的配置目录中 | 把测试驱动开发、代码审查、阅读大型代码库等经验固化为可复用技能 |
简单理解:Claude Code 和 Codex 是执行者,Superpowers 是它们的工作手册。前者决定“谁来生成代码”,后者决定“按什么流程生成代码”。没有 Superpowers 的 AI 编程也能用,但每次对话都要重新描述一遍你想要的流程;装上 Superpowers 之后,常用的工程方法论会被固化下来,AI 会在合适的场景主动触发对应的技能。
1.3 “比啃书强十倍”为什么只对了一半
零基础阶段,AI 编程在“产出可运行代码”上的确比传统看书快很多。因为你不需要先掌握完整语法,只要能把需求描述清楚,AI 就会给出可运行的文件。但这种效率提升发生在“从无到有”阶段。当你面对一个报错、一次性能瓶颈、一段需要维护的遗留代码时,仍然需要理解变量、函数、状态、依赖和网络协议这些基本概念。
所以更准确的说法是:AI 编程让零基础的人提前进入项目实践,通过项目反馈反推理论,学习曲线会比背诵语法更顺。但它不会替代“读懂自己项目”的能力。这也是为什么接下来所有步骤都要求你自己运行、自己验证,而不是让 AI 操作完就结束。
2. 开始前的准备:确认电脑环境,下载安装 Claude Code 与 Codex
在接触任何项目之前,先确认电脑能运行命令行工具。Claude Code 和 Codex 都是基于 Node.js 的 CLI 工具,安装路径并不复杂,但版本不匹配、PATH 配置错误、权限不足是新手最容易卡住的三个点。
2.1 环境要求速查表
以下是与当前主流教程一致的最小环境要求,落地前仍要对应工具的官方文档再确认一次,因为版本要求会随发布变化。
| 检查项 | 建议要求 | 检查命令 |
|---|---|---|
| 操作系统 | Windows 10/11、macOS 12+、主流 Linux 发行版 | Windows 用ver,macOS/Linux 用uname -a |
| Node.js | 建议 18 或更高版本 | node -v |
| npm | 与 Node.js 配套,建议 9+ | npm -v |
| Python | 如果练习项目使用 Python,建议 3.10+ | python --version或python3 --version |
| 终端 | Windows 使用 PowerShell 或 Windows Terminal,macOS/Linux 使用系统终端 | |
| 磁盘空间 | 至少预留 2GB 给工具缓存和项目依赖 |
如果node -v提示找不到命令,说明 Node.js 还没有安装或没有加入 PATH。Windows 上安装 Node.js 官方安装包后通常会自动配置 PATH,安装完成后需要重新打开终端让环境变量生效。
2.2 安装 Claude Code 的完整命令流程
在终端中执行以下命令安装 Claude Code:
node -v npm -v npm install -g @anthropic-ai/claude-code安装完成后,先验证版本:
claude --version如果能看到类似版本号输出,说明安装成功。接着在项目目录里启动:
mkdir ai-first-project cd ai-first-project claude第一次启动会进入登录授权流程。根据终端提示,在浏览器中打开授权链接,登录对应的 Claude 账号并确认授权。这一步的意图是让 CLI 获得使用账号模型权限的令牌。授权的本质是让终端工具替你访问模型服务,而不是把账号密码交给某个未知脚本。
登录完成后,Claude Code 会进入交互式会话。输入help可以查看内置命令,输入/exit退出。
2.3 安装 Codex 并完成命令行登录
Codex 官方提供 npm 包安装方式。以常见安装路径为例:
npm install -g @openai/codex codex --version安装完成后,在项目目录里执行:
codex login登录过程会打开浏览器,要求授权当前终端访问 Codex 服务。登录成功后,运行:
codex "列出当前目录下的文件数量"Codex 会给出一个执行计划,并向你确认是否允许运行命令。这是它和普通对话式 AI 的重要区别:它不仅改写文件,还会在终端里执行命令,所以每一步执行都需要用户确认。
2.4 安装前最容易忽略的三个点
第一个是 Node.js 版本。很多教程直接跳到npm install,但部分版本的 CLI 工具要求特定 Node.js 版本,版本太低会安装失败或运行时报语法错误。安装前先看node -v的输出。
第二个是终端权限。macOS/Linux 全局安装可能提示EACCES: permission denied,这时不要直接切换到 root 安装,更推荐修复 npm 全局目录权限,或者使用 Node 版本管理工具(如 nvm)管理 Node 环境,这样每个用户账号都有独立可写的安装目录。
第三个是下载源。如果安装过程中长时间卡住或反复超时,可以检查网络状态,也可以把 npm 源切换为更快的 registry 后重试:
npm config get registry npm config set registry https://registry.npmmirror.com npm install -g @anthropic-ai/claude-code注意 registry 会影响全局安装的下载来源,不影响工具本身的功能。如果原来的源对你的网络更稳定,用完可以改回默认值。不建议在没有任何判断的情况下反复切换源,先确认是不是下载超时,再调整配置。
3. 用最小流程把 Claude Code 跑通:从零生成一个可运行的 Python 工具
环境准备好之后,用一个小项目验证整条链路。这个项目不追求功能完整,只要求能运行、能交互、能验证结果。这里选择 Python 命令行待办工具,因为依赖最少,对零基础读者最友好。
3.1 创建项目目录并启动 Claude Code
在终端中执行:
mkdir ai-first-project cd ai-first-project claude进入 Claude Code 会话后,可以先输入/status查看当前目录和项目信息。确认它读取的目录是正确的,这决定了 AI 后续生成的代码会落在哪里。
这里有一个常见坑:如果启动时不在目标目录,AI 生成的代码会散落在上一次进入的目录里。每次开新会话前,先用pwd(Windows 用cd查看当前路径)确认所在目录。
3.2 用一段自然语言描述需求
进入会话后,输入下面这段提示词:
帮我在当前目录创建一个 Python 命令行待办事项管理工具。 要求: 1. 使用 JSON 文件保存待办数据,文件放在 data/todos.json 2. 命令行支持 add、list、done、delete 四个子命令 3. 使用 argparse 解析参数 4. 每个待办事项包含 id、内容、状态、创建时间 5. 输出信息尽量清晰,状态变化时给出提示 6. 完成后告诉我如何运行和验证这段提示词比“帮我写一个 Todo 应用”有效的原因在于:它明确了数据保存方式、命令列表、输入输出格式和验证方式。对 AI 编程来说,需求描述里的约束越多,生成结果越接近可运行状态。
3.3 运行并验证生成的代码
Claude Code 生成完成后,先不急着让 AI 继续加功能。退出会话,回到普通终端,查看文件结构:
ls -R预期会出现类似下面的结构:
data/ todos.json todo.py然后按要求运行:
python todo.py add 写一篇AI编程教程 python todo.py list python todo.py done 1 python todo.py delete 1如果一切正常,list命令会显示待办项,done会更新状态,delete会删除指定待办。只要这个闭环能跑通,就说明 Claude Code 的安装、登录、代码生成和终端执行链路全部正常。
3.4 第一个项目跑通后,一定要做这几件事
第一,让 AI 解释代码。回到 Claude Code 会话,输入:
请逐行解释 todo.py 里每个函数的作用,并用表格告诉我关键函数的输入、输出和副作用。这一步的目的是建立代码阅读能力。零基础学习者的常见误区是只关心“能不能运行”,不关心“为什么这样写”。等到程序报错时,看不懂代码会很难定位问题。
第二,用git init提交第一版代码:
git init git add . git commit -m "初始化AI生成的待办工具"第三,保存一次会话记录。Claude Code 会把历史会话保留在本地,后续可以通过/resume回到之前的会话继续对话。这样当项目变大后,AI 仍然记得之前的背景。
4. 理解 Superpowers:给编程助手装上可复用的技能工作流
单独使用 Claude Code 或 Codex 时,AI 每次都会从零理解你的需求。如果你想让它遵守固定的工程流程,比如“先写测试再写实现”,就需要在每个提示词里重复描述。Superpowers 这类技能库解决的就是这个问题:把一套经过验证的开发流程打包成技能,让 AI 在合适的场景自动调用。
4.1 Superpowers 和普通提示词的区别
普通提示词是一份一次性指令,只对当前会话生效。Superpowers 技能则是一份可复用的程序化指导文件,通常由触发条件、执行步骤、质量检查项三部分组成。
以测试驱动开发技能为例,AI 看到“我要实现某个功能”的请求后,如果技能文件里定义了 TDD 触发条件,它就会按照以下顺序执行:
- 先列出功能需求和测试用例。
- 编写一个会失败的测试。
- 运行测试,确认失败信息符合预期。
- 编写最小实现让测试通过。
- 运行全部测试,确认没有回归。
- 重构代码,再次运行测试。
这个流程对不熟悉测试的新手特别有教育意义:它能让你亲眼看到“先写测试-测试失败-写实现-测试通过”的红绿循环,而不是让 AI 一次性把所有代码都堆积出来。
4.2 安装 Superpowers 的通用步骤
Superpowers 是社区维护的开源技能集合,不同仓库的安装方式会略有差异。这里给出通用思路,具体路径要以你下载的仓库 README 为准。
Claude Code 侧的常见安装思路:
- 克隆或下载技能仓库到本地,例如
~/superpowers。 - 查看仓库里的 skills 目录结构。
- 在 Claude Code 配置中把技能目录注册为可用路径。
- 重启 Claude Code,查看
/skills或help确认技能是否加载。
Codex 侧的常见安装思路类似,也是把技能说明文件放到项目能被读取的位置。Codex 更强调项目上下文,所以很多技能文件需要放到项目根目录或.codex配置目录中。
安装过程最需要注意的是版本匹配。有些技能仓库更新很快,依赖的 CLI 版本也在变。如果技能加载后没有生效,优先检查 CLI 版本和技能仓库的最近更新说明,而不是反复重装。
4.3 优先体验 TDD 技能,感受“先测试后实现”的节奏
在已经跑通的待办项目里,可以尝试用 TDD 技能加一个新功能:
使用 TDD 技能为 todo.py 增加一个 export 命令,把待办数据导出为 CSV 文件。如果技能正常触发,AI 会先写出针对导出函数的测试,再运行测试,看到失败后再实现。你也可以在项目里创建测试文件目录,观察测试结果:
python -m pytest -q如果之前没有安装 pytest,可以先安装再运行。对零基础学习者来说,TDD 技能带来的最大收获不是测试覆盖率,而是一种“小步前进、每步验证”的工程习惯。这个习惯在传统编程学习里往往要老师反复提醒,而 Superpowers 把它变成了 AI 默认的执行方式。
5. 把 Codex 接入同一个项目:对比两个命令行助手的使用方式
Claude Code 和 Codex 都是终端里的 AI 编程助手,但它们的执行风格不同。在同一个项目里同时使用两者,可以更直观地感受差异,也能在其中一个工具出问题时切换到另一个继续工作。
5.1 Claude Code 和 Codex 的核心差异
| 对比项 | Claude Code | Codex |
|---|---|---|
| 对应的模型服务 | Anthropic 系模型 | OpenAI 系模型 |
| 登录方式 | 终端授权链接 | codex login浏览器授权 |
| 工作方式 | 阅读文件、编辑文件、解释代码、执行终端命令 | 更强调代理式执行,计划-执行-确认 |
| 适合场景 | 多文件重构、架构讨论、代码解释 | 自动化修改、运行测试、批量处理 |
| 用户确认粒度 | 文件修改前会展示变更,终端命令前会询问 | 执行计划会列出将要运行的命令,需确认 |
这里的差异并不是一个比另一个强,而是两者的设计重点不同。Claude Code 更适合“一边聊天一边改项目”的交互式过程;Codex 更接近“一个替你在终端里干活的代理”。实际项目中很多人会同时装两个,根据任务类型选择。
5.2 在已有项目里启动 Codex 并让 AI 改代码
进入之前的待办项目,启动 Codex:
cd ai-first-project codex "给 todo.py 增加一个 import 命令,可以从 CSV 文件批量导入待办事项"启动后,Codex 会先读取项目文件,生成执行计划,然后向你确认是否用代码编辑器修改文件、是否运行测试、是否安装依赖。确认后它才会开始改动。
这里和 Claude Code 很不一样的地方是:Codex 倾向于把一连串操作合并成一个计划,按顺序执行。如果你不希望它自动安装第三方库,可以在提示词里显式说明“不要安装额外依赖”,或者“只修改代码,不运行包管理器命令”。
5.3 两个 CLI 并存时最容易出现的命令冲突
同时安装两个工具后,终端里自然多了claude和codex两个命令。它们之间没有命令名冲突,但会有两个容易混淆的问题。
第一个是版本问题。如果你通过 npm 全局安装后又用其他包管理器安装了同名工具,终端执行的可能不是你期望的版本。用which claude和which codex(Windows