Chapitre 7 · Chapitre 7 · Sécurité, limites et projet final
7.2 Les bonnes pratiques d'écriture
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementLa documentation donne une liste de bonnes pratiques. Voici ce qu'elles signifient concrètement, avec nos scripts de la boulangerie.
Valider les entrées
Ne fais pas confiance aveuglément au JSON reçu. Vérifie que le champ existe avant de l'utiliser (tool_input?.file_path), et sors proprement s'il manque. Le contenu du JSON vient en partie de ce que Claude a décidé, lui-même influencé par ce qu'il a lu (un fichier, une page web). Traite-le comme une donnée extérieure.
Toujours mettre les variables entre guillemets
En bash, écris "$VAR" et non $VAR. Sans guillemets, un nom de fichier avec un espace ou un caractère spécial peut être découpé ou interprété.
Bloquer les remontées de dossier
Méfie-toi des chemins qui contiennent ... Un chemin comme site/../../autre-projet sort du dossier prévu. Voici un contrôle à ajouter à tes scripts, juste après la lecture du chemin :
import { resolve, sep } from 'node:path';
const racine = resolve(process.env.CLAUDE_PROJECT_DIR || '.');
const cible = resolve(fichier);
if (fichier.includes('..') || !(cible === racine || cible.startsWith(racine + sep))) {
console.error(`Chemin refusé : ${fichier} sort du projet.`);
process.exit(2);
}
resolve calcule le chemin réel, et on vérifie qu'il reste dans le dossier du projet. Pour verifier.mjs, cela garantit que Prettier ne réécrira jamais un fichier hors du projet.
Utiliser des chemins absolus
Référence tes scripts avec $CLAUDE_PROJECT_DIR. Tu évites ainsi le « command not found » et l'exécution d'un mauvais script. La doc précise : en forme shell, entoure le chemin de guillemets doubles. Elle décrit aussi une forme exec (avec un champ args), qui lance le script directement sans shell : consulte la section dédiée de la doc avant de l'utiliser.
Éviter les fichiers sensibles
Ne fais pas lire ou envoyer .env, .git/ ou des clés par un hook. C'est pour ça que verifier.mjs travaille avec une liste blanche d'extensions : .env n'y figure pas, donc Prettier ne l'ouvre jamais.
Bonus : éviter le shell quand c'est possible
Dans notre script, Prettier est lancé avec execFileSync et une liste d'arguments, sans shell. Le chemin du fichier ne peut donc jamais être interprété comme une commande. Pendant le tournage, une première version passait par un shell : Node a affiché un avertissement de sécurité, et le script a été corrigé.
Bonus : garder les hooks rapides et prévisibles
Un hook lent ralentit chaque action. Un hook qui dépend d'Internet peut échouer sans prévenir. Préfère des outils installés dans le projet, et un timeout raisonnable.
La check-list de relecture d'un hook
- ☐ Le script vérifie que les champs reçus existent avant de s'en servir.
- ☐ Les chemins contenant .. ou sortant du projet sont refusés.
- ☐ Aucun shell n'est utilisé, ou toutes les variables sont entre guillemets.
- ☐ Le script est appelé par un chemin absolu ($CLAUDE_PROJECT_DIR).
- ☐ Il ne lit ni n'envoie .env, .git/, ni aucune clé.
- ☐ Il ne contacte aucune adresse web, ou seulement un service que je contrôle.
- ☐ Les règles strictes utilisent exit 2, jamais exit 1.
- ☐ Je comprends chaque ligne.
Si ça coince
- Le contrôle de
..bloque des fichiers légitimes. Vérifie queCLAUDE_PROJECT_DIRest défini lors de tes tests à la main (set CLAUDE_PROJECT_DIR=%CD%). - Node affiche un avertissement de sécurité sur un shell. Passe à
execFileSyncavec une liste d'arguments, sansshell: true. - Ton script bash casse sur un nom de fichier avec espace. Mets chaque variable entre guillemets doubles.
À retenir
- Valide les entrées, mets les variables entre guillemets, refuse les
... - Chemins absolus avec
$CLAUDE_PROJECT_DIR. - Pas de
.env, pas de.git/, pas de clés dans un hook. - Sans shell, c'est plus sûr :
execFileSyncavec une liste d'arguments.