这是 vibe coding 系列的第 2 篇(系列总览)。照着本文做完,你会得到和我开发简单书房时一样的环境:Claude Code + 5 个插件 + 浏览器 MCP + 一份写好的规则文件。

准备什么

项目 说明
Claude 账号 订阅 Claude Pro / Max,或者在 Anthropic Console 开通 API(按量计费)。登录时二选一
电脑 macOS、Linux 直接装;Windows 推荐用 WSL(下面有步骤),我就是这么用的
Node.js 用来运行 chrome-devtools MCP;建议装 LTS 版本
Google Chrome 让 Claude 操作浏览器时用
Git 管理代码版本,Claude 会帮你提交

第一步:安装 Claude Code

Windows:先装 WSL

在「终端(管理员)」或 PowerShell(管理员)里执行,然后重启电脑:

wsl --install

重启后会自动装好 Ubuntu,按提示设置用户名和密码。之后在开始菜单打开 Ubuntu,下面的命令都在这个窗口里执行。

不想用 WSL 也可以直接在 Windows 上装,见官方文档。WSL 的好处是和 Linux 服务器、Docker 的环境一致,NAS 相关的脚本也能直接跑。

安装

macOS / Linux / WSL 里执行官方安装脚本:

curl -fsSL https://claude.ai/install.sh | bash

或者已经装了 Node.js 的,用 npm 安装:

npm install -g @anthropic-ai/claude-code

登录并开始

进入你的项目目录,运行:

cd ~/projects/my-app
claude

第一次运行会让你选择登录方式(Claude 订阅账号或 API Key),按提示在浏览器里完成登录。看到输入框就可以直接用中文说话了。

几个常用命令(在 Claude Code 的输入框里输入):

命令 作用
/init 读一遍项目,自动生成 CLAUDE.md 初稿
/plugin 浏览、安装、管理插件
/mcp 查看 MCP 连接状态
/model 切换模型
/doctor 检查安装是否正常

更新 Claude Code:claude update。

第二步:安装插件

插件给 Claude 装上「工作方法」。下面是我常开的 5 个,在 Claude Code 的输入框里依次输入即可。插件来自不同的「插件市场」,所以先添加市场,再安装插件。

superpowers:开发流程(必装)

让 Claude 先问清需求、写设计、拆计划、先写测试再实现、最后审查。整个系列的核心。

/plugin marketplace add anthropics/claude-plugins-official
/plugin install superpowers@claude-plugins-official

security-guidance:安全提醒

写到登录、权限、文件路径这类涉及安全的代码时给出提醒。和 superpowers 在同一个市场:

/plugin install security-guidance@claude-plugins-official

frontend-design:界面设计

做页面时让设计更讲究,避免千篇一律的「AI 风」。

/plugin marketplace add anthropics/claude-code
/plugin install frontend-design@claude-code-plugins

andrej-karpathy-skills:编码守则

一组让 AI 少犯错的守则:先想清楚、只做必要的改动、不顺手乱改。

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

claude-hud:状态栏

在终端底部显示上下文用了多少、当前在做什么,方便判断什么时候该让它收尾、什么时候该开新对话。

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud@claude-hud
/claude-hud:setup

装完后输入 /reload-plugins(或退出重开 claude),再输入 /plugin 能看到已启用的插件就好了。

第三步:认识 skill

插件里装的能力叫 skill(技能),本质是一份份写给 Claude 的工作说明。superpowers 里最常用的几个:

skill 什么时候用 做什么
brainstorming 要做新功能时 一次问一个问题,把需求问清楚,复述给你确认
writing-plans 设计确认后 把设计拆成小任务,写明改哪些文件、怎么测试
executing-plans 开始实现 按计划逐个任务完成,记录进度
test-driven-development 写任何代码时 先写测试并确认它失败,再写代码让它通过
systematic-debugging 遇到 bug 先找到根本原因再动手,不靠猜
verification-before-completion 宣布完成前 没有测试结果或运行证据,不许说「好了」
requesting-code-review 功能做完 另开一个审查员把所有改动从头看一遍
finishing-a-development-branch 收尾 跑完整测试,问你合并、提 PR 还是先留着

怎么用:大多数时候不用管,Claude 会根据你说的话自动选用。比如你说「我想加一个装到手机桌面的功能」,它会自己进入 brainstorming。

想指定某个技能,可以直接输入它的名字,比如:

/superpowers:brainstorming 我想给书库加一个按作者筛选的功能

也可以写自己的 skill:在 ~/.claude/skills/技能名/SKILL.md 里用文字写清楚「什么时候用、怎么做」,Claude 就会照做。比如把「发版的步骤」写成一个 skill,以后说一句「发版」就够了。

第四步:接上浏览器(chrome-devtools MCP)

MCP 是给 Claude 接外部工具的接口。这一个让 Claude 能自己打开 Chrome、点按钮、截图、量尺寸、看报错。在终端(不是 Claude 的输入框)里执行:

claude mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

然后重开 claude,输入 /mcp,看到 chrome-devtools 显示已连接就好了。

WSL 用户还需要在 Ubuntu 里装一个 Chrome(Windows 11 的 WSL 可以直接弹出 Linux 程序的窗口):

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb

试一下:对 Claude 说「打开 https://www.example.com 截个图给我看」。它能做到哪些事,见《浏览器篇》。

第五步:写 CLAUDE.md

每次新开对话,Claude 都不记得之前的事。CLAUDE.md 是它每次启动都会先读的规则文件,分两种:

  • 项目里的 CLAUDE.md(项目根目录):写这个项目的事实。用 /init 让 Claude 生成初稿,再补充。
  • 你自己的 ~/.claude/CLAUDE.md:写你的个人守则,所有项目都生效。

项目的 CLAUDE.md 里通常写:

  • 项目是什么、用了哪些技术
  • 常用命令(怎么启动、怎么测试、怎么构建)
  • 目录结构、关键文件在哪
  • 约定(比如接口返回什么格式、界面配色只能用主题变量、包管理器用哪个)

个人守则可以直接参考我的这份(节选):

## 核心原则
- 使用中文交流:所有回答、说明、结论一律用中文
- 简单优先:以最小改动达成目标,避免过度设计
- 解决根本原因:不做临时修复
- 修改前先阅读:理解现有代码后再修改,不凭猜测编写

## 安全规则
- 不得把 .env、密码、API Key 等敏感信息输出到文件、日志、提交记录或界面
- 破坏性操作(删除文件、修改数据库、强制推送)执行前必须展示内容并获得确认

## 工作流程
- 3 步以上的任务,先在 tasks/todo.md 写成勾选清单,随时更新进度
- 验证功能正常之前不标记完成,用测试或日志证明
- 收到 bug 报告时自主调查并修复,但不做超出范围的改动

规则不用一次写全。用的过程中发现它总犯同一个错,就加一条。

另外 Claude Code 有自动记忆:踩过的坑、你的偏好会被记下来,下次自动想起。你也可以直接说「记住:以后推送都由我来」。

装好了,然后呢

环境就绪。下一篇《提要求篇》讲怎么跟 Claude 说话,以及一个功能从想法到发版的完整流程。

其他教程