Claude Code 插件参考手册

简介

Claude Code 插件分为两大类：IDE官方插件（VS Code / JetBrains）和 MCP插件（MCP Server）。IDE插件提供图形操作界面；MCP插件是底层能力扩展，用来让Claude Code调用外部工具、资源。

注意：Claude Code 没有独立第三方插件市场，不存在自定义二进制插件，扩展能力主要依靠 MCP 协议。

前置阅读：《Claude Code 插件》

一、IDE插件（UI客户端插件）

1. VS Code Claude Code 插件

作用：VS Code 图形界面，底层依赖 Claude Code CLI。
功能清单

侧边对话面板，直接在编辑器内和Claude Code交互
选中代码片段一键发送给Claude
可视化Diff预览面板，点选批准/拒绝代码变更
状态栏快速切换会话模式（Manual / Plan / Accept Edits）
任务中断快捷键、会话管理
自动加载项目 .claude 目录配置、CLAUDE.md

安装步骤

VS Code 打开扩展商店
搜索 Claude Code（官方）
安装插件，重启VS Code
提前安装 Claude Code CLI，完成登录/API配置

插件只是UI层，必须安装CLI才能正常工作。

2. JetBrains IDE Claude Code 插件

支持 WebStorm、IDEA、PyCharm、Rider 等JetBrains全家桶IDE。
功能：和VS Code插件能力基本一致，集成在JetBrains编辑器内。
安装：JetBrains插件市场搜索 Claude Code，安装后重启IDE。

IDE插件配置

IDE插件配置分为两部分：

IDE插件本身设置（保存在IDE配置）
项目配置 .claude/settings.json（IDE插件与CLI共用）

IDE插件会话和 CLI终端会话默认互相隔离，但是读取同一个项目的 .claude 配置文件。

二、MCP插件（模型上下文协议扩展插件）

MCP插件本质是独立MCP Server进程，在 settings.json 中配置接入，为Claude Code新增外部工具能力，无UI界面。

MCP插件配置位置

项目级：./.claude/settings.json（仅当前项目生效）
全局级：~/.claude/settings.json（Mac/Linux）、%USERPROFILE%\.claude\settings.json（Windows）

配置示例：

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-git"]
    },
    "fetch": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-fetch"]
    }
  }
}

MCP插件管理斜杠命令

/mcp list         # 列出当前加载全部MCP插件(MCP Server)
/mcp restart      # 重启MCP服务，修改配置后重载
/mcp remove [name]# 移除指定MCP插件

常用官方MCP插件清单

MCP插件名称	能力说明
server-git	Git仓库操作，读取提交、diff、分支信息
server-fetch	抓取网页内容
server-filesystem	文件系统增强操作
server-sqlite	Sqlite数据库查询
server-postgres	Postgres数据库查询

三、插件、技能、子代理对比

模块	类型	是否独立进程	作用
IDE插件	UI客户端	❌ IDE扩展	提供可视化操作界面
MCP插件	工具服务	✅ 独立进程	调用外部资源/系统
Skill技能	流程模板	❌ 当前会话内执行	封装可复用任务步骤
Subagent子代理	独立智能体	❌ 会话内独立上下文	任务拆分，专项处理

四、插件加载生命周期

新建会话时，读取 settings.json，加载全部MCP服务
启动MCP Server进程，建立连接
会话内可以调用 /mcp restart 重新加载MCP插件
修改MCP配置后，也可以 /clear 新建会话完整重载

五、最佳实践

IDE插件只从官方市场安装，拒绝第三方修改版，防止代码/密钥泄露。
MCP插件按需启用，不用的MCP服务注释关闭，减少安全攻击面。
MCP插件不要在配置中硬编码密钥，优先使用环境变量传入凭证。
接入陌生第三方MCP插件前，仔细审查代码，评估文件/网络权限。
.claude 目录提交Git，共享MCP插件配置；不要提交密钥、本地路径。

六、常见问题

IDE插件安装完成，提示找不到Claude Code
需要先安装Claude Code CLI，并确保CLI已经加入系统PATH环境变量。
MCP配置正确，但插件无法调用

检查JSON语法是否合法
确认MCP Server运行依赖（Node/Python）已安装
执行 /mcp restart 重启MCP服务，或者 /clear 新建会话

VS Code插件会话和终端CLI会话互通吗？
会话上下文相互隔离；但是共用项目的CLAUDE.md、skills、subagents、MCP配置。

安全提示

MCP插件拥有访问本地文件、网络、数据库的权限，不要使用来源不明的MCP服务。
接入MCP插件后，生产项目保持 Manual 模式，工具调用需要人工审批。
MCP进程独立运行，遵循最小权限原则，不要给MCP服务开放过大目录权限。

简介