Depuis la rentrée, les géants de l'IA ne parlent plus que d'agents. Meta a ouvert le bal avec Muse début septembre, OpenAI a suivi avec ses Dots, et Anthropic a abattu sa carte le mercredi 21 oc...
Modes de permission de Claude Code : les 6 réglages expliqués et comment choisir le bon
J'utilise Claude Code presque tous les jours, et j'ai vite compris qu'une bonne partie du confort d'utilisation se joue sur un seul réglage : le mode de permission. C'est lui qui décide si l'agent doit vous demander l'autorisation avant de modifier un fichier ou de lancer une commande, ou s'il peut se débrouiller seul. Trop strict, on passe sa journée à cliquer sur « Oui ». Trop permissif, on prend des risques sur sa machine.
Dans cet article, je vous explique à quoi sert un mode de permission, je passe en revue les six modes disponibles aujourd'hui (l'outil en compte un de plus que ce qu'on lit souvent), avec pour chacun les cas d'usage et les pièges, puis je vous montre comment changer de mode en cours de session ou fixer celui qui s'applique par défaut. J'ai aussi intégré les changements de la version 2.1.319, sortie le 6 novembre 2026, qui touchent directement au sujet : un nouveau réglage permissions.denyInsteadOfPrompting et un comportement différent du mode auto derrière une passerelle (gateway). Tout a été vérifié dans la documentation officielle d'Anthropic et dans le journal des versions à la date du 11 novembre 2026, avec Claude Code 2.1.322.
Si vous débutez avec l'outil, commencez par mon tutoriel d'installation et de prise en main de Claude Code, puis revenez ici.
Un mode de permission, à quoi ça sert ?
Le dilemme : tout valider ou laisser faire
Un agent de code comme Claude Code a accès à beaucoup de choses sur votre ordinateur. Il peut lire vos fichiers, les modifier, les supprimer, lancer des commandes shell, pousser du code sur un dépôt distant ou interroger un serveur. Laisser un LLM (Large Language Model) faire tout ça sans surveillance serait imprudent. Le modèle peut se tromper, mal comprendre une consigne, ou se faire piéger par le contenu d'un fichier qu'il vient de lire : c'est ce qu'on appelle une injection de prompt.
Mais l'inverse fatigue vite. Si vous demandez une refactorisation sur dix fichiers et qu'une fenêtre de confirmation s'ouvre à chaque écriture, vous finirez par valider sans lire. Le mode de permission sert à placer le curseur au bon endroit entre ces deux extrêmes, selon ce que vous êtes en train de faire.
Comment Claude Code décide de vous demander la permission
Chaque fois que Claude veut utiliser un outil (lire, écrire, lancer une commande, appeler un serveur MCP), Claude Code suit toujours le même ordre :
- L'action est-elle explicitement interdite par une règle deny ? Elle est bloquée.
- Est-elle explicitement autorisée par une règle allow ? Elle passe sans question.
- Sinon, c'est le mode de permission actif qui tranche : demander, laisser passer, ou confier la décision à un contrôle automatique.
Les modes ne remplacent donc pas les règles fines que vous pouvez écrire dans votre fichier settings.json. Ils fixent le comportement de base quand aucune règle ne s'applique. Une exception : en bypassPermissions, les règles allow n'ont plus d'effet, puisque tout est déjà autorisé. Et depuis la 2.1.319, il existe une dernière étape optionnelle : si une action finit malgré tout par réclamer votre accord, le réglage denyInsteadOfPrompting peut la refuser d'office au lieu de vous la présenter. J'y reviens plus bas.
Le classifieur, la pièce maîtresse du mode auto
Avant d'aller plus loin, il faut comprendre un mécanisme : le classifieur. C'est un second modèle, plus petit et plus rapide, qui joue le rôle que vous tenez vous-même en mode manuel. Il regarde chaque action proposée et décide si elle est raisonnable.
En mode auto, une lecture de fichier, un lancement de tests ou la création d'un dossier passent sans vous déranger. Si le classifieur repère quelque chose de louche (un rm -rf mal placé, une écriture dans un fichier sensible, un envoi de données vers l'extérieur, un force push), il vous rend la main avec une demande d'autorisation classique. Le mode plan peut lui aussi s'appuyer sur ce classifieur pour lancer certaines commandes d'exploration quand le mode auto est disponible sur votre compte.
Un détail a changé ces derniers mois et il a son importance pour la suite : ce contrôle ne tourne plus forcément sur votre machine. Dans la plupart des cas, Claude Code demande désormais au serveur d'Anthropic de vérifier les actions directement dans les requêtes envoyées au modèle. Il existe toujours un classifieur intégré côté client, qui sert de solution de repli. Pour savoir lequel décide dans votre session, tapez /status : la ligne « Auto mode server » affiche Enabled quand c'est le serveur qui tranche, et Disabled quand la session s'est rabattue sur le contrôle local.
Le classifieur reste un modèle d'IA, et il peut se tromper lui aussi. C'est un filet de sécurité utile, pas une garantie. Je déconseille les modes autonomes sur des données sensibles ou sur une machine où une erreur serait difficile à rattraper.
Les six modes disponibles
On lit souvent que Claude Code propose cinq modes. La documentation en liste en fait six, si l'on compte dontAsk, plus discret parce qu'il n'apparaît pas dans le raccourci clavier. Voici chacun d'eux, du plus strict au plus permissif.
Manual (default) : vous validez tout
Le mode affiché Manual dans l'interface a pour valeur technique default. C'est celle qu'utilisent les fichiers de configuration, les hooks et le SDK. Petit détail pratique : la ligne de commande accepte aussi manual comme alias, ce qui est plus parlant.
Dans ce mode, Claude ne fait rien sans vous demander, à part lire des fichiers. Chaque modification, chaque commande, chaque appel à un outil MCP (Model Context Protocol) ouvre une demande : vous approuvez une fois, vous approuvez en créant une règle permanente, ou vous refusez.
Quand l'utiliser : sur une base de code sensible, un environnement de production, ou quand vous voulez surveiller de près ce que fait l'agent. Je le garde aussi sur les projets clients que je découvre, le temps de voir comment Claude s'y prend.
Risques : aucun côté sécurité. Le vrai problème, c'est la lassitude. Au bout de la trentième confirmation, on valide machinalement, et le mode perd tout son intérêt.
Un exemple parlant : je demande à Claude de supprimer un répertoire. Il n'a pas besoin de mon accord pour en lire le contenu, il me le liste, puis il me demande dans la conversation si je suis sûr. Cette question posée dans le chat ne compte pas comme une autorisation, et rien n'oblige l'agent à la poser. Ce qui protège vraiment, c'est la fenêtre de validation de la commande elle-même, qui s'affiche ensuite et sans laquelle rien n'est exécuté.
acceptEdits : les éditions passent toutes seules
Le mode acceptEdits (« Edit automatically » dans l'interface) est un cran plus souple. Il autorise sans demander les modifications de fichiers et les commandes courantes de manipulation du système de fichiers : mkdir, touch, mv, cp, mais aussi rm, rmdir et sed. Cette liberté se limite au dossier de travail et aux dossiers que vous avez ajoutés explicitement, et la suppression d'un chemin critique déclenche toujours une demande. Pour tout le reste (autres commandes shell, accès réseau, outils MCP), une demande s'affiche.
Quand l'utiliser : quand vous suivez et guidez un travail d'écriture de code. Claude écrit sans vous interrompre, et vous reprenez la main dès qu'il veut faire autre chose que toucher à vos fichiers.
Risques : une édition ratée modifie le fichier pour de bon, et un rm dans le projet passe sans question. Travaillez avec Git et faites des commits réguliers, c'est votre bouton d'annulation. Pensez aussi à garder Claude Code à jour : la 2.1.319 a corrigé un cas où une commande sed pouvait échapper à la vérification des permissions en acceptEdits et en auto.
Sur le développement d'une petite application web, par exemple, Claude peut créer, lire et modifier tous les fichiers du projet sans me déranger. En revanche, au moment de démarrer le serveur de développement pour tester l'application, il me demande la permission, parce que cette commande ne se limite pas à manipuler des fichiers.
plan : réfléchir avant d'agir
Le mode plan est à part. Claude ne modifie pas vos fichiers sources : il lit, explore votre dépôt, analyse l'existant et vous présente un plan d'action détaillé. Vous le relisez, vous demandez des ajustements si besoin, puis vous passez dans un autre mode pour l'exécution. À la fin, Claude vous propose d'ailleurs de basculer en Manual ou en auto pour passer à l'action.
Contrairement à ce qu'on lit parfois, ce n'est pas un mode « lecture seule » strict : quand le mode auto est disponible, les commandes jugées sûres par le classifieur peuvent tourner pendant la phase d'exploration, ce qui accélère l'analyse.
Quand l'utiliser : avant une grosse refactorisation, une migration de dépendances ou une fonctionnalité qui touche plusieurs modules. Dès qu'un mauvais départ coûterait cher en tokens et en patience.
Risques : presque aucun. Le seul piège est d'oublier de quitter ce mode et de se demander pourquoi Claude ne modifie rien. Avec denyInsteadOfPrompting activé, c'est encore plus vrai : Claude ne peut plus sortir du mode plan de lui-même, ce sera à vous de le faire.
auto : l'autonomie surveillée
Avec auto, Claude exécute la plupart des actions sans demander, mais chacune passe d'abord par le classifieur. Lectures, écritures, tests, commandes ordinaires : tout s'enchaîne. Dès qu'une action paraît risquée, vous retrouvez une demande d'autorisation.
Depuis la version 2.1.283, c'est le mode de démarrage par défaut dans le terminal et dans VS Code, sur tous les plans et chez tous les fournisseurs. Avant, Anthropic avait commencé par l'activer par défaut pour les abonnés Pro, Max et Team à partir du 14 août 2026. Si vous aviez déjà choisi votre propre mode par défaut, Claude Code vous demande votre avis avant de changer quoi que ce soit. Une organisation peut aussi le désactiver pour ses membres.
Le mode auto exige enfin un modèle récent, et la liste dépend de l'endroit d'où vous l'utilisez :
| Accès | Modèles pris en charge |
|---|---|
| API Anthropic, Claude Platform on AWS | Opus 4.6 ou plus récent, Sonnet 4.6 ou plus récent, Haiku 5.5, modèles Fable |
| Amazon Bedrock, Google Cloud, Microsoft Foundry, Claude apps gateway | Sonnet 5 ou plus récent, Opus 4.7 ou plus récent, Haiku 5.5, modèles Fable |
| Sonnet 4.5, Opus 4.5, Haiku 4.5 et les modèles claude-3 ne sont pris en charge nulle part. | |
Quand l'utiliser : c'est le bon compromis pour l'essentiel du travail de développement. C'est d'ailleurs le mode que j'utilise au quotidien : je repasse en Manual quand je travaille sur le site d'un client ou sur quelque chose de sensible. Je le recommande à condition de bien connaître l'outil, de donner des consignes claires et de rester hors production.
Risques : le classifieur peut laisser passer une action qui pose problème dans votre contexte précis, par exemple la modification d'un dossier auquel vous teniez. Deux bonnes habitudes limitent la casse : travailler sous Git, et écrire des règles allow/deny explicites dans votre settings.json pour les cas sensibles.
Le mode auto derrière une gateway : ce qui change avec la 2.1.319
Celle-ci me concerne directement. Sous Windows, je fais régulièrement passer Claude Code par OmniRoute, une passerelle qui redirige les requêtes vers d'autres fournisseurs de modèles, et j'y travaille en mode auto. Ce type de configuration (on parle de gateway LLM ou de proxy) a un effet de bord : la passerelle ne transmet pas toujours la demande de vérification au serveur d'Anthropic, ni sa réponse. Et quand on passe par une gateway, Claude Code ne récupère pas non plus ses feature flags, comme lorsque la télémétrie est coupée.
Jusqu'à la 2.1.318, dans ces situations, Claude Code se rabattait discrètement sur son classifieur intégré. Depuis la 2.1.319, ce n'est plus le cas : quand la télémétrie ou les feature flags sont désactivés, y compris derrière une gateway, toute action que le serveur ne peut pas vérifier vous est soumise ou refusée. Le mode auto reste actif, mais il devient nettement moins silencieux dans ce genre de montage. Bedrock, Vertex et Foundry ne sont pas concernés.
Vous avez trois leviers :
- CLAUDE_CODE_AUTO_MODE_SERVER=0
- Retrouve l'ancien comportement : Claude Code n'interroge plus le serveur et utilise toujours son propre classifieur. À réserver aux passerelles dont vous savez qu'elles ne relaient pas la vérification. Anthropic présente cette variable comme temporaire, elle pourra disparaître dans une version future.
- CLAUDE_CODE_AUTO_MODE_SERVER=1
- Force la vérification côté serveur derrière une gateway, même si
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASest défini. Si vos managed settings fixent cette seconde variable, elles doivent aussi fixer la valeur1. - CLAUDE_CODE_DISABLE_FEATURE_FLAGS
- Nouvelle variable de la 2.1.319 : elle coupe la récupération des feature flags sans désactiver la télémétrie. Chaque option reprend alors sa valeur par défaut intégrée.
Ces variables se définissent dans le shell avant de lancer claude, ou dans la clé env de votre settings.json. Pour mes sessions OmniRoute, c'est ce second emplacement qui me paraît le plus pratique, puisque mes scripts de bascule modifient déjà ce fichier :
{
"env": {
"CLAUDE_CODE_AUTO_MODE_SERVER": "0"
}
}
Autre précision de la même version : si vous avez coupé la vérification serveur en dehors d'un projet, ni le settings.json de ce projet ni un plugin ne peuvent la réactiver. C'est logique, un dépôt cloné ne doit pas décider à votre place.
Si vous utilisez une gateway et que le mode auto vous paraît soudain plus bavard (ou plus restrictif) depuis début novembre, ce n'est pas un bug : c'est la 2.1.319. Lancez /status et regardez la ligne « Auto mode server » avant de toucher à quoi que ce soit. Cette ligne affichait parfois « Enabled » à tort derrière une gateway qui filtrait la vérification, ce qui a aussi été corrigé dans cette version.
dontAsk : ne rien demander, refuser le reste
Voici le mode que beaucoup d'articles oublient. dontAsk (« Don't ask ») fonctionne à l'opposé de ce que son nom laisse penser : il n'autorise que la lecture des fichiers du dossier de travail et les outils que vous avez pré-approuvés par des règles. Tout ce qui déclencherait normalement une demande est refusé d'office, sans vous poser la question.
Quand l'utiliser : pour des exécutions automatisées où personne n'est là pour répondre, mais où vous voulez garder un périmètre strict. Vous listez précisément ce que Claude a le droit de faire, et rien d'autre ne passe. Je le trouve bien plus rassurant que bypassPermissions pour une tâche planifiée.
Risques : pas pour votre machine. Le danger est plutôt qu'une tâche échoue parce qu'une action nécessaire n'était pas dans la liste. Il faut donc bien préparer ses règles. Ce mode n'apparaît jamais dans le cycle Shift+Tab : il se choisit au lancement ou dans la configuration.
bypassPermissions : sans filet
Avec bypassPermissions, tout passe : ni demande, ni classifieur. Claude peut agir immédiatement sur tout ce que votre compte utilisateur a le droit de faire. Quelques garde-fous subsistent quand même : les règles ask explicites et la suppression de chemins critiques continuent de déclencher une demande.
Quand l'utiliser : très rarement sur votre poste de travail. Ce mode est fait pour des environnements isolés et sans interaction : un conteneur Docker jetable, une machine virtuelle dédiée, un dev container ou une chaîne d'intégration continue (CI). Bref, un endroit où une erreur ne laissera pas de traces.
À manier avec une extrême prudence. Sur une machine de travail classique, il n'y a plus aucun garde-fou sérieux. Une commande malheureuse peut effacer des fichiers, pousser du code non désiré ou envoyer des données vers l'extérieur. Ne l'activez jamais en production ni sur votre poste principal sans savoir exactement ce que vous faites.
Pour éviter les activations par erreur, Claude Code impose plusieurs barrières. Le mode doit être demandé dès le lancement, avec --permission-mode bypassPermissions ou --dangerously-skip-permissions : impossible d'y entrer depuis une session démarrée autrement. Au premier lancement interactif, un avertissement s'affiche et il faut l'accepter. Et sous Linux ou macOS, l'outil refuse de démarrer dans ce mode si vous êtes root ou sous sudo :
# claude --dangerously-skip-permissions
--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons
Ce contrôle est levé à l'intérieur d'un bac à sable reconnu. Pour des exécutions autonomes, la documentation conseille un dev container avec un utilisateur non root. Un administrateur peut aussi interdire complètement ce mode à toute son organisation.
Tableau comparatif des modes
| Mode (valeur) | Nom affiché | Passe sans demande | Usage type | Niveau de risque |
|---|---|---|---|---|
default |
Manual | Lectures uniquement | Code sensible, production, découverte d'un projet | Très faible |
acceptEdits |
Edit automatically | Lectures, éditions, mkdir, touch, rm, rmdir, mv, cp, sed dans le dossier de travail | Session d'écriture de code suivie de près | Faible à modéré |
plan |
Plan | Lectures, et commandes validées par le classifieur si auto est disponible | Analyse et préparation avant un gros chantier | Très faible |
auto |
Auto | Presque tout, après contrôle du classifieur | Développement au quotidien hors production | Modéré |
dontAsk |
Don't ask | Lectures et outils pré-approuvés ; tout le reste est refusé | Tâches automatisées au périmètre strict | Faible |
bypassPermissions |
Bypass permissions | Tout, sauf règles ask et suppressions critiques | Conteneur, VM ou CI isolés | Élevé |
| Source : documentation officielle Claude Code, consultée le 11/11/2026 (version 2.1.322). | ||||
Les chemins protégés, une sécurité que peu de gens connaissent
Certains fichiers et dossiers sont traités à part, quel que soit le mode. Une écriture dedans n'est jamais approuvée automatiquement, sauf en bypassPermissions. Même une règle allow dans votre configuration ne suffit pas à les débloquer. L'idée est simple : ces fichiers permettent de modifier le comportement de vos outils, voire d'exécuter du code au prochain démarrage d'un terminal.
- Dossiers protégés
.git,.config/git,.vscode,.idea,.husky,.cargo,.devcontainer,.yarn,.mvnet.claude(avec quelques exceptions, comme.claude/worktrees/et les fichiers de plan de la session).- Fichiers protégés
.gitconfig,.gitmodules, les fichiers de profil du shell (.bashrc,.zshrc,.profile,.envrc…),.npmrc,.yarnrc,.pre-commit-config.yaml,.mcp.json,.claude.json, entre autres. Tout fichier passé à--settings,--mcp-configou--agentsest protégé lui aussi.- Selon le mode
- Demande systématique en Manual et acceptEdits, passage par le classifieur en auto, refus en dontAsk, autorisation en bypassPermissions.
Un correctif récent mérite d'être signalé : jusqu'à la 2.1.321, les règles deny et la protection de ces fichiers ne s'appliquaient pas au fichier écrit par un cp ou un mv vers un dossier. C'est réglé depuis la 2.1.322 du 10 novembre.
En pratique : contrôler et changer de mode
Repérer le mode actif
Dans le terminal, le mode en cours s'affiche en permanence dans la barre d'état, sous la zone de saisie (par exemple « ⏸ manual mode on » ou « auto mode on »). Chaque mode a son symbole et sa couleur, on voit d'un coup d'œil où l'on en est. Et si vous avez un doute, la commande /status vous indique aussi le mode par défaut configuré, ainsi que l'état de la vérification serveur quand vous êtes en auto.
Basculer en cours de session avec Shift+Tab
Le moyen le plus rapide de changer de mode est le raccourci Shift+Tab. À chaque pression, on passe au mode suivant :
auto → default → acceptEdits → plan → auto …
C'est pratique quand on démarre en auto et qu'on arrive à une étape délicate : une pression et vous êtes en Manual. Le mode auto n'apparaît dans le cycle que s'il est disponible sur votre compte. bypassPermissions ne s'y glisse que si vous avez lancé la session avec, et il se place alors juste avant auto. Quant à dontAsk, il n'y figure jamais.
Autre raccourci bien pensé : en Manual ou en acceptEdits, quand une commande Bash vous demande une autorisation, la fenêtre peut proposer « Yes, and switch to auto mode » pour valider et passer directement en auto.
Le mode se change uniquement par ces commandes et réglages. Demander à Claude dans la conversation de « passer en mode auto » ne change rien.
Démarrer dans un mode précis
Si vous savez d'avance comment vous voulez travailler, indiquez-le au lancement avec l'option --permission-mode :
# Démarrer en mode plan pour analyser un projet inconnu
claude --permission-mode plan
# Démarrer en mode manuel pour un travail sensible (default ou manual)
claude --permission-mode manual
# Démarrer en mode auto si ce n'est pas déjà le défaut
claude --permission-mode auto
Pour les exécutions non interactives (option -p), c'est aussi là que vous choisissez votre mode. Attention : depuis la version 2.1.302, une exécution -p sans mode précisé démarre en Manual, et toute action qui demanderait une validation est refusée, sauf si des règles allow ou des hooks l'approuvent. Pour une tâche en CI dans un conteneur isolé, on peut donc écrire :
# Tâche unique dans un conteneur jetable, aucune demande possible
claude -p "Lance la suite de tests" --dangerously-skip-permissions
# Variante plus prudente : seuls les outils autorisés par vos règles passent
claude -p "Lance la suite de tests" --permission-mode dontAsk
Un changement de la 2.1.319 compte beaucoup pour la CI : en mode auto, une exécution -p dont les actions avaient été refusées faute de vérification disponible se terminait quand même avec le code de sortie 0, comme si tout s'était bien passé. Elle renvoie désormais 1, en sortie texte comme en JSON. Si l'un de vos scripts considérait ces exécutions comme réussies, il va maintenant les voir échouer. C'est le comportement attendu.
Refuser au lieu de demander : denyInsteadOfPrompting
C'est la principale nouveauté de la 2.1.319 côté permissions. Le réglage permissions.denyInsteadOfPrompting règle un problème que connaissent bien ceux qui lancent Claude Code sans surveillance : une session qui reste bloquée des heures sur une demande d'autorisation à laquelle personne ne répondra. Une fois activé, toute action qui attendrait votre accord est refusée sur-le-champ. Claude reçoit le refus et poursuit son tour, en cherchant une autre façon de faire. Le réglage s'applique dans les sessions du terminal, aux sous-agents et aux coéquipiers d'une équipe d'agents.
Pour l'activer, j'ajoute ceci dans mon fichier utilisateur ~/.claude/settings.json :
{
"permissions": {
"denyInsteadOfPrompting": true
}
}
On peut aussi le passer ponctuellement au lancement, ce qui est pratique dans un script :
claude -p "Lance la suite de tests" --permission-mode auto --settings '{"permissions":{"denyInsteadOfPrompting":true}}'
Les sources ne disent pas toutes la même chose sur la prise en compte de ce réglage dans le .claude/settings.json d'un projet. Je vous conseille donc de le placer dans votre fichier utilisateur, dans les managed settings ou dans --settings, où il fonctionne à coup sûr. Il suffit qu'une seule de ces sources le mette à true pour qu'il s'applique : un false ailleurs ne l'annule pas.
Quelques effets secondaires sont documentés, et il vaut mieux les connaître avant de l'activer partout :
- Claude perd ses outils de question (AskUserQuestion) et d'entrée ou de sortie du mode plan. Une session lancée en plan ne peut donc plus en sortir seule.
- Les demandes d'informations envoyées par un serveur MCP (elicitation) sont annulées, sauf si un hook y répond.
- Si vous approuvez les appels par du code, le callback
canUseToolet--permission-prompt-toolne sont plus consultés : il faut passer par un hook PermissionRequest. - Après 20 refus d'affilée sans aucune avancée entre deux, Claude s'arrête au lieu de tourner en rond.
Ne le confondez pas avec dontAsk. Le mode dontAsk remplace votre mode de permission et part d'une liste blanche stricte. denyInsteadOfPrompting, lui, se pose par-dessus le mode en cours : vos règles, le mode choisi, le classifieur du mode auto et vos hooks décident d'abord, et le réglage n'intervient que sur ce qui aurait fini en demande. En mode auto, cela donne une session autonome qui ne reste jamais bloquée. Si ces refus reviennent souvent dans vos tâches, c'est le signe que vos règles allow ont des trous.
| Réglage | Nature | Ce qui se passe quand une action demanderait votre accord | Pour quel usage |
|---|---|---|---|
dontAsk |
Mode de permission | Refus, seuls les outils pré-approuvés passent | Tâche automatisée au périmètre très encadré |
denyInsteadOfPrompting |
Réglage qui s'ajoute au mode actif | Refus, Claude continue son tour | Sessions sans surveillance en auto, sous-agents, équipes d'agents |
bypassPermissions |
Mode de permission | Presque rien ne demande, tout passe | Environnement jetable et isolé |
| denyInsteadOfPrompting nécessite Claude Code 2.1.319 ou plus récent. | |||
Bloquer les écritures hors du dossier de travail
Un autre réglage récent, arrivé avec la 2.1.314 fin octobre, complète bien l'ensemble : permissions.blockWritesOutsideWorkingDirectories. Une fois à true, les outils d'écriture et d'édition de Claude refusent tout chemin situé en dehors de vos dossiers de travail, quel que soit le mode, auto et bypassPermissions compris. Il existe un équivalent pour la lecture, permissions.blockReadsOutsideWorkingDirectories. Sur un poste où je laisse Claude en auto, c'est le genre de ceinture que j'aime ajouter.
{
"permissions": {
"blockWritesOutsideWorkingDirectories": true
}
}
Fixer le mode par défaut dans settings.json
Pour qu'un mode s'applique à chaque démarrage, le plus propre est de passer par la clé permissions.defaultMode d'un fichier settings.json. Plusieurs emplacements existent :
| Fichier | Portée |
|---|---|
.claude/settings.json (ou .claude/settings.local.json) |
Toutes les sessions ouvertes dans ce projet |
~/.claude/settings.json |
Toutes vos sessions sur la machine |
| Managed settings | Toute l'organisation, déployé par l'administrateur |
| auto et bypassPermissions sont ignorés dans les fichiers de projet. | |
Un fichier utilisateur ~/.claude/settings.json qui force le mode manuel ressemble à ceci :
{
"permissions": {
"defaultMode": "default"
}
}
Les valeurs acceptées sont default (ou manual), acceptEdits, plan, auto, dontAsk et bypassPermissions. Il y a toutefois une subtilité importante : dans les fichiers de projet, auto et bypassPermissions sont ignorés, pour qu'un dépôt partagé ne puisse pas s'accorder lui-même un mode permissif. Avec auto dans un fichier de projet, la session prend le mode par défaut intégré. Avec bypassPermissions, elle démarre carrément en Manual. Ces deux valeurs doivent donc aller dans votre fichier utilisateur ou dans les managed settings.
Si vous travaillez à plusieurs sur un même dépôt, je vous conseille de ne pas fixer de mode dans le settings.json du projet. Chacun règle ainsi son propre curseur selon son niveau de confiance.
Mettre à jour Claude Code (et vérifier son canal)
Plusieurs correctifs de sécurité touchant aux permissions sont arrivés début novembre : le cas du sed évoqué plus haut, un contournement où un préfixe de variables d'environnement bien construit pouvait masquer une partie d'une commande Bash aux vérifications (2.1.319), puis le problème des cp/mv vers un dossier protégé (2.1.322). La commande claude update suffit pour passer à la dernière version.
Vérifiez votre canal de mise à jour. Au 11 novembre 2026, le canal latest en est à la 2.1.322, mais le canal stable est encore en 2.1.311. Si vous êtes sur stable, vous n'avez ni denyInsteadOfPrompting, ni le nouveau comportement du mode auto derrière une gateway, ni ces correctifs. La commande claude --version vous dit où vous en êtes.
Et hors du terminal ?
Claude Code ne vit pas que dans le terminal, et le changement de mode varie un peu selon l'interface :
- VS Code : un sélecteur de mode est intégré à l'extension. Pour le mode de départ, l'extension ne lit pas les fichiers de projet : on règle
claudeCode.initialPermissionModedans les paramètres utilisateur de VS Code (cette option n'accepte pasauto). - JetBrains : le plugin fait tourner Claude Code dans le terminal de l'IDE, donc Shift+Tab et
--permission-modefonctionnent comme d'habitude. - Application desktop et claude.ai/code : un menu déroulant à côté de la zone de saisie permet de choisir le mode. Pour les sessions cloud sur le web, seuls l'acceptation automatique des éditions et le mode plan sont proposés.
Questions fréquentes
- Quel mode de permission choisir quand on débute avec Claude Code ?
- Je conseille de commencer en Manual pour voir comment l'agent travaille, puis de passer en auto une fois à l'aise, en gardant Git comme filet de sécurité.
- Le mode auto est-il sans danger ?
- Il est bien plus sûr que bypassPermissions puisque chaque action passe par un classifieur, mais celui-ci peut se tromper. Évitez-le en production et sur des données sensibles.
- Quelle différence entre dontAsk et bypassPermissions ?
- Les deux ne posent aucune question. Mais dontAsk refuse tout ce qui n'est pas pré-autorisé, alors que bypassPermissions autorise presque tout. Le premier est fait pour un périmètre maîtrisé, le second pour un environnement jetable.
- Quelle différence entre dontAsk et denyInsteadOfPrompting ?
- dontAsk est un mode : il remplace celui que vous utilisiez et n'accepte que les outils pré-approuvés. denyInsteadOfPrompting est un réglage qui s'ajoute à votre mode actuel, par exemple auto, et qui refuse seulement les actions qui auraient fini en demande d'autorisation. Il faut la version 2.1.319 ou plus récente.
- Depuis début novembre, mon mode auto me demande plus souvent mon accord derrière ma gateway. Pourquoi ?
- C'est la 2.1.319 : quand la télémétrie ou les feature flags sont coupés, ce qui est le cas derrière une gateway LLM, les actions que le serveur ne peut pas vérifier vous sont soumises ou refusées, sans repli sur le classifieur intégré. Vérifiez
/status, et si votre passerelle ne relaie pas la vérification, définissezCLAUDE_CODE_AUTO_MODE_SERVER=0pour retrouver l'ancien comportement. - Pourquoi mon defaultMode « auto » n'est-il pas pris en compte ?
- Vous l'avez probablement placé dans le
.claude/settings.jsondu projet, où cette valeur est ignorée. Déplacez-la dans~/.claude/settings.json. Vérifiez aussi que votre organisation n'a pas désactivé le mode auto et que votre modèle le prend en charge. - Puis-je utiliser --dangerously-skip-permissions en root ?
- Non, Claude Code refuse sous root ou sudo, sauf à l'intérieur d'un bac à sable reconnu. Utilisez plutôt un conteneur avec un utilisateur non root.
- Le mode change-t-il les règles allow et deny ?
- Non. Les règles s'appliquent avant le mode, dans tous les cas. Seul bypassPermissions rend les règles allow inutiles, puisque tout est déjà autorisé.
Conclusion
Six modes, six niveaux de confiance, et depuis la 2.1.319 un réglage en plus pour les sessions que personne ne surveille. Le bon choix dépend de deux choses : la sensibilité de l'environnement sur lequel vous travaillez, et la confiance que vous accordez à l'agent pour la tâche du moment. Ces deux paramètres bougent au cours d'une même session, alors ne vous enfermez pas dans un mode unique pour toute la journée. Et si vous passez par une gateway, gardez un œil sur /status : c'est là que le mode auto a le plus changé ce mois-ci.
De mon côté, je reste en auto la plupart du temps, je passe en plan avant les gros chantiers et je repasse en Manual dès que je touche au site d'un client. Un Shift+Tab suffit, et c'est sans doute le raccourci que j'utilise le plus dans Claude Code.
Comment cet article a-t-il été réalisé ? Le texte a été rédigé par mes soins, puis relu avec l'aide d'une intelligence artificielle afin de corriger d'éventuelles erreurs d'orthographe ou de grammaire. L'illustration de présentation a également été créée à l'aide de l'IA.
Articles qui pourraient vous intéresser
Claude Code s'ouvre aux mods pour se personnaliser
Le 1er octobre 2026, une semaine après la sortie des sessions cloud de leur phase d'aperçu, Anthropic a ajouté à
Trier une boîte de réception qui déborde, retrouver la facture d'un fournisseur reçue il y a trois mois, préparer une réponse à un fil de discussion de quinze messages : ce sont des tâches ...
Gérer ses e-mails Thunderbird avec une IA grâce au protocole MCP : le tutoriel complet
Créer un budget dans Excel avec Copilot : formules, graphiques et tableau de bord qui se met à jour seul
Un budget rangé dans un dossier qu'on n'ouvre jamais ne sert à rien. Celui qui aide vraiment, c'est celui qu'on consulte chaque semaine parce qu'il répond tout de suite aux bonnes questions : co...
Classement Arena : Google prend les deux premières places, Claude complète le podium
Il y a deux semaines, je préparais un article sur l'arrivée de Gemini 4 Argon en tête du classement Arena. Entre-temps, Google a fait encore mieux : son nouveau modèle, Gemini 4 Carbon, est pas...
Plan marketing de fin d'année : ce que vaut le générateur IA gratuit de Positive User
Chaque automne, c'est la même chanson. On se dit qu'on va préparer le Black Friday tranquillement, et on se retrouve fin novembre à écrire un email promo à 23 h en l'envoyant à toute la base....
Claude Cowork passe dans le cloud : ce qui change vraiment pour vos fichiers, vos tâches et vos données
Le 6 octobre 2026, Anthropic a modifié le fonctionnement de Cowork, l'agent de Claude qui mène seul des tâches longues. Pour les a...
Model Context Protocol (MCP) : à quoi ça sert et faut-il s'y mettre ?
Si le sigle MCP vous fait d'abord penser au Master Control Program, l'intelligence tyrannique du film Tron sorti en 1982, rassurez-vous : son homonyme actuel est nettement plus pacifique. ...
Injection de prompt : comment une phrase cachée peut piéger votre IA (et comment s'en protéger)
Je confie de plus en plus de petites tâches à l'IA : résumer une page web, trier de la veille, préparer un brouillon. C'est pratique, mais une question me trotte dans la tête depuis quelque te...
C'est quoi la distillation en IA ? Explication simple, usages et polémique
Depuis le début de l'année 2026, je vois passer le mot « distillation » dans presque toutes les accusations que les laboratoires d'IA américains lancent contre leurs concurrents chinois. Anthr...
