Vibe Coding 知识库

Claude Code 从 0 到 1 ​

本模块演示如何用 Claude Code 从空仓库完成“AI 项目交付看板”的第一版。重点不是让 Claude 一次性写完整系统，而是让它读取项目上下文、先计划、再小步实现、最后验证。

官方依据 ​

Step -1：安装与登录 ​

课堂开始前先完成安装和登录。Claude Code 官方推荐原生安装，npm 安装方式已不作为课堂推荐路径。

Windows PowerShell：

powershell
irm https://claude.ai/install.ps1 | iex
claude

macOS、Linux 或 WSL：

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

macOS/Linux 也可以使用 Homebrew 稳定版：

bash
brew install --cask claude-code
claude

第一次运行 claude 时按提示登录。登录完成后，进入演示仓库根目录再运行一次 claude，确认 Claude Code 能看到当前项目文件。不要把登录令牌、API Key 或一次性验证码写进 CLAUDE.md、聊天记录截图或课程仓库。

Step 0：准备仓库 ​

powershell
mkdir ai-delivery-board
cd ai-delivery-board
git init

推荐方式：下载 Claude Code 中文包 或 Claude Code English package，解压到演示仓库。README.md、CLAUDE.md 和 docs/project/*.md 都由资料包提供。

如果不用资料包，则手动创建这些基础文件：

text
README.md
CLAUDE.md
docs/project/requirements.md
docs/project/acceptance.md
docs/project/design-context.md
docs/project/test-strategy.md
docs/project/risk-register.md
docs/project/release-checklist.md

解压或手写完成后，再按本页步骤补充代码和验证记录。

Step 1：启动 Claude Code ​

powershell
claude

如果是新项目，可以运行：

text
/init

如果已经手写了 CLAUDE.md，让 Claude 先读取现有文件：

text
请阅读 README.md、CLAUDE.md 和 docs/project/*.md。
不要修改文件。先复述项目目标、范围、验收标准和风险。

Step 2：让 Claude 生成计划 ​

提示词：

text
请基于现有 Markdown 上下文，生成第一版实现计划。
要求：
1. 不使用数据库。
2. 不做登录。
3. 先完成可运行的任务看板页面。
4. 列出要创建或修改的文件。
5. 列出验证命令和手动验收步骤。

讲师要点：

  • 如果 Claude 直接改代码，打断它，让它先计划。
  • 如果计划太大，要求缩小到第一版。
  • 如果计划没提验收，要求补充。

Step 3：小步实现 ​

提示词：

text
按计划只实现第一步：创建最小可运行应用。
完成后停止，告诉我：
- 改了哪些文件
- 如何启动
- 如何验证
- 还有哪些风险

如果 Claude 要添加依赖，要求它说明理由：

text
添加依赖前先说明原因、替代方案和风险。

Step 4：本地验证 ​

根据项目技术栈运行命令。课堂示例可以使用：

powershell
npm install
npm run dev
npm run build

如果有测试：

powershell
npm test

手动验收：

  • 页面能打开。
  • 有任务列表。
  • 可以按状态筛选。
  • 无匹配结果时有空状态。
  • 页面没有明显控制台错误。

Step 5：让 Claude 做复盘 ​

提示词：

text
请根据当前 git diff 总结：
1. 已完成内容
2. 对照 acceptance.md 哪些已满足
3. 哪些风险需要写入 risk-register.md
4. 下一步建议
不要继续改文件，先给我审查。

Step 6：更新项目记忆 ​

如果课堂中形成了新规则，可以用：

text
/memory

把稳定规则写入 CLAUDE.md 或合适的 memory 文件。不要把临时讨论、错误尝试、过长日志写入长期记忆。

Step 7：团队化扩展 ​

后续可以引入：

  • /agents：为代码审查、测试策略、文档整理建立专门 subagent。
  • /mcp：连接 GitHub、Jira、Linear、Sentry 等工具。
  • Hooks：在会话生命周期中自动做检查或拦截风险操作。
  • Claude Code GitHub Action：把部分审查和文档同步流程放到 CI。

课堂对比问题 ​

  • Claude Code 哪一步最像“结对编程”？
  • 哪些信息写进 CLAUDE.md 后，后续交互明显变短？
  • PM 写的验收标准是否足以让 Claude 自检？