Plugins de Claude Code
Les plugins (Plugin) sont, dans Claude Code,le mécanisme d'extension de plus haut niveau,utilisé pour prendre des capacités telles que les commandes, les agents, les Skills, les hooks, MCP, LSP etpackager, versionner, partager et distribuer.。
Un plugin = une collection réutilisable de capacités d'extension de Claude Code
Un plugin peut contenir :
- Commandes slash
- Sous-agents (Agents)
- Skills (descriptions de capacités)
- Hooks (hooks d'événements)
- Serveurs MCP (outils/services externes)
- Serveurs LSP (intelligence de code)
L'objectif principal des plugins est unique :
Rendre les capacités de Claude Code réutilisables comme une boîte à outils, plutôt que de les reconfigurer dans chaque projet.
Plugins vs configuration autonome (comment choisir)
Claude Code prend en charge deux méthodes d'extension :
| Méthode | Forme de commande | Scénarios adaptés |
|---|---|---|
Configuration autonome(.claude/) |
/hello |
Usage personnel, projet unique, expérimentations rapides |
Plugin(.claude-plugin/) |
/plugin-name:hello |
Partage en équipe, multi-projet, versionné |
Quand utiliser une configuration autonome ?
- Utilisé uniquement dans le projet actuel
- Flux de travail personnel
- Configuration expérimentale pas encore stable
- Vouloir un nom de commande court (comme
/review)
Quand utiliser des plugins ?
- Besoin deréutiliser dans plusieurs projets
- vouloirPartager avec l'équipe ou la communauté
- Besoin degestion de versions, mises à niveau, restaurations
- Prévoyez une distribution via une place de marché
- Peut accepter des commandes d'espace de noms (pour éviter les conflits)
Bonnes pratiques :
D'abord, dans
.claude/la configuration, itérez → une fois stable, empaquetez comme plugin.
Structure minimale d'un plugin (à retenir)
my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件清单(必需) ├── commands/ # 斜杠命令 ├── agents/ # 子代理 ├── skills/ # Skills ├── hooks/ # 钩子 ├── .mcp.json # MCP 配置 └── .lsp.json # LSP 配置
Règles importantes
.claude-plugin/Dans le répertoire,ne peut contenir queplugin.json- Les autres répertoires doivent se trouver dans le répertoire racine du plugin.
Manifeste de plugin (plugin.json)
La "carte d'identité" du plugin, déterminant :
- Nom du plugin
- Espace de noms des commandes
- Version
- Informations sur l'auteur
Exemple :
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0",
"author": { "name": "Your Name" }
}
Descriptions des champs clés :
| Champ | Objectif |
|---|---|
| name | Identifiant unique + espace de noms de commande |
| description | Affiché dans la place de marché des plugins |
| version | Versionnage sémantique |
| author | Facultatif, description de l’attribution |
Commandes slash (capacité de plugin la plus couramment utilisée)
1. Méthode de définition de commande
- Situé dans
commands/répertoire - Chaque commande = un fichier Markdown
- Nom du fichier = nom de la commande
Exemple :
commands/hello.md
Commande correspondante :
/my-first-plugin:hello
2. Exemple de contenu de commande
--- description: Greet the user with a friendly message --- Greet the user warmly and ask how you can help them today.
3. Commande
Utilisation$ARGUMENTSSaisie utilisateur de la commande
Greet the user named "$ARGUMENTS" warmly.
Invoquer :
/my-first-plugin:hello Alex
Invoquer (essentiel pour le développement)
Utilisation--plugin-dirCharger directement le répertoire des plugins :
claude --plugin-dir ./my-plugin
Fonctionnalités :
- Non requis
- Redémarrer Claude Code après modifications
- Prend en charge le chargement simultané de plusieurs plugins
claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b
Que peuvent faire d'autre les plugins ?
| Capacité | Cas d'utilisation |
|---|---|
| Commandes | Commandes slash personnalisées |
| Agents | Sous-agents dédiés |
| Compétences | Apprendre à Claude quand utiliser une certaine capacité |
| Hooks | Automatisation (par ex., exécuter des commandes après l'écriture de fichiers) |
| MCP | Se connecter à des services externes (GitHub, DB, API) |
| LSP | Intelligence du code (navigation, vérification de types) |
Place de marché des plugins
Les plugins sont distribués viala place de marché; essentiellement, il s'agit d'un dépôt d'annuaire de plugins.
Place de marché officielle
- Ajouté par défaut
- Exécutez
/plugin→ Découvrir

Installer le plugin :
/plugin install plugin-name@claude-plugins-official
Portée d'installation du plugin
| Portée | Description |
|---|---|
| Portée utilisateur | Vous uniquement, tous les projets |
| Portée du projet | Dépôt actuel, partagé avec l'équipe |
| Portée locale | Dépôt actuel, vous uniquement |
Recommandation :
- Outils d'équipe →Portée du projet
- Outils de productivité personnelle →Portée utilisateur
Catégories typiques de plugins
1. Intelligence du code (LSP)
- TypeScript, Python, Go, Rust, etc.
- Fournit la navigation vers les définitions, les références et les erreurs de type
Nécessite l'installation locale du serveur de langage correspondant
2. Intégration externe (MCP)
- GitHub / GitLab
- Jira / Notion
- Slack / Figma
- Vercel / Supabase
Essentiel:Plugin = serveur MCP + configuration
3. Workflow de développement
- Commits Git, PRs
- Agent de revue de code
- Outils de développement de plugins
Commandes courantes pour la gestion des plugins
/plugin # 打开插件管理器 /plugin install # 安装插件 /plugin uninstall # 卸载 /plugin enable/disable # 启用 / 禁用 /plugin marketplace add # 添加市场 /plugin marketplace rm # 移除市场
from.claude/Migration vers les plugins (idées clés)
| Avant | Après migration |
|---|---|
.claude/commands |
plugin/commands |
.claude/agents |
plugin/agents |
settings.json hooks |
plugin/hooks/hooks.json |
Après migration :
- La version du plugin prend effet en premier
- Peut supprimer l'ancien
.claude/La configuration évite la duplication
Quand devez-vous absolument utiliser des plugins ?
- Vous avez déjàdes workflows Claude stables
- Vous êtesen train de copier à plusieurs reprises
.claude/ - Les membres de l'équipe commencent à vous demander : « Comment configurer ceci ? »
- Vous voulez que Claude soit aussi contrôlable que des plugins d'IDE
Autres extensionsLes plugins sont le moment charnière pour Claude Code, qui passe d'un « assistant IA personnel » à un « outil de niveau ingénierie »