每周一个开源项目 #8：Claude How To 保姆级 Claude Code 学习指南

每周一个开源项目 #8：Claude How To 保姆级 Claude Code 学习指南

🚀 一句话看懂项目
Claude How To 是目前最全面的 Claude Code 开源学习指南，通过 10 个渐进式模块、可视化图表和可复制粘贴的模板，帮助开发者从入门到精通掌握 Claude Code 的全部功能，包括斜杠命令、记忆系统、技能包、子代理、MCP 协议、钩子、插件和高级特性，是一周末即可掌握 Claude Code 的完整实战教程。

💻 项目核心简介

Claude How To 是由开发者 Luong Nguyen 创建的开源教程项目，旨在解决 Claude Code 用户「只懂基本对话，不会用高级功能」的痛点。项目提供了结构化、可视化的学习路径，涵盖 Claude Code 的所有核心功能，从简单的斜杠命令到复杂的多代理协作系统，每个功能都配有 Mermaid 流程图、实战模板和即用代码。

作为 2026 年最受欢迎的 Claude Code 学习资源之一，该项目在 GitHub 上迅速获得 5900+ 星标，690+ Fork，被全球 5900+ 开发者使用。项目与 Claude Code 官方文档完美互补——官方文档是功能参考，而本指南是实战教程，帮助开发者真正掌握如何组合使用多个功能构建强大的 AI 工作流。

项目特点：10 个渐进式学习模块（总时长 11-13 小时）、可视化 Mermaid 图表展示工作原理、生产级模板直接复制使用、内置自我评估系统生成个性化学习路径、与 Claude Code v2.1+ 版本同步更新。

项目 GitHub 地址：https://github.com/luongnv89/claude-howto

适用版本：Claude Code 2.1+ / Claude Sonnet 4.6 / Claude Opus 4.6 / Claude Haiku 4.5

核心定位：替代零散的官方文档和碎片化教程，提供一站式、渐进式、实战化的 Claude Code 学习方案。

🔍 核心功能与适用场景

核心能力

10 大功能模块全覆盖

• 斜杠命令（Slash Commands）：用户自定义快捷命令，30 分钟上手
• 记忆系统（Memory）：持久化项目上下文，跨会话记忆
• 检查点（Checkpoints）：会话快照与回滚，安全实验
• 命令行接口（CLI）：非交互模式、脚本集成、CI/CD 自动化
• 技能包（Skills）：可复用能力包，自动调用
• 钩子（Hooks）：事件驱动自动化，25 种事件类型
• MCP 协议：模型上下文协议，连接外部工具和 API
• 子代理（Subagents）：专业化 AI 助手，任务委派
• 高级特性：规划模式、扩展思考、后台任务、无头模式
• 插件系统：打包的完整解决方案，一键安装

渐进式学习路径

• 初学者路径：斜杠命令 → 记忆 → CLI 基础（2.5 小时）
• 中级路径：技能 → 钩子 → MCP（3.5 小时）
• 高级路径：子代理 → 高级特性 → 插件（5 小时）
• 总计：11-13 小时完整路径

可视化教学

• Mermaid 流程图展示每个功能的内部工作原理
• 功能对比表清晰展示使用场景
• 真实世界工作流示例（代码审查、文档生成、DevOps 部署）

适用人群

• Claude Code 新手：刚安装 Claude Code，不知道如何高效使用
• 开发者：想将 Claude Code 集成到项目中，提升开发效率
• 团队：需要标准化 Claude Code 配置，共享最佳实践
• AI 爱好者：想深入理解 Claude Code 的工作原理和高级功能
• DevOps 工程师：想在 CI/CD 流程中使用 Claude Code
• 研究者：想研究 AI Agent 的构建模式和协作机制

🛠️ 本地部署教程

基础环境要求

• 系统：Windows/macOS/Linux
• Claude Code：2.1+ 版本已安装
• Git：克隆仓库
• Python：3.10+（用于生成 EPUB 电子书）
• 可选：uv（推荐的 Python 包管理器）

方案一：快速体验（15 分钟上手）

# 1. 克隆指南仓库
git clone https://github.com/luongnv89/claude-howto.git
cd claude-howto

# 2. 复制第一个斜杠命令到你的项目
mkdir -p /path/to/your-project/.claude/commands
cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/

# 3. 在 Claude Code 中测试
# 启动 Claude Code 并输入：/optimize

# 4. 添加项目记忆
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

# 5. 安装一个技能包
cp -r 03-skills/code-review ~/.claude/skills/

方案二：完整安装（1 小时核心配置）

# 1. 克隆仓库
git clone https://github.com/luongnv89/claude-howto.git
cd claude-howto

# 2. 安装所有斜杠命令（15 分钟）
cp 01-slash-commands/*.md .claude/commands/

# 3. 配置项目记忆（15 分钟）
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
cp 02-memory/directory-api-CLAUDE.md ./src/api/CLAUDE.md

# 4. 安装技能包（15 分钟）
cp -r 03-skills/code-review ~/.claude/skills/
cp -r 03-skills/brand-voice ~/.claude/skills/

# 5. 配置子代理（可选）
cp 04-subagents/*.md .claude/agents/

# 6. 配置钩子（可选）
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

方案三：插件安装（一键式完整解决方案）

# 在 Claude Code 中执行
/plugin install pr-review          # PR 审查工作流
/plugin install devops-automation  # DevOps 自动化
/plugin install documentation      # 文档生成

方案四：生成 EPUB 电子书（离线阅读）

# 1. 安装 uv（推荐）
pip install uv

# 2. 安装依赖
uv pip install -r requirements-dev.txt

# 3. 生成 EPUB（包含所有内容和渲染的 Mermaid 图表）
uv run scripts/build_epub.py

# 4. 在电子书阅读器中打开
# 生成的文件：claude-howto-guide.epub

⚙️ 核心配置与常用命令

学习路径规划

# 自我评估（生成个性化学习路径）
/self-assessment

# 课程测验（检查理解程度）
/lesson-quiz hooks
/lesson-quiz mcp
/lesson-quiz subagents

功能模块速览

安装命令速查

# 斜杠命令
cp 01-slash-commands/*.md .claude/commands/

# 记忆
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
cp 02-memory/directory-api-CLAUDE.md ./src/api/CLAUDE.md
cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md

# 技能
cp -r 03-skills/code-review ~/.claude/skills/
cp -r 03-skills/code-review .claude/skills/

# 子代理
cp 04-subagents/*.md .claude/agents/

# MCP 协议
export GITHUB_TOKEN="token"
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# 钩子
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# 插件
/plugin install pr-review
/plugin install devops-automation
/plugin install documentation

📌 实战常用操作（直接复制使用）

场景1：自动化代码审查工作流

# 1. 安装代码审查技能包
cp -r 03-skills/code-review ~/.claude/skills/

# 2. 配置代码审查子代理
cp 04-subagents/code-reviewer.md .claude/agents/
cp 04-subagents/secure-reviewer.md .claude/agents/

# 3. 配置 GitHub MCP
export GITHUB_TOKEN="your_github_token"
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# 4. 配置 PR 审查钩子
mkdir -p ~/.claude/hooks
cp 06-hooks/pre-commit.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/pre-commit.sh

# 5. 在 settings.json 中配置钩子
cat > ~/.claude/settings.json << 'EOF'
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Write",
      "hooks": ["~/.claude/hooks/pre-commit.sh"]
    }]
  }
}
EOF

# 6. 使用：在 Claude Code 中输入
# "审查这个 PR 的代码质量、安全性和测试覆盖率"

场景2：文档自动生成系统

# 1. 安装文档生成技能
cp -r 03-skills/doc-generator ~/.claude/skills/

# 2. 配置文档编写子代理
cp 04-subagents/documentation-writer.md .claude/agents/

# 3. 配置项目记忆（文档标准）
cat > ./CLAUDE.md << 'EOF'
# 文档标准

## API 文档
- 所有公共 API 必须包含文档字符串
- 使用 Google 风格的文档字符串
- 包含参数、返回值、异常、示例

## README 要求
- 项目简介
- 安装步骤
- 使用示例
- 贡献指南
- 许可证
EOF

# 4. 使用斜杠命令快速生成文档
cp 01-slash-commands/generate-api-docs.md .claude/commands/

# 5. 在 Claude Code 中输入
# /generate-api-docs

场景3：DevOps CI/CD 自动化

# 1. 安装 DevOps 自动化插件
/plugin install devops-automation

# 2. 配置部署子代理
cat > .claude/agents/deployment-specialist.md << 'EOF'
---
description: 部署专家，负责 Kubernetes 部署和监控
---

你是部署专家。职责：
- 评估部署风险
- 执行滚动更新
- 监控健康检查
- 处理回滚
EOF

# 3. 配置 Kubernetes MCP
export KUBECONFIG="~/.kube/config"
claude mcp add kubernetes -- npx -y @modelcontextprotocol/server-kubernetes

# 4. 配置部署钩子
cat > ~/.claude/hooks/pre-deploy.sh << 'EOF'
#!/bin/bash
# 部署前验证
echo "运行部署前验证..."
pytest tests/ || exit 1
npm run lint || exit 1
EOF

chmod +x ~/.claude/hooks/pre-deploy.sh

# 5. 配置部署后钩子
cat > ~/.claude/hooks/post-deploy.sh << 'EOF'
#!/bin/bash
# 部署后健康检查
echo "运行健康检查..."
curl -f http://localhost:8080/health || exit 1
EOF

chmod +x ~/.claude/hooks/post-deploy.sh

# 6. 在 settings.json 中配置钩子
cat >> ~/.claude/settings.json << 'EOF'
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": ["~/.claude/hooks/pre-deploy.sh"]
    }],
    "PostToolUse": [{
      "matcher": "Bash",
      "hooks": ["~/.claude/hooks/post-deploy.sh"]
    }]
  }
}
EOF

# 7. 使用：在 Claude Code 中输入
# /deploy production

场景4：多语言项目管理（记忆 + 目录规则）

# 1. 配置项目级记忆
cat > ./CLAUDE.md << 'EOF'
# 项目标准

## 代码风格
- Python: PEP 8
- JavaScript: Airbnb 风格指南
- Go: 官方风格指南

## 测试要求
- 所有新功能必须包含单元测试
- 测试覆盖率 ≥ 80%

## Git 工作流
- 特性分支: feature/功能名
- 提交消息: Conventional Commits
- PR 必须通过 CI 检查
EOF

# 2. 配置目录级记忆（API 子项目）
mkdir -p src/api
cat > src/api/CLAUDE.md << 'EOF'
# API 子项目规则

## 框架
- FastAPI 0.100+

## API 设计
- RESTful 原则
- 所有端点返回 JSON
- 统一错误处理

## 安全
- 所有端点需要认证
- 敏感数据记录到审计日志
EOF

# 3. 配置前端子项目记忆
mkdir -p frontend
cat > frontend/CLAUDE.md << 'EOF'
# 前端子项目规则

## 框架
- React 18 + TypeScript

## 组件规范
- 函数组件
- Hooks 优先于类组件
- 使用 Tailwind CSS

## 状态管理
- 轻量状态: useState
- 全局状态: Zustand
EOF

# 4. 现在切换到不同目录时，Claude 会自动应用相应规则

⚠️ 新手避坑注意事项

1. 功能加载失败：检查文件位置和命名，确保 YAML frontmatter 语法正确，文件权限可读
2. MCP 连接失败：验证环境变量是否设置，检查 MCP 服务器安装，测试凭证有效性，检查网络连接
3. 子代理不委派：检查工具权限，确保代理描述清晰明确，审查任务复杂度是否需要委派，独立测试子代理
4. 钩子不执行：验证钩子脚本路径，检查 settings.json 配置语法，确保钩子脚本有执行权限（chmod +x）
5. 技能不自动调用：检查技能描述是否清晰，确保技能目录结构正确，测试技能的触发条件
6. 版本兼容性：确保 Claude Code 版本 ≥ 2.1，旧版本可能不支持某些功能
7. 配置冲突：项目级配置覆盖个人级配置，注意配置优先级顺序
8. 性能问题：过多的 MCP 服务器和钩子可能影响性能，按需启用

✨ 项目核心亮点

• 结构化学习路径：10 个渐进式模块，从新手到专家，总时长 11-13 小时
• 可视化教学：Mermaid 流程图展示每个功能的内部工作原理，不仅知其然，更知其所以然
• 生产级模板：所有示例都是可直接复制使用的生产级配置，不是简单的 Hello World
• 个性化评估：内置自我评估系统，生成个性化学习路径，查漏补缺
• 持续更新：与 Claude Code 每次发布同步更新，当前版本 v2.2.0（2026 年 3 月）
• 社区驱动：690+ Fork，开发者贡献真实世界配置和最佳实践
• 多种格式：Markdown、交互式教程、EPUB 电子书（离线阅读）
• 开源友好：MIT 许可，可自由使用、修改、分发，包括商业用途

✅ 上手建议

新手优先级（15 分钟快速上手）：

1. 复制一个斜杠命令（如 optimize.md）到项目
2. 配置项目级 CLAUDE.md 记忆文件
3. 安装一个技能包（如 code-review）
4. 在 Claude Code 中测试斜杠命令

周末学习计划（6-8 小时）：

• 周六上午（2.5 小时）：斜杠命令 + 记忆 + CLI 基础
• 周六下午（3.5 小时）：技能 + 钩子 + MCP
• 周日上午（1.5 小时）：子代理 + 高级特性
• 周日下午（1 小时）：插件 + 实战工作流组合

开发者深度使用：

• 先通读 10 个模块的 README，理解每个功能的定位
• 选择与工作相关的功能深度学习（如 DevOps 重点学 Hooks+MCP+Plugins）
• 复制模板到项目，逐步定制化
• 加入社区，贡献自己的配置和最佳实践

作为目前最全面的 Claude Code 学习资源，Claude How To 不仅教你「怎么用」，更教你「为什么这样设计」、「如何组合使用多个功能」，真正掌握 Claude Code 的精髓。无论你是 Claude Code 新手，还是想深入高级功能的老手，这份指南都能帮你快速提升 10 倍生产力。

📊 完整功能目录

01. 斜杠命令（Slash Commands）

• 位置：01-slash-commands/
• 示例：optimize.md（代码优化）、pr.md（PR 准备）、generate-api-docs.md（API 文档生成）
• 安装：cp 01-slash-commands/*.md .claude/commands/
• 使用：在 Claude Code 中输入 /optimize

02. 记忆系统（Memory）

• 位置：02-memory/
• 示例：project-CLAUDE.md（项目标准）、directory-api-CLAUDE.md（目录规则）、personal-CLAUDE.md（个人偏好）
• 安装：cp 02-memory/project-CLAUDE.md ./CLAUDE.md
• 使用：自动加载，无需手动触发

03. 技能包（Skills）

• 位置：03-skills/
• 示例：code-review/（代码审查）、brand-voice/（品牌语调）、doc-generator/（文档生成）
• 安装：cp -r 03-skills/code-review ~/.claude/skills/
• 使用：Claude 自动检测需求并调用

04. 子代理（Subagents）

• 位置：04-subagents/
• 示例：code-reviewer.md（代码审查员）、test-engineer.md（测试工程师）、documentation-writer.md（文档编写者）、secure-reviewer.md（安全审查员）、implementation-agent.md（实现代理）
• 安装：cp 04-subagents/*.md .claude/agents/
• 使用：Claude 自动委派任务给专业化子代理

05. MCP 协议（Model Context Protocol）

• 位置：05-mcp/
• 示例：github-mcp.json（GitHub 集成）、database-mcp.json（数据库查询）、filesystem-mcp.json（文件操作）、multi-mcp.json（多 MCP 服务器）
• 安装：设置环境变量 + claude mcp add github -- npx -y @modelcontextprotocol/server-github
• 使用：配置后自动可用

06. 钩子（Hooks）

• 位置：06-hooks/
• 示例：format-code.sh（自动格式化）、pre-commit.sh（提交前测试）、security-scan.sh（安全扫描）、log-bash.sh（日志记录）
• 安装：cp 06-hooks/*.sh ~/.claude/hooks/ && chmod +x ~/.claude/hooks/*.sh
• 使用：在 settings.json 中配置事件触发

07. 插件（Plugins）

• 位置：07-plugins/
• 示例：pr-review/（PR 审查工作流）、devops-automation/（DevOps 自动化）、documentation/（文档生成）
• 安装：/plugin install pr-review
• 使用：一键安装完整解决方案

08. 检查点（Checkpoints）

• 位置：08-checkpoints/
• 用途：会话快照、回滚、分支探索
• 使用：自动创建，双击 Esc 或 /rewind 回滚

09. 高级特性（Advanced Features）

• 位置：09-advanced-features/
• 功能：规划模式（Planning Mode）、扩展思考（Extended Thinking）、后台任务（Background Tasks）、无头模式（Headless Mode）
• 安装：在 settings.json 中配置
• 使用：手动启用或自动触发

10. 命令行接口（CLI）

• 位置：10-cli/
• 用途：脚本集成、CI/CD、批处理、多会话工作流
• 示例：claude -p "运行测试"（非交互模式）、cat error.log | claude -p "解释错误"（管道输入）

🔗 相关资源

• 项目主页：https://github.com/luongnv89/claude-howto
• Claude Code 官方文档：https://docs.anthropic.com/claude-code
• MCP 协议规范：https://modelcontextprotocol.io/
• 技能仓库：https://github.com/anthropics/claude-code-skills
• Anthropic Cookbook：https://github.com/anthropics/anthropic-cookbook
• Boris Cherny 的 Claude Code 工作流：https://github.com/boris-cherny/claude-workflow

总结：Claude How To 是 2026 年最值得学习的 Claude Code 教程项目，凭借其结构化学习路径、可视化教学、生产级模板和活跃社区，成为掌握 Claude Code 的首选资源。无论是新手快速上手，还是老手深入高级功能，这份指南都能帮你充分发挥 Claude Code 的威力，实现 10 倍开发效率提升。