Claude How To：34.4k+ Star 的 Claude Code 教程，GitHub 霸榜的"从入门到精通"

luongnv89/claude-howto 是一个在 GitHub 上收获超过 34,000 Star 的 Claude Code 实战指南。它不仅仅是一份静态的 API 文档，更是一个包含 10 个模块、覆盖从 Slash Command（斜杠命令）到全栈智能体（Agents）的完整学习体系。教程配有直观的 Mermaid 运行图解与即插即用的配置模板，适合从零基础小白到希望深度掌握 Claude Code 的开发者。

在 Claude Code 发布的一年多里，许多开发者在尝试运行几条 Prompt 后，往往会卡在以下瓶颈：

• 知道有 Slash Commands，但不知道如何将多条命令组合使用。
• 知道有 Skills（技能），但自己写的 Skill 总是无法在正确的时机被触发。
• 搞不清 Hooks（钩子）和 Skills 的本质区别，不知道什么时候该用哪一个。
• 配置了 MCP（Model Context Protocol）协议，但 Agent 根本不调用相关的外部工具。

官方文档更侧重于功能描述，并没有解答“应该按什么顺序学习”以及“如何将这些功能组合起来解决实际问题”。而 Claude How To 正是为了填补这一空白：

1. 清晰的学习路径：明确先学什么、后学什么，并估算了每个模块所需的学习时长。
2. 直观的 Mermaid 图解：用流程图展示每个功能内部的工作原理。
3. 即插即用的配置模板：提供可以直接复制到实际项目中的配置文件，而非无法落地的概念代码。

截至目前，该项目已收获 34,429 ⭐ Stars 和 4,210 Forks，版本已同步至最新的 Claude Code 发行版 v2.1.145。

整个教程分为三大阶梯，共 10 个模块，预计总学习时长为 11 到 13 小时。你完全可以每次只花 5 分钟学习其中一个子模块，并立即将其应用到工作中。

学完该阶段，你将能够应付日常的代码编写，并在切换多个项目时保证上下文不丢失。

• Slash Commands（30 分钟）：掌握 /command 的编写，并学会配置自定义命令。
• Memory（45 分钟）：理解 Chewie.md 的编写规范，以及项目级与目录级 CLAUDE.md 的区别。
• Checkpoints（45 分钟）：学会使用 /checkpoint、/diff、/rewind，将 Checkpoint 作为轻量级的代码版本管理工具。
• CLI Basics（30 分钟）：掌握 Claude 的命令行参数、批量运行模式及 --print 参数的用法。

• Skills（1 小时）：编写专属 Skill，并深入理解渐进式暴露（Progressive Disclosure）原理。
• Hooks（1 小时）：掌握事件驱动的自动化流程，配置 pre/post tool use 钩子。
• MCP（1 小时）：配置 MCP 服务，使 Agent 能够调用外部工具和检索外部数据。

• Subagents（1.5 小时）：学习如何构建拥有独立上下文、专用工具和特定模型的子 Agent。
• Advanced Features（2-3 小时）：掌握规划模式（Planning mode）、后台任务（Background tasks）以及跨模型审查（Cross-model review）。
• Plugins（2 小时）：了解插件市场、私有插件开发以及技能包管理。

每个模块学习完成后，你可以直接在 Claude Code 中运行测试命令。例如，在完成 Hooks 模块后输入：

/lesson-quiz hooks

系统会针对该模块进行提问，答完即可检验盲区。如果需要针对性地温习，可以运行：

/lesson-quiz hooks read-only

此外，你还可以通过以下命令进行全面的个人能力评估：

/self-assessment

该系统不考枯燥的概念（如“什么是 Agent Teams”），而是通过选择题询问你“实际项目中用过哪些功能”、“能否分清 Skills 与 Command 的区别”等实操问题，并根据结果为你定制后续的学习路径。

普通技术教程的代码大多仅作为“原理解释”的用例。而 Claude How To 提供的配置可以直接复制到你的项目目录中，实现“先运行，后理解”：

cp claude-howto/01-slash-commands/optimize.md → .claude/commands/
cp claude-howto/02-memory/project-CLAUDE.md → ./CLAUDE.md
cp -r claude-howto/03-skills/code-review-specialist → ~/.claude/skills/

每个核心功能都配有 Mermaid 调用链路图。通过将枯燥的文字转化为可视化的流程图，你可以更轻松地将配置项与底层运行逻辑对应起来。

项目的版本号（如当前的 v2.1.145）与官方 Claude Code 的发行版号严格保持同步。当 Claude Code 推出新功能或修改 API 时，教程会第一时间进行适配更新。

项目内置了多语言版本，无需借助翻译插件即可无障碍阅读：

• 简体中文（位于 zh/ 目录下）
• English
• Tiếng Việt
• 日本語
• Українська

你可以通过以下简单的步骤，在一小时内快速完成基础配置：

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

# 2. 复制第一条 slash command 到你的项目中
mkdir -p /path/to/your-project/.claude/commands/
cp claude-howto/01-slash-commands/optimize.md /path/to/your-project/.claude/commands/

# 3. 立即在 Claude Code 中输入以下命令进行体验：
# /optimize

# 4. 配置项目级记忆上下文
cp claude-howto/02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

# 5. 安装代码审查专家技能
cp -r claude-howto/03-skills/code-review-specialist ~/.claude/skills/

如果你希望在没有网络的环境下学习，或者喜欢使用电子阅读器，可以通过以下命令生成全量 EPUB 电子书：

uv run scripts/build_epub.py

Q: 这个教程与官方的 Best Practices Guide（最佳实践指南）有什么区别？

A: 官方的最佳实践指南主要聚焦于 Tips 的分享和基本概念的对比，适合用来查阅零散的技巧。而 Claude How To 侧重于体系化的学习路径以及直接可用的模板，适合想要系统性掌握该工具的开发者。

Q: 是否支持离线查看？

A: 支持。所有的配置文件和模板都保存在本地，无需联网即可使用。你还可以通过脚本生成 EPUB 电子书，放入阅读器中离线阅读。

Q: 零基础的开发者能看懂吗？

A: 完全可以。Level 1 阶段从最基础的命令行和最简单的斜杠命令讲起，不要求有任何前置配置经验。

• 系统化路径：摒弃碎片化学习，提供 11-13 小时、分阶段（基础、进阶、系统）的 Claude Code 完整晋级路线。
• 高实操性：配有可直接复制至项目目录的 .claude/commands/、CLAUDE.md 等模板，降低配置门槛。
• 智能自测：通过内置的 /self-assessment 和 /lesson-quiz 命令，在终端里直接通过答题定位知识盲区。
• 原生中文：提供高质量的中文本地化内容（zh/ 目录），扫清语言障碍。