Claude Code

Claude Code插件管理工具调研：真正能清理本地插件的工具

前言：插件太多的真实痛点

作为一名Claude Code重度用户，我遇到了一个普遍的问题：随着使用时间的增长，本地安装的skills、commands、agents、hooks越来越多。

每次启动Claude Code时，都需要加载这些插件，导致启动速度明显变慢。更让人头疼的是，我甚至不知道自己到底安装了哪些插件，哪些还在使用，哪些已经废弃了。

我迫切需要一个可视化的工具来：

  • 查看所有已安装的插件
  • 禁用不常用的插件
  • 删除废弃的插件
  • 分析插件对启动性能的影响

经过深入调研，我发现了几个真正能管理本地插件的工具。

推荐工具一：ccboard - 全能监控管理工具 ⭐⭐⭐⭐⭐

GitHub: FlorianBruniaux/ccboard

项目定位： TUI + Web界面的综合监控管理工具

为什么强烈推荐？

ccboard是目前功能最全面的Claude Code管理工具，它提供了9个交互式标签页，包括：

标签页 功能 适用场景
Dashboard 概览统计、模型使用、7天活动 快速了解整体使用情况
Sessions 浏览所有会话，3栏布局 查看活跃会话和进程
Config 级联配置编辑器（4列diff） 管理settings.json配置
Hooks ⭐ 事件驱动的hooks管理 查看和清理hooks
Agents ⭐ Agents、commands和skills浏览器 查看和管理agents/skills/commands
Costs Token分析（4个子视图） 分析成本消耗
History 全文搜索会话历史 查找历史记录
MCP MCP服务器管理 管理MCP服务器
Analytics 高级分析、预算跟踪 30天预测和洞察

核心功能亮点

1. Hooks管理（关键功能！）

1
2
3
4
Tab 4 - Hooks
├── Bash语法高亮
├── 测试模式
└── Badge指示器（显示hook状态）

你可以：

  • 查看所有配置的hooks
  • 测试hook是否正常工作
  • 禁用不必要的hooks以提升启动速度

2. Agents、Commands和Skills浏览器

1
2
3
4
Tab 5 - Agents
├── Frontmatter YAML解析
├── 调用统计
└── 分类显示

你可以：

  • 查看所有agents、commands和skills
  • 看到每个插件的调用次数
  • 识别哪些插件很少使用（可以安全删除）

3. 性能优化

  • 89倍启动加速 - 通过SQLite缓存实现（20秒 → 224毫秒）
  • 处理10K+会话
  • 实时文件监控（500ms防抖）

安装方式

推荐：Homebrew（macOS/Linux）

1
2
brew tap FlorianBruniaux/tap
brew install ccboard

替代方案：cargo安装

1
cargo install ccboard

替代方案：一键安装脚本

1
curl -sSL https://raw.githubusercontent.com/FlorianBruniaux/ccboard/main/install.sh | bash

快速开始

1
2
3
4
5
6
7
8
9
10
11
# TUI界面（推荐）
ccboard

# Web界面
ccboard web --port 3333

# 同时启动TUI和Web
ccboard both --port 3333

# 仅统计信息（可脚本化）
ccboard stats

键盘快捷键

  • 1-9: 切换标签页
  • /: 搜索
  • r: 刷新
  • Ctrl+T: 切换深色/浅色主题
  • q: 退出
  • ?: 查看所有快捷键

为什么是最佳选择？

  1. 功能最全面 - 覆盖了hooks、agents、skills、commands、MCP服务器等所有插件类型
  2. 性能优秀 - Rust实现，启动速度极快
  3. 双界面支持 - 既有TUI也有Web界面，满足不同使用场景
  4. 统计功能 - 可以看到每个插件的调用次数，帮助你识别不常用的插件
  5. 开源免费 - MIT许可，完全免费

推荐工具二：claude-code-config - 配置文件管理TUI ⭐⭐⭐⭐

GitHub: joeyism/claude-code-config

项目定位： 专注于配置文件的TUI管理工具

核心功能

MCP服务器管理

1
2
3
4
5
6
7
8
9
10
11
12
13
Claude Configuration
├── Global Servers (1)
│ └── 📡 terraform-cloud-mcp
└── Projects
    ├── 📁 delorean (3s, 15c, 14h)
    │   ├── MCP Servers (3)
    │   │   ├── 📡 mcp_server_mysql
    │   │   ├── 📡 replicate_server
    │   │   └── 📡 bigquery
    │   ├── Conversations (15)
    │   └── History (14)
    └── 📁 web (2s, 8c, 20h)
        └── ...

功能：

  • ✅ 层级视图：全局和项目级MCP服务器树形结构
  • ✅ CRUD操作：添加、编辑、删除MCP服务器
  • ✅ 复制服务器：快速复制配置
  • ✅ 移动服务器：在全局和项目之间移动
  • ✅ 敏感值掩码：API密钥自动隐藏（按V切换）

项目和对话管理

  • ✅ 项目浏览器：查看所有项目及其统计
  • ✅ 对话管理：浏览、查看详情、删除实际.jsonl文件
  • ✅ 对话统计：消息数、文件大小、年龄
  • ✅ 对话清理：删除旧对话并查看完整元数据

安全和可靠性

  • ✅ 自动备份：每次保存前创建时间戳备份
  • ✅ 撤销/重做：Ctrl+Z/Ctrl+Y（最多50个操作）
  • ✅ JSON验证：确保配置保持有效
  • ✅ 回滚支持：从备份轻松恢复

安装方式

1
2
3
4
5
6
7
pip install claude-code-config

# 启动
claude-config

# 使用别名
ccm

键盘快捷键

导航

  • ↑/↓ 或 j/k: 导航树
  • Enter 或 Space: 展开/折叠节点
  • 右/左: 展开/折叠节点

操作

  • a: 添加新的MCP服务器或历史记录
  • e: 编辑选中的服务器或历史记录
  • d: 删除选中的项目
  • c: 复制到剪贴板
  • m: 移动到不同项目
  • v: 查看粘贴内容详情

文件操作

  • s: 保存更改
  • r: 从磁盘重新加载
  • q 或 Ctrl+C: 退出

高级功能

  • V: 切换敏感值掩码（显示/隐藏密钥）
  • Ctrl+Z: 撤销
  • Ctrl+Y: 重做
  • u: 查看撤销/重做历史
  • l: 查看错误日志
  • ?: 显示帮助

适用场景

claude-code-config特别适合：

  1. 管理MCP服务器 - 添加、删除、移动服务器
  2. 清理对话 - 删除旧对话以释放空间
  3. 安全编辑配置 - 带撤销/重做支持
  4. 查看项目统计 - 了解每个项目的使用情况

为什么推荐？

  1. 专注配置管理 - 专门为管理~/.claude.json设计
  2. 层级视图 - 直观的树形结构，易于导航
  3. 安全可靠 - 自动备份、撤销/重做、JSON验证
  4. 轻量级 - Python实现，安装简单

官方解决方案：Claude Code CLI命令 ⭐⭐⭐

Claude Code本身就提供了插件管理的CLI命令，虽然文档不太完整，但功能是存在的。

Marketplace命令（未完全文档化）

1
2
3
4
5
6
7
8
9
10
11
# 添加marketplace
claude plugin marketplace add <url-or-repo>

# 列出所有marketplace
claude plugin marketplace list

# 更新marketplace
claude plugin marketplace update <name>

# 删除marketplace
claude plugin marketplace remove <name>

Plugin命令（有文档但简略）

1
2
3
4
5
6
7
8
9
10
11
# 安装插件（带可选作用域）
claude plugin install <plugin>@<marketplace>
claude plugin install <plugin>@<marketplace> --scope project
claude plugin install <plugin>@<marketplace> --scope local

# 卸载插件
claude plugin uninstall <plugin>

# 启用/禁用插件
claude plugin enable <plugin>
claude plugin disable <plugin>

实用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 添加marketplace
claude plugin marketplace add https://github.com/obra/superpowers

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

# 禁用插件
claude plugin disable frontend-excellence

# 启用插件
claude plugin enable frontend-excellence

# 卸载插件
claude plugin uninstall superpowers

# 列出已安装插件
# 注意：官方没有 claude plugin list 命令
# 可以使用以下方法：
jq -r '.plugins | keys[] | split("@") | "\(.[0]) (from \(.[1]))"' ~/.claude/plugins/installed_plugins.json

内置命令管理

在Claude Code REPL中，你也可以使用：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 查看已安装插件
/plugin

# 转到Installed标签页
/plugin
# 然后按Tab切换到Installed标签

# 查看插件详情
/plugin info <plugin-name>

# 启用/禁用插件
/plugin enable <plugin-name>
/plugin disable <plugin-name>

# 卸载插件
/plugin uninstall <plugin-name>

为什么使用官方命令？

  1. 无需额外安装 - Claude Code自带
  2. 官方支持 - 来自Anthropic，信任边界明确
  3. 简单直接 - 对于基本管理足够使用
  4. 可脚本化 - 容易集成到自动化流程

局限性

  1. 没有list命令 - 官方没有直接的list命令
  2. 文档不完整 - Marketplace命令在官方文档中缺失
  3. 缺少可视化 - 纯命令行，没有UI界面
  4. 功能有限 - 主要针对plugin，对单独的skills/commands支持有限

第三方工具：claude-plugins CLI ⭐⭐⭐

GitHub: Kamalnrf/claude-plugins

官网： claude-plugins.dev

核心功能

1
2
3
4
5
6
7
8
9
10
11
# 安装插件
npx claude-plugins install <unique-plugin-identifier>

# 列出已安装插件
npx claude-plugins list

# 启用插件
npx claude-plugins enable <plugin-name>

# 禁用插件
npx claude-plugins disable <plugin-name>

为什么使用？

  1. 插件注册表 - 管理了11,989个Claude Code插件和63,065个agent skills
  2. 发现和安装 - 可以搜索和浏览大量插件
  3. 自动处理 - 自动添加marketplace和安装插件，一步完成
  4. 多客户端支持 - 支持Claude Code、Cursor、Windsurf等多个AI编码客户端

局限性

  1. 第三方工具 - 需要额外的信任
  2. 不直接管理本地插件 - 主要用于发现和安装新插件
  3. 依赖npm - 需要Node.js/npm环境

安装

1
npm install -g claude-plugins

专用工具：sub-agents Manager ⭐⭐⭐

GitHub: webdevtodayjason/sub-agents

项目定位： 专门管理Claude Code Sub Agents的CLI工具

核心功能

1
2
3
4
5
6
7
8
9
10
11
# 安装
npm install -g @webdevtoday/claude-agents

# 列出可用agents
claude-agents list

# 初始化项目
claude-agents init

# 卸载agents（批量删除和清理）
claude-agents uninstall

可用的Sub-Agents

Agent名称 描述 Slash命令
code-reviewer 代码审查专家 /review
test-runner 自动化测试执行 /test [pattern]
debugger 调试专家 /debug [error]
refactor 代码重构 /refactor [target]
doc-writer 文档生成 /document [type]
security-scanner 安全扫描 /security-scan [path]
shadcn-ui-builder UI/UX专家 /ui 或 /shadcn
project-planner 项目规划 /plan [project]
api-developer API开发 /api [spec]
frontend-developer 前端开发 /frontend [feature]
tdd-specialist TDD专家 /tdd [component]
api-documenter API文档 /api-docs

为什么使用？

  1. 专业管理 - 专门为sub agents设计
  2. 一键初始化 - 快速为项目设置agents
  3. 批量卸载 - v1.4.0新增的清理功能
  4. Context-Forge集成 - 自动检测和智能集成

工具对比总结

工具 类型 插件管理能力 可视化 推荐指数
ccboard TUI + Web ⭐⭐⭐⭐⭐ (全覆盖) ✅ 双界面 ⭐⭐⭐⭐⭐
claude-code-config TUI ⭐⭐⭐⭐ (配置+MCP) ✅ TUI ⭐⭐⭐⭐
Claude Code CLI CLI ⭐⭐⭐ (基本) ❌ ⭐⭐⭐
claude-plugins CLI ⭐⭐⭐ (发现+安装) ❌ ⭐⭐⭐
sub-agents CLI ⭐⭐⭐ (agents专用) ❌ ⭐⭐⭐

我的建议

如果你的主要需求是全面管理所有插件：

强烈推荐：ccboard

理由：

  • 功能最全面，覆盖hooks、agents、skills、commands、MCP服务器
  • 调用统计可以帮助识别不常用的插件
  • 89倍启动加速，性能优秀
  • 双界面支持，TUI和Web都很好用

如果你主要关注MCP服务器和配置文件：

推荐：claude-code-config

理由：

  • 专门为配置文件管理设计
  • 层级视图直观清晰
  • 自动备份和撤销/重做，安全可靠

如果你想要最简单的解决方案：

使用：Claude Code官方CLI

理由：

  • 无需额外安装
  • 基本管理功能齐全
  • 可以脚本化

实战：如何精简插件提升启动速度

基于调研，这里是精简插件的具体步骤：

第一步：查看插件现状

使用ccboard查看：

1
2
3
ccboard
# 按 5 进入Agents标签页
# 按 4 进入Hooks标签页

或者使用官方CLI：

1
2
# 列出已安装插件
jq -r '.plugins | keys[] | split("@") | "\(.[0]) (from \(.[1]))"' ~/.claude/plugins/installed_plugins.json

第二步：分析使用频率

在ccboard的Agents标签页中：

  • 查看每个agent/skill/command的调用次数
  • 标记调用次数为0或很少的插件

第三步：禁用不常用插件

1
2
3
4
5
6
# 方法1：使用官方CLI
claude plugin disable <plugin-name>

# 方法2：使用ccboard
# 在Agents或Hooks标签页中
# 选择插件并禁用

第四步：删除废弃插件

1
2
3
4
5
# 卸载不再需要的插件
claude plugin uninstall <plugin-name>

# 或者删除整个marketplace及其所有插件
claude plugin marketplace remove <marketplace-name>

第五步：清理配置文件

使用claude-code-config：

1
2
3
4
5
claude-config

# 导航到要删除的项目
# 按 d 删除
# 按 s 保存

第六步：验证启动速度

1
2
3
4
# 时间测量
time claude --version

# 观察启动速度是否有改善

启动速度优化技巧

除了清理插件，还有以下方法可以提升启动速度：

1. 按需加载插件

将不常用的插件从全局配置移到项目级别配置：

1
2
3
4
5
6
7
8
9
10
11
# ~/.claude/settings.json（全局）
# 仅保留常用插件
{
  "plugins": ["常用插件"]
}

# project/.claude/settings.json（项目级别）
# 项目特定插件
{
  "plugins": ["项目特定skill"]
}

2. 禁用不必要的hooks

某些hooks可能会在启动时执行，影响速度：

1
2
3
# 在ccboard中
# 按 4 进入Hooks标签页
# 禁用不必要的hooks

或者在settings.json中：

1
2
3
4
5
6
7
{
  "hooks": {
    "PreToolUse": [],  // 禁用预工具执行hooks
    "PostToolUse": [],  // 禁用后工具执行hooks
    "SessionStart": []    // 禁用会话启动hooks
  }
}

3. 减少agents数量

每个agent都会增加初始化时间：

1
2
# 使用ccboard查看所有agents
# 删除或禁用不常用的agents

4. 定期清理

建议每个月进行一次插件清理：

  • 删除试用后不满意的插件
  • 合并功能相似的插件
  • 将不常用但可能有用的插件移到备用目录

未来展望

虽然当前的工具已经很强大，但我期待未来能有更专门的插件管理功能：

  1. 插件依赖分析 - 显示插件之间的依赖关系
  2. 性能分析 - 显示每个插件对启动时间的影响
  3. 智能推荐 - 根据使用模式推荐禁用不常用插件
  4. 批量操作 - 一键禁用多个插件
  5. 插件市场集成 - 直接从管理界面发现和安装新插件

结语

通过这次调研，我发现了几个真正能管理本地Claude Code插件的工具：

  1. ccboard - 功能最全面的TUI+Web管理工具
  2. claude-code-config - 专注配置管理的TUI工具
  3. Claude Code官方CLI - 内置的插件管理命令
  4. claude-plugins - 带注册表的CLI发现工具
  5. sub-agents - 专门管理sub agents的工具

对于插件太多导致启动缓慢的问题，我的建议是：

  1. 优先使用ccboard - 查看所有插件的使用统计
  2. 禁用不常用插件 - 使用官方CLI或ccboard
  3. 删除废弃插件 - 定期清理不再使用的插件
  4. 按需加载 - 将项目特定插件移到项目配置中
  5. 定期维护 - 每月进行一次插件清理

希望这篇调研文章对你有帮助！如果你有其他好的工具或技巧，欢迎分享。

相关链接：