插件解决什么问题
Claude Code 的扩展点一直都有：CLAUDE.md、skills、agents、hooks、MCP。插件不新增能力，而是解决怎么把这些东西打包、加版本、发给别人的问题。判断用哪边的标准官方给得很直接：
| 方式 | 技能名 | 适合 |
|---|---|---|
| .claude/ 目录直放 | /hello | 个人工作流、项目内定制、快速实验 |
| 插件 | /插件名:hello | 发给团队、社区分发、带版本更新、跨项目复用 |
官方建议先在 .claude/ 里快速迭代，要分享时再转成插件。
三个官方维护的市场
| 市场 | 标识 | 说明 |
|---|---|---|
| 官方市场 | claude-plugins-official | Anthropic 策展，首次交互启动自动添加，也可网页浏览 claude.com/plugins |
| 社区市场 | claude-community | 第三方插件，过自动校验与安全筛查，逐个钉死 commit SHA；需手动添加 |
| 示例市场 | claude-code-plugins | anthropics/claude-code 仓库里的演示插件，学写法用 |
# 官方市场装插件（市场已自动添加）
/plugin install github@claude-plugins-official
# 社区市场要先手动添加
/plugin marketplace add anthropics/claude-plugins-community
/plugin install <插件名>@claude-community/plugin 打开四标签面板：Discover（浏览）、Installed（管理）、Marketplaces（增删市场）、Errors（加载错误）。终端里 /plugin 不可用的环境（如云端会话），改用桌面应用的插件浏览器，或在 .claude/settings.json 里声明enabledPlugins。
装之前看两个数字
插件详情页有两块多数人略过、但应该先看的信息：
- Context cost：这个插件每轮会往上下文窗口添加多少 token 的估算。插件不是越多越好——每个都在持续吃上下文预算。
- Will install 清单：列出将要装入的 commands、agents、skills、hooks、MCP 和 LSP 服务器。hooks 和 MCP 意味着它能执行代码和访问外部服务，装前过目。
安装时选作用域：User（自己所有项目）、Project（该仓库全部协作者）、Local（仅自己在该仓库）。装完按提示 /reload-plugins 激活，提示会重读会话时加--force。
最值得装的一类：LSP 代码智能
官方市场的 LSP 插件给 Claude 接上语言服务器协议——VS Code 代码智能的同款底层。装好后 Claude 获得两个能力：
- 自动诊断：每次编辑后语言服务器把类型错误、缺失导入、语法问题直接报给 Claude，不用跑编译器；Claude 引入错误会当轮自己发现自己修。你自己想看时按 Ctrl+O。
- 代码导航：跳定义、找引用、查类型、列符号、调用层级——比 grep 检索精确得多。
关键前提：插件只配置连接，不安装语言服务器本体。TypeScript 要先装 typescript-language-server、Python 装 pyright-langserver、Go 装 gopls、Rust 装 rust-analyzer……装完二进制再装插件（typescript-lsp、pyright-lsp、gopls-lsp 等，共覆盖 11 种语言）。/plugin 的 Errors 页出现 Executable not found in $PATH 就是这个原因。
其他官方插件速览
- 外部集成：github、gitlab、atlassian、asana、linear、notion、figma、vercel、firebase、supabase、slack、sentry——都是预配置好的 MCP 服务器，免手动配置。
- 安全：security-guidance 让 Claude 每次改完代码自查常见漏洞并当场修复。
- 开发工作流：commit-commands（提交/推送/PR）、pr-review-toolkit（PR 审查专用 agents）、agent-sdk-dev、plugin-dev（写插件的工具箱）。
- 输出风格：explanatory / learning 两种教学向回复风格。
15 分钟写出自己的插件
一个插件 = 一个目录 + 一个 manifest + 若干载荷。最小结构：
my-first-plugin/
├── .claude-plugin/
│ └── plugin.json # manifest
└── skills/
└── hello/
└── SKILL.md # 技能，装后叫 /my-first-plugin:hello// .claude-plugin/plugin.json
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0",
"author": { "name": "Your Name" }
}name 是唯一标识兼技能命名空间；version 决定用户何时收到更新——不 bump 版本号用户就不更新。本地测试不需要发布：
claude --plugin-dir ./my-first-plugin
# 会话里执行
/my-first-plugin:hello已有 .claude/ 里的 skills、agents、hooks 想转插件，把目录挪进插件文件夹加上 manifest 即可——注意所有技能名会 多出插件前缀，写在文档和肌肉记忆里的旧名字要改。
团队与公开分发
- 团队内部：建一个 marketplace 仓库（本质是带目录清单的 Git 仓库），成员
/plugin marketplace add 组织/仓库后照常安装；管理员用 pluginSuggestionMarketplaces 管理设置可让插件按工作目录相关性在 Discover 页置顶。 - 公开社区：按 create-plugins 文档的流程提交 anthropics/claude-plugins-community，过自动校验与安全筛查后上架，条目钉死 commit SHA。
- 官方市场：由 Anthropic 策展，应用内提交表单进的是社区市场，不是官方市场。
使用清单
- 装前看 Context cost 与 Will install，含 hooks / MCP 的插件按「能执行代码」的标准审查来源。
- LSP 插件先装语言服务器二进制，后装插件；Errors 标签页零报错才算装好。
- 作用域按共享面选：个人工具 User，团队规范 Project 并提交 .claude/settings.json。
- 自建插件 bump version 才会触发用户更新；manifest 里补 homepage / repository 便于溯源。
- 定期清理：不再用的插件卸掉，省的是每一轮的上下文预算。
插件把「配好一套顺手的 Claude Code」从每人每项目重复劳动变成一次打包、处处安装。先从官方市场的 LSP 和 commit-commands 装起，再把团队自己的规范沉淀成内部插件，是当前最实用的路径。