Chapitre 2 · Garder la main
Les permissions et les modes
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementCe qu'il a le droit de faire sans te demander
Le pourquoi
Un agent qui agit doit avoir des limites. Claude Code en a deux, d'après la documentation : les points de restauration (il garde une copie d'un fichier avant de le modifier, leçon 5) et les permissions (ce qu'il peut faire sans te demander).
Pense à une coach sportive qui confie son site à Claude Code. Elle veut bien qu'il lise tout, mais elle veut valider chaque modification de sa page tarifs, et elle ne veut surtout pas qu'il touche au fichier où dorment ses mots de passe. Les permissions servent exactement à ça.
Le comment : les modes
Un mode règle ce que Claude Code fait sans te demander. Dans le terminal, Shift+Tab fait défiler les modes, et le mode actif s'affiche en bas de l'écran. Dans VS Code et dans l'application de bureau, un sélecteur de mode se trouve sous la zone de saisie. La documentation décrit notamment :
- Manual (appelé
defaultdans les réglages) : il lit sans demander, mais te demande avant de modifier un fichier ou de lancer une commande. Le plus prudent pour débuter. - Accept edits : il modifie les fichiers et lance des commandes courantes de rangement (créer un dossier, déplacer un fichier) sans demander, mais demande pour les autres commandes.
- Plan : il explore et propose un plan sans modifier tes fichiers (leçon 5).
- Auto : un système de contrôle (un « classificateur », un modèle qui trie les actions) examine les actions en arrière-plan et bloque celles qui sont risquées au lieu de te demander. D'après la documentation, c'est le mode de départ des sessions dans le terminal et dans VS Code sur les versions récentes.
Sur le mode Auto, la documentation prévient : il réduit les demandes de permission mais ne garantit pas la sécurité. Il convient aux tâches dont tu approuves la direction générale, pas aux opérations sensibles.
Il existe aussi un mode qui supprime toutes les vérifications (bypassPermissions). La documentation le réserve aux environnements isolés (une machine virtuelle sans accès à internet, par exemple). Pour toi, la règle est simple : n'y touche pas.
Le comment : répondre à une demande de permission
Quand il demande, tu peux accepter une fois, accepter pour la session, ou refuser. Lis toujours ce qu'il compte faire : quel fichier, quelle commande. Si tu ne comprends pas, refuse et demande-lui d'expliquer.
Le comment : des règles durables
Tu peux écrire des règles dans le fichier .claude/settings.json de ton projet, ou les gérer avec la commande /permissions :
- allow : ce qu'il peut faire sans demander ;
- ask : ce qu'il doit toujours te demander ;
- deny : ce qu'il n'a jamais le droit de faire.
D'après la documentation, une règle deny bloque dans tous les modes. C'est la bonne protection pour le fichier .env (le fichier où l'on range les clés et mots de passe d'un projet).
Exemple à copier
{
"permissions": {
"deny": ["Read(./.env)", "Read(./.env.*)"]
}
}
Et pour le faire écrire par Claude Code :
Contexte : mon projet utilise un fichier .env pour ses clés.
Objectif : t'interdire de lire ce fichier, dans tous les modes.
Contraintes : ne lis pas le fichier .env, même pour vérifier. Modifie seulement .claude/settings.json.
Format attendu : le contenu complet du fichier avant de l'écrire.
Validation : attends mon accord, puis explique-moi comment vérifier la règle avec /permissions.
Les erreurs à éviter
- Accepter « pour toute la session » dès la première demande. Attends de connaître la tâche.
- Passer en Auto pour gagner du temps sur une tâche sensible (paiement, suppression, publication).
- Croire qu'une phrase dans la conversation suffit à protéger un fichier. Une consigne peut se perdre ; une règle deny, non.
À toi de jouer
Dans ton terminal, appuie plusieurs fois sur Shift+Tab et note le nom de chaque mode qui s'affiche chez toi. Repasse en mode Manual. Puis demande une petite modification et lis la demande de permission avant de répondre : quel fichier, quelle action ? Enfin, si ton projet a un .env, ajoute la règle deny avec le prompt ci-dessus.