Tous les paramètres

Index des paramètres

Modèle et réponses

advisorModel

• Portée : Any file
• Type : chaîne, l’un des alias "fable", "opus" ou "sonnet", qui correspondent à la version par défaut actuelle de Claude Code pour cette famille de modèles, ou un ID de modèle complet tel que "claude-opus-5-5"
• Valeur par défaut : non définie, l’advisor est donc désactivé
• Remplacements par session : --advisor a priorité sur cette clé pour une session. CLAUDE_CODE_DISABLE_ADVISOR_TOOL désactive l’advisor, et cette clé ne peut pas le réactiver

{
  "advisorModel": "opus"
}

alwaysThinkingEnabled

• Portée : Any file
• Type : booléen
  • true : aucun effet ; la réflexion est déjà activée
  • false : Claude Code désactive la réflexion étendue pour toutes les sessions
• Valeur par défaut : non définie, la réflexion est donc activée pour les modèles qui la prennent en charge
• Remplacements par session : MAX_THINKING_TOKENS a priorité sur cette clé pour une session : 0 désactive la réflexion, dans les mêmes limites de modèle et de fournisseur que false, et une valeur positive active la réflexion même lorsque cette clé vaut false. Sur les modèles à raisonnement adaptatif, le nombre lui-même est ignoré

{
  "alwaysThinkingEnabled": false
}

availableModels

• Portée : Any file. Déployez-la dans les paramètres gérés pour l’imposer à une organisation.
• Type : tableau d’alias ou d’ID de modèles
• Valeur par défaut : non définie, tous les modèles sont donc disponibles

{
  "availableModels": ["sonnet", "haiku"]
}

availableModelsMatch

• Portée : Managed. Claude Code ignore la clé dans les paramètres utilisateur, projet et locaux ainsi que dans --settings, avec un avertissement
• Type : chaîne, l’une des valeurs suivantes :
  • "prefix" : une entrée d’ID de modèle autorise sa version et tout ID de modèle qui la prolonge d’un segment supplémentaire
  • "exact" : une entrée d’ID de modèle n’autorise que la version qu’elle nomme, de sorte que "claude-opus-5" autorise Opus 5 mais pas claude-opus-5-5. Une entrée telle que "claude-opus-4-5" autorise également son ID de modèle Anthropic daté claude-opus-4-5-20251101. Un alias de famille tel que "opus" autorise toujours toute la famille, et les entrées best, opusplan et default sont ignorées
• Valeur par défaut : "prefix"

{
  "availableModels": ["claude-opus-5", "claude-sonnet-5"],
  "availableModelsMatch": "exact"
}

deniedModels

• Portée : Managed. Claude Code ignore la clé dans les paramètres utilisateur, projet et locaux ainsi que dans --settings, avec un avertissement
• Type : tableau d’alias ou d’ID de modèles
  • Un alias de famille tel que "opus" bloque tous les modèles de cette famille
  • Un ID de modèle tel que "claude-opus-5-5" bloque cette version sous toutes ses graphies, y compris les ID datés et propres aux fournisseurs
  • Un ID de modèle sans version mineure, tel que "claude-opus-5", bloque également les versions mineures ultérieures comme Opus 5.5. Écrivez "claude-opus-5-0" pour bloquer Opus 5 seul
  • Les entrées best, opusplan et default sont ignorées
• Valeur par défaut : non définie, aucun modèle n’est donc bloqué

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

effortLevel

• Portée : Any file
• Type : chaîne, l’une des valeurs suivantes :
  • "low" : le moins de raisonnement, pour des tâches courtes, ciblées et sensibles à la latence qui ne dépendent pas de l’intelligence
  • "medium" : réduit la consommation de tokens pour un travail sensible aux coûts qui peut sacrifier un peu d’intelligence
  • "high" : équilibre consommation de tokens et intelligence
  • "xhigh" : un raisonnement plus approfondi, au prix d’une consommation de tokens plus élevée
• Valeur par défaut : non définie
• Remplacements par session : --effort a priorité sur cette clé pour une session, et CLAUDE_CODE_EFFORT_LEVEL a priorité sur les deux

{
  "effortLevel": "xhigh"
}

enforceAvailableModels

• Portée : Any file
• Type : booléen
  • true : lorsque Default serait résolue vers un modèle hors de availableModels, Claude Code la résout vers le premier modèle disponible de la liste
  • false : cette clé ne modifie pas la façon dont Default est résolue
• Valeur par défaut : false

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

fallbackModel

• Portée : Any file
• Type : tableau d’alias ou d’ID de modèles ; "default" est remplacé par le modèle par défaut
• Valeur par défaut : non définie, une requête échouée n’est donc pas réessayée sur un autre modèle
• Remplacements par session : --fallback-model a priorité sur cette clé pour une session

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

fastMode

• Portée : Any file
• Type : booléen
  • true : Claude Code active le mode rapide pour les sessions où il est disponible. Sur Fable 5.2, vous devez également exécuter /fast lorsque vous utilisez Fable 5.2
  • false : le mode rapide reste désactivé
• Valeur par défaut : non définie, le mode rapide est donc désactivé
• Remplacements par session : CLAUDE_CODE_DISABLE_FAST_MODE désactive le mode rapide pour une session, et cette clé ne peut pas le réactiver

{
  "fastMode": true
}

fastModePerSessionOptIn

• Portée : Any file
• Type : booléen
  • true : un fastMode: true enregistré n’active plus le mode rapide au démarrage de la session, donc chaque personne exécute /fast dans chaque session où elle le souhaite ; un fastMode: true transmis avec --settings compte toujours pour cette session, sauf si les paramètres gérés définissent cette clé
  • false : un fastMode: true enregistré fonctionne comme le décrit fastMode
• Valeur par défaut : false

{
  "fastModePerSessionOptIn": true
}

language

• Portée : Any file
• Type : chaîne, n’importe quel nom de langue, comme "japanese", "spanish" ou "french" ; Claude Code ne la valide pas
• Valeur par défaut : non définie ; les titres de session suivent alors la langue de votre conversation

{
  "language": "japanese"
}

maxEffortLevel

• Portée : Any file. Déployez-la dans les paramètres gérés pour l’imposer à une organisation. Lorsque plusieurs portées définissent un plafond, le plus bas s’applique, de sorte qu’un plafond défini dans une portée ne peut pas être relevé depuis une autre
• Type : chaîne, l’une des valeurs "low", "medium", "high", "xhigh" ou "max". Une valeur "max" ne définit aucun plafond
• Valeur par défaut : non définie, aucun plafond ne s’applique donc
• Plafonds par modèle : ajoutez maxEffortLevel à l’entrée modelSettings d’un modèle. Cette entrée remplace cette clé pour ce modèle uniquement au sein de la source de paramètres qui définit les deux, comme vos paramètres utilisateur ou une source gérée. Définissez-y "max" pour exempter le modèle du plafond de cette source ; Claude Code applique toujours les plafonds des autres sources

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

model

• Portée : Any file
• Type : chaîne, un alias de modèle ou un ID de modèle complet
• Valeur par défaut : non définie, Claude Code utilise donc le modèle par défaut de votre compte
• Remplacements par session : --model a priorité sur ANTHROPIC_MODEL, et tous deux ont priorité sur cette clé pour une session, y compris sur un model géré ; une liste availableModels s’applique toujours au choix

{
  "model": "claude-sonnet-5"
}

modelOverrides

• Portée : Any file
• Type : objet associant un ID de modèle à un ID de modèle du fournisseur
• Valeur par défaut : non définie

{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example"
  }
}

modelPicker

• Portée : User or managed. Claude Code lit la clé depuis les paramètres gérés, --settings et les paramètres utilisateur, et l’ignore dans les paramètres de projet et locaux, afin qu’un dépôt que vous clonez ne puisse pas renommer les entrées du sélecteur. La source la plus prioritaire de ces trois qui définit la clé fournit toute la liste, et Claude Code ne combine jamais les listes de deux sources.
• Type : objet avec un tableau options de lignes et un booléen facultatif replaceBuiltInOptions
• Valeur par défaut : non définie, le sélecteur affiche donc la liste intégrée

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

Champs de modelPicker

• Supprimée : une ligne que Claude Code ne peut pas servir, comme un modèle retiré ou un modèle auquel votre organisation n’a pas accès
• Grisée : une ligne que vous ne pouvez pas encore sélectionner, affichée avec le motif
• Aucune ligne ne subsiste : Claude Code conserve la liste intégrée, filtrée par la liste d’autorisation comme d’habitude

modelPricing

• Portée : Managed. Déployez la clé via les paramètres gérés par le serveur, une stratégie MDM, un fichier managed-settings.json ou un programme d’aide de stratégie. Claude Code l’ignore dans les paramètres utilisateur, projet et locaux, dans --settings et, sous Windows, dans le registre HKCU accessible en écriture par l’utilisateur. Avec les paramètres gérés par le serveur, chaque session indique les coûts au prix catalogue jusqu’à ce que la récupération des paramètres de cette session ait confirmé le paramètre. Une application hôte qui intègre Claude Code et définit CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST peut fournir sa propre table via l’option managedSettings du SDK, que Claude Code n’utilise que lorsqu’aucune source gérée ne définit la clé, et uniquement dans Claude Code v2.1.246 ou ultérieure.
• Type : objet avec un multiplier facultatif et une table overrides facultative
• Valeur par défaut : non définie, Claude Code indique donc le prix catalogue, sauf si une application hôte fournit une table

{
  "modelPricing": {
    "multiplier": 0.85,
    "overrides": {
      "claude-sonnet-4-6": {
        "input": 2.4,
        "output": 12,
        "cacheRead": 0.24,
        "cacheWrite": 3
      }
    }
  }
}

Champs de modelPricing

À quels modèles une ligne modelPricing s’applique

• L’ID d’un modèle intégré : une clé que Claude Code utilise lui-même pour un modèle intégré, qu’il s’agisse de l’ID propre du modèle, comme claude-sonnet-4-6, ou de son ID Bedrock, Agent Platform ou Foundry. Claude Code applique la ligne à chaque ID de snapshot daté et à chaque ID propre à un fournisseur de ce modèle.
• Toute autre clé : une clé qui n’est pas l’ID d’un modèle intégré, comme un alias de modèle de passerelle. Claude Code applique la ligne à cet unique ID. Lorsqu’un ID de modèle correspond exactement à l’une de vos clés et relève également d’une ligne dont la clé est l’ID d’un modèle intégré, Claude Code utilise la correspondance exacte.
• Un profil d’inférence d’application Bedrock : une fois que Claude Code a résolu le profil vers le modèle vers lequel il achemine, via votre table modelOverrides ou la recherche bedrock:GetInferenceProfile, Claude Code applique la ligne de ce modèle au profil.

modelSettings

• Portée : Any file
• Type : objet associant un nom de modèle à un objet comportant un ou plusieurs des champs suivants :
  • effortLevel : l’une des valeurs "low", "medium", "high" ou "xhigh"
  • maxEffortLevel : le niveau d’effort le plus élevé auquel le modèle peut s’exécuter
  • autoCompactWindow : un nombre de tokens de 100000 à 1000000, ou "auto" pour la fenêtre adaptée au modèle. /autocompact enregistre sa valeur ici. Pour ce modèle, la valeur a priorité sur un autoCompactWindow de premier niveau dans le même fichier de paramètres. Nécessite Claude Code v2.1.288 ou ultérieure
• Valeur par défaut : non définie

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

outputStyle

• Portée : Any file
• Type : chaîne, le nom d’un style de sortie intégré ou personnalisé
• Valeur par défaut : non définie, Claude Code utilise donc le style par défaut

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

• Portée : Any file
• Type : chaîne, l’une des valeurs suivantes :
  • "5m" : le cache est conservé pendant cinq minutes
  • "1h" : le cache est conservé pendant une heure
• Valeur par défaut : non définie, chaque requête de la conversation principale reçoit donc sa durée de vie par défaut
• Remplacements par session : FORCE_PROMPT_CACHING_5M a priorité sur tout le reste, puis CLAUDE_CODE_PROMPT_CACHE_TTL, puis cette clé, et enfin ENABLE_PROMPT_CACHING_1H

{
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

showThinkingSummaries

• Portée : Any file
• Type : booléen
  • true : vous voyez les résumés complets de la réflexion lorsque vous la développez avec Ctrl+O
  • false : l’API Anthropic masque le contenu des blocs de réflexion et Claude Code affiche un bloc réduit
• Valeur par défaut : false

{
  "showThinkingSummaries": true
}

subagentPromptCacheTtl

• Portée : Any file
• Type : chaîne, l’une des valeurs suivantes :
  • "5m" : le cache est conservé pendant cinq minutes
  • "1h" : le cache est conservé pendant une heure
• Valeur par défaut : non définie, chacune de ces requêtes reçoit donc sa durée de vie par défaut
• Remplacements par session : FORCE_PROMPT_CACHING_5M a priorité sur tout le reste, puis CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, puis cette clé, puis ENABLE_PROMPT_CACHING_1H, qui demande la durée de vie d’une heure pour chaque requête. Pour savoir où se situe la valeur du frontmatter propre à un sous-agent, consultez Choisir vous-même le TTL

{
  "subagentPromptCacheTtl": "1h"
}

switchModelsOnFlag

• Portée : Any file. Apparaît dans /config sous le nom Switch models when a message is flagged, avec les options Switch automatically et Ask each time.
• Type : booléen
  • true : Claude Code bascule sur le modèle de secours et continue
  • false : dans une session interactive, Claude Code fait une pause pour que vous puissiez choisir entre basculer et modifier le prompt ; là où aucune boîte de dialogue ne peut s’afficher, comme dans une exécution -p, la requête signalée se termine par une erreur
• Valeur par défaut : non définie. Claude Code bascule automatiquement, mais il peut demander d’abord dans une session interactive

{
  "switchModelsOnFlag": false
}

ultracode

• Portée : Any file
• Type : booléen
  • true : les sessions démarrent avec ultracode activé lorsque les workflows dynamiques sont activés pour vous et que votre modèle prend en charge xhigh
  • false : les sessions démarrent avec ultracode désactivé
• Valeur par défaut : non définie, ultracode est donc désactivé
• Remplacements par session : /effort ultracode active ultracode pour une session sans cette clé, et /effort ultracode off le désactive pour une session lorsque cette clé vaut true. Le flag --effort ultracode l’active également pour une session, avec l’effort xhigh

{
  "ultracode": true
}

Paramètres de permission

allowManagedPermissionRulesOnly

• Le répertoire .claude/ d’un dépôt
• Vos répertoires ~/.claude/skills/ et ~/.claude/commands/, y compris les skills synchronisés depuis claude.ai
• Un répertoire --add-dir
• Les plugins déclarés avec un manifeste .claude-plugin dans ~/.claude/skills/ ou dans le .claude/skills/ du projet
• Les plugins chargés pour une seule session, dont l’ID se termine par @inline, lorsque toutes ces conditions sont réunies :
  • La session est une session Code ou une session Cowork, autre qu’une session cloud, pour laquelle l’application Claude Desktop démarre elle-même Claude Code
  • Vos paramètres gérés définissent la clé, et pas seulement les paramètres parents d’un hôte d’intégration
  • La session exécute Claude Code v2.1.305 ou ultérieur

• Portée : Managed
• Type : Booléen
  • true : les paramètres gérés deviennent la seule source de règles de permission
  • false : Claude Code applique les règles de permission des fichiers utilisateur, projet, local et --settings en plus des règles gérées
• Défaut : non défini, donc Claude Code applique les règles de permission des paramètres utilisateur, projet et local et de --settings, en plus des règles gérées

{
  "allowManagedPermissionRulesOnly": true
}

autoMode

• Portée : User or managed
• Type : objet avec des tableaux environment, allow, soft_deny et hard_deny de règles en prose, plus le Booléen classifyAllShell
• Défaut : non défini, donc le classificateur utilise uniquement ses règles intégrées

{
  "autoMode": {
    "soft_deny": ["$defaults", "Never run terraform apply"]
  }
}

autoMode.classifyAllShell

• Portée : User or managed. Lisez partout où autoMode est lu.
• Type : Booléen
  • true : pendant que le mode auto est actif, Claude Code envoie chaque commande Bash et PowerShell via le classificateur et suspend vos règles d’autorisation shell ; en dehors du mode auto, les règles s’appliquent toujours
  • false : le mode auto suspend uniquement les règles d’autorisation qui pourraient exécuter du code arbitraire, comme Bash(*) et Bash(python *) ; une commande qui correspond à toute autre règle d’autorisation ignore le classificateur sauf si elle porte des domaines autorisés par commande, et chaque autre commande shell le traverse
• Défaut : false

{
  "autoMode": {
    "classifyAllShell": true
  }
}

disableAutoMode

• Portée : Any file. Plus utile dans les paramètres gérés, où les utilisateurs ne peuvent pas le remplacer. Également accepté sous permissions comme permissions.disableAutoMode.
• Type : la chaîne "disable"
• Défaut : non défini

{
  "disableAutoMode": "disable"
}

permissions

• Portée : Any file
• Type : objet avec allow, ask, deny, additionalDirectories, blockReadsOutsideWorkingDirectories, blockWritesOutsideWorkingDirectories, defaultMode, denyInsteadOfPrompting, disableBypassPermissionsMode et disableAutoMode
• Défaut : non défini

{
  "permissions": {
    "allow": ["Bash(npm run *)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)"],
    "defaultMode": "acceptEdits"
  }
}

useAutoModeDuringPlan

• Portée : User, local, or managed. Un dépôt ne peut pas l’éteindre pour vous.
  • Un false dans l’un de ces fichiers ou dans --settings le désactive, sauf si vous excluez ce fichier utilisateur ou local avec une option telle que --setting-sources. Pour qu’un fichier exclu soit ignoré, Claude Code v2.1.314 ou ultérieur est nécessaire
• Type : Booléen
  • true : identique à non défini ; quand le mode auto est disponible, le classificateur examine les commandes shell pendant la planification
  • false : vous obtenez une invite de permission pour chaque commande en dehors de l’ensemble intégré en lecture seule
• Défaut : true

{
  "useAutoModeDuringPlan": false
}

permissions.allow

• Portée : Any file
• Type : tableau de chaînes de règles de permission
• Défaut : non défini
• Remplacements par session : --allowedTools ajoute des règles d’autorisation pour une session, et une règle de blocage de n’importe quel fichier de paramètres bloque toujours un outil qu’elle nomme

{
  "permissions": {
    "allow": ["Bash(git diff *)", "Read(~/.zshrc)"]
  }
}

Syntaxe des règles de permission

permissions.ask

• Portée : Any file
• Type : tableau de chaînes de règles de permission
• Défaut : non défini

{
  "permissions": {
    "ask": ["Bash(git push *)"]
  }
}

permissions.deny

• Portée : Any file
• Type : tableau de chaînes de règles de permission
• Défaut : non défini
• Remplacements par session : --disallowedTools ajoute des règles de blocage pour une session à côté de cette clé

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Bash(curl *)"
    ]
  }
}

permissions.additionalDirectories

• Portée : Any file, avec des limites sur l’accès en écriture du sandbox que confèrent les entrées de projet et locales
• Type : tableau de chemins de répertoires
• Défaut : non défini
• Remplacements par session : --add-dir et /add-dir ajoutent des répertoires pour une session à côté de cette clé

{
  "permissions": {
    "additionalDirectories": ["../docs/"]
  }
}

permissions.blockReadsOutsideWorkingDirectories

• Les actions qu’aucun mode n’auto-approuve couvre quand une commande shell qui lit un tel chemin vous invite
• Les commandes sandboxées sous le blocage couvre ce qu’une commande sandboxée peut lire

• Portée : Any file. Un true dans n’importe quel fichier s’applique, donc un dépôt peut activer le blocage pour lui-même mais ne peut pas lever le vôtre.
• Type : Booléen
  • true : les outils de fichiers de Claude refusent les lectures en dehors des répertoires de travail
  • false : identique à non défini ; le blocage s’applique toujours si un autre fichier définit true
• Défaut : non défini, donc les lectures en dehors des répertoires de travail suivent votre mode de permission

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

Commandes sandboxées sous le blocage

• L’isolation du système de fichiers est désactivée via sandbox.filesystem.disabled
• allowManagedReadPathsOnly est défini
• Le chemin du répertoire dans lequel vous avez démarré Claude Code contient un caractère glob comme *, ? ou [

• ~/.gitconfig
• Les fichiers config, ignore et attributes sous $XDG_CONFIG_HOME/git, qui par défaut est ~/.config/git
• Les fichiers que votre configuration git globale nomme via [include], [includeIf], core.excludesFile ou core.attributesFile

permissions.blockWritesOutsideWorkingDirectories

• Portée : Any file. Un true dans n’importe quel fichier que la session charge s’applique, donc un dépôt peut activer le blocage pour lui-même mais ne peut pas lever le vôtre. Dans une session cloud, Claude Code peut ne pas appliquer la clé, car les outils de fichiers s’exécutent dans un conteneur qui constitue lui-même la frontière.
• Type : Booléen
  • true : active le blocage
  • false : identique à non défini ; le blocage s’applique toujours si un autre fichier définit true
• Défaut : non défini, donc les écritures en dehors des répertoires de travail suivent votre mode de permission. Le blocage est aussi actif tant que Claude Code ne peut pas lire l’objet permissions dans vos paramètres gérés.

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

Ce que le blocage en écriture refuse et ce qui reste inscriptible

• Les fichiers de paramètres de Claude Code : Claude Code refuse ces écritures à l’intérieur des répertoires de travail également, car un fichier de paramètres peut lever le blocage. Modifiez vous-même les fichiers de paramètres.
• Un répertoire que seuls les paramètres du dépôt ajoutent : un répertoire que additionalDirectories liste uniquement dans .claude/settings.json, ou dans .claude/settings.local.json sauf si git signale ce fichier comme non suivi
• Le worktree d’un sous-agent : les modifications de fichiers d’un sous-agent isolation: worktree sont refusées quand son worktree se trouve en dehors des répertoires de travail
• La mémoire automatique dans un répertoire choisi par le dépôt : un répertoire que autoMemoryDirectory nomme dans les paramètres du dépôt

Laisser passer un répertoire à travers le blocage en lecture ou en écriture

permissions.defaultMode

• Portée : Any file. auto et bypassPermissions ne prennent pas effet à partir des paramètres du projet ou local, donc définissez-les dans ~/.claude/settings.json à la place. Avant la v2.1.257, bypassPermissions prenait effet à partir de n’importe quel fichier. Pour les conversations que l’extension VS Code démarre, Claude Code lit uniquement les valeurs utilisateur, gérées et --settings.
• Type : chaîne, l’une de :
  • "default" : Claude Code exécute uniquement les lectures sans demander
  • "acceptEdits" : Claude Code exécute aussi les éditions de fichiers et les commandes courantes du système de fichiers comme mkdir et mv sans demander
  • "plan" : Claude Code lit et planifie mais bloque les éditions jusqu’à ce que vous approuviez un plan
  • "auto" : Claude Code exécute sans invites de routine ; avant que les actions telles que les commandes shell et les requêtes réseau s’exécutent, un classificateur en arrière-plan vérifie qu’elles s’alignent avec votre demande
  • "dontAsk" : Claude Code refuse automatiquement chaque appel qui inviterait autrement, bien qu’un mod que vous avez installé puisse toujours approuver certains de ces appels. Les lectures de fichiers dans vos répertoires de travail, les autres actions qui ne nécessitent pas d’approbation, et les outils pré-approuvés s’exécutent toujours, à l’exception des lectures depuis des chemins réseau
  • "bypassPermissions" : Claude Code exécute tout sans demander
  • "manual" : un alias pour "default"
• Défaut : non défini
• Remplacements par session : --permission-mode, et son équivalent --dangerously-skip-permissions pour bypassPermissions, ont priorité sur cette clé pour une session

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

permissions.denyInsteadOfPrompting

• Portée : User or managed, et --settings. Un dépôt ne peut pas la définir pour vous.
• Type : Booléen
  • true : Claude Code refuse les appels qui déclencheraient autrement une demande
  • false : identique à non défini ; les appels sont toujours refusés si une autre de ces sources définit true
• Défaut : non défini, donc un appel qui nécessite une approbation vous est soumis par une demande

{
  "permissions": {
    "defaultMode": "auto",
    "denyInsteadOfPrompting": true
  }
}

Ce que denyInsteadOfPrompting arrête d’autre

• Outils de question et de plan : Claude Code omet AskUserQuestion, EnterPlanMode et ExitPlanMode, de sorte qu’une session en mode plan ne peut pas en sortir d’elle-même. Un coéquipier dans une équipe d’agents conserve EnterPlanMode et ExitPlanMode
• Élicitation MCP : Claude Code annule une requête d’élicitation sauf si un hook Elicitation y répond
• Hôtes de permission : Claude Code n’interroge pas votre callback canUseTool ni --permission-prompt-tool. Pour approuver des appels depuis du code, répondez depuis un hook PermissionRequest. Certains appels sont refusés avant qu’un hook soit consulté, comme une suppression de chemin critique en mode auto qu’aucune règle ask ne couvre.
• Avis de facturation du classificateur : là où l’avis sur les requêtes facturées du classificateur ouvrirait un dialogue, Claude Code ne l’affiche pas et refuse les actions qui nécessitent ces requêtes

Messages de denyInsteadOfPrompting

Permission for this tool use was denied. It requires approval, and this session has no approval surface

no approval surface in this session; permission request denied automatically

20 actions were refused and no work went ahead in between, so Claude stopped.

permissions.disableBypassPermissionsMode

• Portée : Any file. Généralement défini dans les paramètres gérés pour appliquer la politique organisationnelle.
• Type : la chaîne "disable"
• Défaut : non défini
• Remplacements par session : cette clé a priorité sur --dangerously-skip-permissions, que Claude Code rejette pendant que la clé est définie

{
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

skipAutoPermissionPrompt

• Portée : User or managed. Un dépôt ne peut pas le définir pour vous.
• Type : Booléen
  • true : Claude Code ignore l’avis
  • false : identique à non défini ; l’avis apparaît une fois sauf si un de ces fichiers définit true
• Défaut : non défini, donc l’avis apparaît une fois

{
  "skipAutoPermissionPrompt": true
}

skipDangerousModePermissionPrompt

• Portée : User, local, or managed, et les fichiers passés avec --settings. Les sessions en arrière-plan ne prennent en compte que les paramètres utilisateur et gérés. Un dépôt non approuvé ne peut pas ignorer le dialogue pour vous.
• Type : Booléen
  • true : Claude Code ignore le dialogue de confirmation avant qu’une session entre en mode bypassPermissions
  • false : identique à non défini ; le dialogue apparaît sauf si un de ces fichiers définit true
• Défaut : non défini, donc le dialogue apparaît

{
  "skipDangerousModePermissionPrompt": true
}

Paramètres du sandbox

sandbox

• Scope : Any file
• Type : objet avec enabled, failIfUnavailable, autoAllowBashIfSandboxed, excludedCommands, allowUnsandboxedCommands, enableWeakerNestedSandbox, enableWeakerNetworkIsolation, allowAppleEvents, allowNestedUserNamespaces, bwrapPath, socatPath, ignoreViolations et ripgrep, ainsi que les objets filesystem, network et credentials
• Default : non défini, donc Claude Code exécute les commandes sans sandbox

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

sandbox.enabled

• Scope : Any file, avec des limites sur les paramètres de projet et locaux
• Type : Booléen
  • true : Claude Code met en sandbox les commandes Bash
  • false : les commandes Bash s’exécutent sans sandbox
• Default : false

{
  "sandbox": {
    "enabled": true
  }
}

sandbox.failIfUnavailable

• Scope : Any file, avec des limites sur les paramètres de projet et locaux
• Type : booléen
  • true : Claude Code se termine avec une erreur au démarrage lorsque sandbox.enabled vaut true mais que le sandbox ne peut pas démarrer. Si le sandbox passe cette vérification puis échoue à s’initialiser, la session continue et Claude Code refuse chaque commande en sandbox
  • false : Claude Code exécute les commandes hors sandbox lorsque le sandbox ne peut pas démarrer
• Default : false

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}

sandbox.autoAllowBashIfSandboxed

• Scope : Any file
• Type : Booléen
  • true : Claude Code exécute les commandes Bash en sandbox sans demande de permission, sauf dans les cas que décrit Auto-allow mode ; CLAUDE_CODE_SUBPROCESS_ENV_SCRUB désactive l’auto-allow
  • false : les commandes en sandbox passent par le flux de permission régulier, donc vos règles d’autorisation et le mode de permission décident. L’onglet Mode de /sandbox appelle ceci mode de permissions régulier
• Default : true