跳转到内容
全部开发指南

Claude Code 配置怎么一次装好？用 claude-code-templates 按需装 Agent、Hook 和 MCP

AIGoCode发布于 更新于

Claude Code 配置怎么一次装好？用 claude-code-templates 按需装 Agent、Hook 和 MCP 封面

装好 Claude Code 之后，很多人做的第一件事是打开 CLAUDE.md 写几条规则，然后就停在这里了。Hook 可以在危险操作前拦一下，自定义 Command 可以一句话跑完一整套测试，MCP 可以让 Claude 直接查数据库，这些能力都在，只是要自己一个个从零配。

claude-code-templates 解决的就是这个问题。它把社区里常用的 Claude Code 配置收集起来，按类别整理成独立组件，用一条 npx 命令按需安装。项目在 GitHub 上已超过 3 万 star。

这篇文章适合已经在用 Claude Code、想快速补齐 Agent、Hook、MCP 等配置的开发者。下面依次讲 claude-code-templates 的六类组件、安装命令、附带的几个工具、组件来源，以及值得优先装的几个组件和使用时要注意的地方。

claude-code-templates 的六类组件

六类组件正好对应 Claude Code 的六个扩展点，先把它们分清楚：

类型作用例子
Agent给 Claude 一个专家角色code-reviewer 用架构审查员的视角看代码；playwright-tester 负责自动化测试
Command自定义斜杠命令，一句话触发一套流程/generate-tests、/optimize-bundle
MCP连接外部服务GitHub 操作 PR、PostgreSQL 查库
Hook在特定操作前后自动执行检查提交前扫描硬编码密钥
Skill比 Agent 更细的可复用能力PDF 处理、Excel 自动化、TDD 红绿重构
Setting全局配置超时、输出风格、权限、遥测开关

Agent 覆盖前端、DevOps、数据、游戏开发等多个方向；Command 涵盖分析、部署、Git 工作流和数据库操作；MCP 从数据库、浏览器自动化到营销工具都有。具体数量一直在变，以官网 aitmpl.com 当前列出的为准。

claude-code-templates 原文配图 1

如果你还不熟悉这些组件最终放在哪里，可以先看 Claude Code 的 .claude 文件夹怎么配，里面逐个讲了 CLAUDE.md、rules、skills 和权限配置。

怎么安装 claude-code-templates 组件

安装不需要先全局装什么，直接用 npx：

# 交互式浏览，选好再装
npx claude-code-templates@latest

# 直接装指定组件
npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command performance/optimize-bundle --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

# 一次装一整套开发栈
npx claude-code-templates@latest --agent development-team/frontend-developer --command testing/generate-tests --mcp development/github-integration --yes

每个组件都是独立的 JSON 或 Markdown 文件，装进项目的 .claude 目录后各归各位。不想要哪个，删掉对应文件即可，不影响其他组件。

也可以在网页上挑：aitmpl.com 能在线浏览组件、看说明和安装量，选好的组件加入 Stack Builder，最后生成一条命令一次装完。

除了模板，还附带几个工具

claude-code-templates 原文配图 2

  • Analytics：运行 npx claude-code-templates@latest --analytics，可以看到 Claude Code 的会话状态、工具调用频率和性能指标。
  • Chat Viewer：加 --chats 参数可以在手机上查看 Claude 的实时回复；再加 --tunnel 会走 Cloudflare Tunnel，外网也能访问。适合挂着长任务离开电脑的时候用。
  • Health Check：加 --health-check 参数，诊断 Claude Code 安装和配置是否正常。
  • Plugins 面板：加 --plugins 参数，在一个界面里查看插件市场、已安装插件和权限。

组件从哪里来

claude-code-templates 是社区聚合项目，组件来自多个开源仓库，例如 Anthropic 官方 Skill、obra/superpowers 的工作流 Skill、wshobson/agents 的 Agent，以及 awesome-claude-code 收录的命令等，README 里列了各个来源和许可证。可以把它理解成 Claude Code 生态里的一个组件市场：搜一下、装一下就能用，但每个组件的质量取决于原作者，装之前最好看一眼内容。

和 mattpocock/skills 有什么区别

两者经常被放在一起比较：

对比项mattpocock/skillsclaude-code-templates
来源Matt Pocock 一个人维护社区多个仓库聚合
风格个人偏好强，比如 TDD、先追问需求不做取舍，提供大量可选组件
适合认同他工作方式、想直接套一套流程想按项目自己挑组合

如果你倾向前者，可以参考我们写过的 mattpocock skills 安装教程。

claude-code-templates 原文配图 3

值得优先装的几个组件

  • 密钥扫描类 Hook：提交前自动扫描代码里硬编码的 API Key，能识别 Anthropic、OpenAI、AWS、Stripe、Google、GitHub、HuggingFace 等常见格式。
  • 架构审查类 Agent：不看代码细节，评估服务边界、数据归属和技术选型，适合微服务拆分、技术栈迁移这类决策。
  • 数据库 MCP：让 Claude 直接连 PostgreSQL（包括 Neon 这类 Serverless 数据库）查询数据，不用来回复制查询结果。
  • 强制推送拦截 Hook：拦下 git push 的强制推送，避免覆盖远程分支。

组件名称会随项目更新调整，安装前在 aitmpl.com 搜一下当前的名字。

使用时要注意的地方

  • Hook 会在本机执行脚本，MCP 会连接外部服务，装之前先读一遍组件内容，确认它做了什么、要哪些权限。
  • 不要一次装太多 MCP。每个 MCP 的工具描述都会占用上下文，接得越多，留给实际任务的空间越少。
  • 组件来自不同作者，风格和质量不一致，团队使用时建议挑一套固定组合写进仓库，而不是每个人各装各的。

总结

Claude Code 的 Hook、Command、MCP、Skill 这些扩展机制才是拉开使用差距的地方，但从零配置门槛不低。claude-code-templates 把常用配置做成了可以单独安装的组件，先用交互模式或 aitmpl.com 挑几个最需要的，比一次装满更稳妥。

配好之后，如果想在国内稳定使用 Claude Code、Codex，可以在 AIGoCode 上直接接入。

参考链接