最近被问得最多的一个问题，其实是同一个：我完全没写过代码，也不想从语法书开始啃，能不能用 AI 直接写项目？能。而且现在最主流的一条路，就是 Vibe Coding——用自然语言描述需求，让 Claude Code 或 Codex 这类终端编程助手把代码写出来，你负责读、验证、纠偏。这篇文章就是给零基础准备的，我会把 Vibe Coding、Superpowers、Claude Code、Codex 这几组关键词串成一条完整链路，从装环境到跑通第一个项目，再到批量任务和常见报错，全部按实际落地顺序讲。最关键的一点先说在前面：AI 编程真正考验的，不是你会不会背 API，而是你会不会描述需求、会不会看日志、会不会在 AI 跑偏的时候把它拉回来。下面按实测流程拆开讲。
1. 零基础学 AI 编程，先理解 Vibe Coding 到底改变了什么
1.1 Vibe Coding 不是“不用学编程”，而是把重心从“写”挪到“管”
Vibe Coding 是最近一年 AI 编程领域出现频率最高的工作方式。它的核心做法很简单：你用自然语言描述想要的功能，AI 生成代码，生成之后你负责运行、观察结果、把报错或不满意的地方反馈回去，如此循环。整个过程像在和 AI 对话，而不是传统开发那样逐行敲代码。
很多人把 Vibe Coding 理解成“完全不用学编程”，这个说法容易误导人。实际操作几次就会发现，零基础用户最需要补的不是语法，而是三件事：第一，能把需求说清楚；第二，能读懂简单的报错；第三，能判断 AI 做出来的东西是不是对的。这三件事都不需要科班基础，但都需要练。
适合 Vibe Coding 入门的人，包括：
- 完全没写过代码，但想用 Python 处理 Excel、批量改名、整理公开网页数据；
- 会一点前端基础，想快速搭一个个人主页或工具页面；
- 业务人员想写内部脚本，但公司没有专门开发；
- 学生想做个课程设计，又不确定怎么设计目录和模块。
不管是 Web 前端、Python 脚本，还是小程序、鸿蒙应用，Vibe Coding 的操作思路大体一致，只是要提前确认目标框架在模型训练和工具链支持范围内。越主流的框架，AI 生成质量越稳定。
1.2 为什么我不建议一上来就只盯着网页版聊天窗口
现在能写代码的 AI 工具很多。ChatGPT、Claude、DeepSeek 的网页版都能写代码，Cursor、Trae、PyCharm 里的 AI 插件也能做辅助。但零基础要“完整做项目”时，我更推荐先从命令行编程助手入手，也就是 Claude Code 和 Codex 这类终端工具。
原因有三个。第一，它们在项目目录里运行，AI 能直接看到整个文件结构，改一个文件还是改十个文件，它自己有上下文。第二，它们可以连续执行多步任务，比如生成代码、运行、看报错、修改、再运行，这套循环不需要你把代码复制来复制去。第三，日志和输出都在终端里，报错信息可以原样回贴给 AI，调试效率高很多。
如果你已经在用 Cursor，或者习惯在 PyCharm 里装 Continue 这类 AI 补全插件，也没必要放弃。它们解决的问题不同：编辑器插件适合“边写边补全”，命令行编程助手更适合“给我把整个项目写完”。零基础我建议先选后者，因为它能逼着你理解“输入、输出、日志、验证”这条最基本的链路。一些云平台也提供了网页版的一键生成页面，本质上是同一套思路，但先掌握终端工具，更容易理解底层发生了什么。
2. Claude Code 和 Codex，先搞清楚两个工具的区别再选
2.1 两个工具各自的定位
Claude Code 是 Anthropic 推出的终端编程助手，通过命令行在项目目录里运行。它的特点是上下文长，适合把整个小项目塞进对话里让它理解全局，再进行跨文件修改。很多使用者反馈它在“理解需求、代码审查、重构老代码”这类任务上表现比较稳。
Codex 是 OpenAI 推出的终端编程助手，安装后通过codex命令启动。它的定位同样是项目级编码工具，适合生成代码、实现功能、处理多文件改动。因为背后是 OpenAI 的模型体系，它在写算法、生成样板代码、做多方案对比时也有自己的优势。
两个工具在交互方式上有很多相似之处：都在终端里跑，都支持自然语言下达任务，都能读取项目目录，都有登录和配置流程。对零基础用户来说，不需要纠结“谁更强”，因为模型能力更新很快，今天这个好用，明天另一个可能更好用。更值得做的是把安装、登录、基本操作都跑一遍。
2.2 选型对比
| 对比项 | Claude Code | Codex CLI |
|---|---|---|
| 出品方 | Anthropic | OpenAI |
| 启动命令 | claude | codex |
| 安装方式 | Node.js 环境下用 npm 全局安装，具体以官方文档为准 | 同样可用 npm 或官方推荐的包管理器安装 |
| 登录方式 | Claude 账号订阅，或 API Key | ChatGPT 账号登录，或 API Key |
| 配置目录 | ~/.claude | ~/.codex |
| 典型优势 | 长上下文、需求理解、代码审查 | 代码生成、多方案探索、模型生态 |
| 适合场景 | 项目级开发、重构、批量改代码 | 快速搭原型、写算法、从零生成功能模块 |
这里有一个容易踩的误区：两个工具都能通过环境变量切换到其他兼容 API，所以“用什么模型”和“用什么工具”不一定是绑定关系。后文我会专门讲这件事。
2.3 我的建议
新手阶段，我更建议两个都装上，但只把其中一个当作主力。先用 Claude Code 跑一个小项目，体会一下“描述需求—生成代码—运行—反馈报错”的循环；再换 Codex 跑一遍同样的小项目，感受两个工具在对话风格和输出上的差异。这样比只看评测文章更能帮你建立判断。
不要做的是：同一个项目同时让两个工具改，或者每换一个任务就换一个工具。AI 编程的核心在于你对项目的连续性理解，频繁换工具会让上下文断裂，代码风格也会变得混乱。选定一个主力，把流程跑熟，再考虑另一个。
3. 安装与初始化：先把 Claude Code 和 Codex 跑起来
3.1 前置环境：先确认 Node.js 和终端可用
两个工具都需要 Node.js 环境。安装前先打开终端，执行：
node -v npm -v如果两个命令都能输出版本号，说明 Node.js 环境可用。如果没有，先去 Node.js 官网下载 LTS 版本安装。以 Claude Code 当前版本的依赖要求来看，通常会要求 Node.js 18 或更高版本，具体版本号以官方文档为准。这一步不要跳过，因为后面很多报错，根源就是 Node 版本太老。
Windows 用户建议使用 PowerShell 或 Windows Terminal；macOS 用户用系统自带终端即可。如果之后报错提示 command not found，优先排查是不是 npm 全局路径没有加到 PATH。
3.2 安装 Claude Code
Node 环境就绪后，在终端执行：
npm install -g @anthropic-ai/claude-code安装完成后验证：
claude --version能输出版本号，说明安装成功。然后输入：
claude首次启动会进入登录引导。你有两种认证方式：一种是用 Claude 账号订阅的登录态，另一种是用 API Key。登录方式不同，计费方式和权限边界也不同，建议先看官方提示，按自己能接受的方式选。
登录成功后，会在用户目录生成配置文件夹，默认位置是~/.claude，里面存放设置、历史会话和技能包。后面安装 Superpowers 时就要用这个目录。如果你习惯 VS Code，可以直接在集成终端里运行claude，也可以安装官方提供的扩展，这样文件改动和终端输出能在同一个界面里看到。
3.3 安装 Codex CLI
Codex CLI 的安装方式类似，官方提供了多种途径，常见做法是用 npm 全局安装：
npm install -g @openai/codex安装后验证：
codex --version然后输入：
codex按提示完成登录。Codex 的登录方式和 Claude Code 思路一致：可以用 OpenAI 账号的登录态，也可以用 API Key。
登录完成后，配置目录一般在~/.codex。这里有一个容易出问题的点：如果你是先装了某个编辑器插件或桌面端工具，再安装 Codex CLI，插件可能找不到 codex 可执行文件的路径，报错会提示 “unable to locate the codex cli binary”。这个报错在搜索热词里出现过，说明碰到的人不少。解决办法不用重装，去插件设置里把 Codex 可执行文件的路径指过去，或者先把 CLI 装好再重启插件。
3.4 用最小样例验证整个链路
装完两个工具后，先不要急着写项目。建立一个测试目录：
mkdir test-ai cd test-ai claude在 Claude Code 里输入一句最简单的话：“创建一个 hello.py，运行后输出 hello world”。如果它能创建文件、执行命令、把结果反馈回来，说明安装、登录、权限、目录这套链路都是通的。
再用同样方式测一遍 Codex。两个工具都能把最小任务跑通之后，再开始正式项目。我见过很多新手一上来就在真实项目里装工具，结果报错之后分不清是工具问题还是项目问题。最小样例能在 10 分钟内暴露大部分环境问题。
注意：登录态过期、Node 版本不对、npm 全局路径没配好，都会导致“工具装好了但用不了”。先跑最小样例，不要直接进大项目。
4. 第一次 Vibe Coding：用自然语言写一个能运行的小项目
4.1 从最小项目开始，别让 AI 一口气造一个大系统
零基础最常见的错误，是上来就说“帮我做个电商平台”。这种需求对 AI 来说太大，生成出来的代码会非常依赖假设，运行起来大概率报错，而且你根本不知道从哪开始排查。
正确的做法是先做一个 20 分钟能跑起来的小项目。比如：
- 一个待办清单页面，能新增、勾选、删除；
- 一个 Python 脚本，批量把文件名里的空格替换成下划线；
- 一个 Markdown 转 HTML 的小工具；
- 一个能添加记录的本地记账页面。
这些项目技术栈简单、文件少、运行方式明确，很适合第一次体验 Vibe Coding。
4.2 可复制的第一次实战流程
以“用 Claude Code 做一个本地待办清单页面”为例，完整流程如下。
第一步，创建项目目录并进入：
mkdir todo-app cd todo-app claude第二步，让 AI 先了解项目。输入/init，让 Claude Code 读取目录结构，生成项目说明。空目录时它会直接创建一个基础的项目描述。
第三步，用自然语言描述需求。类似这样：
创建一个本地待办清单页面。要求： 1. 使用 HTML、CSS、JavaScript，不需要框架； 2. 页面能新增待办、勾选完成、删除待办； 3. 数据保存在 localStorage，刷新不丢失； 4. 样式简洁，适合移动端和桌面端； 5. 启动命令写明在 README 里。注意，这里的信息要具体。把技术栈、功能点、数据保存方式、样式要求、交付物都说清楚。
分类的数据集)
