Claude code拓展：Skill、MCP、Plugin、Hook

Cocopink

431人浏览 · 2026-04-16 21:20:25

Cocopink · 2026-04-16 21:20:25 发布

Claude Code 拓展功能概述

配置Claude Code 推荐方式

推荐使用zcf帮助配置。
zcf教程

总述

Feature	What it does	When to use it	Example
CLAUDE.md	每次对话都会加载持久上下文	项目惯例，"始终执行 X"规则	“请使用 pnpm，而不是 npm。提交之前请运行测试。”
Skill	可以使用的说明、知识和工作流程	可重用内容、参考文档、可重复任务	/deploy 运行部署检查清单
Subagent	返回汇总结果的独立执行上下文	上下文隔离、并行任务、专业化工作者	一项研究任务，读取大量文件但仅返回关键发现
Agent teams	协调多个独立的 Claude Code 会话	并行研究、新功能开发、在相互竞争的假设下进行调试	同时派遣审核人员检查安全性、性能和测试结果
MCP	连接到外部服务	外部数据或操作	查询数据库、发布到 Slack、控制浏览器
Hook	基于事件运行的确定性脚本	可预测的自动化，无需LLM参与	每次编辑文件后运行 ESLint

subagents vs. Agent Teams

Skill

渐进式披露，一般 md 存储在 /.claude/skills/ 中，为 md/**/docs/pdf/pptx/xlsx 格式

元数据扫描：Claude 仅加载名称和描述（30-50 token/per skill）
相关性匹配：技能与当前任务匹配则加载完整说明
资源加载：脚本和文件仅在执行时加载

使用场景

可重复操作流程
相同专业知识
知识与上下文同时关注
知识的关注点是如何做，而非如何获得/执行

Hook

确定性执行，当触发器触发时就会运行钩子；配置文件路径：.claude/settings.local.json

可选的 Hook Points

PreToolUse：在工具调用之前运行，可能会阻塞工具调用
PostToolUse：在工具执行后运行
权限请求：在出现权限对话框时运行
SessionStart：在每个会话开始时运行

// .claude/settings.local.json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit",
        "command": "npm run lint --fix $FILE"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "command": "./scripts/notify-slack.sh 'File created: $FILE'"
      }
    ]
  }
}

何时使用

强制执行质量门控（编辑前检查代码，写入后测试）
通知和日志
自动格式化或验证
与 CI/CD 流水线集成

MCP

模型上下文协议，是一个开放标准，用于将 LLM 连接到外部工具和数据，如访问 GitHub、数据库、浏览器、API。

一般存储在 ~/.claude/settings.json 中：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your-token" }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
    }
  }
}

存在问题

工具定义会消耗 token，58 个工具的五台服务器架构在任何对话开始前就会消耗超过 55000 个 token。

解决方式：仅安装必要的内容

常用 MCP

GitHub: Repository management, PRs, issues, commits
Filesystem: Secure local file operations with permission controls
Context7: Automatic documentation lookup for any library
Playwright: Browser automation using accessibility snapshots
PostgreSQL: Natural language database queries
Sequential Thinking: Structured problem-solving for complex tasks

使用场景

需要 Claude 来访问外部系统
需要实时数据（而不仅仅是指令）
该工具需要执行操作（而不仅仅是提供指导）
您正在与第三方服务集成

Plugin

将多个自定义项打包成可分发的单元。它们将斜杠命令、子代理、MCP 配置、钩子和技能捆绑到一个可安装的软件包中。插件需要安装。

使用方式：/my-plugin:review

推荐的插件结构：

my-plugin/
├── .claude-plugin/
│   └── plugin.json    # Metadata and configuration
├── commands/          # Slash commands
├── agents/            # Specialized subagents
├── skills/            # Agent skills
├── hooks/             # Event handlers
├── .mcp.json          # MCP server configs
└── README.md

安装

# Install from GitHub
/plugin install github.com/username/my-plugin
# List installed plugins
/plugin list
# Disable a plugin
/plugin disable my-plugin

何时使用