> 📌 **项目地址**：[luongnv89/claude-howto](https://github.com/luongnv89/claude-howto) | ⭐ 35,650 颗星 | 🔧 Python | 📜 未标注
## 问题在哪
你装了Claude Code，试过几个prompt，然后呢？
Slash命令、CLAUDE.md、hooks、sub-agents、MCP服务器——这五个功能单独看，官方文档每页讲得清清楚楚。但你要干一个具体的事情，比如“写一个自定义代码审查命令，让它自动对比项目规范、标记问题、给修改建议”。这几个功能怎么组合？官方文档不画那条连线。
luongnv89/claude-howto的35,650个Star来自一个简单的事实：它把你需要的那条连线画出来了。
项目是Python写的，提供5种语言（中、英、日、越南、乌克兰文）。你可以不用Python，只需要往 `.claude/` 目录里放配置文件。
## 10个模块，三条路径
README把内容分成10个模块，按依赖关系可以归为三个层次。
**基础层（模块1-3）**：
1. 斜杠命令——配第一个自定义命令，15分钟能跑通
2. CLAUDE.md——控制回复风格、项目上下文、行为规则
3. Hooks——git提交前自动校验之类
**能力层（模块4-7）**：
4. Skills——把重复操作封装成可复用工具
5. MCP服务器——接外部工具（数据库、API、文件系统）
6. Memory——跨会话记忆项目历史
7. Sub-agents——把大任务拆给多个子agent
**集成层（模块8-10）**：
8. 自定义代理团队——多个sub-agent协作
9. 插件包——把skills、hooks、memory打包成一个整体
10. 生产部署——把前面学的东西放进真实项目
每个模块有三样东西：Mermaid流程图解释内部逻辑、配置文件模板（直接放 `.claude/`）、时间预估。模块1写的是“15分钟能搭起来”。我试了下，如果你已经装好Claude Code并买了订阅，配一个斜杠命令加一个CLAUDE.md文件，确实15-20分钟。那是从写模板开始，不是从零装环境。
## 它和官方文档实际差在哪
README里有一个对比表，我翻译关键点：
| 维度 | 官方文档 | 这个项目 |
|——|———-|———-|
| 组织形式 | 按功能分章 | 按学习路径从易到难 |
| 示例粒度 | 基础代码片段 | 完整可复制配置文件 |
| 解释深度 | 描述功能做什么 | 画图说明怎么做（Mermaid） |
| 上手方式 | 你自己翻目录 | 自评估后给个性化路径 |
| 多语言 | 只有英文 | 5种语言 |
最实在的区别：官方文档是查的，这个项目是学的。你不需要先理解每一步原理，复制粘贴让它跑起来，再看流程图理解逻辑。
## 三个最值钱的部分
**第一个：学习路径**
不是代码本身。那些hook脚本、MCP配置，有经验的开发者自己也能写。最值钱的是学习路径和组合思路。它节省了你试错的时间：不用自己摸索先学哪个、后学哪个，哪些配置可以共存，哪些会冲突。
**第二个：配置文件模板**
README里说的是“copy-paste configs”，包括slash commands, CLAUDE.md templates, hook scripts, MCP configs, subagent definitions, full plugin bundles。格式是现成的，改几个参数就能用。
**第三个：两个入口设计**
项目给了两条路。
– “15分钟开始”直接指向模块1的精简版，适合已经装好Claude Code的人，上来就干活。
– “不确定从哪开始？”READEME说有一套自评估测验，帮你找知识盲区再生成学习路径。我翻了README和CATALOG.md，没找到具体链接。如果测验没上线，按模块1到10的顺序走一遍也不亏。
另外CATALOG.md是总览文件。如果不想按顺序学，只想找一个功能的模板——比如MCP的配置——直接翻那个文件更快。
## 你需要的配置全在这
项目提供的内容，本质上是一整套 `.claude/` 目录下的配置文件集合。
– 斜杠命令配置：放 `.claude/commands/`
– CLAUDE.md：项目根目录
– Hook脚本：放 `.claude/hooks/`
– Skills：放 `.claude/skills/`
– MCP配置：通常是 `.claude/mcp.json`
– Sub-agent定义：放 `.claude/agents/`
中文翻译是完整的，不是机翻。如果你是中文用户，不用硬啃英文。
## 两个你必须知道的限制
**第一：依赖订阅**
项目本身开源，但前提你要有Claude Code的订阅。没有订阅，这些配置文件无处执行。这不是开源替代品，是付费产品的使用指南。34500个Star来自有订阅的人，不是靠开源替代方案圈粉。
**第二：配置需要定制**
配置文件不是“复制进去就完美适配”。模板基于通用场景。hooks的触发条件、MCP服务器的API地址，都得根据你项目改。如果你用GitHub Actions，hook脚本的目录结构可能和项目默认的不一样。如果你连的数据库是私有的，MCP配置里的连接信息得换。
许可证文件在根目录。复制配置模板放自己项目之前，看一眼LICENSE。
项目还在迭代。自评估测验没找到，可能后面会补上。
## 什么时候该用
**适合**：已经买了Claude Code订阅，想从“问答工具”升级成“开发工作流核心”的开发者。如果你之前只用Claude Code写代码、读代码，没碰过配置文件和自定义命令，这个项目能节省你配置时间。从模块1到7走一遍，大概一个周末能做完。手册里也写了：Go from typing `claude` to orchestrating agents, hooks, skills, and MCP servers — with visual tutorials, copy-paste templates, and a guided learning path。
**不适合**：还没有Claude Code订阅的人。
如果你只需要一个斜杠命令模板，或者MCP的配置参考，直接去CATALOG.md找，不用从模块1开始读。如果你想系统性地把Claude Code用透，按10个模块的顺序走一遍——至少到第7个模块。
===
标签：Claude Code，开发工具，工作流，配置文件