夜雨聆风
Claude Code 插件使用指南
在 Claude Code 中使用插件（Plugin）的完整指南
Claude Code（Anthropic 官方的 AI 编程助手，支持 CLI 和 VS Code/Cursor 等 IDE 集成）从 2025 年 10 月起正式支持 插件系统。插件是最高级别的扩展方式，能打包斜杠命令（Slash Commands）、子代理（Agents）、Skills、Hooks、MCP 服务器等，一键安装、共享和版本管理。比手动在 .claude/ 目录配置更方便，尤其适合团队或复用。
1. 前提条件
-
Claude Code 版本 ≥ 1.0.33（推荐最新版）。 -
Homebrew：brew upgrade claude-code -
npm：npm update -g @anthropic-ai/claude-code -
更新命令： -
重启终端（或 IDE）。 -
检查版本：claude –version
2. 最简单方式：打开插件管理器 UI
在 Claude Code 终端（或 VS Code 的 Claude Code 面板）直接输入：
text
/plugin-
按 Tab / Shift+Tab 切换选项卡： - 发现
（Discover）：浏览可用插件 - 已安装
：启用/禁用/卸载插件 - 市场
（Marketplaces）：添加/管理市场 - 错误
：查看加载问题
VS Code / Cursor 用户：在 Claude Code 聊天框输入 /plugins 即可打开图形界面，更直观（支持搜索、开关切换）。
3. 添加插件市场（Marketplace）
官方 Anthropic 市场（claude-plugins-official）自动可用，无需添加。
添加其他市场（比如演示市场或社区市场）：
text
/plugin marketplace add anthropics/claude-code-
支持 GitHub（推荐 owner/repo 格式）、GitLab、本地路径、远程 JSON URL 等。 -
示例： -
本地：/plugin marketplace add ./my-marketplace -
GitHub：/plugin marketplace add affaan-m/everything-claude-code（超受欢迎的 13 个 Agent + 40+ Skills 集合）
列出所有市场：/plugin marketplace list
4. 安装插件
命令方式（推荐）：
text
/plugin install 插件名@市场名-
示例（官方市场）： text
/plugin install commit-commands@claude-plugins-official/plugin install typescript-lsp@claude-plugins-official
交互式方式：
-
输入 /plugin -
进入 发现 选项卡 -
选中插件 → 按 Enter -
选择安装范围： - 用户范围
（默认，全局） - 项目范围
（当前仓库） - 本地范围
（仅本次会话）
常用插件推荐（官方市场）：
-
typescript-lsp、pyright-lsp 等：代码智能（需先装对应语言服务器如 typescript-language-server） -
commit-commands：一键 Git 提交/PR -
pr-review-toolkit：PR 审查 -
agent-sdk-dev：开发 Agent 的工具
5. 使用插件
安装后立即生效，命令带命名空间：
-
示例：/commit-commands:commit（自动暂存、生成提交信息并提交） -
Skills/Agents 会自动出现在可用命令列表中，或被 Claude 自动调用。
6. 管理插件
-
禁用/启用：/plugin disable 插件名@市场名 或 /plugin enable … -
卸载：/plugin uninstall 插件名@市场名 -
更新市场：/plugin marketplace update 市场名 -
查看已安装：/plugin → 已安装 选项卡
7. 常见问题解决
-
/plugin 命令不存在 → 更新 Claude Code 并重启终端。 -
插件不生效 → 清除缓存：rm -rf ~/.claude/plugins/cache 后重装。 -
LSP 插件提示 “Executable not found” → 手动安装对应语言服务器（例如 brew install pyright）。 -
想团队统一使用 → 在项目 .claude/settings.json 配置 extraKnownMarketplaces 和 enabledPlugins。
8. 进阶：自己创建/分享插件
详见官方文档：创建插件
插件系统让 Claude Code 从“单人工具”变成“可复用的团队工作流引擎”，一行命令就能装上别人验证过的完整最佳实践，强烈推荐试试官方市场里的开发工作流插件！
