市场如何工作
市场是他人创建和共享的插件目录。使用市场是一个两步过程: 可以将其视为添加应用商店:添加商店让您可以访问浏览其集合,但您仍然可以单独选择要下载的应用。官方 Anthropic 市场
官方 Anthropic 市场 (claude-plugins-official) 在您启动 Claude Code 时自动可用。运行 /plugin 并转到发现选项卡以浏览可用内容。
要从官方市场安装插件:
官方市场由 Anthropic 维护。要分发您自己的插件,请创建您自己的市场并与用户共享。
代码智能
代码智能插件帮助 Claude 更深入地理解您的代码库。安装这些插件后,Claude 可以跳转到定义、查找引用,并在编辑后立即查看类型错误。这些插件使用语言服务器协议 (LSP),这是为 VS Code 代码智能提供支持的相同技术。 这些插件需要在您的系统上安装语言服务器二进制文件。如果您已经安装了语言服务器,当您打开项目时,Claude 可能会提示您安装相应的插件。| 语言 | 插件 | 所需二进制文件 |
|---|---|---|
| C/C++ | clangd-lsp | clangd |
| C# | csharp-lsp | csharp-ls |
| Go | gopls-lsp | gopls |
| Java | jdtls-lsp | jdtls |
| Lua | lua-lsp | lua-language-server |
| PHP | php-lsp | intelephense |
| Python | pyright-lsp | pyright-langserver |
| Rust | rust-analyzer-lsp | rust-analyzer |
| Swift | swift-lsp | sourcekit-lsp |
| TypeScript | typescript-lsp | typescript-language-server |
如果在安装插件后在
/plugin 错误选项卡中看到 Executable not found in $PATH,请从上表安装所需的二进制文件。外部集成
这些插件捆绑预配置的 MCP 服务器,以便您可以将 Claude 连接到外部服务,无需手动设置:- 源代码控制:
github、gitlab - 项目管理:
atlassian(Jira/Confluence)、asana、linear、notion - 设计:
figma - 基础设施:
vercel、firebase、supabase - 通信:
slack - 监控:
sentry
开发工作流
为常见开发任务添加命令和代理的插件:- commit-commands:Git 提交工作流,包括提交、推送和 PR 创建
- pr-review-toolkit:用于审查拉取请求的专门代理
- agent-sdk-dev:使用 Claude Agent SDK 构建的工具
- plugin-dev:用于创建您自己的插件的工具包
输出样式
自定义 Claude 的响应方式:- explanatory-output-style:关于实现选择的教育见解
- learning-output-style:用于技能构建的交互式学习模式
尝试:添加演示市场
Anthropic 还维护一个演示插件市场(claude-code-plugins),其中包含展示插件系统可能性的示例插件。与官方市场不同,您需要手动添加此市场。
浏览可用插件
运行
/plugin 打开插件管理器。这会打开一个选项卡式界面,有四个选项卡,您可以使用 Tab 键循环切换(或使用 Shift+Tab 向后切换):- 发现:从所有市场浏览可用插件
- 已安装:查看和管理您安装的插件
- 市场:添加、删除或更新您添加的市场
- 错误:查看任何插件加载错误
安装插件
选择一个插件以查看其详细信息,然后选择安装范围:请参阅配置范围以了解有关范围的更多信息。
- 用户范围:在所有项目中为自己安装
- 项目范围:为此存储库上的所有协作者安装
- 本地范围:仅在此存储库中为自己安装
添加市场
使用/plugin marketplace add 命令从不同来源添加市场。
- GitHub 存储库:
owner/repo格式(例如,anthropics/claude-code) - Git URL:任何 git 存储库 URL(GitLab、Bitbucket、自托管)
- 本地路径:目录或
marketplace.json文件的直接路径 - 远程 URL:托管
marketplace.json文件的直接 URL
从 GitHub 添加
使用owner/repo 格式添加包含 .claude-plugin/marketplace.json 文件的 GitHub 存储库,其中 owner 是 GitHub 用户名或组织,repo 是存储库名称。
例如,anthropics/claude-code 指的是由 anthropics 拥有的 claude-code 存储库:
从其他 Git 主机添加
通过提供完整 URL 添加任何 git 存储库。这适用于任何 Git 主机,包括 GitLab、Bitbucket 和自托管服务器: 使用 HTTPS:# 后附加 ref:
从本地路径添加
添加包含.claude-plugin/marketplace.json 文件的本地目录:
marketplace.json 文件的直接路径:
从远程 URL 添加
通过 URL 添加远程marketplace.json 文件:
与基于 Git 的市场相比,基于 URL 的市场有一些限制。如果在安装插件时遇到”路径未找到”错误,请参阅故障排除。
安装插件
添加市场后,您可以直接安装插件(默认安装到用户范围):/plugin,转到发现选项卡,然后在插件上按 Enter。您将看到以下选项:
- 用户范围(默认):在所有项目中为自己安装
- 项目范围:为此存储库上的所有协作者安装(添加到
.claude/settings.json) - 本地范围:仅在此存储库中为自己安装(不与协作者共享)
/plugin 并转到已安装选项卡以查看按范围分组的插件。
管理已安装的插件
运行/plugin 并转到已安装选项卡以查看、启用、禁用或卸载您的插件。
您也可以使用直接命令管理插件。
禁用插件而不卸载:
--scope 选项允许您使用 CLI 命令针对特定范围:
管理市场
您可以通过交互式/plugin 界面或 CLI 命令管理市场。
使用交互式界面
运行/plugin 并转到市场选项卡以:
- 查看所有添加的市场及其来源和状态
- 添加新市场
- 更新市场列表以获取最新插件
- 删除您不再需要的市场
使用 CLI 命令
您也可以使用直接命令管理市场。 列出所有配置的市场:配置自动更新
Claude Code 可以在启动时自动更新市场及其已安装的插件。为市场启用自动更新后,Claude Code 会刷新市场数据并将已安装的插件更新到其最新版本。如果任何插件已更新,您将看到建议重启 Claude Code 的通知。 通过 UI 为单个市场切换自动更新:- 运行
/plugin打开插件管理器 - 选择市场
- 从列表中选择市场
- 选择启用自动更新或禁用自动更新
DISABLE_AUTOUPDATER 环境变量。有关详细信息,请参阅自动更新。
要在禁用 Claude Code 自动更新的同时保持插件自动更新启用,请设置 FORCE_AUTOUPDATE_PLUGINS=true 以及 DISABLE_AUTOUPDATER:
配置团队市场
团队管理员可以通过将市场配置添加到.claude/settings.json 来为项目设置自动市场安装。当团队成员信任存储库文件夹时,Claude Code 会提示他们安装这些市场和插件。
有关完整配置选项(包括 extraKnownMarketplaces 和 enabledPlugins),请参阅插件设置。
故障排除
/plugin 命令无法识别
如果您看到”未知命令”或/plugin 命令未出现:
- 检查您的版本:运行
claude --version。插件需要版本 1.0.33 或更高版本。 - 更新 Claude Code:
- Homebrew:
brew upgrade claude-code - npm:
npm update -g @anthropic-ai/claude-code - 本地安装程序:从设置重新运行安装命令
- Homebrew:
- 重启 Claude Code:更新后,重启您的终端并再次运行
claude。
常见问题
- 市场未加载:验证 URL 是否可访问以及
.claude-plugin/marketplace.json是否存在于该路径 - 插件安装失败:检查插件源 URL 是否可访问以及存储库是否为公开(或您有访问权限)
- 安装后文件未找到:插件被复制到缓存,因此引用插件目录外文件的路径将不起作用
- 插件技能未出现:使用
rm -rf ~/.claude/plugins/cache清除缓存,重启 Claude Code,然后重新安装插件。有关详细信息,请参阅插件技能安装后未出现。