Claude Code 作为 Anthropic 推出的 AI 编程助手，许多开发者在安装后仅停留在简单的问答交互层面，未能发挥其真正的自动化潜力。官方文档虽然详尽地描述了各项功能，却缺乏将 Slash 命令、Hooks、Memory、Subagents 等特性组合成生产级工作流的系统性指导。
开源项目 claude-howto 填补了这一空白，它提供了一套视觉化、示例驱动的学习路径，帮助用户从基础概念逐步进阶到高级 Agent 编排。该指南将 Claude Code 的能力划分为 10 个渐进式模块，每个模块都配有可直接复制到项目中的模板文件，学习者在 15 分钟内即可获得第一个可用的自动化工具，完整掌握全部特性约需 11 至 13 小时。
核心架构：Claude Code 的 10 大能力模块
理解 Claude Code 的工作流编排，首先需要厘清其 10 个核心特性模块的层级关系与协作方式。
Slash Commands 是最基础的入口，以 Markdown 文件形式存储在项目 .claude/commands/ 目录下，用户通过 /command-name 触发。这类命令适合封装重复性任务，如代码优化分析、PR 准备、API 文档生成等场景。
Memory 机制通过 CLAUDE.md 文件实现跨会话的持久化上下文。项目级 Memory 放在仓库根目录，记录团队编码规范；目录级 Memory 放在特定代码目录，定义该模块的架构约束；个人级 Memory 位于 ~/.claude/CLAUDE.md，保存用户偏好。这种分层设计让 Claude 能在不同粒度上理解上下文。
Skills 是可复用的自动化能力包，包含指令和配套脚本，存放在 ~/.claude/skills/ 或项目级 .claude/skills/ 目录。与 Slash Commands 的手动触发不同，Skills 会在检测到相关任务时自动调用，例如代码审查专家 Skill 会在识别到代码变更请求时自动介入。
Subagents 是具备独立上下文和自定义提示词的专用 AI 助手，定义在 .claude/agents/ 目录下。主 Agent 可将任务委派给这些子代理，如代码审查员、测试工程师、文档编写者、安全审查员等，实现并行处理与专业分工。
MCP（Model Context Protocol） 是连接外部工具和 API 的桥梁，支持 GitHub、数据库、文件系统等集成。通过环境变量配置凭证后，Claude 可实时查询 GitHub PR、执行数据库查询或操作文件系统，将外部数据无缝融入工作流。
Hooks 提供事件驱动的自动化能力，支持 5 类 29 种事件触发。Tool Hooks 在工具调用前后执行，Session Hooks 在会话生命周期节点触发，Task Hooks 响应任务状态变化，Lifecycle Hooks 处理配置变更等事件。典型应用包括代码格式化、安全扫描、提交前测试等。
Plugins 是上述特性的打包集合，通过 /plugin install 一键安装完整解决方案，如 PR 审查工作流、DevOps 自动化套件等。
Checkpoints 实现会话状态快照与回滚，用户可通过 /rewind 回到任意历史节点，探索不同实现方案或从错误中恢复。
Advanced Features 包含规划模式（Planning Mode）、深度思考（Extended Thinking）、后台任务（Background Tasks）、权限模式（Permission Modes）和无头模式（Headless Mode）等高级能力，适用于复杂实现和 CI/CD 集成。
CLI 提供完整的命令行接口，支持交互模式、打印模式、管道输入、JSON 输出等，便于脚本自动化和批量处理。
渐进式学习路径：从 15 分钟到生产就绪
claude-howto 设计了一条清晰的学习路径，让不同水平的用户都能找到起点。
初学者（2.5 小时）从 Slash Commands 和 Memory 入手。15 分钟内完成首个命令配置：克隆仓库后，将 optimize.md 复制到项目 .claude/commands/ 目录，即可在 Claude Code 中输入 /optimize 体验代码优化分析。随后配置项目级 CLAUDE.md，让 Claude 理解团队编码规范。
中级用户（3.5 小时）深入 Skills、Hooks 和 MCP。Skills 的自动调用机制适合构建自动化代码审查流程；Hooks 的事件驱动特性可实现提交前自动测试和安全扫描；MCP 集成则将 GitHub、数据库等外部系统纳入工作流。
高级用户（5 小时）掌握 Subagents、Advanced Features 和 Plugins。Subagents 的多代理协作模式支持复杂任务的并行分解；Advanced Features 的规划模式适合大型重构项目；Plugins 则提供开箱即用的完整解决方案。
实战工作流：可复制的模板示例
自动化代码审查工作流 是 Slash Commands、Subagents、Memory 和 MCP 的组合应用。用户输入 /review-pr 后，Claude 首先加载项目 Memory 中的编码规范，通过 GitHub MCP 获取 PR 详情，然后并行委派给代码审查员 Subagent（关注代码质量）和测试工程师 Subagent（关注测试覆盖），最后综合两个子代理的分析结果输出完整审查报告。
DevOps 部署流水线 展示了 Plugins、MCP 和 Hooks 的协同。用户执行 /deploy production 时，PreToolUse Hook 先验证环境配置，然后主 Agent 委派给部署专家 Subagent，通过 Kubernetes MCP 执行部署操作，期间持续监控进度，部署完成后 PostToolUse Hook 执行健康检查并通知团队。
安全审计工作流 利用 Subagents、Skills 和 Hooks 构建只读审查模式。安全审查员 Subagent 被配置为只读权限，配合安全扫描 Skill 和代码写入前的安全扫描 Hook，确保潜在安全问题在代码变更前被拦截。
配置要点与最佳实践
在实际落地时，建议遵循渐进式增强原则。从单个 Slash Command 开始验证价值，再逐步叠加 Memory、Skills 等特性。所有配置文件应纳入版本控制，便于团队协作和回滚。
敏感信息（API Token、数据库凭证等）必须通过环境变量注入，避免硬编码。MCP 配置中的凭证应通过 export GITHUB_TOKEN="token" 方式设置，而非写入配置文件。
Hooks 脚本需放置在 ~/.claude/hooks/ 目录并赋予可执行权限，同时在 ~/.claude/settings.json 中配置触发规则。建议从 Tool Hooks 入手，如代码写入前的格式化操作，再扩展到其他事件类型。
Subagents 的提示词设计应明确职责边界和输入输出格式，避免任务重叠或遗漏。配合 Checkpoints 功能，可在复杂重构前创建快照，便于对比不同实现方案。
版本兼容与资源
claude-howto 当前版本 v2.1.160（2026 年 6 月）与 Claude Code 2.1+ 兼容，支持 Claude Sonnet 4.6、Claude Opus 4.8 和 Claude Haiku 4.5 模型。从 v2.1.113 起，Claude Code 采用原生平台二进制分发，企业环境需将 downloads.claude.ai 加入白名单。
该项目采用 MIT 协议开源，提供完整的中英文文档。用户可通过 uv run scripts/build_epub.py 生成离线 EPUB 电子书，包含所有内容和渲染后的 Mermaid 图表。
资料来源
- luongnv89/claude-howto: A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates (GitHub)
内容声明：本文无广告投放、无付费植入。
如有事实性问题，欢迎发送勘误至 i@hotdrydog.com。