Skip to content
Floskool

Chapter 7 · Chapitre 7 · Sécurité, limites et projet final

7.5 Projet final : ton système de garde-fous

Free lesson 7 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Tu vas maintenant assembler ce que tu as appris dans un seul projet, avec trois hooks qui travaillent ensemble. Tu peux le faire sur le site de la boulangerie ou directement dans ton propre projet.

L'objectif

Dans ton propre projet :

  1. Formater automatiquement chaque fichier modifié (PostToolUse, Edit|Write).
  2. Protéger les fichiers sensibles (PreToolUse, Edit|Write).
  3. Être prévenu quand Claude attend ton accord (Notification, permission_prompt).

Étape 1 : les scripts

Copie verifier.mjs (leçon 5.2) et proteger.mjs (leçon 6.1, version corrigée de l'exercice pour laisser .env.example modifiable) dans .claude/hooks/. Ajoute à chacun le contrôle de chemin de la leçon 7.2. Teste chaque script à la main avec ses trois cas.

Étape 2 : la configuration du projet

.claude/settings.json :

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/proteger.mjs\"" }]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/verifier.mjs\"" }]
      }
    ]
  }
}

Étape 3 : la notification personnelle

La notification, elle, va dans ~/.claude/settings.json (leçon 3.3), puisque tu la veux dans tous tes projets. Sous Windows :

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

Sous macOS, reprends la commande osascript de la leçon 3.3. Si ce fichier contient déjà d'autres réglages, ajoute la clé "hooks" à côté, sans rien écraser.

Étape 4 : le complément permissions

Dans .claude/settings.json, à côté de "hooks", ajoute les règles de refus de lecture des secrets vues en leçon 6.1. Le hook protège l'écriture, la permission protège la lecture.

La check-list de validation

  • ☐ /hooks affiche bien les trois hooks sous le bon événement.
  • ☐ Chaque script passe les trois tests manuels : cas normal, cas d'erreur, cas hors sujet.
  • ☐ Demander « ajoute un commentaire dans .env » est bloqué, avec un message clair.
  • ☐ .env.example reste modifiable.
  • ☐ Une modification d'un fichier .js le reformate.
  • ☐ Un code volontairement cassé fait remonter l'erreur à Claude.
  • ☐ Une demande d'autorisation laissée en attente déclenche la notification.
  • ☐ Tu as lu et compris chaque ligne de chaque script.

Exercice corrigé : l'ordre des hooks

Claude essaie d'écrire dans .env. Lequel des deux hooks s'exécute ?

Corrigé : seulement proteger.mjs. Il tourne en PreToolUse, avant l'écriture, et la bloque avec le code 2. Comme l'outil n'a pas réussi, PostToolUse ne se déclenche pas, et verifier.mjs ne tourne pas.

Si ça coince

  • Un seul des trois hooks apparaît. Les événements sont dans des fichiers différents : /hooks doit montrer ceux du projet et ceux de ~/.claude/settings.json. Vérifie les deux JSON.
  • La notification ne vient jamais. Elle attend environ six secondes de demande en attente, et la boîte de dialogue peut être cachée derrière ton terminal.
  • .env.example est bloqué. Tu as gardé la version includes('.env') : passe à endsWith('/.env').

Pour aller plus loin

Écris un hook personnel : « après chaque modification d'un fichier .md de mon dossier articles/, compte les mots et préviens Claude si l'article dépasse 1 500 mots ». Tu as toutes les briques : le matcher, la lecture du chemin, le filtre de dossier, l'additionalContext pour prévenir.

Si tu veux aller encore plus loin avec Claude Code, des skills prêts à l'emploi et des guides pratiques t'attendent sur govincia.fr. Tu pourras les combiner avec les hooks que tu viens de construire.

À retenir

  • Trois hooks complémentaires : protéger avant, formater après, être prévenu.
  • Les hooks du projet vont dans .claude/settings.json, la notification dans ~/.claude/settings.json.
  • Hooks et permissions se complètent : écriture bloquée par le hook, lecture refusée par la permission.
  • Chaque script est testé à la main, puis en session, et compris ligne par ligne.

Bravo : tu sais désormais faire en sorte que Claude Code vérifie son travail automatiquement, sans que tu le lui redemandes.