Claude Docs

Slash commands et hooks

Automatiser des tâches répétitives avec des commandes personnalisées et des hooks déclenchés par le harness.

Mis à jour le 18 avril 2026·Version: Claude Opus 4.7·
claude-codeautomatisationavancé

Claude Code devient vraiment puissant quand on le personnalise. Deux mécanismes complémentaires : les slash commands (appelés par l'utilisateur) et les hooks (déclenchés par le harness).

Slash commands

Une slash command est un prompt réutilisable rangé dans .claude/commands/. Vous l'invoquez via /<nom> dans une session.

---
description: Lancer les tests et corriger les échecs
---
 
Run the project's test suite. For each failure:
1. Read the failing test
2. Diagnose the root cause (not a workaround)
3. Propose a fix, apply after approval
4. Re-run to confirm

Fichier : .claude/commands/fix-tests.md → invocation : /fix-tests.

Hooks

Les hooks sont des commandes shell exécutées automatiquement par Claude Code sur certains événements (avant un edit, après un bash, à la fin d'une session, etc.).

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npm run lint --silent" }
        ]
      }
    ]
  }
}
Où configurer ?

Les hooks se définissent dans ~/.claude/settings.json (global) ou .claude/settings.json (projet). Les deux se combinent.

Cas d'usage typiques

  • PreToolUse sur Bash — bloquer les commandes dangereuses (rm -rf, git push --force)
  • PostToolUse sur Edit|Write — formatter/linter automatiquement
  • Stop — lancer le type-check à la fin de chaque session
  • UserPromptSubmit — injecter du contexte dynamique (état Git, issue en cours)
Les hooks exécutent du code arbitraire

Un hook mal écrit peut ralentir ou bloquer toute une session. Testez en local avant de partager un settings.json à votre équipe.