claude-code-templates-cli

用途

claude-code-templates CLI 是 Anthropic Claude Code 的配置组件管理工具，提供一组可直接使用的配置，用于安装和管理 AI 智能体（agents）、自定义命令、MCP（Model Context Protocol 集成）、settings、hooks 与 skills，以增强 AI 辅助开发工作流。它既支持交互式浏览，也支持直接安装组件。

主要能力

组件类型

Agents：针对特定开发任务的专用 AI 角色，安装到项目的 .claude/agents/ 目录。
Commands：Claude Code 的自定义斜杠命令，安装到 .claude/commands/，可用 /command-name 调用。
MCPs：外部服务集成，例如 GitHub、PostgreSQL、AWS，需配置环境变量。
Settings：Claude Code 配置预设，合并进 .claude/settings.json。
Hooks：开发工作流的自动化触发器，如 git pre-commit 校验。

开发工具

分析仪表盘（--analytics）：以网页界面展示活动会话状态、性能指标、token 用量和会话时间线。
会话监控（--chats）：实时查看 Claude 响应，支持 --tunnel 通过 Cloudflare Tunnel 远程访问。
健康检查（--health-check）：诊断 Claude Code 安装、配置有效性、MCP 集成、文件权限和依赖。
插件面板（--plugins）：管理已安装插件并查看市场。

使用方式

无需安装直接运行：

npx claude-code-templates@latest

频繁使用时全局安装：

npm install -g claude-code-templates

交互式安装会打开菜单界面浏览组件。直接安装特定组件使用对应 flag：

# 安装 agent
npx claude-code-templates@latest --agent development-team/frontend-developer --yes

# 安装 command
npx claude-code-templates@latest --command testing/generate-tests --yes

# 安装 MCP 集成
npx claude-code-templates@latest --mcp development/github-integration --yes

# 安装 setting
npx claude-code-templates@latest --setting performance/mcp-timeouts --yes

# 安装 hook
npx claude-code-templates@latest --hook git/pre-commit-validation --yes

--yes 用于跳过确认提示，适合自动化工作流。可在同一命令中批量安装多个组件：

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

配置结构

CLI 遵循 Claude Code 的标准配置结构：

.claude/
├── agents/           # Installed agents
├── commands/         # Custom commands
├── mcps/            # MCP integrations
├── settings.json    # Global settings
├── hooks/           # Automation hooks
└── skills/          # Reusable capabilities

需要凭据的 MCP 集成使用环境变量，例如：

# GitHub
export GITHUB_TOKEN=${GITHUB_TOKEN}

# PostgreSQL
export POSTGRES_HOST=${POSTGRES_HOST}
export POSTGRES_USER=${POSTGRES_USER}
export POSTGRES_PASSWORD=${POSTGRES_PASSWORD}

# AWS
export AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
export AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}

程序化调用

可作为 Node.js 模块导入：

const { installComponent } = require('claude-code-templates');

await installComponent({
  type: 'agent',
  name: 'development-team/frontend-developer',
  skipConfirmation: true
});

适用场景

资料中给出的常见组合包括：搭建前端开发环境（frontend-developer agent、react-optimizer agent、generate-tests 命令、optimize-bundle 命令、github-integration MCP、mcp-timeouts 设置）；安全工具组合（security-auditor agent、check-security 命令、dependency-audit 命令、pre-commit-validation hook）；数据库开发组合（database-architect agent、optimize-queries 命令、postgresql-integration MCP）。

限制与排查

组件未在 Claude Code 中出现时，需检查 .claude/agents/、.claude/commands/、.claude/mcps/ 安装位置，并确保 Claude Code 配置为读取 .claude 目录。MCP 集成失败可运行 --health-check 并使用 echo $GITHUB_TOKEN 等确认环境变量。权限错误需对 .claude 目录加写权限（chmod -R u+w .claude/）。远程会话监控需要安装 Cloudflare CLI（cloudflared）。组件冲突时可先删除已有文件再重新安装。

Web 界面可浏览全部可用组件（按分类筛选、关键词搜索、查看详情与示例、复制安装命令、查看安装统计），文档地址见资料。价格、收费与平台支持范围资料未提供。