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

​
Démarrage rapide

Créons un simple plugin de salutation 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 fondamentaux.

​
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éez la structure de la marketplace

mkdir test-marketplace
cd test-marketplace
2

Créez le répertoire du plugin

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

Créez le manifeste du plugin

Créez .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "A simple greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
EOF
4

Ajoutez une commande personnalisée

Créez commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user warmly and ask how you can help them today. Make the greeting personal and encouraging.
EOF
5

Créez le manifeste de la marketplace

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

Installez et testez votre plugin

Démarrez Claude Code à partir du répertoire parent
cd ..
claude
Ajoutez la marketplace de test
/plugin marketplace add ./test-marketplace
Installez 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.
Essayez 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

​
Aperçu 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
├── skills/                   # Skills des agents (optionnel)
│   └── my-skill/
│       └── SKILL.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/
  • Skills : Créez des fichiers SKILL.md dans le répertoire skills/
  • Hooks : Créez hooks/hooks.json pour la gestion des événements
  • Serveurs MCP : Créez .mcp.json pour l’intégration d’outils externes
Prochaines étapes : Prêt à ajouter plus de fonctionnalités ? Allez à Développez des plugins plus complexes pour ajouter des agents, des hooks et des serveurs MCP. Pour les spécifications techniques complètes de tous les composants de plugin, voir Référence des plugins.

​
Installez et gérez 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

​
Ajoutez des marketplaces

Les marketplaces sont des catalogues de plugins disponibles. Ajoutez-les pour découvrir et installer des plugins :
Ajoutez une marketplace
/plugin marketplace add your-org/claude-plugins
Parcourez les plugins disponibles
/plugin
Pour la gestion détaillée de la marketplace, y compris les référentiels Git, le développement local et la distribution d’équipe, voir Marketplaces de plugins.

​
Installez les plugins

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

Ouvrez 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)

Installez un plugin spécifique
/plugin install formatter@your-org
Activez un plugin désactivé
/plugin enable plugin-name@marketplace-name
Désactivez sans désinstaller
/plugin disable plugin-name@marketplace-name
Supprimez complètement un plugin
/plugin uninstall plugin-name@marketplace-name

​
Vérifiez l’installation

Après avoir installé un plugin :
  1. Vérifiez les commandes disponibles : Exécutez /help pour voir les nouvelles commandes
  2. Testez les fonctionnalités du plugin : Essayez les commandes et fonctionnalités du plugin
  3. Examinez les détails du plugin : Utilisez /plugin → « Manage Plugins » pour voir ce que le plugin fournit

​
Configurez les workflows de plugins d’équipe

Configurez les plugins au niveau du référentiel pour assurer des outils cohérents dans votre équipe. Lorsque les membres de l’équipe font confiance à votre dossier de référentiel, Claude Code installe automatiquement les marketplaces et les plugins spécifiés. Pour configurer les plugins d’équipe :
  1. Ajoutez la configuration de la marketplace et du plugin au fichier .claude/settings.json de votre référentiel
  2. Les membres de l’équipe font confiance au dossier du référentiel
  3. Les plugins s’installent automatiquement pour tous les membres de l’équipe
Pour les instructions complètes, y compris les exemples de configuration, la configuration de la marketplace et les meilleures pratiques de déploiement, voir Configurez les marketplaces d’équipe.

​
Développez 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.

​
Ajoutez des Skills à votre plugin

Les plugins peuvent inclure Agent Skills pour étendre les capacités de Claude. Les Skills sont invoqués par le modèle—Claude les utilise de manière autonome en fonction du contexte de la tâche. Pour ajouter des Skills à votre plugin, créez un répertoire skills/ à la racine de votre plugin et ajoutez des dossiers Skill avec des fichiers SKILL.md. Les Skills du plugin sont automatiquement disponibles lorsque le plugin est installé. Pour des conseils complets sur la création de Skills, voir Agent Skills.

​
Organisez les 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 du répertoire des plugins.

​
Testez vos plugins localement

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

Configurez votre structure de développement

Organisez votre plugin et votre marketplace pour les tests :
Créez la structure du répertoire
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éez le manifeste de la marketplace

Créez marketplace.json
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Developer"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "Plugin under development"
}
]
}
EOF
3

Installez et testez

Démarrez Claude Code à partir du répertoire parent
cd ..
claude
Ajoutez votre marketplace de développement
/plugin marketplace add ./dev-marketplace
Installez 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érez sur votre plugin

Après avoir apporté des modifications au code de votre plugin :
Désinstallez la version actuelle
/plugin uninstall my-plugin@dev-marketplace
Réinstallez pour tester les modifications
/plugin install my-plugin@dev-marketplace
Répétez ce cycle au fur et à mesure 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éboguez les problèmes de plugin

Si votre plugin ne fonctionne pas comme prévu :
  1. Vérifiez la structure : Assurez-vous que vos répertoires se trouvent à 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

​
Partagez vos plugins

Lorsque votre plugin est prêt à être partagé :
  1. Ajoutez de la documentation : Incluez un README.md avec les instructions d’installation et d’utilisation
  2. Versionnez votre plugin : Utilisez la versioning sémantique dans votre plugin.json
  3. Créez ou utilisez une marketplace : Distribuez via les 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écouvrez les plugins : Parcourez les marketplaces communautaires pour trouver des outils utiles
  • Adoption d’équipe : Configurez les plugins au niveau du référentiel pour vos projets
  • Gestion de la marketplace : Apprenez à gérer plusieurs sources de plugins
  • Utilisation avancée : Explorez les combinaisons et workflows 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 les composants de plugin spécifiques :
    • Commandes slash - Détails du développement des commandes
    • Sous-agents - Configuration et capacités des agents
    • Agent Skills - Étendez les capacités de Claude
    • Hooks - Gestion des événements et automatisation
    • MCP - Intégration d’outils externes
  • Stratégies de distribution : Empaquetez et partagez vos plugins efficacement
  • Contribution communautaire : Envisagez de contribuer aux collections de plugins communautaires

​
Pour les responsables d’équipe et les administrateurs

  • Configuration du référentiel : Configurez l’installation automatique des plugins pour les projets d’équipe
  • Gouvernance des plugins : Établissez des directives pour l’approbation et l’examen de sécurité des plugins
  • Maintenance de la marketplace : Créez et maintenez des catalogues de plugins spécifiques à l’organisation
  • Formation et documentation : Aidez les membres de l’équipe à adopter les workflows de plugins efficacement

​
Voir aussi

  • Marketplaces de plugins - Création et gestion des catalogues de plugins
  • Commandes slash - Comprendre les commandes personnalisées
  • Sous-agents - Création et utilisation d’agents spécialisés
  • Agent Skills - Étendez les capacités de Claude
  • Hooks - Automatisation des workflows avec des gestionnaires d’événements
  • MCP - Connexion aux outils et services externes
  • Paramètres - Options de configuration pour les plugins