AI Feeds
开源项目

claude-howto

面向 Claude Code 用户的视觉化教程，从基础 slash commands 到高级 agent、hooks、MCP 编排，配有可直接复制的模板和 Mermaid 流程图。亮点在于结构化的学习路径（共10个模块，预估11-13小时）和交互式自测功能，适合想系统掌握 Claude Code 全部潜力的开发者。MIT 开源许可，持续跟进 Claude Code 版本更新。

README

Claude How To

GitHub 星标 GitHub Forks License: MIT 版本 Claude Code

🌐 语言 / Ngôn ngữ / 语言 / Мова: English | Tiếng Việt | 中文 | Українська | 日本語

一个周末精通 Claude Code

从输入 claude 到编排 agent（代理）、hooks（钩子）、skills（技能）和 MCP servers（MCP 服务器）——附带可视化教程、可直接复制粘贴的模板以及分阶段的学习路径。

15 分钟开始 | 找到你的水平 | 浏览功能目录

目录

问题

你安装了 Claude Code。你运行了几个 prompt（提示）。然后呢？

  • 官方文档描述了功能——但没有展示如何组合运用。 你知道 slash commands（斜杠命令）存在，但不知道如何将它们与 hooks、memory（记忆）和 subagents（子代理）链式组合成一个真正节省数小时的工作流。
  • 没有清晰的学习路径。 你应该先学习 MCP 还是 hooks？先学 skills 还是 subagents？最终你只能走马观花，什么都不精通。
  • 示例过于简单。 一个 "hello world" 的 slash command 并不能帮你构建一个使用 memory、委派给专业 agent（代理）并自动运行安全扫描的生产级代码审查流水线。

你浪费了 Claude Code 90% 的能力——而且你根本不知道自己所不知道的。

Claude How To 如何解决

这不是另一份功能参考文档。这是一份结构化、可视化、示例驱动的指南，教你使用每个 Claude Code 功能，并提供真实世界的模板，你可以今天就将它们复制到自己的项目中。

官方文档 本指南
形式 参考文档 可视化教程（含 Mermaid 图）
深度 功能描述 底层工作原理
示例 基础代码片段 可直接使用的生产级模板
结构 按功能组织 渐进式学习路径（从入门到高级）
上手 自助探索 带时间估算的引导式路线图
自我评估 无 互动测验，找出知识盲点并定制个性化路径

你会获得：

  • 10 个教程模块，覆盖每个 Claude Code 功能——从 slash commands 到自定义 agent teams（代理团队）
  • 可直接复制粘贴的配置——slash commands、CLAUDE.md 模板、hook 脚本、MCP 配置、subagent 定义，以及完整的 plugin bundles（插件包）
  • Mermaid 图，展示每个功能的内部工作原理，让你理解为什么，而不仅仅是怎么做
  • 引导式学习路径，在 11-13 小时内从新手晋升为高级用户
  • 内置自我评估——在 Claude Code 中运行 /self-assessment 或 /lesson-quiz hooks 来识别知识缺口

开始学习路径 ->

工作原理

1. 找到你的水平

进行自我评估测验或在 Claude Code 中运行 /self-assessment。根据你已经掌握的内容获得个性化路线图。

2. 跟随引导路径

按顺序完成 10 个模块——每个模块都建立在前一个基础上。边学边将模板直接复制到你的项目中。

3. 组合功能形成工作流

真正的力量在于组合功能。学习如何将 slash commands + memory + subagents + hooks 连接起来，形成自动化流水线，处理代码审查、部署和文档生成。

4. 测试你的理解

在每个模块之后运行 /lesson-quiz [topic]。测验会指出你漏掉的内容，让你快速填补知识空白。

15 分钟开始

受到开发者信赖

  • GitHub stars 来自每日使用 Claude Code 的开发者
  • Forks 来自团队，将本指南调整用于自己的工作流
  • 积极维护——与每个 Claude Code 版本同步（最新：v2.1.160，2026 年 6 月）
  • 社区驱动——贡献来自分享真实配置的开发者

Star History Chart

不知道从何开始？

进行自我评估，或选择你的水平：

水平 你能... 从这里开始 时间
入门 启动 Claude Code 并对话 Slash Commands ~2.5 小时
中级 使用 CLAUDE.md 和自定义命令 Skills ~3.5 小时
高级 配置 MCP 服务器和 hooks 高级功能 ~5 小时

包含全部 10 个模块的完整学习路径：

顺序 模块 水平 时间
1 Slash Commands 入门 30 分钟
2 Memory 入门+ 45 分钟
3 Checkpoints 中级 45 分钟
4 CLI 基础 入门+ 30 分钟
5 Skills 中级 1 小时
6 Hooks 中级 1 小时
7 MCP 中级+ 1 小时
8 Subagents 中级+ 1.5 小时
9 高级功能 高级 2-3 小时
10 Plugins 高级 2 小时

完整学习路线图 ->

15 分钟开始

安装说明: 从 v2.1.113 开始，Claude Code 以每个平台的本地二进制文件（macOS/Linux/Windows）形式提供。npm install -g @anthropic-ai/claude-code 仍然有效——本地二进制文件在首次使用时作为可选依赖下载。从 v2.1.116 开始，下载来自 https://downloads.claude.ai/claude-code-releases——企业代理必须将此主机加入白名单。

# 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. 准备更多？设置项目 memory：
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

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

想要完整设置？这里是1 小时基本设置：

# Slash commands（15 分钟）
cp 01-slash-commands/*.md .claude/commands/

# 项目 memory（15 分钟）
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# 安装一个 skill（15 分钟）
cp -r 03-skills/code-review-specialist ~/.claude/skills/

# 周末目标：添加 hooks、subagents、MCP 和 plugins
# 跟随学习路径进行引导设置

查看完整安装参考

你能用它构建什么？

用例 你将组合的功能
自动化代码审查 Slash Commands + Subagents + Memory + MCP
团队上手 Memory + Slash Commands + Plugins
CI/CD 自动化 CLI Reference + Hooks + Background Tasks
文档生成 Skills + Subagents + Plugins
安全审计 Subagents + Skills + Hooks（只读模式）
DevOps 流水线 Plugins + MCP + Hooks + Background Tasks
复杂重构 Checkpoints + Planning Mode + Hooks

常见问题

这是免费的吗？ 是的。MIT 许可，永远免费。可用于个人项目、工作场所、团队——唯一要求是包含许可声明。

有人维护吗？ 积极维护。本指南与每个 Claude Code 版本同步。当前版本：v2.1.160（2026 年 6 月），兼容 Claude Code 2.1+。

这与官方文档有何不同？ 官方文档是功能参考。本指南是带图解、生产级模板和渐进学习路径的教程。二者互补——从这里开始学习，在需要细节时参考官方文档。

全部学完需要多长时间？ 完整路径需要 11-13 小时。但 15 分钟内就能获得即时价值——只需复制一个 slash command 模板并尝试它。

我可以和 Claude Sonnet / Haiku / Opus 一起使用吗？ 可以。所有模板都适用于 Claude Sonnet 4.6、Claude Opus 4.8 和 Claude Haiku 4.5。

我可以贡献吗？ 当然可以。请参阅 CONTRIBUTING.md 获取指南。我们欢迎新示例、错误修复、文档改进和社区模板。

我可以离线阅读吗？ 可以。运行 uv run scripts/build_epub.py 生成包含所有内容和渲染后图表的 EPUB 电子书。

今天就开始精通 Claude Code

你已经安装了 Claude Code。你和 10 倍生产力之间唯一的障碍就是知道如何正确地使用它。本指南为你提供结构化的路径、可视化的解释和可直接复制粘贴的模板。

MIT 许可。永远免费。克隆它、Fork 它、让它成为你的工具。

开始学习路径 -> | 浏览功能目录 | 15 分钟开始

快速导航——所有功能
功能 描述 文件夹
功能目录 带安装命令的完整参考 CATALOG.md
Slash Commands 用户调用的快捷方式 01-slash-commands/
Memory 持久上下文 02-memory/
Skills 可复用能力 03-skills/
Subagents 专门的 AI 助手 04-subagents/
MCP Protocol 外部工具访问 05-mcp/
Hooks 事件驱动自动化 06-hooks/
Plugins 打包功能集 07-plugins/
Checkpoints 会话快照与回退 08-checkpoints/
高级功能 规划、思考、后台任务 09-advanced-features/
CLI Reference 命令、标志和选项 10-cli/
博客文章 真实使用案例 博客文章
功能对比
功能 调用方式 持久性 最佳用途
Slash Commands 手动（/cmd） 仅会话 快速快捷方式
Memory 自动加载 跨会话 长期学习
Skills 自动调用 文件系统 自动化工作流
Subagents 自动委派 隔离上下文 任务分发
MCP Protocol 自动查询 实时 实时数据访问
Hooks 事件触发 配置后持续 自动化和验证
Plugins 一条命令 所有功能 完整解决方案
Checkpoints 手动/自动 基于会话 安全实验
Planning Mode 手动/自动 规划阶段 复杂实现
Background Tasks 手动 任务持续时间 长时间运行的操作
CLI Reference 终端命令 会话/脚本 自动化和脚本
安装快速参考
# Slash Commands
cp 01-slash-commands/*.md .claude/commands/

# Memory
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

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

# Subagents
cp 04-subagents/*.md .claude/agents/

# MCP
export GITHUB_TOKEN="token"
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Hooks
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# Plugins
/plugin install pr-review

# Checkpoints (auto-enabled, configure in settings)
# See 08-checkpoints/README.md

# Advanced Features (configure in settings)
# See 09-advanced-features/config-examples.json

# CLI Reference (no installation needed)
# See 10-cli/README.md for usage examples
01. Slash Commands

位置: 01-slash-commands/

内容: 用户调用的快捷方式，存储为 Markdown 文件

示例:

  • optimize.md - 代码优化分析
  • pr.md - 拉取请求准备
  • generate-api-docs.md - API 文档生成器

安装:

cp 01-slash-commands/*.md /path/to/project/.claude/commands/

用法:

/optimize
/pr
/generate-api-docs

了解更多: 探索 Claude Code Slash Commands

02. Memory

位置: 02-memory/

内容: 跨会话的持久上下文

示例:

  • project-CLAUDE.md - 团队级项目标准
  • directory-api-CLAUDE.md - 目录特定规则
  • personal-CLAUDE.md - 个人偏好

安装:

# Project memory
cp 02-memory/project-CLAUDE.md /path/to/project/CLAUDE.md

# Directory memory
cp 02-memory/directory-api-CLAUDE.md /path/to/project/src/api/CLAUDE.md

# Personal memory
cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md

用法: 由 Claude 自动加载

03. Skills

位置: 03-skills/

内容: 可复用的自动调用能力，包含指令和脚本

示例:

  • code-review-specialist/ - 附带脚本的全面代码审查
  • brand-voice/ - 品牌语调一致性检查器
  • doc-generator/ - API 文档生成器

安装:

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

# Project skills
cp -r 03-skills/code-review-specialist /path/to/project/.claude/skills/

用法: 在相关时自动调用

04. Subagents

位置: 04-subagents/

内容: 专门的 AI 助手，具有隔离上下文和自定义 prompt

示例:

  • code-reviewer.md - 全面的代码质量分析
  • test-engineer.md - 测试策略和覆盖率
  • documentation-writer.md - 技术文档
  • secure-reviewer.md - 安全重点审查（只读）
  • implementation-agent.md - 完整功能实现

安装:

cp 04-subagents/*.md /path/to/project/.claude/agents/

用法: 由主 agent 自动委派

05. MCP Protocol

位置: 05-mcp/

内容: Model Context Protocol（模型上下文协议），用于访问外部工具和 API

示例:

  • github-mcp.json - GitHub 集成
  • database-mcp.json - 数据库查询
  • filesystem-mcp.json - 文件操作
  • multi-mcp.json - 多个 MCP 服务器

安装:

# Set environment variables
export GITHUB_TOKEN="your_token"
export DATABASE_URL="postgresql://..."

# Add MCP server via CLI
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Or add to project .mcp.json manually (see 05-mcp/ for examples)

用法: 配置后，MCP 工具自动可供 Claude 使用

06. Hooks

位置: 06-hooks/

内容: 事件驱动的 shell 命令，自动响应 Claude Code 事件执行

示例:

  • format-code.sh - 在写入前自动格式化代码
  • pre-commit.sh - 在提交前运行测试
  • security-scan.sh - 扫描安全问题
  • log-bash.sh - 记录所有 bash 命令
  • validate-prompt.sh - 验证用户 prompt
  • notify-team.sh - 在事件发生时发送通知

安装:

mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

在 ~/.claude/settings.json 中配置 hooks：

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Write",
      "hooks": ["~/.claude/hooks/format-code.sh"]
    }],
    "PostToolUse": [{
      "matcher": "Write",
      "hooks": ["~/.claude/hooks/security-scan.sh"]
    }]
  }
}

用法: Hooks 在事件发生时自动执行

Hook 类型（5 种类型，29 个事件）：

  • 工具 Hooks: PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest
  • 会话 Hooks: SessionStart, SessionEnd, Stop, StopFailure, SubagentStart, SubagentStop
  • 任务 Hooks: UserPromptSubmit, TaskCompleted, TaskCreated, TeammateIdle
  • 生命周期 Hooks: ConfigChange, CwdChanged, FileChanged, PreCompact, PostCompact, WorktreeCreate, WorktreeRemove, Notification, InstructionsLoaded, Elicitation, ElicitationResult
07. Plugins

位置: 07-plugins/

内容: 打包的命令、agent、MCP 和 hooks 的集合

示例:

  • pr-review/ - 完整的 PR 审查工作流
  • devops-automation/ - 部署和监控
  • documentation/ - 文档生成

安装:

/plugin install pr-review
/plugin install devops-automation
/plugin install documentation

用法: 使用打包的 slash commands 和功能

08. Checkpoints and Rewind

位置: 08-checkpoints/

内容: 保存对话状态并回退到之前的点，以探索不同的方法

关键概念:

  • Checkpoint: 对话状态的快照
  • Rewind: 返回之前的 checkpoint
  • Branch Point: 从同一 checkpoint 探索多种方法

用法:

# Checkpoints are created automatically with every user prompt
# To rewind, press Esc twice or use:
/rewind

# Then choose from five options:
# 1. Restore code and conversation
# 2. Restore conversation
# 3. Restore code
# 4. Summarize from here
# 5. Never mind

使用场景:

  • 尝试不同的实现方法
  • 从错误中恢复
  • 安全实验
  • 比较替代解决方案
  • A/B 测试不同设计
09. 高级功能

位置: 09-advanced-features/

内容: 复杂工作流和自动化的高级能力

包括:

  • Planning Mode — 在编码前创建详细的实现计划
  • Extended Thinking — 针对复杂问题的深度推理（按 Alt+T / Option+T 切换）
  • Background Tasks — 不阻塞地运行长时间操作
  • Permission Modes — default, acceptEdits, plan, dontAsk, bypassPermissions
  • Headless Mode — 在 CI/CD 中运行 Claude Code：claude -p "Run tests and generate report"
  • Session Management — /resume, /rename, /fork, claude -c, claude -r
  • Configuration — 在 ~/.claude/settings.json 中自定义行为

完整配置见 config-examples.json。

10. CLI 参考

位置: 10-cli/

内容: Claude Code 的完整命令行界面参考

快速示例:

# Interactive mode
claude "explain this project"

# Print mode (non-interactive)
claude -p "review this code"

# Process file content
cat error.log | claude -p "explain this error"

# JSON output for scripts
claude -p --output-format json "list functions"

# Resume session
claude -r "feature-auth" "continue implementation"

使用场景: CI/CD 流水线集成、脚本自动化、批处理、多会话工作流、自定义 agent 配置

示例工作流

完整代码审查工作流

# Uses: Slash Commands + Subagents + Memory + MCP

User: /review-pr

Claude:
1. Loads project memory (coding standards)
2. Fetches PR via GitHub MCP
3. Delegates to code-reviewer subagent
4. Delegates to test-engineer subagent
5. Synthesizes findings
6. Provides comprehensive review

自动化文档

# Uses: Skills + Subagents + Memory

User: "Generate API documentation for the auth module"

Claude:
1. Loads project memory (doc standards)
2. Detects doc generation request
3. Auto-invokes doc-generator skill
4. Delegates to api-documenter subagent
5. Creates comprehensive docs with examples

DevOps 部署

# Uses: Plugins + MCP + Hooks

User: /deploy production

Claude:
1. Runs pre-deploy hook (validates environment)
2. Delegates to deployment-specialist subagent
3. Executes deployment via Kubernetes MCP
4. Monitors progress
5. Runs post-deploy hook (health checks)
6. Reports status
目录结构
├── 01-slash-commands/
│   ├── optimize.md
│   ├── pr.md
│   ├── generate-api-docs.md
│   └── README.md
├── 02-memory/
│   ├── project-CLAUDE.md
│   ├── directory-api-CLAUDE.md
│   ├── personal-CLAUDE.md
│   └── README.md
├── 03-skills/
│   ├── code-review-specialist/
│   │   ├── SKILL.md
│   │   ├── scripts/
│   │   └── templates/
│   ├── brand-voice/
│   │   ├── SKILL.md
│   │   └── templates/
│   ├── doc-generator/
│   │   ├── SKILL.md
│   │   └── generate-docs.py
│   └── README.md
├── 04-subagents/
│   ├── code-reviewer.md
│   ├── test-engineer.md
│   ├── documentation-writer.md
│   ├── secure-reviewer.md
│   ├── implementation-agent.md
│   └── README.md
├── 05-mcp/
│   ├── github-mcp.json
│   ├── database-mcp.json
│   ├── filesystem-mcp.json
│   ├── multi-mcp.json
│   └── README.md
├── 06-hooks/
│   ├── format-code.sh
│   ├── pre-commit.sh
│   ├── security-scan.sh
│   ├── log-bash.sh
│   ├── validate-prompt.sh
│   ├── notify-team.sh
│   └── README.md
├── 07-plugins/
│   ├── pr-review/
│   ├── devops-automation/
│   ├── documentation/
│   └── README.md
├── 08-checkpoints/
│   ├── checkpoint-examples.md
│   └── README.md
├── 09-advanced-features/
│   ├── config-examples.json
│   ├── planning-mode-examples.md
│   └── README.md
├── 10-cli/
│   └── README.md
└── README.md (this file)
最佳实践

应该做

  • 从简单的 slash commands 开始
  • 逐步添加功能
  • 使用 memory 存储团队标准
  • 先在本地测试配置
  • 记录自定义实现
  • 将项目配置纳入版本控制
  • 与团队分享 plugins

不应该做

  • 不要创建冗余功能
  • 不要硬编码凭证
  • 不要跳过文档
  • 不要让简单任务复杂化
  • 不要忽视安全最佳实践
  • 不要提交敏感数据
故障排除

功能未加载

  1. 检查文件位置和命名
  2. 验证 YAML frontmatter 语法
  3. 检查文件权限
  4. 检查 Claude Code 版本兼容性

MCP 连接失败

  1. 验证环境变量
  2. 检查 MCP 服务器安装
  3. 测试凭证
  4. 检查网络连接

Subagent 未委派

  1. 检查工具权限
  2. 验证 agent 描述清晰度
  3. 检查任务复杂度
  4. 单独测试 agent
测试

本项目包含全面的自动化测试

开源项目luongnv892026-06-08原文

相关内容