自学教程

Claude Code 插件

Claude Code 教程

简介

Claude Code 插件系统用来扩展原生能力，分为两大类：IDE插件（VS Code / JetBrains，图形界面客户端）和 MCP插件（MCP Server，底层工具扩展）。

注意：Claude Code 本身没有独立的第三方插件生态，扩展能力主要依靠 MCP 协议实现。日常所说的插件，大多指IDE端的官方扩展，或是MCP工具服务。

插件分类

1. IDE官方插件（客户端插件）

作用：在代码编辑器里提供可视化对话面板、Diff预览、快捷键、一键唤起Claude Code，底层依然调用Claude Code CLI。

  • VS Code 插件：Claude Code 官方扩展
  • JetBrains系列插件：WebStorm、IDEA、PyCharm等IDE官方插件

IDE插件功能

  • 侧边对话面板，直接在编辑器内聊天
  • 代码选中一键发送给Claude
  • 可视化Diff面板，点选接受/拒绝代码变更
  • 快捷键快速切换交互模式、中断任务
  • 自动识别项目根目录，加载 CLAUDE.md 和 .claude 配置

IDE插件安装

  • VS Code：打开扩展市场，搜索 Claude Code，安装官方插件
  • JetBrains IDE：打开插件市场，搜索 Claude Code，安装后重启IDE

IDE插件安装完成后，需要完成身份认证或配置API Key才能使用。

2. MCP插件（模型上下文协议扩展，能力插件）

MCP Server 是 Claude Code 的工具插件，通过配置 settings.json 接入，用来新增外部能力。属于后端能力插件，不提供UI界面。

上一节《Claude Code MCP》有详细介绍。

常用MCP插件示例：

  • filesystem：增强文件操作
  • git：读取Git提交记录、分支信息
  • fetch：网页抓取
  • sqlite/postgres：数据库查询
  • slack/email：对接消息通知服务

插件配置位置

  1. IDE插件：配置保存在IDE本身设置面板
  2. MCP插件：在 .claude/settings.json（项目级）或 ~/.claude/settings.json（全局）内配置 mcpServers

MCP插件配置示例：

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

配置完成后执行 /clear 新建会话，加载MCP插件。

插件管理斜杠命令

/mcp list         # 列出当前已加载的MCP插件(MCP Server)
/mcp restart      # 重启MCP服务，重载MCP插件配置
/mcp remove       # 移除指定MCP服务

插件使用场景

  1. IDE插件：日常开发，不想切换终端，在编辑器内直接对话、审阅代码改动
  2. MCP插件：需要访问外部资源、数据库、网页、Git信息，扩展Claude原生能力

插件最佳实践

  1. IDE插件优先官方版本，不要使用非官方第三方修改版
  2. MCP插件按需启用，不用的MCP服务注释关闭，减少安全风险
  3. 项目MCP配置写入Git，团队共用一套MCP插件配置；密钥使用环境变量
  4. 接入陌生第三方MCP插件前，仔细评估权限，仅开放最小访问范围

常见问题

  1. IDE插件安装完成，调用提示找不到Claude Code
    需要先安装 Claude Code CLI，插件依赖CLI程序。
  2. MCP插件配置成功，但无法调用
  • 检查 settings.json JSON语法是否正确
  • 确认MCP Server依赖环境（Node/Python）已安装
  • /clear 新建会话加载配置，或 /mcp restart 重启MCP服务
  1. IDE插件和CLI的会话互通吗？
    默认不互通，IDE面板会话独立；读取同一个项目下的 CLAUDE.md 和 .claude 配置。

安全提示

  • MCP插件拥有访问本地文件、数据库、网络的权限，不要使用来源不明的MCP服务
  • IDE插件仅从官方市场安装，避免恶意插件窃取代码、密钥
  • 开启MCP插件后，生产项目保持 Manual 交互模式，工具调用需要人工审批
标签：

0 条笔记