发现并安装插件

插件通过技能、代理、钩子和 MCP 服务器扩展 Claude Code。插件市场是帮助你发现和安装这些扩展的目录。

想创建和分发自己的市场？请查看创建并分发插件市场。

市场工作原理

市场是别人创建和共享的插件目录。使用市场是两步操作：

1. 添加市场：注册目录，尚未安装任何插件
2. 安装单个插件：浏览目录并安装你想要的插件

官方 Anthropic 市场

官方 Anthropic 市场（claude-plugins-official）在你启动 Claude Code 时自动可用。运行 /plugin 进入 Discover 标签页浏览，或访问 claude.com/plugins。

安装插件：

/plugin install github@claude-plugins-official

官方市场插件分类

代码智能插件

安装后 Claude 获得两项能力：

• 自动诊断：每次文件编辑后，语言服务器分析变更并实时报告错误和警告
• 代码导航：跳转到定义、查找引用、悬停类型信息等

按 Ctrl+O 可内联查看诊断结果。

语言	插件	需要二进制文件
C/C++	clangd-lsp	clangd
C#	csharp-lsp	csharp-ls
Go	gopls-lsp	gopls
Java	jdtls-lsp	jdtls
Python	pyright-lsp	pyright-langserver
Rust	rust-analyzer-lsp	rust-analyzer
TypeScript	typescript-lsp	typescript-language-server

若在 /plugin 错误标签页看到 Executable not found in $PATH，请安装对应语言服务器二进制文件。

外部集成插件

预配置了 MCP 服务器，无需手动设置：

• 源码控制：github、gitlab
• 项目管理：atlassian（Jira/Confluence）、asana、linear、notion
• 设计：figma
• 基础设施：vercel、firebase、supabase
• 通信：slack
• 监控：sentry

开发工作流插件

• commit-commands：Git 提交工作流，包含提交、推送和创建 PR
• pr-review-toolkit：专门用于审查 Pull Request 的代理
• agent-sdk-dev：使用 Claude Agent SDK 构建的工具
• plugin-dev：创建自己插件的工具包

输出风格插件

• explanatory-output-style：关于实现选择的教育性见解
• learning-output-style：用于技能培养的互动学习模式

试用演示市场

/plugin marketplace add anthropics/claude-code

添加后运行 /plugin 浏览可用插件。安装示例：

/plugin install commit-commands@anthropics-claude-code

安装后运行 /reload-plugins 激活，然后尝试：

/commit-commands:commit

添加市场

支持多种来源：

从 GitHub 添加

/plugin marketplace add anthropics/claude-code

从其他 Git 托管添加

# HTTPS
/plugin marketplace add https://gitlab.com/company/plugins.git

# SSH
/plugin marketplace add git@gitlab.com:company/plugins.git

# 特定分支/标签
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

从本地路径添加

/plugin marketplace add ./my-marketplace
/plugin marketplace add ./path/to/marketplace.json

从远程 URL 添加

/plugin marketplace add https://example.com/marketplace.json

安装插件

/plugin install plugin-name@marketplace-name

选择作用域（交互式界面）：运行 /plugin，进入 Discover 标签页，按 Enter 选择插件：

• User scope（默认）：为自己在所有项目中安装
• Project scope：为此仓库的所有协作者安装（添加到 .claude/settings.json）
• Local scope：仅为自己在此仓库中安装（不与协作者共享）

安全提醒：安装插件前确保信任该插件。Anthropic 不控制插件中包含的 MCP 服务器、文件或其他软件。

管理已安装插件

# 禁用插件（不卸载）
/plugin disable plugin-name@marketplace-name

# 重新启用
/plugin enable plugin-name@marketplace-name

# 完全删除
/plugin uninstall plugin-name@marketplace-name

# 按作用域操作（CLI 命令）
claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

会话期间安装、启用或禁用插件后，运行 /reload-plugins 使更改生效：

/reload-plugins

管理市场

交互式界面：运行 /plugin → Marketplaces 标签页

CLI 命令：

# 列出所有已配置的市场
/plugin marketplace list

# 刷新市场插件列表
/plugin marketplace update marketplace-name

# 删除市场
/plugin marketplace remove marketplace-name

删除市场会卸载从该市场安装的所有插件。

配置自动更新

通过 UI 切换各市场的自动更新：运行 /plugin → Marketplaces → 选择市场 → Enable/Disable auto-update

要禁用所有自动更新同时保持插件更新：

export DISABLE_AUTOUPDATER=true
export FORCE_AUTOUPDATE_PLUGINS=true

配置团队市场

团队管理员可在 .claude/settings.json 中添加市场配置，自动提示团队成员安装：

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

故障排除

/plugin 命令无法识别

1. 检查版本：claude --version（需要 1.0.33 或更高版本）
2. 更新 Claude Code：
   • Homebrew：brew upgrade claude-code
   • npm：npm update -g @anthropic-ai/claude-code
3. 重启 Claude Code

常见问题

• 市场无法加载：验证 URL 可访问，.claude-plugin/marketplace.json 在指定路径存在
• 插件安装失败：检查插件源 URL 可访问，仓库为公开或有访问权限
• 插件技能未显示：清除缓存 rm -rf ~/.claude/plugins/cache，重启并重新安装

代码智能问题

• 语言服务器无法启动：验证二进制文件已安装并在 $PATH 中，查看 /plugin 错误标签页
• 内存占用高：rust-analyzer 和 pyright 在大型项目上可能消耗大量内存，用 /plugin disable <plugin-name> 禁用

下一步

• 构建自己的插件：创建技能、代理和钩子
• 创建市场：向团队或社区分发插件
• 技术参考：完整规范