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 :

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 :

Modèles compatibles avec le mode auto
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_BETAS est défini. Si vos managed settings fixent cette seconde variable, elles doivent aussi fixer la valeur 1.
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

Les six modes de permission de Claude Code
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, .mvn et .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-config ou --agents est 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 :

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.

Trois façons de ne plus être sollicité
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 :

Où placer defaultMode
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 :

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éfinissez CLAUDE_CODE_AUTO_MODE_SERVER=0 pour retrouver l'ancien comportement.
Pourquoi mon defaultMode « auto » n'est-il pas pris en compte ?
Vous l'avez probablement placé dans le .claude/settings.json du 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.

Source

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.