Claude Code 实战指南：从基础到高级 Agent 的可视化教程

这是什么

claude-howto 是一个由开发者 luongnv89 维护的 GitHub 热门开源项目（Python 语言，Star 数约 35.5k+），旨在成为 Claude Code 的终极实战指南与资源库。

它不仅仅是一份文档，而是一个结构化的、视觉化的、以示例驱动的学习路径。该项目提供了从基础命令到复杂工作流编排的全套教程，包含可直接复制粘贴的配置模板、Mermaid 架构图解以及自测工具。其核心目标是帮助用户从“仅仅输入提示词”进阶为“编排 Agent、Hooks、Skills 和 MCP 服务器”的高级用户，从而最大化释放 Claude Code 的生产力。

解决的问题

尽管官方文档详细列举了 Claude Code 的功能特性，但在实际工程落地中，开发者常面临以下痛点：

1. 缺乏组合策略：官方文档仅描述单一功能，未展示如何将 Slash Commands（斜杠命令）、Hooks（钩子）、Memory（记忆）和 Subagents（子代理）串联成能真正节省时间的工作流。
2. 学习路径缺失：开发者往往困惑于学习顺序（例如：应先学 MCP 还是 Hooks？），导致浅尝辄止，无法深入掌握。
3. 示例过于基础：官方的 "Hello World" 级示例无法帮助构建生产级的代码审查管道、自动化部署或安全扫描流程。
4. 功能盲区：用户往往只使用了 Claude Code 10% 的功能，却因“不知道不知道”而浪费了剩余 90% 的潜力。

该项目通过提供生产级模板和渐进式学习路径，解决了从“知道功能”到“高效应用”之间的断层。

核心功能

项目内容划分为 10 个模块化教程，覆盖 Claude Code 的所有核心特性：

• Slash Commands（斜杠命令）：
  • 提供如 optimize.md（代码优化）、pr.md（PR 准备）、generate-api-docs.md（API 文档生成）等现成模板。
  • 用户只需将 .md 文件复制到 .claude/commands/ 目录即可在终端直接调用。
• Memory（持久化记忆）：
  • 支持项目级、目录级和个人级上下文记忆。
  • 提供 CLAUDE.md 模板，用于存储团队规范、目录特定规则或个人偏好，确保跨会话的一致性。
• Skills（技能模块）：
  • 可复用的自动触发能力，包含指令和脚本。
  • 示例包括 code-review-specialist（代码审查专家）、brand-voice（品牌语气检查器）等。
• Subagents（子代理）：
  • 定义具有隔离上下文和自定义提示词的专业 AI 助手，用于处理特定任务。
• MCP (Model Context Protocol) 集成：
  • 提供配置示例，展示如何连接 GitHub 等外部数据源（如 claude mcp add github）。
• Hooks（钩子）：
  • 自动化脚本集成，可在特定事件触发时执行操作（如代码提交前自动运行检查）。
• Plugins（插件）：
  • 支持安装社区或官方插件（如 pr-review）。
• Checkpoints & Advanced Features：
  • 提供检查点配置和高级 CLI 参考，支持离线阅读（生成 EPUB 格式）。

此外，项目内置了 /self-assessment 和 /lesson-quiz 功能，用户可在 Claude Code 中直接运行自测，生成个性化的学习路线图。

亮点 / 与同类相比

• 结构化学习路径 vs. 碎片化文档：
  • 官方文档是功能参考手册，而 claude-howto 是教程。它提供了一条从新手到 Power User 的 11-13 小时渐进式学习路径，每个模块建立在前一个模块的基础上。
• 生产级模板 vs. Hello World：
  • 提供的模板（如完整的插件包、Hook 脚本、MCP 配置）可直接复制到项目中用于生产环境，而非仅用于演示。
• 可视化理解：
  • 使用 Mermaid 图表展示每个功能内部的运作机制，帮助用户理解“为什么”这样做，而不仅仅是“如何”操作。
• 高度活跃与维护：
  • 与 Claude Code 每次发布同步更新（最新同步至 v2.1.160，2026年6月版本）。
  • 社区驱动，包含来自开发者的真实世界配置案例。
• 多模型兼容：
  • 所有模板均兼容 Claude Sonnet 4.6、Opus 4.8 和 Haiku 4.5。
• 开源免费：
  • 采用 MIT 许可证，永久免费，允许个人、团队及商业项目自由使用。

适合谁用 / 上手

适合人群：

• 已安装 Claude Code 但不知如何深入使用的开发者。
• 希望构建自动化代码审查、部署管道和文档生成工作流的工程团队。
• 需要统一团队编码规范、记忆上下文和协作流程的技术负责人。
• 希望系统掌握 MCP、Hooks 和 Agent 编排的高级用户。

快速上手指南：

1. 安装 Claude Code：

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

   注：v2.1.113+ 版本为原生二进制文件，npm 安装会自动下载可选依赖。

2. 克隆项目：

   git clone https://github.com/luongnv89/claude-howto.git
   cd claude-howto
   

3. 体验核心功能（15分钟入门）：

   • 斜杠命令：

     mkdir -p /path/to/your-project/.claude/commands
     cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/
     # 在 Claude Code 中输入 /optimize
     

   • 项目记忆：

     cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md
     

   • 安装技能：

     cp -r 03-skills/code-review-specialist ~/.claude/skills/
     

4. 进阶学习：

   • 在 Claude Code 中运行 /self-assessment 获取个性化路线图。
   • 按顺序完成 10 个模块的学习，每章结束后运行 /lesson-quiz 巩固知识。
   • 参考 CONTRIBUTING.md 参与社区贡献。