Claude Code Templates：给 Claude Code 装组件，再看着它跑

Claude Code Templates（Web 站点 aitmpl.com）把散在各处的 Claude Code 配置收拢成一套可搜索、可一键安装、装完还能看效果的系统。settings.json、MCP 配置、Agent 定义这些原本要手动写的文件，它按模块打包，用 CLI 或 Web UI 装进项目。

与多数只解决"怎么装"的配置方案不同，它多管了一层"装了之后怎么看"——Analytics 监控、对话查看、健康检查打包在同一个 CLI 里。

适用对象是已经跑通 Claude Code、想统一管理组件库并观察实际使用情况的团队。还没在本地跑通过的话，建议先走完官方 Quick Start 再来。

组件地图

Templates 的六类组件在 Claude Code 的运行时里各司其职，下面这张图展示它们怎么协作：

入口有两条：CLI 适合脚本化和自动化，Web UI 适合浏览发现。六类组件装好后注入 Claude Code 运行时，运行时再通过监控层的四个工具反向暴露状态、性能和诊断。图中虚线表示关联：Hooks 可以挂载在 Agent 的事件上，Commands 可以调用 MCPs 访问外部服务，Skills 可以嵌进 Agent 作为递进式暴露的能力模块。

六类组件

这些组件聚合自多个上游仓库，每个保留原始许可和归属：K-Dense-AI 的 139 个科学计算 skills、Anthropic 官方 skills（21 个）与 claude-code 开发指南（10 个）、obra/superpowers 的 14 个工作流 skills、alirezarezvani 的 36 个角色 skills、wshobson 的 48 个 agents，以及 awesome-claude-code 的 21 个 commands 等社区来源。

安装

两种途径：CLI 一键安装和 Web UI 交互式浏览。二者都写进项目的 .claude/ 目录（或用户级 ~/.claude/），不改变 Claude Code 本身的运行方式。

CLI

npx claude-code-templates@latest --agent development-team/frontend-developer --command testing/generate-tests --mcp development/github-integration --yes

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 --setting performance/mcp-timeouts --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

不带参数运行会进入交互式浏览模式，逐个选择要装的组件。带上 --yes 跳过确认，适合脚本化部署。另外三个参数值得先知道：

• --dry-run：只打印将要安装的组件清单，不实际写入，用来在动手前核对路径；
• --directory：把组件装进指定目录而不是当前项目；
• --help：列出全部可选参数。

npx claude-code-templates@latest --dry-run
npx claude-code-templates@latest --directory /path/to/project
npx claude-code-templates@latest --help

Web UI

打开 aitmpl.com 是一个带搜索和分类筛选的组件目录。每个组件有独立页面展示描述、安装命令和依赖关系，点击安装按钮会生成对应的 CLI 命令。

Web UI 的价值在浏览阶段——不用记住几十上百个组件的路径，搜索 “security” 就能看到所有相关的 agents、commands 和 hooks。

一次安装怎么穿过这套系统

下面用一个示意流程说明组件从选到用的路径。组件路径和命令来自目录，具体参数以你装的组件为准。

团队要搭一条代码审查流水线：

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command testing/generate-tests --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes

三条命令分别把 code-reviewer agent、/generate-tests 命令、pre-commit 校验 hook 写进 Claude Code 的配置目录。下次在项目里启动会话，agent 就以审查员角色运行；执行 git commit 时，hook 会在提交前触发一次自动审查。审查报告的具体覆盖点取决于该 agent 的 SKILL 定义，通常是安全、风格或效率相关的检查项。

/generate-tests 这类命令是对代码的操作入口，作用范围是你当前改动的文件。hooks 和 commands 一个挂在事件上、一个挂在斜杠命令上，两者解决的是不同的触发方式。

组件落在哪个目录

安装的本质是把组件文件写进 Claude Code 的配置目录，位置决定了它对当前项目生效还是对所有项目生效：

用 --directory 指定了目标目录，组件就落在该目录下；不指定则写进当前项目。想全局生效的组件（比如各项目通用的角色 agent），可以装到用户级目录。判断组件到底装没装对，先看文件落点是否符合预期，再跑 --health-check 校验一致性。

监控层：装完怎么知道有没有用

Templates 的差异化能力在监控，四个工具都挂在同一个 CLI 上。

Analytics

npx claude-code-templates@latest --analytics

在本地起一个监控服务，实时检测 Claude Code 会话状态并采集性能指标，用一个面板展示。它回答的是"团队到底在哪些任务上花时间、token 烧在哪"这类问题。具体指标和解读口径以 docs.aitmpl.com 为准，这里不展开编造阈值。

对话监控器

npx claude-code-templates@latest --chats

移动端适配的界面，实时查看 Claude Code 的对话内容，适合在手机或平板上盯远程开发机上的会话。加 --tunnel 通过 Cloudflare Tunnel 从外网安全访问：

npx claude-code-templates@latest --chats --tunnel

健康检查

npx claude-code-templates@latest --health-check

做一次全面诊断，检查 Claude Code 安装是否处于优化状态——版本兼容性、Node.js 版本、已装组件一致性、MCP 连接状态、配置文件语法。组件之间有版本冲突或配置错误时，会直接指出来。

插件面板

npx claude-code-templates@latest --plugins

在一个界面里查看已安装的插件、可用市场和权限状态。当你从多个来源装了组件后，用它理清哪些来自哪个源、当前是否启用、有没有权限冲突。

常见问题与排查

组件装了但没生效

先看落盘位置（见"组件落在哪个目录"）：当前项目启动会话时只加载 .claude/ 下的组件，想全局生效要装到 ~/.claude/。位置没错的话，重启 Claude Code 会话再试——新装的 agent、command 和 hook 在已有会话里不会热加载。

装了一堆组件后担心冲突

跑一次 --health-check。它会检查已装组件的一致性、MCP 连接状态和配置文件语法，组件之间有版本冲突或配置错误会直接指出来。多个来源混装后，用 --plugins 面板按来源理清已装项和权限状态。

不确定某个组件要不要装

先 --dry-run 看它实际会写哪些文件，再决定。这会列出将要安装的组件清单而不写入任何东西，比在 Web UI 里反复对比描述更直接。

CLI 提示命令不存在或行为异常

确认用的是 npx claude-code-templates@latest（带 @latest），避免本地缓存了旧版本；--help 可查看当前版本支持的全部参数。仍异常时参考 docs.aitmpl.com 的故障排查章节。

生态里的位置

Claude Code 生态里已经有不少配置类项目，Templates 和它们各有分工，也能配合。

与 OpenClaw

OpenClaw 是本地优先的个人 AI 助手平台，支持 20+ 消息渠道（WhatsApp、Telegram、iMessage、飞书等），核心是 Gateway 架构——一个长期运行的守护进程管理会话、渠道、工具和事件。

两者能配合：如果把 Claude Code 作为 OpenClaw 的后端模型，用 Templates 装进的能力会跟着生效，OpenClaw 的渠道只是入口。

与 Anthropic 官方 Plugins

Claude Code Plugins 是官方插件目录，定义插件规范和注册机制。Templates 做的是聚合——在官方定义的基础上，把社区贡献的 agents、commands、hooks、skills 和 MCPs 收进一个可搜索目录，并提供 CLI 和 Web UI 两种安装途径。类比一下：官方 Plugins 定标准和上架通道，Templates 是筛选分类好的合集。

与 ECC

ECC 是社区维护的 Claude Code 资源大全，涵盖文章、视频、工具、skills 和 MCPs。差别在发力点：ECC 是索引，告诉你有什么资源并给链接；Templates 是分发，你不只知道有什么，还能一键装。两者互补，实践中常先在 ECC 里发现工具，再去 Templates 里搜安装命令。

与 9arm/skills 和 superpowers

9arm/skills 和 obra/superpowers 都是独立的 Claude Code skills 仓库，Templates 聚合了它们的内容，并额外统一了安装入口、处理组件间的依赖冲突、提供可视化管理界面。已经在用 superpowers 或 9arm/skills 的，迁到 Templates 不会丢功能，换来的是统一安装和监控。

什么时候值得用

判断依据是"你是不是已经有一批 Claude Code 配置要管"。

值得用的场景：团队已经跑通 Claude Code，组件数量开始超过手动维护的承受范围；想统一安装入口、理清多个来源的依赖冲突；想观察每次会话到底花在哪、token 烧在哪。监控层的收益在这里才体现得出来。

可以先不用的场景：只想要一两个组件，直接找到对应文件复制即可；Claude Code 本身还没配置好，这时候先跑官方 Quick Start 更实际。

建议的切入顺序：先在 Web UI 搜索浏览，确认你要的组件存在；再按需用 CLI 安装，--yes 做脚本化；装完跑一次 --health-check 校验；最后用 --analytics 观察一段时间，再决定要不要长期挂监控。

项目当前在 GitHub 上有 30,515 Stars 和 3,454 Forks（GitHub API 2026-09-04 验证），MIT 协议，GitHub 语言标签为 Python，经 npm 包 claude-code-templates 分发（npx claude-code-templates@latest），持续更新。浏览全部组件：aitmpl.com；完整文档：docs.aitmpl.com。