Claude Code Plugins : Le guide complet du système d'extension 2025

Claude Code s'est imposé comme l'outil de développement IA leader pour le terminal. Mais sa véritable puissance réside dans le système d'extension modulaire, qui permet aux développeurs de personnaliser Claude Code selon leurs workflows spécifiques. Dans ce guide, vous découvrirez tout sur les Plugins, Skills, Serveurs MCP, Agents et leur fonctionnement ensemble.

---

Vue d'ensemble du système d'extension Claude Code

Claude Code offre cinq mécanismes d'extension différents, chacun couvrant différents cas d'usage :

Comprendre la hiérarchie

┌─────────────────────────────────────────────────────────────┐
│                      Claude Code CLI                         │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │   Plugins   │  │   Skills    │  │   Serveurs MCP      │  │
│  │  (Packages) │  │ (Capacité)  │  │ (Outils externes)   │  │
│  └──────┬──────┘  └──────┬──────┘  └──────────┬──────────┘  │
│         │                │                     │             │
│         ▼                ▼                     ▼             │
│  ┌─────────────────────────────────────────────────────────┐│
│  │                    Agents/Subagents                      ││
│  │              (Assistants spécialisés)                    ││
│  └─────────────────────────────────────────────────────────┘│
│                            ▲                                 │
│                            │                                 │
│  ┌─────────────────────────────────────────────────────────┐│
│  │    CLAUDE.md / AGENTS.md (Contexte projet & règles)     ││
│  └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘

---

1. Claude Code Plugins – La solution complète

Les Plugins sont le format d'extension le plus puissant. Ils regroupent plusieurs composants dans un package distribuable :

Ce que les Plugins peuvent contenir

• Slash Commands – Commandes personnalisées (/plugin:command)
• Agents – Subagents spécialisés
• Skills – Capacités sensibles au contexte
• Hooks – Gestionnaires d'événements pour l'automatisation
• Serveurs MCP – Configurations d'outils externes
• Serveurs LSP – Intelligence de code pour les langages

Structure d'un Plugin

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # Métadonnées du plugin (requis)
├── commands/                # Slash commands
│   └── hello.md
├── agents/                  # Définitions de subagents
│   └── reviewer.md
├── skills/                  # Agent Skills
│   └── code-review/
│       └── SKILL.md
├── hooks/                   # Gestionnaires d'événements
│   └── hooks.json
├── .mcp.json                # Configuration serveur MCP
├── .lsp.json                # Configuration serveur LSP
└── README.md                # Documentation

Manifeste du Plugin (plugin.json)

{
  "name": "my-plugin",
  "description": "Description du plugin",
  "version": "1.0.0",
  "author": {
    "name": "Votre Nom",
    "email": "email@example.com"
  },
  "repository": "https://github.com/user/my-plugin",
  "license": "MIT"
}

---

2. Skills – Capacités contextuelles

Les Skills sont invoqués par le modèle : Claude décide automatiquement quand un skill est pertinent, basé sur le contexte de la tâche.

Différence avec les Plugins

Structure d'un Skill (SKILL.md)

---
name: code-review
description: Revue de code selon les meilleures pratiques. À utiliser lors des revues de PR.
---

Lors de la revue du code, analyser :
1. Structure et lisibilité du code
2. Vulnérabilités de sécurité
3. Implications de performance
4. Couverture de tests

Fournir des retours organisés par priorité :
- Critique (à corriger obligatoirement)
- Avertissements (à corriger)
- Suggestions (à considérer)

Emplacements de stockage des Skills

---

3. Serveurs MCP – Intégration d'outils externes

Model Context Protocol (MCP) permet à Claude d'accéder à des sources de données et outils externes. Les serveurs MCP sont indépendants de Claude Code et peuvent être utilisés par divers clients.

MCP vs. Plugin

Intégrer MCP dans les Plugins

Les plugins peuvent configurer des serveurs MCP via .mcp.json :

{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["-y", "@my-org/db-mcp-server"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

Quand MCP vs. Plugin ?

Utilisez MCP quand :

• Vous intégrez des APIs/bases de données externes
• La fonctionnalité doit être agnostique au client
• Vous voulez utiliser des serveurs MCP existants

Utilisez les Plugins quand :

• Vous personnalisez les workflows Claude Code
• Vous avez besoin de slash commands ou hooks
• Vous voulez définir des agents spécialisés

---

4. Agents & Subagents – Assistants spécialisés

Les Agents (aussi appelés subagents) sont des personnalités IA préconfigurées à qui Claude Code peut déléguer des tâches.

Différence avec les Skills

Définition d'un Agent

---
name: code-reviewer
description: Revue de code experte. À utiliser proactivement après modifications de code.
tools: Read, Grep, Glob, Bash
model: sonnet
permissionMode: default
---

Vous êtes un reviewer de code senior. Concentrez-vous sur :
- Qualité et lisibilité du code
- Meilleures pratiques de sécurité
- Considérations de performance
- Couverture de tests

Fournissez des retours actionnables avec exemples.

Agents intégrés

Claude Code inclut ces agents intégrés :

---

5. CLAUDE.md & AGENTS.md – Contexte projet

Ces fichiers Markdown fournissent à Claude un contexte persistant sur votre projet.

CLAUDE.md

Chargé automatiquement, contient :

• Description du projet & architecture
• Conventions de code & guides de style
• Commandes de build & test
• Fichiers & structures importants

# Projet : Mon Application Web

## Architecture
- Frontend : Next.js 14 avec App Router
- Backend : Python FastAPI
- Base de données : PostgreSQL avec Prisma

## Commandes
- `npm run dev` - Démarrer le développement
- `npm test` - Exécuter les tests
- `npm run build` - Build production

## Conventions
- Utiliser TypeScript strict mode
- Suivre les règles ESLint
- Écrire des tests pour toutes nouvelles fonctionnalités

AGENTS.md

Instructions spécifiques pour les agents IA :

# Instructions Agent

## Règles de revue de code
- Toujours vérifier les vulnérabilités de sécurité
- Exiger une couverture de tests pour les nouvelles fonctionnalités
- Signaler l'utilisation d'APIs dépréciées

## Directives de commit
- Utiliser des commits conventionnels
- Inclure les numéros de tickets
- Signer les commits avec GPG

---

Plugins officiels Claude Code

Anthropic fournit 12 plugins officiels qui démontrent les meilleures pratiques :

1. agent-sdk-dev

Kit de développement pour le Claude Agent SDK

2. claude-opus-4-5-migration

Migration vers Claude Opus 4.5

Migration automatisée depuis Sonnet 4.x et Opus 4.1 :

• Mises à jour des chaînes de modèle
• Ajustements des headers beta
• Optimisations de prompts

3. code-review ⭐

Revue PR automatisée avec système multi-agents

4. commit-commands

Automatisation du workflow Git

5. feature-dev ⭐

Workflow de développement de fonctionnalités en 7 phases

6. frontend-design

Design frontend professionnel

Skill pour créer des interfaces distinctives et prêtes pour la production, évitant l'esthétique IA générique.

7. hookify

Générateur de hooks personnalisés

8. plugin-dev ⭐

Toolkit de développement de plugins

9. pr-review-toolkit

Système de revue PR complet

/pr-review-toolkit:review-pr [aspects]

Aspects disponibles : comments, tests, errors, types, code, simplify, all

10. security-guidance

Hook de rappel de sécurité

Surveille 9 patterns de sécurité lors des modifications de fichiers :

• Injection de commandes
• Vulnérabilités XSS
• Utilisation de eval()
• HTML dangereux
• Et plus...

---

Installation de Plugins

Méthode 1 : Via Marketplace

# Dans Claude Code
/plugin install marketplace-name/plugin-name

Méthode 2 : Développement local

# Charger le répertoire du plugin
claude --plugin-dir ./my-plugin

Méthode 3 : Configuration projet

Dans .claude/settings.json :

{
  "plugins": [
    {
      "name": "my-plugin",
      "source": "./plugins/my-plugin"
    }
  ]
}

---

Créer des Plugins personnalisés

Étape 1 : Créer la structure

mkdir -p my-plugin/.claude-plugin
mkdir -p my-plugin/commands
mkdir -p my-plugin/agents

Étape 2 : Créer le manifeste

// my-plugin/.claude-plugin/plugin.json
{
  "name": "my-plugin",
  "description": "Mon premier plugin Claude Code",
  "version": "1.0.0"
}

Étape 3 : Ajouter une commande

<!-- my-plugin/commands/hello.md -->
---
description: Accueille l'utilisateur chaleureusement
---

# Commande Hello

Accueillez l'utilisateur nommé "$ARGUMENTS" chaleureusement et demandez comment vous pouvez aider.

Étape 4 : Tester

claude --plugin-dir ./my-plugin
# Puis dans Claude Code :
/my-plugin:hello Max

---

Bonnes pratiques

1. Conventions de nommage

plugin-name/           # kebab-case pour les noms de plugins
├── commands/
│   └── my-command.md  # kebab-case pour les noms de commandes
├── agents/
│   └── my-agent.md    # kebab-case pour les noms d'agents
└── skills/
    └── my-skill/      # kebab-case pour les dossiers de skills
        └── SKILL.md   # MAJUSCULES pour SKILL.md

2. Composants focalisés

Chaque composant doit faire une chose bien :

# ✅ Bon : Agents spécialisés
---
name: security-reviewer
description: Revue de code pour vulnérabilités de sécurité uniquement
tools: Read, Grep
---

3. Descriptions claires

Les descriptions aident Claude à décider quand utiliser un agent/skill :

# ✅ Spécifique
description: Revue de code TypeScript pour problèmes de typage. À utiliser proactivement lors de l'édition de fichiers .ts ou .tsx.

---

Résumé : Quand utiliser quoi ?

---

Conclusion

Le système d'extension Claude Code offre une flexibilité maximale :

• Plugins pour des packages complets et distribuables
• Skills pour des capacités contextuelles
• Serveurs MCP pour l'intégration d'outils externes
• Agents pour la délégation de tâches spécialisées
• CLAUDE.md pour le contexte projet

Avec les 12 plugins officiels comme inspiration et ce guide comme référence, vous pouvez parfaitement personnaliser Claude Code pour vos workflows de développement.

---

Questions fréquentes (FAQ)

Quelle est la différence entre un Plugin et un serveur MCP ?

Les plugins sont des packages d'extension spécifiques à Claude Code qui regroupent Commands, Agents, Skills et Hooks. Les serveurs MCP sont des serveurs d'outils basés sur un protocole utilisables par tout client compatible MCP. Les plugins peuvent configurer des serveurs MCP, mais les serveurs MCP sont utilisables indépendamment des plugins.

Puis-je convertir des configurations .claude/ existantes en plugins ?

Oui ! Vous pouvez copier vos commands existantes de .claude/commands/, agents de .claude/agents/, et skills de .claude/skills/ directement dans un répertoire de plugin. Ajoutez simplement un manifeste .claude-plugin/plugin.json et votre configuration devient un plugin partageable.

Quand dois-je utiliser un Agent personnalisé plutôt qu'un Skill ?

Utilisez les Agents quand vous avez besoin : de votre propre fenêtre de contexte, d'un accès aux outils restreint, d'un modèle différent (ex: Haiku pour des recherches rapides), ou de déléguer des tâches multi-étapes complexes. Utilisez les Skills pour des extensions de capacités plus simples qui doivent s'exécuter dans le contexte principal.

Comment partager des plugins avec mon équipe ?

Plusieurs options : 1) Créer un marketplace d'équipe (dépôt Git avec index de plugins), 2) Partager le répertoire du plugin via votre monorepo, 3) Publier sur un marketplace public. Pour une utilisation en équipe, un marketplace privé basé sur Git est recommandé.

Quels hooks sont les plus utiles pour les workflows développeur ?

Les hooks les plus populaires sont : PostToolUse pour le linting automatique après modifications de fichiers, PreToolUse pour les vérifications de sécurité avant opérations dangereuses, et SessionStart pour l'injection de contexte. Le plugin security-guidance démontre des hooks PreToolUse efficaces pour la surveillance de sécurité.