Référence des plugins

​

Référence des composants de plugin

​

Skills

skills/
├── pdf-processor/
│   ├── SKILL.md
│   ├── reference.md (optionnel)
│   └── scripts/ (optionnel)
└── code-reviewer/
    └── SKILL.md

• Les skills et les commandes sont découverts automatiquement lors de l’installation du plugin
• Claude peut les invoquer automatiquement en fonction du contexte de la tâche
• Les skills peuvent inclure des fichiers de support à côté de SKILL.md

​

Agents

---
name: agent-name
description: Ce dans quoi cet agent se spécialise et quand Claude devrait l'invoquer
---

Invite système détaillée pour l'agent décrivant son rôle, son expertise et son comportement.

• Les agents apparaissent dans l’interface /agents
• Claude peut invoquer les agents automatiquement en fonction du contexte de la tâche
• Les agents peuvent être invoqués manuellement par les utilisateurs
• Les agents de plugin fonctionnent aux côtés des agents Claude intégrés

​

Hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/format-code.sh"
          }
        ]
      }
    ]
  }
}

• PreToolUse : Avant que Claude utilise un outil
• PostToolUse : Après que Claude utilise avec succès un outil
• PostToolUseFailure : Après l’échec de l’exécution d’un outil par Claude
• PermissionRequest : Quand une boîte de dialogue de permission est affichée
• UserPromptSubmit : Quand l’utilisateur soumet une invite
• Notification : Quand Claude Code envoie des notifications
• Stop : Quand Claude tente d’arrêter
• SubagentStart : Quand un subagent est démarré
• SubagentStop : Quand un subagent tente d’arrêter
• SessionStart : Au début des sessions
• SessionEnd : À la fin des sessions
• TeammateIdle : Quand un coéquipier d’une équipe d’agents est sur le point de devenir inactif
• TaskCompleted : Quand une tâche est marquée comme complétée
• PreCompact : Avant que l’historique de conversation soit compacté

• command : Exécuter des commandes shell ou des scripts
• prompt : Évaluer une invite avec un LLM (utilise l’espace réservé $ARGUMENTS pour le contexte)
• agent : Exécuter un vérificateur agentic avec des outils pour les tâches de vérification complexes

​

Serveurs MCP

{
  "mcpServers": {
    "plugin-database": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_PATH": "${CLAUDE_PLUGIN_ROOT}/data"
      }
    },
    "plugin-api-client": {
      "command": "npx",
      "args": ["@company/mcp-server", "--plugin-mode"],
      "cwd": "${CLAUDE_PLUGIN_ROOT}"
    }
  }
}

• Les serveurs MCP de plugin démarrent automatiquement quand le plugin est activé
• Les serveurs apparaissent comme des outils MCP standard dans la boîte à outils de Claude
• Les capacités du serveur s’intègrent de manière transparente avec les outils existants de Claude
• Les serveurs de plugin peuvent être configurés indépendamment des serveurs MCP de l’utilisateur

​

Serveurs LSP

• Diagnostics instantanés : Claude voit les erreurs et les avertissements immédiatement après chaque modification
• Navigation de code : aller à la définition, trouver les références et les informations au survol
• Sensibilisation au langage : informations de type et documentation pour les symboles de code

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

{
  "name": "my-plugin",
  "lspServers": {
    "go": {
      "command": "gopls",
      "args": ["serve"],
      "extensionToLanguage": {
        ".go": "go"
      }
    }
  }
}

​

Portées d’installation des plugins

​

Schéma du manifeste du plugin

​

Schéma complet

{
  "name": "plugin-name",
  "version": "1.2.0",
  "description": "Brief plugin description",
  "author": {
    "name": "Author Name",
    "email": "[email protected]",
    "url": "https://github.com/author"
  },
  "homepage": "https://docs.example.com/plugin",
  "repository": "https://github.com/author/plugin",
  "license": "MIT",
  "keywords": ["keyword1", "keyword2"],
  "commands": ["./custom/commands/special.md"],
  "agents": "./custom/agents/",
  "skills": "./custom/skills/",
  "hooks": "./config/hooks.json",
  "mcpServers": "./mcp-config.json",
  "outputStyles": "./styles/",
  "lspServers": "./.lsp.json"
}

​

Champs obligatoires

​

Champs de métadonnées

​

Champs de chemin de composant

​

Règles de comportement des chemins

• Si commands/ existe, il est chargé en plus des chemins de commandes personnalisés
• Tous les chemins doivent être relatifs à la racine du plugin et commencer par ./
• Les commandes des chemins personnalisés utilisent les mêmes règles de nommage et d’espace de noms
• Plusieurs chemins peuvent être spécifiés sous forme de tableaux pour plus de flexibilité

{
  "commands": [
    "./specialized/deploy.md",
    "./utilities/batch-process.md"
  ],
  "agents": [
    "./custom-agents/reviewer.md",
    "./custom-agents/tester.md"
  ]
}

​

Variables d’environnement

{
  "hooks": {
    "PostToolUse": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/process.sh"
          }
        ]
      }
    ]
  }
}

​

Mise en cache des plugins et résolution des fichiers

• Via claude --plugin-dir, pour la durée d’une session.
• Via une marketplace, installés pour les sessions futures.

​

Limitations de traversée de répertoires

​

Travail avec les dépendances externes

# À l'intérieur de votre répertoire de plugin
ln -s /path/to/shared-utils ./shared-utils

​

Structure du répertoire des plugins

​

Disposition standard des plugins

enterprise-plugin/
├── .claude-plugin/           # Répertoire de métadonnées (optionnel)
│   └── plugin.json             # manifeste du plugin
├── commands/                 # Emplacement de commande par défaut
│   ├── status.md
│   └── logs.md
├── agents/                   # Emplacement d'agent par défaut
│   ├── security-reviewer.md
│   ├── performance-tester.md
│   └── compliance-checker.md
├── skills/                   # Skills d'agent
│   ├── code-reviewer/
│   │   └── SKILL.md
│   └── pdf-processor/
│       ├── SKILL.md
│       └── scripts/
├── hooks/                    # Configurations des hooks
│   ├── hooks.json           # Configuration principale des hooks
│   └── security-hooks.json  # Hooks supplémentaires
├── settings.json            # Paramètres par défaut pour le plugin
├── .mcp.json                # Définitions du serveur MCP
├── .lsp.json                # Configurations du serveur LSP
├── scripts/                 # Scripts de hooks et d'utilitaires
│   ├── security-scan.sh
│   ├── format-code.py
│   └── deploy.js
├── LICENSE                  # Fichier de licence
└── CHANGELOG.md             # Historique des versions

​

Référence des emplacements de fichiers

​

Référence des commandes CLI

​

plugin install

claude plugin install <plugin> [options]

• <plugin> : Nom du plugin ou plugin-name@marketplace-name pour une marketplace spécifique

# Installer dans la portée utilisateur (par défaut)
claude plugin install formatter@my-marketplace

# Installer dans la portée du projet (partagé avec l'équipe)
claude plugin install formatter@my-marketplace --scope project

# Installer dans la portée locale (ignorée par git)
claude plugin install formatter@my-marketplace --scope local

​

plugin uninstall

claude plugin uninstall <plugin> [options]

• <plugin> : Nom du plugin ou plugin-name@marketplace-name

​

plugin enable

claude plugin enable <plugin> [options]

• <plugin> : Nom du plugin ou plugin-name@marketplace-name

​

plugin disable

claude plugin disable <plugin> [options]

• <plugin> : Nom du plugin ou plugin-name@marketplace-name

​

plugin update

claude plugin update <plugin> [options]

• <plugin> : Nom du plugin ou plugin-name@marketplace-name

​

Outils de débogage et de développement

​

Commandes de débogage

• Quels plugins sont en cours de chargement
• Toute erreur dans les manifestes de plugins
• Enregistrement des commandes, agents et hooks
• Initialisation du serveur MCP

​

Problèmes courants

​

Exemples de messages d’erreur

• Invalid JSON syntax: Unexpected token } in JSON at position 142 : vérifiez les virgules manquantes, les virgules supplémentaires ou les chaînes non citées
• Plugin has an invalid manifest file at .claude-plugin/plugin.json. Validation errors: name: Required : un champ obligatoire est manquant
• Plugin has a corrupt manifest file at .claude-plugin/plugin.json. JSON parse error: ... : erreur de syntaxe JSON

• Warning: No commands found in plugin my-plugin custom directory: ./cmds. Expected .md files or SKILL.md in subdirectories. : le chemin de commande existe mais ne contient aucun fichier de commande valide
• Plugin directory not found at path: ./plugins/my-plugin. Check that the marketplace entry has the correct path. : le chemin source dans marketplace.json pointe vers un répertoire inexistant
• Plugin my-plugin has conflicting manifests: both plugin.json and marketplace entry specify components. : supprimez les définitions de composants en double ou supprimez strict: false dans l’entrée de la marketplace

​

Dépannage des hooks

1. Vérifiez que le script est exécutable : chmod +x ./scripts/your-script.sh
2. Vérifiez la ligne shebang : La première ligne doit être #!/bin/bash ou #!/usr/bin/env bash
3. Vérifiez que le chemin utilise ${CLAUDE_PLUGIN_ROOT} : "command": "${CLAUDE_PLUGIN_ROOT}/scripts/your-script.sh"
4. Testez le script manuellement : ./scripts/your-script.sh

1. Vérifiez que le nom de l’événement est correct (sensible à la casse) : PostToolUse, pas postToolUse
2. Vérifiez que le motif de correspondance correspond à vos outils : "matcher": "Write|Edit" pour les opérations de fichier
3. Confirmez que le type de hook est valide : command, prompt, ou agent

​

Dépannage du serveur MCP

1. Vérifiez que la commande existe et est exécutable
2. Vérifiez que tous les chemins utilisent la variable ${CLAUDE_PLUGIN_ROOT}
3. Vérifiez les journaux du serveur MCP : claude --debug affiche les erreurs d’initialisation
4. Testez le serveur manuellement en dehors de Claude Code

1. Assurez-vous que le serveur est correctement configuré dans .mcp.json ou plugin.json
2. Vérifiez que le serveur implémente correctement le protocole MCP
3. Vérifiez les délais d’expiration de la connexion dans la sortie de débogage

​

Erreurs de structure de répertoire

my-plugin/
├── .claude-plugin/
│   └── plugin.json      ← Seul le manifeste ici
├── commands/            ← Au niveau racine
├── agents/              ← Au niveau racine
└── hooks/               ← Au niveau racine

1. Exécutez claude --debug et recherchez les messages « loading plugin »
2. Vérifiez que chaque répertoire de composants est listé dans la sortie de débogage
3. Vérifiez que les permissions de fichier permettent de lire les fichiers du plugin

​

Référence de distribution et de versioning

​

Gestion des versions

{
  "name": "my-plugin",
  "version": "2.1.0"
}

• MAJOR : Changements cassants (changements d’API incompatibles)
• MINOR : Nouvelles fonctionnalités (ajouts rétro-compatibles)
• PATCH : Corrections de bugs (corrections rétro-compatibles)

• Commencez à 1.0.0 pour votre première version stable
• Mettez à jour la version dans plugin.json avant de distribuer les modifications
• Documentez les modifications dans un fichier CHANGELOG.md
• Utilisez des versions de pré-version comme 2.0.0-beta.1 pour les tests

​

Voir aussi

• Plugins - Tutoriels et utilisation pratique
• Marketplaces de plugins - Création et gestion des marketplaces
• Skills - Détails du développement des skills
• Subagents - Configuration et capacités des agents
• Hooks - Gestion des événements et automatisation
• MCP - Intégration des outils externes
• Paramètres - Options de configuration pour les plugins