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

Claude How To 是一份拥有 34,429+ Star 的 非 API 文档型学习体系。该项目以 v2.1.145 严格同步官方发行版，通过 10 个循序渐进的模块、内置自测系统、可一键复制的配置模板及 Mermaid 流程图，为初学者与进阶用户提供了从基础命令到高级 Agent 配置的完整实操路径。原始仓库：GitHub（Stars: 34,429 ⭐ | Forks: 4,210）。

Claude Code 发布一年多了。很多用户安装过、跑过几条 prompt 后，依然卡在以下核心问题：

• 知道 slash commands 存在，但不知道哪些命令能组合使用
• 知道有 Skills，但自定义 Skill 总是触发时机不对
• 知道有 Hooks，但不清楚何时该用 Hook 或 Skill
• 了解 MCP 协议，但在配置后 Agent 依然无法正确调用

官方文档主要负责描述功能，却不回答两个关键问题：“我该按什么顺序学？” 以及 “它们组合起来到底能干什么？” Claude How To 补的就是这个学习链路缺口。它不重复 API 文档的内容，而是直接提供三样东西：

1. 明确的学习路径——先学什么再学什么，每个模块标注耗时
2. 功能图解——每个功能内部工作流的 Mermaid 图
3. 可直接运行的配置模板——不是“照着文档配”，而是“拿到你的项目中就能跑”

34,000+ 的 Star 数量直接印证了这个系统性缺口的存在。

整个教程划分为三大梯级，共 10 个核心模块，支持按需学习：

Level 1：基础功力（入门级，约 2.5 小时）

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

📈 学完这 4 个模块后，即可使用 Claude 进行日常编码，并在多项目切换时保持上下文不丢失。

Level 2：组合能力（进阶级，约 3.5 小时）

• Skills（1 小时）——编写自定义 Skill，理解 progressive disclosure 原理
• Hooks（1 小时）——事件驱动的自动化，掌握 pre/post tool use 钩子机制
• MCP（1 小时）——配置 MCP server，让 Agent 高效调用外部工具与数据

Level 3：系统思维（高级，约 5 小时）

• Subagents（1.5 小时）——部署独立上下文、独立工具与独立模型的子 Agent
• Advanced Features（2-3 小时）——Planning mode、background tasks、cross-model review 等前沿特性
• Plugins（2 小时）——插件市场使用、私有插件开发及技能包管理

全文总计约 11-13 小时，但采用模块化设计，用户每次只需针对单一模块学习，平均 5 分钟即可上手实践。

每个模块学完后，可在 Claude Code 内直接运行命令进行针对性测试：

/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 的发行版号。不存在网上常见的“过时教程”或“手动修改废弃脚本”问题，官方更新一步跟进一步，可靠性远超网络搜索到的碎片化内容。

项目内置原生多语言支持：English、中文（zh/ 目录）、Tiếng Việt、日本語、Українська。阅读中文教程无需依赖第三方翻译插件。

完整部署步骤：

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

# 2. 复制第一条 slash command 到你的项目
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/

一小时极速全量配置（进阶）：

cp 01-slash-commands/*.md .claude/commands/     # 15 分钟
cp 02-memory/project-CLAUDE.md ./CLAUDE.md      # 15 分钟
cp -r 03-skills/code-review-specialist ~/.claude/skills/  # 15 分钟

离线阅读： 支持在本地运行 uv run scripts/build_epub.py 生成全量 EPUB 电子书，同步至任意阅读器。

Claude How To 并不是技术含量最高或代码量最多的项目，但它极可能是目前对 Claude Code 用户 最具实操价值 的指引资料。

它与官方提供的 Best Practices Guide 定位不同：后者聚焦 Tips 和概念对比，适合“想找某条具体建议”的场景；前者聚焦底层学习体系与标准化模板，适合“想系统掌握全部工作流”的用户。零基础可安全入门，老手亦可补齐盲点。因为它回答的核心问题不是“Claude Code 有什么功能”，而是 “你该如何学会并组合使用这些功能”。

• 精准填补教学空白：官方文档只罗列功能，本教程解决“学习顺序”与“功能组合落地”的断层问题。
• 模块化实战路径：10 个模块分三级（基础 ~2.5h / 进阶 ~3.5h / 高级 ~5h），支持按需抽取碎片化学习。
• 自带即时反馈闭环：内置 /lesson-quiz 与 /self-assessment 指令，学完即测、缺漏即补。
• 重模板轻展示：所有配置均为可一键 cp 落地的生产级文件（SLash Command、CLAUDE.md、Skills），开箱即用。
• 全语言 + 本地离线可用：支持中英越日乌五语，内置 EPUB 生成指令，保障断网环境下的连续学习体验。