Accueil / Fondamentaux et boucle d'agent

Permissions et mode plan

Le mode de permission décide quelles actions Claude Code exécute sans rien demander : depuis septembre 2026, une session interactive de terminal ou de VS Code sans mode configuré démarre en mode auto, sur tous les forfaits, et non plus en mode default, et le mode auto agit largement sous la surveillance en arrière-plan d'un second modèle.

Le mode de permission décide quelles actions Claude Code exécute sans rien demander, et lesquelles s'arrêtent devant une invite de confirmation. Depuis septembre 2026, une session interactive de terminal ou de VS Code démarre en mode auto quand aucun mode n'est configuré, sur tous les forfaits. Le mode de départ n'est donc plus celui qui demande avant chaque action.

Six modes, un filet différent à chaque fois

Le mode default, affiché manual mode on dans la barre d'état, ne fait que lire : chaque édition et chaque commande shell attendent une réponse. Le mode acceptEdits édite les fichiers et lance les commandes courantes de système de fichiers, mais s'arrête devant le reste. Le mode plan reste en lecture seule le temps de produire un plan. Le mode auto agit largement sous la surveillance en arrière-plan d'un classifieur, un second modèle qui bloque d'emblée quelques catégories : télécharger puis exécuter du code, exfiltrer des données sensibles, déployer en production, supprimer en masse sur du stockage cloud, lancer git reset --hard ou terraform destroy. Le mode dontAsk ne va pas plus loin que les outils approuvés à l'avance. Le mode bypassPermissions supprime le filet entier.

Quand la session ne démarre pas en auto

Le réglage disableAutoMode, un modèle non pris en charge, une organisation sous configuration HIPAA ou une coupure côté serveur ramènent la session en mode manuel. claude -p et l'Agent SDK démarrent aussi en default depuis octobre 2026 : un appel qui demande une approbation y est refusé tant qu'une règle d'autorisation ou un hook ne l'accorde pas. Une tâche lancée sans regarder le mode actif peut donc s'exécuter plus loin que prévu, avec le classifieur pour seul filet. Ce classifieur réagit : après une série de refus rapprochés, le mode auto se met en pause et redemande confirmation, et la figure chiffre les deux seuils.

claude --permission-mode plan
# lance la session directement en mode plan,
# en lecture seule tant que le plan n'est pas approuvé

Maj+Tabulation fait cycler les modes disponibles sans quitter la conversation : default, acceptEdits, plan, bypassPermissions s'il est activé, auto s'il est disponible, puis retour à default. Le drapeau --dangerously-skip-permissions équivaut au mode bypassPermissions.

Régler ce que le mode auto laisse passer

Avant une lecture hors des dossiers de travail, le mode auto pose une invite : la réponse « Yes, but ask again next time » autorise cette lecture sans ouvrir la porte aux suivantes. La commande /auto-mode-setup lit le projet et les sessions récentes pour apprendre au mode auto votre environnement, ce qui réduit les refus inutiles sans passer en bypass. Côté règles, mcp__a ne couvre plus qu'un serveur nommé a, pas a__b ni a_ : écrivez mcp__serveur__* pour un serveur entier. Une règle Bash avec :* au milieu du motif, ignorée jusque-là dans les fichiers de réglages, s'y applique désormais : relisez les vôtres.

Le mode plan, un sas avant d'écrire

Claude lit, explore, propose une séquence d'actions, et rien ne touche le disque avant l'approbation du plan, sauf dans un terminal interactif où le mode bypassPermissions est disponible : les éditions n'y attendent plus l'approbation. Hors de ce cas, le mode plan reste une vraie lecture seule, y compris face à un hook PreToolUse qui autoriserait une écriture. Si un plan approuvé part dans une mauvaise direction, la touche Échap interrompt le tour en cours sans perdre le travail déjà fait.