Pour les spécifications techniques complètes et les schémas, voir Référence des plugins. Pour la gestion des marketplaces, voir Marketplaces de plugins.
Les plugins vous permettent d’étendre Claude Code avec des fonctionnalités personnalisées qui peuvent être partagées entre projets et équipes. Installez des plugins depuis les marketplaces pour ajouter des commandes, agents, hooks et serveurs MCP pré-construits, ou créez les vôtres pour automatiser vos flux de travail.

​
Démarrage rapide

Créons un plugin de salutation simple pour vous familiariser avec le système de plugins. Nous allons construire un plugin fonctionnel qui ajoute une commande personnalisée, le tester localement, et comprendre les concepts de base.

​
Prérequis

  • Claude Code installé sur votre machine
  • Familiarité de base avec les outils en ligne de commande

​
Créez votre premier plugin

1

Créer la structure de marketplace

mkdir test-marketplace
cd test-marketplace
2

Créer le répertoire du plugin

mkdir my-first-plugin
cd my-first-plugin
3

Créer le manifeste du plugin

Créer .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "Un plugin de salutation simple pour apprendre les bases",
"version": "1.0.0",
"author": {
"name": "Votre Nom"
}
}
EOF
4

Ajouter une commande personnalisée

Créer commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Saluer l'utilisateur avec un message personnalisé
---

# Commande Hello

Saluez l'utilisateur chaleureusement et demandez comment vous pouvez l'aider aujourd'hui. Rendez la salutation personnelle et encourageante.
EOF
5

Créer le manifeste de marketplace

Créer marketplace.json
cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "test-marketplace",
"owner": {
"name": "Utilisateur Test"
},
"plugins": [
{
  "name": "my-first-plugin",
  "source": "./my-first-plugin",
  "description": "Mon premier plugin de test"
}
]
}
EOF
6

Installer et tester votre plugin

Démarrer Claude Code depuis le répertoire parent
cd ..
claude
Ajouter la marketplace de test
/plugin marketplace add ./test-marketplace
Installer votre plugin
/plugin install my-first-plugin@test-marketplace
Sélectionnez “Install now”. Vous devrez ensuite redémarrer Claude Code pour utiliser le nouveau plugin.
Essayer votre nouvelle commande
/hello
Vous verrez Claude utiliser votre commande de salutation ! Vérifiez /help pour voir votre nouvelle commande listée.
Vous avez créé et testé avec succès un plugin avec ces composants clés :
  • Manifeste du plugin (.claude-plugin/plugin.json) - Décrit les métadonnées de votre plugin
  • Répertoire des commandes (commands/) - Contient vos commandes slash personnalisées
  • Marketplace de test - Vous permet de tester votre plugin localement

​
Vue d’ensemble de la structure du plugin

Votre plugin suit cette structure de base : 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # Métadonnées du plugin
├── commands/                 # Commandes slash personnalisées (optionnel)
│   └── hello.md
├── agents/                   # Agents personnalisés (optionnel)
│   └── helper.md
└── hooks/                    # Gestionnaires d'événements (optionnel)
    └── hooks.json
Composants supplémentaires que vous pouvez ajouter :
  • Commandes : Créez des fichiers markdown dans le répertoire commands/
  • Agents : Créez des définitions d’agents dans le répertoire agents/
  • Hooks : Créez hooks/hooks.json pour la gestion d’événements
  • Serveurs MCP : Créez .mcp.json pour l’intégration d’outils externes
Prochaines étapes : Prêt à ajouter plus de fonctionnalités ? Passez à Développer des plugins plus complexes pour ajouter des agents, hooks et serveurs MCP. Pour les spécifications techniques complètes de tous les composants de plugins, voir Référence des plugins.

​
Installer et gérer les plugins

Apprenez à découvrir, installer et gérer les plugins pour étendre vos capacités Claude Code.

​
Prérequis

  • Claude Code installé et en cours d’exécution
  • Familiarité de base avec les interfaces en ligne de commande

​
Ajouter des marketplaces

Les marketplaces sont des catalogues de plugins disponibles. Ajoutez-les pour découvrir et installer des plugins :
Ajouter une marketplace
/plugin marketplace add your-org/claude-plugins
Parcourir les plugins disponibles
/plugin
Pour la gestion détaillée des marketplaces incluant les dépôts Git, le développement local et la distribution d’équipe, voir Marketplaces de plugins.

​
Installer des plugins

​
Via le menu interactif (recommandé pour la découverte)

Ouvrir l'interface de gestion des plugins
/plugin
Sélectionnez “Browse Plugins” pour voir les options disponibles avec descriptions, fonctionnalités et options d’installation.

​
Via des commandes directes (pour une installation rapide)

Installer un plugin spécifique
/plugin install formatter@your-org
Activer un plugin désactivé
/plugin enable plugin-name@marketplace-name
Désactiver sans désinstaller
/plugin disable plugin-name@marketplace-name
Supprimer complètement un plugin
/plugin uninstall plugin-name@marketplace-name

​
Vérifier l’installation

Après avoir installé un plugin :
  1. Vérifier les commandes disponibles : Exécutez /help pour voir les nouvelles commandes
  2. Tester les fonctionnalités du plugin : Essayez les commandes et fonctionnalités du plugin
  3. Examiner les détails du plugin : Utilisez /plugin → “Manage Plugins” pour voir ce que le plugin fournit

​
Configurer les flux de travail de plugins d’équipe

Configurez les plugins au niveau du dépôt pour assurer un outillage cohérent dans votre équipe. Lorsque les membres de l’équipe font confiance au dossier de votre dépôt, Claude Code installe automatiquement les marketplaces et plugins spécifiés. Pour configurer les plugins d’équipe :
  1. Ajoutez la configuration de marketplace et de plugin au .claude/settings.json de votre dépôt
  2. Les membres de l’équipe font confiance au dossier du dépôt
  3. Les plugins s’installent automatiquement pour tous les membres de l’équipe
Pour des instructions complètes incluant des exemples de configuration, la configuration de marketplace et les meilleures pratiques de déploiement, voir Configurer les marketplaces d’équipe.

​
Développer des plugins plus complexes

Une fois que vous êtes à l’aise avec les plugins de base, vous pouvez créer des extensions plus sophistiquées.

​
Organiser des plugins complexes

Pour les plugins avec de nombreux composants, organisez votre structure de répertoires par fonctionnalité. Pour les dispositions de répertoires complètes et les modèles d’organisation, voir Structure de répertoire des plugins.

​
Tester vos plugins localement

Lors du développement de plugins, utilisez une marketplace locale pour tester les changements de manière itérative. Ce flux de travail s’appuie sur le modèle de démarrage rapide et fonctionne pour les plugins de toute complexité.
1

Configurer votre structure de développement

Organisez votre plugin et marketplace pour les tests :
Créer la structure de répertoires
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
Cela crée :
dev-marketplace/
├── .claude-plugin/marketplace.json  (vous allez créer ceci)
└── my-plugin/                        (votre plugin en développement)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

Créer le manifeste de marketplace

Créer marketplace.json
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Développeur"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "Plugin en cours de développement"
}
]
}
EOF
3

Installer et tester

Démarrer Claude Code depuis le répertoire parent
cd ..
claude
Ajouter votre marketplace de développement
/plugin marketplace add ./dev-marketplace
Installer votre plugin
/plugin install my-plugin@dev-marketplace
Testez les composants de votre plugin :
  • Essayez vos commandes avec /command-name
  • Vérifiez que les agents apparaissent dans /agents
  • Vérifiez que les hooks fonctionnent comme prévu
4

Itérer sur votre plugin

Après avoir apporté des modifications au code de votre plugin :
Désinstaller la version actuelle
/plugin uninstall my-plugin@dev-marketplace
Réinstaller pour tester les changements
/plugin install my-plugin@dev-marketplace
Répétez ce cycle pendant que vous développez et affinez votre plugin.
Pour plusieurs plugins : Organisez les plugins dans des sous-répertoires comme ./plugins/plugin-name et mettez à jour votre marketplace.json en conséquence. Voir Sources de plugins pour les modèles d’organisation.

​
Déboguer les problèmes de plugins

Si votre plugin ne fonctionne pas comme prévu :
  1. Vérifiez la structure : Assurez-vous que vos répertoires sont à la racine du plugin, pas à l’intérieur de .claude-plugin/
  2. Testez les composants individuellement : Vérifiez chaque commande, agent et hook séparément
  3. Utilisez les outils de validation et de débogage : Voir Outils de débogage et de développement pour les commandes CLI et les techniques de dépannage

​
Partager vos plugins

Quand votre plugin est prêt à être partagé :
  1. Ajoutez de la documentation : Incluez un README.md avec des instructions d’installation et d’utilisation
  2. Versionnez votre plugin : Utilisez le versioning sémantique dans votre plugin.json
  3. Créez ou utilisez une marketplace : Distribuez via des marketplaces de plugins pour une installation facile
  4. Testez avec d’autres : Faites tester le plugin par les membres de l’équipe avant une distribution plus large
Pour les spécifications techniques complètes, les techniques de débogage et les stratégies de distribution, voir Référence des plugins.

​
Prochaines étapes

Maintenant que vous comprenez le système de plugins de Claude Code, voici les chemins suggérés pour différents objectifs :

​
Pour les utilisateurs de plugins

  • Découvrir des plugins : Parcourez les marketplaces communautaires pour des outils utiles
  • Adoption d’équipe : Configurez des plugins au niveau du dépôt pour vos projets
  • Gestion de marketplace : Apprenez à gérer plusieurs sources de plugins
  • Utilisation avancée : Explorez les combinaisons et flux de travail de plugins

​
Pour les développeurs de plugins

  • Créez votre première marketplace : Guide des marketplaces de plugins
  • Composants avancés : Plongez plus profondément dans des composants de plugins spécifiques :
    • Commandes slash - Détails de développement de commandes
    • Sous-agents - Configuration et capacités des agents
    • Hooks - Gestion d’événements et automatisation
    • MCP - Intégration d’outils externes
  • Stratégies de distribution : Empaquetez et partagez vos plugins efficacement
  • Contribution communautaire : Considérez contribuer aux collections de plugins communautaires

​
Pour les chefs d’équipe et administrateurs

  • Configuration de dépôt : Configurez l’installation automatique de plugins pour les projets d’équipe
  • Gouvernance des plugins : Établissez des directives pour l’approbation et la révision de sécurité des plugins
  • Maintenance de marketplace : Créez et maintenez des catalogues de plugins spécifiques à l’organisation
  • Formation et documentation : Aidez les membres de l’équipe à adopter les flux de travail de plugins efficacement

​
Voir aussi

  • Marketplaces de plugins - Créer et gérer des catalogues de plugins
  • Commandes slash - Comprendre les commandes personnalisées
  • Sous-agents - Créer et utiliser des agents spécialisés
  • Hooks - Automatiser les flux de travail avec des gestionnaires d’événements
  • MCP - Se connecter à des outils et services externes
  • Paramètres - Options de configuration pour les plugins