Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Quand Claude veut modifier un fichier, exécuter une commande shell ou effectuer une demande réseau, il s’arrête et vous demande d’approuver l’action. Les modes de permission contrôlent la fréquence de cette pause. Le mode que vous choisissez façonne le flux d’une session : le mode par défaut vous permet d’examiner chaque action au fur et à mesure, tandis que les modes plus souples permettent à Claude de travailler dans des étapes plus longues et ininterrompues et de faire un rapport quand c’est terminé. Choisissez une supervision plus importante pour les travaux sensibles, ou moins d’interruptions quand vous faites confiance à la direction.

​
Modes disponibles

Chaque mode fait un compromis différent entre la commodité et la supervision. Le tableau ci-dessous montre ce que Claude peut faire sans invite de permission dans chaque mode.
ModeCe qui s’exécute sans demanderIdéal pour
defaultLectures uniquementDémarrage, travaux sensibles
acceptEditsLectures, modifications de fichiers et commandes courantes du système de fichiers (mkdir, touch, mv, cp, etc.)Itération sur le code que vous examinez
planLectures uniquementExplorer une base de code avant de la modifier
autoTout, avec des vérifications de sécurité en arrière-planTâches longues, réduction de la fatigue des invites
dontAskUniquement les outils pré-approuvésCI verrouillé et scripts
bypassPermissionsToutConteneurs et machines virtuelles isolés uniquement
Dans tous les modes sauf bypassPermissions, les écritures dans les chemins protégés ne sont jamais auto-approuvées, protégeant l’état du dépôt et la configuration propre de Claude contre la corruption accidentelle. Les modes définissent la ligne de base. Superposez les règles de permission pour pré-approuver ou bloquer des outils spécifiques dans n’importe quel mode sauf bypassPermissions, qui ignore complètement la couche de permission.

​
Changer de mode de permission

Vous pouvez changer de mode en cours de session, au démarrage ou comme paramètre par défaut persistant. Le mode est défini via ces contrôles, pas en demandant à Claude dans le chat. Sélectionnez votre interface ci-dessous pour voir comment le modifier.
Pendant une session : appuyez sur Maj+Tab pour parcourir default → acceptEdits → plan. Le mode actuel apparaît dans la barre d’état. Tous les modes ne sont pas dans le cycle par défaut :
  • auto : apparaît quand votre compte répond aux exigences du mode auto ; le parcours vers auto affiche une invite d’acceptation jusqu’à ce que vous l’acceptiez, ou sélectionnez Non, ne me le demandez plus pour supprimer auto du cycle
  • bypassPermissions : apparaît après que vous ayez démarré avec --permission-mode bypassPermissions, --dangerously-skip-permissions, ou --allow-dangerously-skip-permissions ; la variante --allow- ajoute le mode au cycle sans l’activer
  • dontAsk : n’apparaît jamais dans le cycle ; définissez-le avec --permission-mode dontAsk
Les modes optionnels activés s’insèrent après plan, avec bypassPermissions en premier et auto en dernier. Si vous avez les deux activés, vous parcourrez bypassPermissions en allant vers auto.Au démarrage : passez le mode comme drapeau.
claude --permission-mode plan
Par défaut : définissez defaultMode dans les paramètres.
{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}
Le même drapeau --permission-mode fonctionne avec -p pour les exécutions non-interactives.

​
Approuver automatiquement les modifications de fichiers avec le mode acceptEdits

Le mode acceptEdits permet à Claude de créer et de modifier des fichiers dans votre répertoire de travail sans inviter. La barre d’état affiche ⏵⏵ accept edits on tandis que ce mode est actif. En plus des modifications de fichiers, le mode acceptEdits approuve automatiquement les commandes Bash courantes du système de fichiers : mkdir, touch, rm, rmdir, mv, cp et sed. Ces commandes sont également auto-approuvées quand elles sont préfixées avec des variables d’environnement sûres comme LANG=C ou NO_COLOR=1, ou des wrappers de processus comme timeout, nice ou nohup. Comme les modifications de fichiers, l’approbation automatique s’applique uniquement aux chemins à l’intérieur de votre répertoire de travail ou additionalDirectories. Les chemins en dehors de cette portée, les écritures dans les chemins protégés et toutes les autres commandes Bash invitent toujours. Quand l’outil PowerShell est activé, le mode acceptEdits approuve également automatiquement Set-Content, Add-Content, Clear-Content et Remove-Item sur les chemins dans la portée, ainsi que leurs alias courants. Les mêmes règles de portée et de chemins protégés s’appliquent. Utilisez acceptEdits quand vous voulez examiner les modifications dans votre éditeur ou via git diff après coup plutôt que d’approuver chaque modification en ligne. Appuyez sur Maj+Tab une fois depuis le mode par défaut pour l’entrer, ou démarrez directement avec : 
claude --permission-mode acceptEdits

​
Analyser avant de modifier avec le mode de planification

Le mode de planification indique à Claude de rechercher et de proposer des modifications sans les apporter. Claude lit les fichiers, exécute des commandes shell pour explorer et écrit un plan, mais ne modifie pas votre source. Les invites de permission s’appliquent de la même manière que le mode par défaut. Entrez le mode de planification en appuyant sur Maj+Tab ou en préfixant une seule invite avec /plan. Vous pouvez également démarrer en mode de planification depuis le CLI : 
claude --permission-mode plan
Appuyez sur Maj+Tab à nouveau pour quitter le mode de planification sans approuver un plan.

​
Examiner et approuver un plan

Quand le plan est prêt, Claude le présente et demande comment procéder. À partir de cette invite, vous pouvez :
  • Approuver et démarrer en mode auto
  • Approuver et accepter les modifications
  • Approuver et examiner manuellement chaque modification
  • Continuer la planification avec des commentaires
  • Affiner avec Ultraplan pour un examen basé sur le navigateur
Approuver un plan quitte le mode de planification et bascule la session vers le mode de permission que chaque option d’approbation décrit, de sorte que Claude commence à modifier. Pour planifier à nouveau, revenez au mode de planification avec Maj+Tab, ou préfixez votre prochaine invite avec /plan. Appuyez sur Ctrl+G pour ouvrir le plan proposé dans votre éditeur de texte par défaut et le modifier directement avant que Claude ne procède. Quand showClearContextOnPlanAccept est activé, chaque option d’approbation offre également d’effacer le contexte de planification en premier. Accepter un plan nomme également la session à partir du contenu du plan automatiquement, sauf si vous avez déjà défini un nom avec --name ou /rename.

​
Définir le mode de planification comme valeur par défaut

Pour faire du mode de planification la valeur par défaut pour un projet, définissez defaultMode dans .claude/settings.json : 
{
  "permissions": {
    "defaultMode": "plan"
  }
}

​
Éliminer les invites avec le mode auto

Le mode auto nécessite Claude Code v2.1.83 ou ultérieur.
Le mode auto permet à Claude d’exécuter sans invites de permission. Un modèle classificateur séparé examine les actions avant qu’elles ne s’exécutent, bloquant tout ce qui escalade au-delà de votre demande, cible une infrastructure non reconnue ou semble entraîné par du contenu hostile que Claude a lu. Le mode auto instruit également Claude d’exécuter immédiatement et de minimiser les questions de clarification. Pour obtenir ce comportement tout en conservant les invites de permission, définissez plutôt le style de sortie proactif.
Le mode auto est un aperçu de recherche. Il réduit les invites mais ne garantit pas la sécurité. Utilisez-le pour les tâches où vous faites confiance à la direction générale, pas comme remplacement de l’examen sur les opérations sensibles.
Le mode auto n’est disponible que quand votre compte répond à toutes ces exigences :
  • Plan : Max, Team, Enterprise ou API. Non disponible sur Pro.
  • Admin : sur Team et Enterprise, un administrateur doit l’activer dans les paramètres d’administration Claude Code avant que les utilisateurs puissent l’activer. Les administrateurs peuvent également le verrouiller en définissant permissions.disableAutoMode sur "disable" dans les paramètres gérés.
  • Modèle : Claude Sonnet 4.6, Opus 4.6 ou Opus 4.7 sur les plans Team, Enterprise et API ; Claude Opus 4.7 uniquement sur les plans Max. Les autres modèles, y compris Haiku et les modèles claude-3, ne sont pas supportés.
  • Fournisseur : API Anthropic uniquement. Non disponible sur Bedrock, Vertex ou Foundry.
Si Claude Code signale le mode auto comme indisponible, l’une de ces exigences n’est pas remplie ; ce n’est pas une panne transitoire. Un message séparé qui nomme un modèle et dit que le mode auto « ne peut pas déterminer la sécurité » d’une action est une panne transitoire du classificateur ; consultez la référence d’erreur.

​
Ce que le classificateur bloque par défaut

Le classificateur fait confiance à votre répertoire de travail et aux télécommandes configurées de votre dépôt. Tout le reste est traité comme externe jusqu’à ce que vous configuriez l’infrastructure de confiance. Bloqué par défaut :
  • Téléchargement et exécution de code, comme curl | bash
  • Envoi de données sensibles à des points de terminaison externes
  • Déploiements et migrations de production
  • Suppression en masse sur le stockage cloud
  • Octroi de permissions IAM ou de dépôt
  • Modification de l’infrastructure partagée
  • Destruction irréversible de fichiers qui existaient avant la session
  • Forçage ou poussée directe vers main
Autorisé par défaut :
  • Opérations de fichiers locaux dans votre répertoire de travail
  • Installation de dépendances déclarées dans vos fichiers de verrouillage ou manifestes
  • Lecture de .env et envoi des identifiants à leur API correspondante
  • Demandes HTTP en lecture seule
  • Poussée vers la branche sur laquelle vous avez commencé ou celle créée par Claude
Les demandes d’accès réseau sandbox sont acheminées via le classificateur plutôt que d’être autorisées par défaut. Exécutez claude auto-mode defaults pour voir les listes de règles complètes. Si les actions courantes sont bloquées, un administrateur peut ajouter des dépôts de confiance, des compartiments et des services via le paramètre autoMode.environment : consultez Configurer le mode auto.

​
Limites que vous énoncez dans la conversation

Le classificateur traite les limites que vous énoncez dans la conversation comme un signal de blocage. Si vous dites à Claude « ne pousse pas » ou « attends que j’examine avant de déployer », le classificateur bloque les actions correspondantes même quand les règles par défaut les autoriseraient. Une limite reste en vigueur jusqu’à ce que vous la leviez dans un message ultérieur. Le propre jugement de Claude qu’une condition a été remplie ne la lève pas. Les limites ne sont pas stockées comme des règles. Le classificateur les relit à partir de la transcription à chaque vérification, donc une limite peut être perdue si la compaction de contexte supprime le message qui l’a énoncée. Pour une garantie absolue, ajoutez une règle de refus à la place.

​
Quand le mode auto revient en arrière

Chaque action refusée affiche une notification et apparaît dans /permissions sous l’onglet Récemment refusé, où vous pouvez appuyer sur r pour la réessayer avec une approbation manuelle. Si le classificateur bloque une action 3 fois de suite ou 20 fois au total, le mode auto s’interrompt et Claude Code reprend l’invite. Approuver l’action invitée reprend le mode auto. Ces seuils ne sont pas configurables. Toute action autorisée réinitialise le compteur consécutif, tandis que le compteur total persiste pour la session et ne se réinitialise que quand sa propre limite déclenche un retour en arrière. En mode non-interactif avec le drapeau -p, les blocages répétés abandonnent la session puisqu’il n’y a pas d’utilisateur pour inviter. Les blocages répétés signifient généralement que le classificateur manque de contexte sur votre infrastructure. Utilisez /feedback pour signaler les faux positifs, ou demandez à un administrateur de configurer l’infrastructure de confiance.
Chaque action passe par un ordre de décision fixe. La première étape correspondante gagne :
  1. Les actions correspondant à vos règles d’autorisation ou de refus se résolvent immédiatement
  2. Les actions en lecture seule et les modifications de fichiers dans votre répertoire de travail sont auto-approuvées, sauf les écritures dans les chemins protégés
  3. Tout le reste va au classificateur
  4. Si le classificateur bloque, Claude reçoit la raison et essaie une alternative
En entrant en mode auto, les règles d’autorisation larges qui accordent l’exécution de code arbitraire sont supprimées :
  • Bash(*) sans restriction
  • Interpréteurs avec caractères génériques comme Bash(python*)
  • Commandes d’exécution du gestionnaire de paquets
  • Règles Agent
Les règles étroites comme Bash(npm test) sont conservées. Les règles supprimées sont restaurées quand vous quittez le mode auto.Le classificateur voit les messages utilisateur, les appels d’outils et votre contenu CLAUDE.md. Les résultats des outils sont supprimés, donc le contenu hostile dans un fichier ou une page web ne peut pas le manipuler directement. Une sonde côté serveur séparée analyse les résultats des outils entrants et signale le contenu suspect avant que Claude ne le lise. Pour plus d’informations sur la façon dont ces couches fonctionnent ensemble, consultez l’annonce du mode auto et l’analyse technique approfondie.
Le classificateur vérifie le travail des sous-agents à trois points :
  1. Avant qu’un sous-agent ne démarre, la description de la tâche déléguée est évaluée, donc une tâche qui semble dangereuse est bloquée au moment du lancement.
  2. Pendant que le sous-agent s’exécute, chacune de ses actions passe par le classificateur avec les mêmes règles que la session parent, et tout permissionMode dans le frontmatter du sous-agent est ignoré.
  3. Quand le sous-agent se termine, le classificateur examine son historique d’action complet ; si cette vérification de retour signale une préoccupation, un avertissement de sécurité est ajouté aux résultats du sous-agent.
Le classificateur s’exécute sur un modèle configuré par le serveur qui est indépendant de votre sélection /model, donc changer de modèle ne change pas la disponibilité du classificateur. Les appels du classificateur comptent dans votre utilisation de jetons. Chaque vérification envoie une partie de la transcription plus l’action en attente, ajoutant un aller-retour avant l’exécution. Les lectures et les modifications de répertoire de travail en dehors des chemins protégés ignorent le classificateur, donc la surcharge provient principalement des commandes shell et des opérations réseau.

​
Autoriser uniquement les outils pré-approuvés avec le mode dontAsk

Le mode dontAsk refuse automatiquement chaque appel d’outil qui inviterait autrement. Seules les actions correspondant à vos règles permissions.allow et les commandes Bash en lecture seule peuvent s’exécuter ; les règles ask explicites sont refusées plutôt que d’inviter. Cela rend le mode entièrement non-interactif pour les pipelines CI ou les environnements restreints où vous prédéfinissez exactement ce que Claude peut faire. Définissez-le au démarrage avec le drapeau : 
claude --permission-mode dontAsk

​
Ignorer toutes les vérifications avec le mode bypassPermissions

Le mode bypassPermissions désactive les invites de permission et les vérifications de sécurité pour que les appels d’outils s’exécutent immédiatement. À partir de la v2.1.126, cela inclut les écritures dans les chemins protégés, que les versions antérieures invitaient toujours. Les suppressions ciblant la racine du système de fichiers ou le répertoire personnel, telles que rm -rf / et rm -rf ~, invitent toujours comme disjoncteur contre les erreurs du modèle. Utilisez ce mode uniquement dans les environnements isolés comme les conteneurs, les machines virtuelles ou les devcontainers sans accès à Internet, où Claude Code ne peut pas endommager votre système hôte. Vous ne pouvez pas entrer bypassPermissions à partir d’une session qui a été démarrée sans l’un des drapeaux d’activation ; redémarrez avec l’un pour l’activer : 
claude --permission-mode bypassPermissions
Le drapeau --dangerously-skip-permissions est équivalent. Sur Linux et macOS, Claude Code refuse de démarrer dans ce mode lors de l’exécution en tant que root ou sous sudo : 
--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons
La vérification est ignorée automatiquement à l’intérieur d’un sandbox reconnu. Pour fonctionner de manière autonome dans un conteneur, utilisez la configuration du devcontainer, qui exécute Claude Code en tant qu’utilisateur non-root.
bypassPermissions n’offre aucune protection contre l’injection d’invite ou les actions involontaires. Pour les vérifications de sécurité en arrière-plan sans invites, utilisez le mode auto à la place. Les administrateurs peuvent bloquer ce mode en définissant permissions.disableBypassPermissionsMode sur "disable" dans les paramètres gérés.

​
Chemins protégés

Les écritures dans un petit ensemble de chemins ne sont jamais auto-approuvées, dans tous les modes sauf bypassPermissions. Cela empêche la corruption accidentelle de l’état du dépôt et de la configuration propre de Claude. Dans default, acceptEdits et plan, ces écritures invitent ; dans auto, elles sont acheminées vers le classificateur ; dans dontAsk, elles sont refusées ; dans bypassPermissions, elles sont autorisées. Répertoires protégés :
  • .git
  • .vscode
  • .idea
  • .husky
  • .claude, sauf pour .claude/commands, .claude/agents, .claude/skills et .claude/worktrees où Claude crée régulièrement du contenu
Fichiers protégés :
  • .gitconfig, .gitmodules
  • .bashrc, .bash_profile, .zshrc, .zprofile, .profile
  • .ripgreprc
  • .mcp.json, .claude.json

​
Voir aussi

  • Permissions : règles d’autorisation, de demande et de refus ; politiques gérées
  • Configurer le mode auto : indiquez au classificateur quelle infrastructure votre organisation fait confiance
  • Hooks : logique de permission personnalisée via les hooks PreToolUse et PermissionRequest
  • Ultraplan : exécutez le mode de planification dans une session Claude Code sur le web avec examen basé sur le navigateur
  • Sécurité : garanties de sécurité et meilleures pratiques
  • Sandboxing : isolation du système de fichiers et du réseau pour les commandes Bash
  • Mode non-interactif : exécutez Claude Code avec le drapeau -p