Aller au contenu
Outils devDécryptage

Claude Code : les permissions expliquées

Claude Code vérifie les règles deny, puis ask, puis allow, et un allow étroit ne l'emporte jamais sur un deny large. Six tests de Tech AI Wire montrent où les règles s'arrêtent.

Par

5 min de lecture

XLinkedIn

Traduit automatiquement de l'original anglais, vérifié et édité par Claire Whitmore. La version anglaise fait foi. Notre méthode

Screenshot of the Claude Code Docs page "Configure permissions", with the Permissions and sandboxing menu open on the left.

Les permissions de Claude Code sont les règles qui décident de ce que l'agent de codage d'Anthropic peut faire de lui-même. Elles indiquent aussi ce qu'il doit demander d'abord, et ce qu'il ne doit jamais faire. Elles se trouvent dans des fichiers de paramètres JSON, sous forme de trois listes : allow, ask et deny. Un mode de permission fixe ce qui arrive à tout ce qu'aucune règle ne couvre. Mal les régler, c'est soit crouler sous les demandes de confirmation, soit laisser l'agent exécuter des commandes que vous n'aviez jamais voulu approuver.

Comment fonctionnent les permissions de Claude Code

Chaque règle nomme un outil, avec un motif facultatif entre parenthèses. Bash(npm run test *) correspond à toute commande shell qui commence par npm run test. Read(./.env) correspond à un seul fichier. WebFetch(domain:example.com) correspond à un seul site web. Un nom d'outil seul, comme Bash, correspond à toute utilisation de cet outil.

C'est l'ordre qui compte le plus. La page d'Anthropic sur les permissions indique : « Les règles sont évaluées dans cet ordre : deny, puis ask, puis allow. La première correspondance dans cet ordre détermine le résultat, et la spécificité d'une règle ne change pas l'ordre. » Ainsi, un deny large comme Bash(aws *) bloque aussi aws s3 ls, même si un allow plus étroit nomme exactement cette commande. Selon les mots de la documentation, « une règle allow ne peut pas découper une exception dans une règle deny ».

Tous les guides ne sont pas d'accord. Un article publié en avril 2026 sur le blog de Vincent Qiao affirme que Claude Code « évalue d'abord la règle la plus spécifique ». La page officielle et le test de Tech AI Wire ci-dessous disent tous deux le contraire.

Les règles proviennent de plusieurs fichiers, et leurs listes sont combinées plutôt que remplacées. La page des paramètres donne l'ordre pour les valeurs uniques, de la plus prioritaire à la moins prioritaire : « paramètres gérés, ligne de commande, projet local, projet partagé, utilisateur ». Les paramètres gérés sont définis par un employeur et ne peuvent pas être remplacés. Le fichier de projet partagé, .claude/settings.json, est fait pour être commité dans Git. Le fichier local, .claude/settings.local.json, est réservé à une seule personne et reste hors de Git. Et un deny dans n'importe quel fichier l'emporte, car « les règles deny de toutes les portées sont évaluées avant les règles allow ».

Les six modes de permission

Un mode est la solution de repli pour les appels qu'aucune règle ne couvre. Claude Code 2.1.325 en accepte six avec son option --permission-mode. Ce tableau résume chacun d'eux d'après la documentation d'Anthropic.

ModeCe qui s'exécute sans demanderIdéal pour
default (affiché comme Manual)Les lectures ; tout autre outil demande à la première utilisationLes dépôts inconnus
acceptEditsLes lectures, les modifications de fichiers, et mkdir, touch, mv, cp dans le dossier de travailLes sessions riches en modifications que vous surveillez
planLes lectures et les commandes shell en lecture seule ; aucune modification des fichiers sourcePlanifier avant de modifier
autoTout, avec une vérification en arrière-plan des actions shell et réseauLes longues tâches auxquelles vous faites confiance
dontAskSeulement les outils préapprouvés ; tout ce qui demanderait une confirmation est refuséLes scripts et la CI
bypassPermissionsTout, sauf les actions qu'aucun mode n'approuve automatiquementUniquement les conteneurs et VM isolés

Selon la page des modes de permission, les règles deny bloquent toujours dans tous les modes, y compris bypassPermissions.

Test de Tech AI Wire : six règles, six résultats

Le test a été mené le 18 novembre 2026, sous macOS 26.6 avec Claude Code 2.1.325, dans un dossier Git vide. Chaque exécution utilisait claude -p avec --permission-mode dontAsk, si bien qu'un appel qui aurait demandé une confirmation était refusé. L'option --settings fournissait les règles, et --setting-sources local excluait les paramètres propres à la machine. Le modèle Haiku devait exécuter une commande, et la sortie JSON était vérifiée pour y chercher permission_denials.

TestRèglesCommandeRésultat
Aallow Bash(echo hello)echo helloExécutée
Ballow Bash(echo hello), deny Bash(echo *)echo helloRefusée
Callow Bash(echo hello), ask Bash(echo *)echo helloRefusée
Daucune règleecho helloExécutée
Eallow Bash(cat *), deny Read(./secret.txt)cat secret.txtRefusée
Fallow Bash(python3 *), deny Read(./secret.txt)python3 -c "print(open('secret.txt').read())"Exécutée, fichier affiché

Les tests B et C confirment l'ordre : le deny et le ask plus larges l'emportent tous deux sur le allow exact. Le test D s'est exécuté sans aucune règle, car echo fait partie de l'ensemble intégré de commandes en lecture seule de Claude Code. Le test E montre qu'un deny Read couvre aussi cat. La documentation dit la même chose pour head, tail, sed et tee.

Le test F révèle la faille. La documentation avertit que les deny de fichiers n'atteignent pas « un script Python ou Node qui ouvre lui-même les fichiers ». Ici, un script Python d'une ligne a lu le fichier « refusé » et l'a affiché.

Ce qui a changé, et quand

Les permissions ont souvent changé en 2026. Selon la page des paramètres, la version 2.1.257 a empêché bypassPermissions de prendre effet dans les paramètres de projet ou locaux. Depuis la 2.1.283, auto est le mode par défaut des sessions interactives dans le terminal et dans VS Code. Depuis la 2.1.302, claude -p lancé sans mode défini démarre plutôt en Manual.

Tech AI Wire a couvert les paramètres qui entourent ces règles. Claude Code a commencé en août à ajouter par défaut un lien de session aux commits. Il a commencé à lire AGENTS.md comme solution de repli dans la version 2.1.277. Le guide de Tech AI Wire sur les plugins de Claude Code couvre les extensions, qui ajoutent des outils ayant besoin de leurs propres règles. La forme mcp__<server>__<tool> désigne un outil issu d'un serveur MCP, une source d'outils comparable à un plugin.

Ce que cela signifie pour les développeurs

Écrivez des règles deny pour ce qui ne doit jamais arriver, et gardez-les larges : Bash(git push *) plutôt qu'un seul nom de branche. Un deny large ne peut pas être annulé par un allow étroit, vous ne pouvez donc pas y créer d'exceptions. Utilisez ask pour les actions que vous voulez examiner, car un ask l'emporte aussi sur un allow correspondant.

Ne considérez pas un deny Read comme une protection pour un secret. Le test F montre que n'importe quel script que l'agent peut exécuter peut quand même ouvrir le fichier. La documentation indique qu'une règle Bash « n'est pas une frontière de sécurité autour du programme ». Pour de vraies limites, ajoutez le sandbox, qui restreint ce que les commandes shell peuvent atteindre au niveau du système d'exploitation. Mieux encore, gardez les secrets hors du dossier du projet.

Versionnez vos paramètres dans Git sous .claude/settings.json pour que toute l'équipe reçoive les mêmes deny. Gardez les approbations personnelles dans settings.local.json. Pour les tâches de CI, utilisez dontAsk avec une liste allow explicite, afin qu'une commande inattendue échoue au lieu de rester bloquée sur une demande de confirmation. Réservez bypassPermissions aux conteneurs jetables.

Sources

  1. Configure permissions - Claude Code Docs
  2. Claude Code settings - Claude Code Docs
  3. Choose a permission mode - Claude Code Docs
  4. Claude Code Permission Rules & settings.json Guide - AI Arte
  5. Claude Code settings.json Permissions: Control Exactly What AI Can Do - Vincent's Blog

Articles liés