luongnv89/claude-howto
⭐ 32,138 · Python · GitHub 仓库
一份视觉化、示例驱动的Claude Code指南——涵盖从基础概念到高级代理，附带即用型复制粘贴模板，可立即带来实际价值。
claude-code guide tutorial
一句话总结
一本可视化、示例驱动的指南，通过即用型模板，将Claude Code新手蜕变为高级代理编排专家。
🔥 核心能力与独特卖点
- 10个渐进式教程模块 — 解决"从何入手"的难题，提供结构化的11-13小时学习路径，从斜杠命令到自定义代理团队，告别零散的官方文档。
- 即用型生产模板 — 消除配置猜测环节，提供可直接植入任何项目的现成斜杠命令、CLAUDE.md文件、钩子脚本、MCP配置和子代理定义。
- 可视化Mermaid图表 — 针对"知其然不知其所以然"的痛点，深入解析每项功能的内部机制，实现深度理解而非死记硬背。
- 内置自我评估 — 通过交互式
/self-assessment和/lesson-quiz命令，在Claude Code内直接生成个性化学习路径，精准定位知识盲区。 - 多语言支持 — 提供英文、越南文、中文、乌克兰文和日文版README，消除语言障碍，让全球开发者都能掌握Claude Code高级用法。
技术架构
| 组件 | 说明 |
|---|---|
| 语言 | Python（EPUB构建脚本，uv run scripts/build_epub.py） |
| 结构 | 模块化目录式指南（01-slash-commands/、02-memory/等） |
| 配置 | CLAUDE.md记忆文件、.claude/commands/、~/.claude/skills/ |
| 可扩展性 | MCP服务器配置、钩子脚本、子代理定义、插件包 |
| 离线支持 | 通过uv run scripts/build_epub.py生成EPUB |
| 兼容性 | Claude Sonnet 4.6、Opus 4.7、Haiku 4.5 |
快速入门指南
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 ~/.claude/skills/bash
# 1小时核心配置
# 斜杠命令（15分钟）
cp 01-slash-commands/*.md .claude/commands/
# 项目记忆（15分钟）
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
# 安装技能（15分钟）
cp -r 03-skills/code-review ~/.claude/skills/优势、局限与适用场景
优势
- MIT许可证，永久免费 — 无供应商锁定，无付费层级。
- 持续维护 — 与Claude Code每个版本同步更新（v2.1.138，2026年5月）。
- 社区驱动 — 欢迎贡献，确保最佳实践持续演进。
- 渐进式学习路径 — 从入门到高级代理编排，循序渐进。
局限
- 需要安装Claude Code — 非独立工具，依赖Anthropic生态系统。
- 完整学习路径需11-13小时 — 全面掌握需要相当的时间投入。
- 部分功能需高级配置 — 可能需要安装原生二进制文件及配置企业代理白名单。
不适合谁？
- 不使用Claude Code或偏好其他AI编程助手（如GitHub Copilot、Cursor）的开发者。
- 寻求5分钟快速配置、不愿深入探索功能的团队。
- 不愿投入11-13小时进行结构化学习的用户。
理想使用场景
- 新用户上手Claude Code — 提供从零到高级代理工作流的结构化入门路径。
- 团队配置标准化 — 即用型模板确保跨项目统一的斜杠命令、钩子和记忆文件。
- 构建自定义代理团队 — 子代理和插件高级模块支持复杂的多代理编排。
- 离线学习 — EPUB生成功能支持无网络环境下的学习。
社区与活跃度
该项目已获得32,138颗星标，并持续与Claude Code v2.1.138（2026年5月）同步维护，显然在开发者社区中引起了强烈共鸣。这股势头表明，市场对实用、示例驱动的指南有着强劲且不断增长的需求，这类指南能弥合官方文档与实际Claude Code掌握之间的鸿沟。开放的贡献模式和多语言支持预示着，该项目将持续演进，成为社区标准参考。