Introduction au Concept

Introduction

Lorsque vous avez configuré un workflow parfait dans Claude Code — commandes personnalisées, hooks de revue de code, Skills dédiés — vous pourriez vous demander : est-il possible d'empaqueter tout cela et de le partager avec votre équipe ou la communauté ?

C'est exactement le problème que Plugin résout.

Si les Skills sont des « manuels d'instructions » pour l'IA, alors un Plugin est une « boîte à outils » : il regroupe les Skills, les Commands, les Hooks, les serveurs MCP et toutes les autres configurations pour que vous puissiez tout installer et distribuer en une seule commande.

Comprendre Plugin

Imaginez que vous êtes un artisan expérimenté qui a accumulé au fil des années un ensemble d'outils de confiance : marteaux, scies, règles, divers tournevis. Chaque fois que vous changez d'établi, vous devez transporter chaque outil un par un et tout réorganiser. Un Plugin est comme une boîte à outils bien conçue : elle contient non seulement tous vos outils, mais les maintient aussi classés par catégorie, prêts à l'emploi où que vous alliez.

D'un point de vue technique, Plugin est le mécanisme d'empaquetage d'extensions de Claude Code. Un Plugin peut contenir :

Ces composants fonctionnent ensemble pour former une solution de workflow complète.

Plugin vs Configuration autonome

Dans Claude Code, vous pouvez placer les configurations dans le répertoire .claude/ du projet ou les empaqueter en tant que Plugin. La différence fondamentale réside dans la méthode de distribution et l'espace de noms :

Quand choisir Plugin :

• Vous devez partager des configurations de workflow avec les membres de votre équipe
• Vous souhaitez réutiliser le même ensemble d'outils dans plusieurs projets
• Vous prévoyez de distribuer des configurations à la communauté
• Vous avez besoin du contrôle de version et des mises à jour automatiques

Quand utiliser la configuration autonome :

• Expérimentations rapides à usage personnel
• Configurations spécifiques au projet qui n'ont pas besoin d'être réutilisées
• Commandes simples à usage unique

Structure de répertoires du Plugin

La structure standard d'un Plugin se présente comme suit :

my-plugin/
├── .claude-plugin/           # 元数据目录
│   └── plugin.json           # 必需：插件清单
├── commands/                 # 斜杠命令
│   ├── review.md
│   └── deploy.md
├── agents/                   # 子代理
│   └── code-reviewer.md
├── skills/                   # Agent Skills
│   └── code-review/
│       └── SKILL.md
├── hooks/                    # 事件钩子
│   └── hooks.json
├── scripts/                  # 辅助脚本
│   └── format-code.sh
├── .mcp.json                 # MCP 服务器配置
└── .lsp.json                 # LSP 服务器配置

Points importants :

• plugin.json doit être placé dans le répertoire .claude-plugin/
• Les autres répertoires (commands, agents, skills, etc.) se trouvent à la racine du plugin
• Ne placez pas les répertoires fonctionnels dans .claude-plugin/

Fichier de configuration principal

Le cœur d'un Plugin est .claude-plugin/plugin.json, qui définit les métadonnées et les chemins des composants du plugin :

{
  "name": "my-awesome-plugin",
  "version": "1.0.0",
  "description": "一个示例插件",
  "author": {
    "name": "Your Name",
    "email": "you@example.com"
  },
  "keywords": ["example", "demo"],
  "commands": "./commands/",
  "agents": "./agents/",
  "skills": "./skills/",
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json"
}

Portées d'installation

Plugin supporte quatre portées d'installation pour s'adapter aux différents cas d'utilisation :

La portée d'installation par défaut est user. Si vous souhaitez enregistrer la configuration du plugin dans Git pour une utilisation en équipe, choisissez la portée project.

Avantages principaux

Isolation des espaces de noms

Les commandes du Plugin portent un préfixe d'espace de noms (par exemple, /my-plugin:review), évitant les conflits de noms avec d'autres plugins ou configurations de projet. Cela est particulièrement important dans la collaboration d'équipe : les plugins développés par différentes équipes peuvent coexister harmonieusement.

Gestion des versions

Plugin supporte le Semantic Versioning, vous permettant de :

• Suivre l'historique des modifications du plugin
• Revenir à des versions antérieures si nécessaire
• Recevoir automatiquement les mises à jour compatibles

Distribution facilitée

Via le Plugin Marketplace, vous pouvez :

• Héberger vos plugins sur GitHub
• Permettre aux utilisateurs d'installer avec une simple commande
• Gérer automatiquement les dépendances et les mises à jour

Collaboration d'équipe

Plugin est particulièrement adapté aux scénarios d'équipe :

• Unifier la chaîne d'outils de développement de l'équipe
• Les nouveaux membres obtiennent tous les outils en une seule commande
• La gestion centralisée des configurations réduit le travail en double

Écosystème Plugin

L'écosystème Plugin de Claude Code se développe rapidement. Début 2025, l'écosystème a atteint une échelle considérable :

• 229+ plugins actifs dans l'écosystème
• 239 Agent Skills distribués sur le marketplace
• 200+ serveurs MCP préconstruits dans le toolkit Docker

Ressources officielles :

Sélections de la communauté :

Relation avec les autres fonctionnalités

Plugin est un concept de « conteneur » qui peut inclure d'autres fonctionnalités de l'écosystème Claude Code :

Plugin (Conteneur)
├── Skills (Paquets de connaissances)
├── Commands (Commandes rapides)
├── Agents (Sous-agents)
├── Hooks (Hooks d'événements)
└── MCP/LSP (Connexions externes)

Comprendre cette hiérarchie est important :

• Skills enseignent à Claude comment faire quelque chose
• Commands fournissent des points d'entrée rapides
• Agents gèrent des tâches indépendantes et spécialisées
• Hooks permettent l'automatisation pilotée par événements
• Plugin regroupe tout cela pour faciliter la distribution et la gestion

Skills vs Plugins

La différence entre Skills et Plugins peut prêter à confusion au début. Selon l'analyse de Young Leaders Tech :

Point clé : Les Skills sont déclenchés automatiquement par le modèle sans invocation manuelle ; les Plugins sont un mécanisme d'empaquetage qui résout le défi du partage distribué. Les deux peuvent être utilisés ensemble : un Plugin peut contenir des Skills.

Résumé

Claude Code Plugin est essentiellement un mécanisme d'empaquetage et de distribution de workflows. Il résout les problèmes de réutilisation des configurations et de collaboration d'équipe, vous permettant de partager votre chaîne d'outils soigneusement élaborée avec davantage de personnes.

Retenez trois mots-clés :

Maintenant que vous comprenez les concepts, le prochain article, Guide pratique de Claude Code Plugin, vous guidera dans la pratique : créer un Plugin de zéro, publier sur le Marketplace et appliquer les meilleures pratiques de collaboration d'équipe.

Si vous n'êtes pas encore familier avec les composants qu'un Plugin peut contenir, nous vous recommandons de lire Qu'est-ce que Claude Skills pour comprendre les concepts fondamentaux des Skills.