你和 10 倍生产力之间，差的就是它 : claude-howto，用一个周末掌握ClaudeCode

---

你和 10 倍生产力 之间，差的只是知道该怎么正确使用Claude Code。Claude-HowTo这份指南会提供结构化路径、可视化解释和可直接复制的模板，帮助你真正掌握它。

Claude Code 官方文档只告诉你有什么功能，却不告诉你怎么组合使用。

这就是 Claude How To 存在的意义。

这个项目已经在 GitHub 收获 超过 25.2k个 stars，采用 MIT 许可证，完全免费。

---

它是如何工作的

第一步：找到你的水平

完成自我评估测验，或者在 Claude Code 中运行 /self-assessment。系统会根据你已经掌握的内容，生成一份个性化学习路线。

第二步：按引导路径学习

按照顺序学习 10 个模块，每个模块都建立在前一个模块的基础上。你可以一边学，一边把模板直接复制到自己的项目中。

第三步：组合成工作流

真正的威力来自功能组合。你会学到如何把 slash commands、memory、subagents 和 hooks 连接成自动化流水线，用于代码审查、部署和文档生成等任务。

第四步：测试理解程度

每学完一个模块后运行 /lesson-quiz [topic]。测验会精准指出你漏掉的知识点，让你快速补齐短板。

---

学习路径：10 个模块，11-13 小时精通

不管你是新手还是老手，都能找到适合自己的起点：

模块	主题	难度	推荐时长
1	Slash Commands	初学者	30 分钟
2	Memory	初学者+	45 分钟
3	Checkpoints	中级	45 分钟
4	CLI Basics	初学者+	30 分钟
5	Skills	中级	1 小时
6	Hooks	中级	1 小时
7	MCP	中级+	1 小时
8	Subagents	中级+	1.5 小时
9	Advanced Features	高级	2-3 小时
10	Plugins	高级	2 小时

---

核心功能解析

1️⃣ Slash Commands --- 手动触发的快捷命令

比如 /optimize 可以一键优化代码，仅在当前会话生效。

2️⃣ Memory --- 跨会话持久化

项目级别的上下文记忆，下次打开依然记得项目背景。

3️⃣ Skills --- 会自动触发的能力包

不同于 slash commands，skills 会在合适的时机自动激活。

4️⃣ Subagents --- 专门化的 AI 助手

拥有隔离上下文和自定义提示词的专门化助手，适合复杂任务拆分。

5️⃣ Hooks --- 事件触发机制

基于 Git 事件的 shell 命令，支持 4 类共 25 个事件。

6️⃣ MCP Protocol --- 外部工具扩展

访问外部 API 和工具的能力。

7️⃣ Checkpoints --- 会话快照

随时保存和回退会话状态，不用担心搞砸。

---

实用场景组合

场景	推荐组合
自动化代码审查	Slash Commands + Subagents + Memory + MCP
团队入职培训	Memory + Slash Commands + Plugins
CI/CD 自动化	CLI Reference + Hooks + Background Tasks
安全审计	Subagents + Skills + Hooks
复杂重构	Checkpoints + Planning Mode + Hooks

---

快速上手：5 分钟体验

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

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

# 3. 在 Claude Code 中输入
/optimize

# 4. 设置项目记忆（跨会话持久化）
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

# 5. 安装 skill
cp -r 03-skills/code-review ~/.claude/skills/

---

实战示例

🟢 Level 1：Beginner --- 从这里开始

里程碑 1A：第一个命令与 Memory

# 练习 1：安装你的第一个 slash command
mkdir -p .claude/commands
cp 01-slash-commands/optimize.md .claude/commands/

# 练习 2：创建项目 memory
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# 练习 3：试用一下
# 在 Claude Code 中输入：/optimize

✅ 成功标准

• 成功执行 /optimize
• Claude 记住了 CLAUDE.md 中的项目规范
• 你知道什么时候用 slash command，什么时候用 memory

---

里程碑 1B：安全探索

# 练习 1：尝试 checkpoint 工作流
# 在 Claude Code 中：
# 做一些实验性修改，然后按 Esc+Esc 或使用 /rewind
# 选择你实验之前的 checkpoint
# 选择"恢复代码和对话"返回

# 练习 2：交互模式 vs 输出模式（Print mode）
claude "explain this project"           # 交互模式
claude -p "explain this function"       # 输出模式（非交互）

# 练习 3：通过管道处理文件内容
cat error.log | claude -p "explain this error"

✅ 成功标准

• 成功创建并回退到一个 checkpoint
• 使用过交互模式和 print mode
• 把文件通过管道传给 Claude 做分析
• 明白什么时候该用 checkpoints 做安全试验

---

🔵 Level 2：Intermediate --- 构建工作流

里程碑 2A：自动化（Skills + Hooks）

# 练习 1：安装一个 skill
cp -r 03-skills/code-review ~/.claude/skills/

# 练习 2：设置 hooks
mkdir -p ~/.claude/hooks
cp 06-hooks/pre-tool-check.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/pre-tool-check.sh

# 练习 3：在 settings 中配置 hooks
# 添加到 ~/.claude/settings.json：
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/pre-tool-check.sh"
          }
        ]
      }
    ]
  }
}

✅ 成功标准

• 在相关场景下，代码审查 skill 会自动触发
• PreToolUse hook 会在工具执行前运行
• 你理解 skill 自动触发和 hook 事件触发的区别

---

里程碑 2B：集成（MCP + Subagents）

# 练习 1：设置 GitHub MCP
export GITHUB_TOKEN="your_github_token"
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# 练习 2：测试 MCP 集成
# 在 Claude Code 中：/mcp__github__list_prs

# 练习 3：安装 subagents
mkdir -p .claude/agents
cp 04-subagents/*.md .claude/agents/

✅ 成功标准

• 能通过 MCP 成功查询 GitHub 数据
• Claude 会把复杂任务委派给 subagents
• 你理解 MCP 和 subagents 的区别
• 能把 MCP + subagents + hooks 组合进一个工作流

---

🔴 Level 3：Advanced --- 高阶用户与团队负责人

里程碑 3A：高级功能

# 练习 1：使用 planning mode
/plan Implement user authentication system

# 练习 2：尝试权限模式（共有 6 种：default、acceptEdits、plan、auto、dontAsk、bypassPermissions）
claude --permission-mode plan "analyze this codebase"
claude --permission-mode acceptEdits "refactor the auth module"
claude --permission-mode auto "implement the feature"

# 练习 3：启用 extended thinking
# 在会话中按 Alt+T（macOS 上是 Option+T）切换

# 练习 4：高级 checkpoint 工作流
# 1. 创建名为 "Clean state" 的 checkpoint
# 2. 使用 planning mode 设计功能
# 3. 通过 subagent 委派实现
# 4. 在后台运行测试
# 5. 如果测试失败，回退到 checkpoint
# 6. 尝试另一种方案

# 练习 5：尝试自动模式（Auto mode，后台安全分类器）
claude --permission-mode auto "implement user settings page"

# 练习 6：启用 agent teams
export CLAUDE_AGENT_TEAMS=1
# 让 Claude 执行："Implement feature X using a team approach"

# 练习 7：定时任务
/loop 5m /check-status
# 或使用 CronCreate 创建持久化定时任务

# 练习 8：用通道（Channels）管理多会话工作流
# 用 channels 来组织跨会话工作

# 练习 9：语音输入（Voice Dictation）
# 用语音输入和 Claude Code 进行无手操作

✅ 成功标准

• 为复杂功能使用过 planning mode
• 配置过权限模式（plan、acceptEdits、auto、dontAsk）
• 用 Alt+T / Option+T 切换过 extended thinking
• 使用过带后台安全分类器的自动模式（Auto mode）
• 使用过后台任务处理长时间操作
• 探索过通道（Channels）做多会话工作流
• 尝试过语音输入（Voice Dictation）做无手输入
• 理解 Remote Control、Desktop App 和 Web 会话
• 启用并使用过 Agent Teams 做协作任务
• 用过 /loop 做周期任务或定时监控

---

里程碑 3B：团队与分发（Plugins + CLI 精通）

# 练习 1：安装一个完整 plugin
# 在 Claude Code 中：/plugin install pr-review

# 练习 2：让 print mode 服务于 CI/CD
claude -p "Run all tests and generate report"

# 练习 3：为脚本输出 JSON
claude -p --output-format json "list all functions"

# 练习 4：会话管理与恢复
claude -r "feature-auth" "continue implementation"

# 练习 5：带约束的 CI/CD 集成
claude -p --max-turns 3 --output-format json "review code"

# 练习 6：批处理
for file in *.md; do
  claude -p --output-format json "summarize this: $(cat $file)" > ${file%.md}.summary.json
done

📝 课后测验

学完以上内容，可以运行以下命令测试你的理解程度：

/lesson-quiz slash-commands
/lesson-quiz memory
/lesson-quiz checkpoints
/lesson-quiz cli
/lesson-quiz skills
/lesson-quiz hooks
/lesson-quiz mcp
/lesson-quiz subagents
/lesson-quiz advanced-features

---

🔗 项目地址 ：github.com/luongnv89/c...