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é danscommands/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

Les plugins sont le moment charnière pour Claude Code, qui passe d'un « assistant IA personnel » à un « outil de niveau ingénierie »

Autres extensions