24.4K Star！这份Claude Code保姆级教程，90%的人装完就吃灰

大家好，我是何三，独立开发者

Claude Code装了，然后呢？

说个扎心的事实。Claude Code发布到现在，不少开发者装完之后的状态就是——打几个claude命令，聊几句，然后...不知道还能干啥了。

官方文档倒是写了不少，但问题是：它只会告诉你每个功能是什么，不会告诉你怎么把这些功能组合起来，变成真正能省时间的生产力工具。这就像给了你一本汽车说明书，但你还是不会开车。

最近GitHub上有个项目火了，24.4K Star，叫 claude-howto。它做的事情很简单粗暴——用10个模块、可视化教程、能直接复制粘贴的配置模板，把Claude Code从"会用"到"玩透"的学习路径给铺好了。

我花时间仔细过了一遍这个仓库，说说它到底解决了什么问题，哪些内容值得你直接抄作业。

为什么大多数人的Claude Code只用了10%

Claude Code的能力远不止"聊天写代码"。但大多数人卡在三个地方：

不知道学什么。Claude Code有斜杠命令、记忆系统、技能、子代理、MCP协议、Hooks钩子、插件、检查点... 光列出来就一大串。官方文档按功能组织，不是按学习路径组织的，你根本不知道先学哪个。

不知道怎么组合。单独会用一个功能没什么用。真正的效率提升来自组合——斜杠命令 + 记忆 + 子代理 + Hooks串成自动化流水线，这才是Claude Code的杀手级用法。但官方文档压根不会教你这个。

例子太基础。官方给的例子大多是hello world级别。你想要的是一个能真正在项目里跑的代码审查流水线，它给你一个"打印hello world"的命令。这中间的落差，让人无从下手。

claude-howto就是冲着这三个痛点来的。

10个模块，11-13小时搞定

这个仓库的核心结构很清晰，10个目录对应10个模块，从入门到高级逐层递进：

我挑几个最实用的模块说说。

斜杠命令：15分钟见效的快招

这是最简单也最容易上手的。Claude Code内置了60多个斜杠命令，但大多数人只会用/help和/clear。

claude-howto提供了8个预置的自定义命令，可以直接复制到项目里用：

# 复制所有预置命令
mkdir -p .claude/commands
cp 01-slash-commands/*.md .claude/commands/

几个比较实用的：

• /optimize — 代码性能分析，找内存泄漏和优化点
• /pr — PR提交前的检查清单，linting、测试、commit格式化一条龙
• /commit — 自动读git diff，生成带上下文的commit message
• /push-all — 暂存、提交、推送，内置安全检查（不会不小心把.env推上去）

不过有个变化值得注意：自定义命令现在被合并到了Skills系统里。.claude/commands/目录下的文件还能用，但推荐的方式是放在.claude/skills/下。两者都能创建/command-name格式的快捷方式，但Skills有更多能力。

Memory记忆系统：跨会话的持久上下文

这个功能很多新手完全忽略了。

Claude Code每次会话都是全新的——它不记得你上次聊了什么。但你可以通过CLAUDE.md文件告诉它项目的基本信息，这些信息会在每次会话自动加载。

claude-howto给了三个层级的记忆模板：

# 项目级记忆（团队共享）
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

实际效果就是：你不用每次都告诉Claude"我们用TypeScript"、"测试框架是Jest"、"commit格式遵循Conventional Commits"，它从CLAUDE.md里自己读。

Skills技能系统：自动触发的专业能力

这个是Claude Code真正强大的地方。

Skills跟斜杠命令的区别在于：斜杠命令需要你手动输入/xxx触发，而Skills会在Claude判断需要的时候自动触发。

举个例子，claude-howto里的代码审查技能：

---
name: code-review-specialist
description: 全面代码审查，包含安全、性能和质量分析。
  当用户要求审查代码、分析代码质量、评估PR时使用。
---

你只需要说"帮我review一下这段代码"，Claude就会自动识别并调用这个技能，执行完整的审查流程——包含安全漏洞检测、性能分析、代码质量评估、可维护性评分。

Skills采用渐进式加载架构，这点很巧妙：

• Level 1：只加载name和description（约100 tokens/个），几乎所有Skills都能同时挂载
• Level 2：被触发时才加载SKILL.md的完整指令
• Level 3：需要时才读脚本、模板等附加文件

所以你可以装几十个Skills，不用担心撑爆上下文窗口。

Hooks钩子：事件驱动的自动化

Hooks可能是被低估最多的功能。它在Claude Code的特定事件发生时自动执行脚本——比如写入文件前自动格式化、提交代码前跑测试、文件改动后自动安全扫描。

Claude Code支持26种Hook事件，4种Hook类型：

一个实用的例子——自动格式化+安全扫描：

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [
        {
          "type": "command",
          "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/format-code.sh"
        },
        {
          "type": "command",
          "command": "python3 $CLAUDE_PROJECT_DIR/.claude/hooks/security-scan.py"
        }
      ]
    }]
  }
}

Claude每次写或编辑文件后，自动跑格式化和安全扫描。安全扫描会检测硬编码的密码、API Key之类的敏感信息。

Subagents子代理：让AI分身术成为现实

子代理是Claude Code架构里最有意思的设计。

主Claude可以把任务委派给专门的子代理，每个子代理有独立的上下文窗口和自定义的系统提示词。这意味着复杂任务可以被拆分成多个专业化的小任务，各自处理，互不干扰。

claude-howto提供了6个开箱即用的子代理配置：

• code-reviewer — 代码审查专家，专注安全和质量
• test-engineer — 测试工程师，自动补测试用例
• debugger — 调试专家，根因分析
• secure-reviewer — 安全审查（只读权限，更安全）
• documentation-writer — 技术文档撰写
• data-scientist — 数据分析

# 安装所有子代理
mkdir -p .claude/agents
cp 04-subagents/*.md .claude/agents/

装完之后，你跟Claude说"审查一下最近的代码改动"，它会自动委派给code-reviewer子代理。审查完之后，子代理把结果浓缩返回给主代理，主代理再综合呈现给你。

更高级的玩法是Agent Teams（实验性功能）：多个Claude Code实例协同工作，各自有独立的上下文窗口，还能通过"邮箱系统"互相通信。适合大型任务——一个管API端点，一个管数据库Schema，一个管测试套件。

高级特性：Planning Mode、Extended Thinking、Auto Mode

到了这个层级，你已经在用Claude Code做真正的工程级的事情了。

Planning Mode 先规划再执行。你说"帮我加一个实时通知系统"，Claude不会直接开写，而是先出一份详细的实施计划——分几个阶段、改哪些文件、预估时间。你确认了，它才开始写代码。

Extended Thinking 深度推理。按Alt+T切换，让Claude花更多时间思考复杂问题。适合架构决策、算法选择这类需要权衡利弊的场景。

Auto Mode 自动模式（实验性）。后台有一个安全分类器，审查Claude的每个操作。读文件、编辑代码自动放行，但rm -rf、curl | bash、生产环境部署这类危险操作会被拦截。

真实组合案例

单独的功能说完了，怎么组合才是关键。claude-howto给了几个生产级的组合方案：

自动化代码审查：Slash Commands + Subagents + Memory + MCP

用户: /review-pr
Claude:
1. 加载项目记忆（编码规范）
2. 通过GitHub MCP拉取PR内容
3. 委派给code-reviewer子代理做代码质量审查
4. 委派给test-engineer子代理做测试覆盖分析
5. 综合两份报告，输出审查结果

DevOps部署：Plugins + MCP + Hooks

用户: /deploy production
Claude:
1. PreToolUse Hook验证环境配置
2. 委派给deployment子代理
3. 通过Kubernetes MCP执行部署
4. PostToolUse Hook跑健康检查
5. 报告部署状态

文档生成：Skills + Subagents + Memory

用户: "给认证模块生成API文档"
Claude:
1. 加载项目记忆（文档规范）
2. 自动触发doc-generator技能
3. 委派给documentation-writer子代理
4. 生成含示例的完整文档

直接上手

不想看完整的11小时学习路径？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/
cp 01-slash-commands/commit.md /path/to/your-project/.claude/commands/

# 3. 设置项目记忆
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

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

然后在Claude Code里试试/optimize、/commit，感受一下区别。

MIT开源协议，免费，社区驱动，2.9K fork。仓库还支持生成离线EPUB电子书——在飞机上也能学。

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

说实话，Claude Code这类AI编程工具的门槛不在安装，而在你知道它到底能干什么。大多数人浪费的不是工具本身，而是对工具能力的认知盲区。这个仓库最大的价值，就是把那90%你不知道的能力，用你能看懂的方式铺到了你面前。

本文使用 MGO 编辑并发布

关注"何三笔记"，回复"mgo" 免费下载使用