luongnv89/claude-howto 来源：https://github.com/luongnv89/claude-howto GitHub Stars (https://github.com/luongnv89/claude-howto/stargazers) GitHub Forks (https://github.com/luongnv89/claude-howto/network/members) 许可证：MIT 版本 Claude Code (https://code.claude.com) 🌐 语言 / Ngôn ngữ / 语言 / Мова: English | Tiếng Việt | 中文 | Українська | 日本語 # 周末精通 Claude Code 从输入 claude 到编排智能体、钩子、技能和 MCP 服务器——配有可视化教程、可复制粘贴的模板和循序渐进的学习路径。 15 分钟快速上手 | 找到你的水平 | 浏览功能目录 — ## 目录 - 问题所在 - Claude How To 如何解决 - 工作原理 - 不知从何开始？ - 15 分钟快速上手 - 你能用它构建什么？ - 常见问题 - 贡献指南 - 许可证 — ## 问题所在 你安装了 Claude Code，运行了几个提示。然后呢？ - 官方文档只描述功能——却不教你如何组合使用它们。 你知道斜杠命令的存在，但不知道如何将它们与钩子、记忆和子智能体串联成一个真正节省数小时的工作流程。 - 没有清晰的学习路径。 你该先学 MCP 还是钩子？先学技能还是子智能体？结果你什么都浏览一遍，却什么也没精通。 - 例子太过基础。 一个“hello world”斜杠命令并不能帮你构建一个使用记忆、委派给专门智能体并自动运行安全扫描的生产级代码审查流水线。 你浪费了 Claude Code 90% 的潜力——而且你甚至不知道你不知道什么。 — ## Claude How To 如何解决 这并非又一个功能参考。这是一份结构化、可视化、以实例驱动的指南，教你使用每个 Claude Code 功能，并提供现成的模板，今天就能复制到你的项目中。 | | 官方文档 | 本指南 | |–|–––––|––––| | 形式 | 参考文档 | 带有 Mermaid 图表的可视化教程 | | 深度 | 功能描述 | 底层工作原理 | | 示例 | 基础代码片段 | 可直接使用的生产级模板 | | 结构 | 按功能组织 | 渐进式学习路径（从入门到高级） | | 入门上手 | 自行探索 | 带时间预估的引导式路线图 | | 自我评估 | 无 | 交互式测验，找出你的知识盲区并定制个人路径 | ### 你将获得： - 10 个教程模块，涵盖所有 Claude Code 功能——从斜杠命令到自定义智能体团队 - 可复制粘贴的配置——斜杠命令、CLAUDE.md 模板、钩子脚本、MCP 配置、子智能体定义和完整的插件包 - Mermaid 图表，展示每个功能的内部工作原理，让你理解为什么，而不仅仅是如何 - 循序渐进的学习路径，在 11-13 小时内带你从新手成长为高级用户 - 内置自我评估——直接在 Claude Code 中运行 /self-assessment 或 /lesson-quiz hooks 来找出知识盲区 开始学习路径 -> — ## 工作原理 ### 1. 找到你的水平 参加自我评估测验或在 Claude Code 中运行 /self-assessment。根据你已掌握的知识获得个性化路线图。 ### 2. 跟随引导路径 按顺序学习 10 个模块——每个模块都建立在前一个的基础上。学习过程中直接将模板复制到你的项目中。 ### 3. 将功能组合成工作流程 真正的力量在于组合功能。学习如何将斜杠命令、记忆、子智能体和钩子连接成自动化流水线，处理代码审查、部署和文档生成。 ### 4. 测试你的理解 每完成一个模块后运行 /lesson-quiz [topic]。测验能精确指出你遗漏的地方，让你快速填补空白。 15 分钟快速上手 — ## 深受开发者信赖 - GitHub Stars 来自日常使用 Claude Code 的开发者 - Forks 来自根据自身工作流程改编本指南的团队 - 积极维护——与每个 Claude Code 版本同步（最新版本：v2.1.160，2026 年 6 月） - 社区驱动——来自分享真实世界配置的开发者的贡献 Star History Chart (https://star-history.com/#luongnv89/claude-howto&Date) — ## 不知从何开始？ 进行自我评估或选择你的水平： | 水平 | 你能… | 从这里开始 | 时间 | |——|———|———–|——| | 入门 | 启动 Claude Code 并对话 | 斜杠命令 | ~2.5 小时 | | 中级 | 使用 CLAUDE.md 和自定义命令 | 技能 | ~3.5 小时 | | 高级 | 配置 MCP 服务器和钩子 | 高级功能 | ~5 小时 | 包含所有 10 个模块的完整学习路径： | 顺序 | 模块 | 水平 | 时间 | |——|——|——|——| | 1 | 斜杠命令 | 入门 | 30 分钟 | | 2 | 记忆 | 入门+ | 45 分钟 | | 3 | 检查点 | 中级 | 45 分钟 | | 4 | CLI 基础 | 入门+ | 30 分钟 | | 5 | 技能 | 中级 | 1 小时 | | 6 | 钩子 | 中级 | 1 小时 | | 7 | MCP | 中级+ | 1 小时 | | 8 | 子智能体 | 中级+ | 1.5 小时 | | 9 | 高级功能 | 高级 | 2-3 小时 | | 10 | 插件 | 高级 | 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——企业代理必须将主机加入白名单。 bash # 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/ # 3. 尝试它——在 Claude Code 中输入： # /optimize # 4. 准备好更多？设置项目记忆： cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md # 5. 安装一个技能： cp -r 03-skills/code-review-specialist ~/.claude/skills/ 想要完整设置？这是 1 小时基本设置： bash # 斜杠命令（15 分钟） 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/ # 周末目标：添加钩子、子智能体、MCP 和插件 # 按照学习路径进行引导式设置 查看完整安装参考 — ## 你能用它构建什么？ | 使用场景 | 你将组合的功能 | |–––––|––––––––| | 自动化代码审查 | 斜杠命令 + 子智能体 + 记忆 + MCP | | 团队入职培训 | 记忆 + 斜杠命令 + 插件 | | CI/CD 自动化 | CLI 参考 + 钩子 + 后台任务 | | 文档生成 | 技能 + 子智能体 + 插件 | | 安全审计 | 子智能体 + 技能 + 钩子（只读模式） | | DevOps 流水线 | 插件 + MCP + 钩子 + 后台任务 | | 复杂重构 | 检查点 + 规划模式 + 钩子 | — ## 常见问题 这是免费的吗？ 是的。MIT 许可，永久免费。可在个人项目、工作中、团队内使用——除保留许可证声明外无任何限制。 是否在维护？ 积极维护。本指南与每个 Claude Code 版本同步。当前版本：v2.1.160（2026 年 6 月），兼容 Claude Code 2.1+。 这与官方文档有何不同？ 官方文档是功能参考。本指南是带图表、生产级模板和渐进学习路径的教程。两者互补——从这里开始学习，需要具体细节时查阅文档。 全部学完需要多长时间？ 完整路径需要 11-13 小时。但你在 15 分钟内就能获得即时价值——只需复制一个斜杠命令模板并尝试。 我能在 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 许可。永久免费。克隆它，复刻它，让它成为你的。 开始学习路径 -> | 浏览功能目录 | 15 分钟快速上手 — 快速导航——所有功能 | 功能 | 描述 | 文件夹 | |——|——|––––| | 功能目录 | 包含安装命令的完整参考 | CATALOG.md | | 斜杠命令 | 用户调用的快捷方式 | 01-slash-commands/ | | 记忆 | 持久化上下文 | 02-memory/ | | 技能 | 可复用的能力 | 03-skills/ | | 子智能体 | 专门的 AI 助手 | 04-subagents/ | | MCP 协议 | 外部工具访问 | 05-mcp/ | | 钩子 | 事件驱动自动化 | 06-hooks/ | | 插件 | 捆绑功能 | 07-plugins/ | | 检查点 | 会话快照与回退 | 08-checkpoints/ | | 高级功能 | 规划、思考、后台任务 | 09-advanced-features/ | | CLI 参考 | 命令、标志和选项 | 10-cli/ | | 博客文章 | 真实世界使用示例 | Blog Posts (https://medium.com/@luongnv89) | 功能对比 | 功能 | 调用方式 | 持久性 | 最适合 | |——|———|––––|––––| | 斜杠命令 | 手动 (/cmd) | 仅会话 | 快速快捷方式 | | 记忆 | 自动加载 | 跨会话 | 长期学习 | | 技能 | 自动调用 | 文件系统 | 自动化工作流程 | | 子智能体 | 自动委派 | 隔离上下文 | 任务分配 | | MCP 协议 | 自动查询 | 实时 | 实时数据访问 | | 钩子 | 事件触发 | 已配置 | 自动化与验证 | | 插件 | 一条命令 | 所有功能 | 完整解决方案 | | 检查点 | 手动/自动 | 基于会话 | 安全实验 | | 规划模式 | 手动/自动 | 规划阶段 | 复杂实现 | | 后台任务 | 手动 | 任务持续时间 | 长时间运行操作 | | CLI 参考 | 终端命令 | 会话/脚本 | 自动化与脚本编程 | 安装快速参考 bash # 斜杠命令 cp 01-slash-commands/*.md .claude/commands/ # 记忆 cp 02-memory/project-CLAUDE.md ./CLAUDE.md # 技能 cp -r 03-skills/code-review-specialist ~/.claude/skills/ # 子智能体 cp 04-subagents/*.md .claude/agents/ # MCP export GITHUB_TOKEN="token" claude mcp add github -- npx -y @modelcontextprotocol/server-github # 钩子 mkdir -p ~/.claude/hooks cp 06-hooks/*.sh ~/.claude/hooks/ chmod +x ~/.claude/hooks/*.sh # 插件 /plugin install pr-review # 检查点（默认启用，在设置中配置） # 参见 08-checkpoints/README.md # 高级功能（在设置中配置） # 参见 09-advanced-features/config-examples.json # CLI 参考（无需安装） # 参见 10-cli/README.md 查看使用示例 01. 斜杠命令 位置：01-slash-commands/ 是什么：用户调用的快捷方式，存储为 Markdown 文件 示例： - optimize.md - 代码优化分析 - pr.md - 拉取请求准备 - generate-api-docs.md - API 文档生成器 安装： bash cp 01-slash-commands/*.md /path/to/project/.claude/commands/ 用法： /optimize /pr /generate-api-docs 了解更多：Discovering Claude Code Slash Commands (https://medium.com/@luongnv89/discovering-claude-code-slash-commands-cdc17f0dfb29) 02. 记忆 位置：02-memory/ 是什么：跨会话的持久化上下文 示例： - project-CLAUDE.md - 团队级项目标准 - directory-api-CLAUDE.md - 目录特定规则 - personal-CLAUDE.md - 个人偏好 安装： bash # 项目记忆 cp 02-memory/project-CLAUDE.md /path/to/project/CLAUDE.md # 目录记忆 cp 02-memory/directory-api-CLAUDE.md /path/to/project/src/api/CLAUDE.md # 个人记忆 cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md 用法：由 Claude 自动加载 03. 技能 位置：03-skills/ 是什么：可复用、自动调用的能力，包含指令和脚本 示例： - code-review-specialist/ - 带脚本的全面代码审查 - brand-voice/ - 品牌语态一致性检查器 - doc-generator/ - API 文档生成器 安装： bash # 个人技能 cp -r 03-skills/code-review-specialist ~/.claude/skills/ # 项目技能 cp -r 03-skills/code-review-specialist /path/to/project/.claude/skills/ 用法：在相关时自动调用 04. 子智能体 位置：04-subagents/ 是什么：具有隔离上下文和自定义提示的专门 AI 助手 示例： - code-reviewer.md - 全面代码质量分析 - test-engineer.md - 测试策略与覆盖率 - documentation-writer.md - 技术文档 - secure-reviewer.md - 安全焦点审查（只读） - implementation-agent.md - 完整功能实现 安装： bash cp 04-subagents/*.md /path/to/project/.claude/agents/ 用法：由主智能体自动委派 05. MCP 协议 位置：05-mcp/ 是什么：模型上下文协议，用于访问外部工具和 API 示例： - github-mcp.json - GitHub 集成 - database-mcp.json - 数据库查询 - filesystem-mcp.json - 文件操作 - multi-mcp.json - 多个 MCP 服务器 安装： bash # 设置环境变量 export GITHUB_TOKEN="your_token" export DATABASE_URL="postgresql://..." # 通过 CLI 添加 MCP 服务器 claude mcp add github -- npx -y @modelcontextprotocol/server-github # 或手动添加到项目 .mcp.json（参见 05-mcp/ 示例） 用法：配置后，MCP 工具自动对 Claude 可用 06. 钩子 位置：06-hooks/ 是什么：事件驱动的 shell 命令，自动响应 Claude Code 事件而执行 示例： - format-code.sh - 写入前自动格式化代码 - pre-commit.sh - 提交前运行测试 - security-scan.sh - 扫描安全问题 - log-bash.sh - 记录所有 bash 命令 - validate-prompt.sh - 验证用户提示 - notify-team.sh - 在事件时发送通知 安装： bash mkdir -p ~/.claude/hooks cp 06-hooks/*.sh ~/.claude/hooks/ chmod +x ~/.claude/hooks/*.sh 在 ~/.claude/settings.json 中配置钩子： json { "hooks": { "PreToolUse": [{ "matcher": "Write", "hooks": ["~/.claude/hooks/format-code.sh"] }], "PostToolUse": [{ "matcher": "Write", "hooks": ["~/.claude/hooks/security-scan.sh"] }] } } 用法：钩子在事件发生时自动执行 钩子类型（5 种类型…