返回
Everything Claude Code 系列 开发工具

Everything Claude Code 教程 8：Plugins - 扩展 Claude Code 能力

本文详解 Everything Claude Code 的 Plugins 系统，包含 Marketplace 使用、LSP 插件配置和推荐插件列表。

教程概述

Plugins 是 Claude Code 的扩展机制，让你能够轻松安装和管理新功能，无需手动配置。

你将学到

  • ✅ Plugin vs 手动配置的区别
  • ✅ Marketplace 安装流程
  • ✅ LSP 插件配置方法
  • ✅ 推荐插件列表
  • ✅ 上下文窗口管理警告

什么是 Plugins？

Plugins 是预打包的功能扩展，可以包含：

flowchart TD
    A[Plugin] --> B[Skills]
    A --> C[Commands]
    A --> D[Hooks]
    A --> E[MCP Servers]
    A --> F[Agents]

    style A fill:#e3f2fd

Plugin vs 手动配置

特性 Plugin 手动配置
安装难度 一键安装 需要手动复制文件
更新维护 自动更新 手动同步
依赖管理 自动处理 需要手动安装
版本控制 内置版本管理 无
发现性 Marketplace 可搜索 需要知道来源

Marketplace 安装流程

流程图

flowchart TD
    A[打开 Claude Code] --> B[/plugins]
    B --> C[查看 Marketplace]
    C --> D{选择插件}
    D --> E[点击安装]
    E --> F[验证安装]
    F --> G{成功?}
    G -->|是| H[开始使用]
    G -->|否| I[检查错误日志]
    I --> D

命令行操作

# 添加 Marketplace
claude plugin marketplace add https://github.com/owner/marketplace-name

# 查看已添加的 Marketplace
claude plugin marketplace list

# 安装插件
claude plugin install plugin-name@marketplace-name

# 更新插件
claude plugin update plugin-name

# 卸载插件
claude plugin uninstall plugin-name

在 Claude Code 中操作

# 打开插件管理
/plugins

# 输出示例
已安装的 Plugins:
✅ typescript-lsp@claude-plugins-official
✅ hookify@claude-plugins-official
✅ mgrep@Mixedbread-Grep

可用 Marketplace:
- claude-plugins-official
- Mixedbread-Grep
- custom-marketplace

LSP 插件配置

为什么需要 LSP 插件？

LSP（Language Server Protocol）提供：

  • 实时类型检查
  • 跳转定义
  • 智能补全
  • 错误诊断

安装 TypeScript LSP

# 添加官方 Marketplace
claude plugin marketplace add claude-plugins-official

# 安装 TypeScript LSP
claude plugin install typescript-lsp@claude-plugins-official

验证：

# Claude Code 中测试
读取 src/index.ts 并告诉我第 10 行的类型错误

安装 Python LSP

# 安装 Pyright LSP
claude plugin install pyright-lsp@claude-plugins-official

支持的 LSP 插件

语言 插件名称 功能
TypeScript typescript-lsp 类型检查、跳转定义
Python pyright-lsp 类型推断、错误诊断
Go gopls-lsp 代码补全、重构
Rust rust-analyzer-lsp 类型检查、Cargo 集成
Java jdtls-lsp Spring 支持、重构

插件分类表格

生产力工具

插件 用途 优先级
hookify 用自然语言创建 Hooks ⭐⭐⭐
mgrep 比 grep 更好的搜索 ⭐⭐⭐
ralph-wiggum 循环自动化 ⭐⭐
commit-commands Git 提交工作流 ⭐⭐
code-simplifier 代码简化 ⭐⭐

开发辅助

插件 用途 优先级
frontend-design UI/UX 模式 ⭐⭐
security-guidance 安全检查 ⭐⭐⭐
pr-review-toolkit PR 自动化 ⭐⭐
feature-dev 功能开发流程 ⭐⭐
code-review 代码审查 ⭐⭐

文档和研究

插件 用途 优先级
context7 实时文档查询 ⭐⭐⭐
explanatory-output-style 详细输出风格 ⭐

推荐插件详解

1. hookify - 自然语言创建 Hooks

用途：不想手写 JSON 配置？用自然语言描述即可。

安装：

claude plugin install hookify@claude-plugins-official

使用：

/hookify

我想创建一个 Hook：
- 当 Claude 执行长时间命令时提醒我使用 tmux
- 当编辑 TypeScript 文件后自动运行 prettier

2. mgrep - 更好的搜索

用途：比传统 grep 节省约 50% tokens。

安装：

claude plugin marketplace add Mixedbread-Grep
claude plugin install mgrep@Mixedbread-Grep

使用：

/mgrep "function handleSubmit"  # 本地搜索
/mgrep --web "Next.js 15 app router changes"  # 网络搜索

3. context7 - 实时文档

用途：获取任何库的最新文档。

安装：

claude plugin install context7@claude-plugins-official

使用：

使用 context7 查询 React 19 的最新 hooks 文档

4. security-guidance - 安全检查

用途：自动检测代码中的安全漏洞。

安装：

claude plugin install security-guidance@claude-plugins-official

检查项：

  • OWASP Top 10
  • 硬编码密钥
  • SQL 注入
  • XSS 漏洞

5. commit-commands - Git 工作流

用途：规范化 Git 提交流程。

安装：

claude plugin install commit-commands@claude-plugins-official

命令：

  • /commit - 生成规范的提交信息
  • /pr - 创建 PR
  • /branch - 创建规范化分支

上下文窗口警告

问题

每个 Plugin 都会占用你的上下文窗口：

flowchart LR
    A[200k 上下文] --> B[系统提示 20k]
    A --> C[MCP 工具 30k]
    A --> D[Plugin 工具 20k]
    A --> E[对话历史 80k]
    A --> F[剩余 50k]

    style D fill:#fff3e0

建议

✅ 推荐做法
- 只安装需要的 Plugin
- 保持在 5-8 个活跃插件
- 定期审查和清理

❌ 避免
- 安装所有看起来有用的 Plugin
- 同时启用 15+ 插件
- 从不清理不需要的插件

检查插件占用

/plugins --stats

# 输出示例
Plugin              工具数    上下文占用
typescript-lsp      8        ~5k
hookify             3        ~2k
mgrep               2        ~3k
context7            5        ~4k
security-guidance   6        ~4k

总计: 24 工具, ~18k 上下文

插件开发基础

插件结构

my-plugin/
├── manifest.json    # 插件元数据
├── skills/          # 包含的 Skills
├── commands/        # 包含的 Commands
├── hooks/           # 包含的 Hooks
├── mcp/             # 包含的 MCP 配置
└── README.md        # 文档

manifest.json

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "My custom plugin",
  "author": "your-name",
  "skills": ["skill1", "skill2"],
  "commands": ["cmd1"],
  "hooks": ["hooks.json"],
  "mcpServers": ["mcp-config.json"],
  "dependencies": {
    "npm": ["some-package"]
  }
}

最佳实践

1. 按需安装

开发前端项目 → 安装 frontend-design, typescript-lsp
开发后端项目 → 安装 security-guidance, pyright-lsp
代码审查 → 安装 code-review, pr-review-toolkit

2. 分项目配置

// 项目 A: 前端
{
  "plugins": ["typescript-lsp", "frontend-design", "mgrep"]
}

// 项目 B: 后端
{
  "plugins": ["pyright-lsp", "security-guidance", "context7"]
}

3. 定期清理

# 每月检查一次
/plugins

# 卸载不常用的
claude plugin uninstall unused-plugin

小结

关键要点

  • ✅ Plugins 提供一键安装的扩展能力
  • ✅ Marketplace 让发现和安装变得简单
  • ✅ LSP 插件提供 IDE 级别的代码智能
  • ✅ 控制插件数量避免上下文窗口溢出
  • ✅ 推荐插件：hookify, mgrep, context7, security-guidance

系列导航：