SpyBara
Go Premium

settings.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 83 additions and 83 deletions.

2026
Wed 7 23:59 Fri 9 23:02 Sat 10 23:01 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Tue 27 22:59 Wed 28 23:57

Fichiers de paramètres et précédence

Modifiez les paramètres Claude Code, choisissez la portée à laquelle appartient une clé, vérifiez la modification, et apprenez quelle valeur Claude Code utilise quand une clé est définie à plusieurs endroits.

Les paramètres sont les clés JSON qui modifient le comportement de Claude Code : quel modèle il démarre, ce qu'il peut exécuter sans demander, quels fichiers il ne peut pas lire, comment il s'affiche dans votre terminal, et ce que votre organisation applique.

[!TIP]

Pour rechercher une clé spécifique, allez à Tous les paramètres, qui énumère chaque clé avec le fichier dans lequel vous la définissez, sa valeur par défaut, et un exemple.

Claude Code lit les paramètres à partir de fichiers de paramètres JSON tels que ~/.claude/settings.json. Il les cherche à quelques emplacements, et le fichier à partir duquel il lit un paramètre décide à qui le paramètre s'applique. Cette page couvre ces fichiers : dans lequel mettre un paramètre, comment modifier un paramètre et confirmer qu'il s'est appliqué, et quelle valeur Claude Code utilise quand la même clé est définie dans plus d'un fichier. Configurer les permissions couvre ce que Claude Code peut exécuter sans demander et comment écrire les règles allow, ask, et deny.

[!NOTE]

Cette page couvre Claude Code s'exécutant sur votre machine : le terminal, les extensions VS Code et JetBrains, et l'application de bureau, qui lisent tous les mêmes fichiers de paramètres. Une session cloud sur Claude Code sur le web s'exécute sur une machine différente et ne lit que certains d'entre eux ; voir Paramètres dans les sessions cloud.

Fichiers de paramètres et qui ils affectent

Claude Code lit les paramètres à partir de quatre fichiers, et une organisation peut également fournir des paramètres gérés à partir de la console claude.ai. Chaque source a une portée : l'ensemble des personnes et des projets auxquels un paramètre enregistré s'applique, que ce soit juste vous, tout le monde dans un projet, ou tout le monde dans votre organisation.

Portée Fichier Qui est affecté Utilisez-le pour
Utilisateur ~/.claude/settings.json Vous, dans chaque projet sur cette machine Préférences personnelles : thème, mode éditeur, modèle par défaut, vos propres règles de permission
Projet partagé .claude/settings.json Tout le monde travaillant dans le dossier qui le contient. Dans un dépôt git, faites-en un commit pour que vos coéquipiers l'obtiennent Permissions d'équipe, hooks, plugins, et les variables d'environnement dont le projet a besoin
Projet local .claude/settings.local.json Vous, dans ce seul projet. Claude Code le garde hors de git quand il crée le fichier ; si vous le créez à la main, ajoutez-le à .gitignore vous-même Remplacements personnels pour un projet, et test avant de partager
Géré managed-settings.json et autres sources gérées Tout le monde auquel votre organisation le déploie ; Priorité des paramètres indique ce qui peut le remplacer Politique de sécurité et exigences de conformité

Dans la colonne Fichier, ~/.claude est le dossier .claude dans votre répertoire personnel, et un .claude nu est le dossier .claude à l'intérieur de votre projet.

Comparez la portée de chaque fichier de paramètres

Supposons que vous ayez trois projets sur votre machine, website/, api/, et acme-app/, qu'un coéquipier ait son propre clone de acme-app/, et que vous démarriez une session cloud sur acme-app/.

Le graphique ci-dessous montre dans quels dossiers un paramètre s'applique quand vous démarrez Claude Code à partir d'eux. Cliquez sur un fichier de paramètres pour voir les dossiers qu'il atteint.

Settings file

Your machine

A teammate’s machine

A cloud session

  • ~/.claude/settings.json : chaque projet sur votre machine, et rien sur celle de votre coéquipier ou dans la session cloud
  • acme-app/.claude/settings.json : votre acme-app/. Il atteint le clone de votre coéquipier et la session cloud uniquement si vous faites un commit du fichier dans le contrôle de version ; jusqu'à ce que vous le fassiez, c'est un fichier sur votre disque comme n'importe quel autre et personne d'autre ne l'a
  • acme-app/.claude/settings.local.json : votre acme-app/ uniquement. Claude Code l'ajoute à vos exclusions git globales la première fois qu'il écrit le fichier, donc il reste hors de vos commits ; si vous créez le fichier à la main, ajoutez-le à .gitignore vous-même
  • Paramètres gérés, qu'il s'agisse d'un fichier managed-settings.json, d'une politique MDM, ou de paramètres gérés par le serveur à partir de la console claude.ai : chaque projet sur chaque machine auquel votre organisation la déploie, ou auquel vous vous connectez avec votre compte d'organisation. Seuls les paramètres gérés par le serveur atteignent la session cloud

Trouvez ou créez vos fichiers de paramètres

L'installation de Claude Code ne crée aucun fichier de paramètres. Si votre machine ou projet en a déjà un, il provient de l'une de ces sources :

  • Géré : votre organisation la déploie. Vous ne la créez ni ne l'éditez.
  • Projet partagé : un projet qui utilise déjà Claude Code peut en avoir un commité. Sinon, créez-le à .claude/settings.json dans le dossier du projet.
  • Utilisateur et Projet local : créez-les vous-même, ou laissez Claude Code les créer. Il écrit ~/.claude/settings.json la première fois que vous modifiez une option dans le menu /config qu'il stocke dans les paramètres utilisateur, comme le thème, et .claude/settings.local.json la première fois que vous donnez une approbation permanente sur une demande de permission, comme « Oui, et ne me demande plus » pour une commande Bash. Quelques options /config, y compris Afficher les conseils, s'enregistrent dans .claude/settings.local.json à la place du fichier utilisateur.

[!NOTE]

Sur Windows, ~/.claude signifie %USERPROFILE%\.claude. Pour garder les fichiers du répertoire personnel ailleurs, définissez CLAUDE_CONFIG_DIR ; Claude Code stocke alors vos paramètres, l'historique de session, et les plugins à la place.

Claude Code conserve également un cinquième fichier, ~/.claude.json, qu'il écrit pour lui-même ; vous n'avez pas besoin de l'éditer. Il contient les détails de votre compte, les configurations de serveur MCP, l'état par projet comme les décisions de confiance, et les clés de configuration globale que /config écrit pour vous.

Partagez les paramètres avec votre équipe

Commitez .claude/settings.json pour que tout le monde qui clone le dépôt obtienne les mêmes permissions, hooks, et plugins. Chaque coéquipier peut toujours le remplacer pour lui-même dans son propre .claude/settings.local.json, donc les exceptions personnelles n'ont pas besoin d'un commit. Pour un fichier d'équipe complet, voir les paramètres partagés d'une équipe.

Une partie de ce que vous commitez attend que chaque coéquipier fasse confiance au dossier, et quelques clés ne prennent jamais effet à partir d'un fichier de dépôt ; Dépannez un paramètre qui ne s'applique pas couvre les deux.

Gardez les paramètres personnels hors d'un dépôt

Pour modifier un paramètre pour vous-même dans un projet sans le modifier pour vos coéquipiers, enregistrez-le dans .claude/settings.local.json à l'intérieur du projet. Claude Code applique ce fichier sur le .claude/settings.json commité, donc si le fichier de votre équipe définit "model": "claude-sonnet-5" et que vous voulez Opus, mettez "model": "claude-opus-5-5" dans votre fichier local et seules vos sessions changent.

Claude Code écrit également dans ce fichier, le garde hors de vos commits, et applique ses règles allow sans l'étape de confiance :

  • Claude Code l'écrit aussi. Quand Claude demande la permission d'exécuter une commande Bash et que vous choisissez « Oui, et ne me demande plus », Claude Code enregistre cette approbation de permission ici comme une règle allow.
  • Vous n'avez pas besoin de le gitignorer vous-même, sauf si vous l'avez créé à la main. La première fois que Claude Code écrit le fichier dans un dépôt git qui ne l'ignore pas déjà, il ajoute **/.claude/settings.local.json à votre fichier d'exclusions git global, donc le fichier reste hors de vos commits dans chaque dépôt. Ce fichier est core.excludesFile quand votre configuration git globale le définit à un chemin absolu ou préfixé par ~ ; sinon c'est $XDG_CONFIG_HOME/git/ignore, ou ~/.config/git/ignore quand XDG_CONFIG_HOME n'est pas défini. Si vous avez créé le fichier à la main et que Claude Code ne l'a pas encore écrit, ajoutez-le à .gitignore vous-même.
  • Ses règles allow n'attendent pas la confiance tant que le fichier reste non suivi. Parce que le fichier est le vôtre et non celui du dépôt, Claude Code applique ses règles allow sans l'étape de confiance de l'espace de travail qu'il exige pour le fichier commité. Si le fichier est suivi par git, l'étape de confiance s'applique aussi ; voir Quand votre fichier de paramètres locaux a besoin de confiance.

Où Claude Code garde le fichier local dans un dépôt git

Quand Claude demande la permission d'exécuter une commande Bash et que vous choisissez « Oui, et ne me demande plus », Claude Code enregistre cette approbation comme une règle allow dans .claude/settings.local.json. Si vous démarrez Claude Code dans un sous-répertoire d'un dépôt git, il lit et écrit ce fichier à la racine du dépôt et applique l'approbation dans tout le dépôt. Dans un worktree, il utilise le fichier à la racine du checkout principal.

Deux règles qualifient l'emplacement racine :

  • Quand le fichier reste avec .claude/settings.json à la place : en dehors d'un dépôt git, quand la racine du dépôt est votre répertoire personnel, sur Windows, ou quand la racine du dépôt ou son entrée .git ou .claude n'est pas possédée par votre utilisateur.
  • Les chemins dans le fichier ne s'ancrent pas à la racine du dépôt : une règle de permission qui commence par / ou un chemin sandbox relatif s'ancre au répertoire de travail principal de la session à la place.

Avant v2.1.211, Claude Code gardait le fichier dans le répertoire de démarrage. Il lit toujours un fichier qu'une version antérieure a laissé là à côté du fichier racine ; où les deux définissent la même clé, la valeur de la racine s'applique, et les règles de permission des deux fichiers s'appliquent. L'assistant resolveSettings() du SDK Agent lit toujours le fichier à partir du répertoire de démarrage.

Claude Code lit le .claude/settings.json partagé à partir du répertoire de travail principal de la session, donc pour utiliser un fichier commité à la racine du dépôt, démarrez Claude Code là. Après avoir déplacé la session avec /cd, Claude Code lit les deux fichiers de projet à partir du nouveau répertoire à la place, plaçant le fichier local par les mêmes règles. Les lire à partir du répertoire vers lequel vous avez déplacé nécessite Claude Code v2.1.246 ou ultérieur. Pour une session worktree que vous démarrez à partir de l'application de bureau, voir Ce que les worktrees partagent avec le checkout principal.

Vérifiez ce que votre organisation applique

Si votre organisation gère Claude Code, certains paramètres sont décidés pour vous et rien de ce que vous mettez dans vos propres fichiers ne les change. Pour voir lesquels, exécutez /status : la ligne Setting sources nomme la source gérée qui s'applique à vous. Les paramètres gérés s'appliquent partout où Claude Code s'exécute sur cette machine ; Ce qu'un développeur peut modifier couvre les droits d'administrateur local et les outils autres que Claude Code.

Les paramètres gérés vous atteignent via les mécanismes de livraison sur la page des paramètres gérés, le plus souvent :

Dans une session Cowork qui s'exécute sur votre machine dans l'application Claude Desktop, Claude Code ne récupère pas les paramètres gérés par le serveur à partir de la console d'administration claude.ai, et il lit la politique déployée sur votre appareil sauf si la configuration Claude Desktop de votre organisation définit requireCoworkFullVmSandbox. Où et quand une politique s'applique couvre Cowork et les sessions cloud.

Si vous êtes l'administrateur, Configurez Claude Code pour votre organisation vous guide dans le choix de ce qu'il faut appliquer, et Déployez les paramètres gérés couvre la livraison et comment confirmer qu'une politique est en vigueur. Pour l'avertissement que l'éditeur de paramètres gérés de la console d'administration claude.ai peut afficher, voir Configurer les paramètres gérés par le serveur.

Modifiez un paramètre

Vous pouvez modifier un paramètre à partir du menu /config, en éditant un fichier de paramètres, ou pour une session à partir de la ligne de commande.

L'invite système de Claude Code n'est pas publiée. Pour donner à Claude des instructions permanentes, utilisez les fichiers CLAUDE.md ou l'indicateur --append-system-prompt.

Utilisez le menu /config

Exécutez /config à l'intérieur de Claude Code et ouvrez l'onglet Config. Il énumère un petit ensemble d'options personnelles comme le thème, le mode éditeur, et la sortie détaillée, pas chaque clé de paramètres. Sélectionnez une option pour la modifier ; Claude Code l'enregistre pour vous :

  • La plupart des options : ~/.claude/settings.json
  • Quelques options, comme Afficher les conseils : .claude/settings.local.json
  • Les options de configuration globale : ~/.claude.json

Pour définir une option sans le menu, passez key=value, comme /config verbose=true.

[!NOTE]

/config fait partie de l'interface du terminal. Le panneau de chat VS Code et l'application de bureau ne l'ouvrent pas ; modifiez les paramètres là en éditant un fichier de paramètres ou via les paramètres propres de ces applications.

Éditez un fichier de paramètres

Ouvrez le fichier de paramètres pour la portée que vous voulez dans votre éditeur et ajoutez ou modifiez une clé. Les fichiers de paramètres sont du JSON strict : un commentaire // ou une virgule finale est une erreur de syntaxe, et Claude Code signale le fichier comme une Erreur de paramètres au prochain démarrage. Par exemple, pour laisser Claude Code exécuter vos commandes lint et test sans demander et l'empêcher de lire les fichiers .env, ajoutez ceci à ~/.claude/settings.json :

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

Chaque entrée sous permissions est une règle qui nomme un outil et ce qu'il peut faire ; Configurer les permissions explique la syntaxe. La ligne $schema pointe vers le schéma JSON publié pour les paramètres Claude Code, qui vous donne l'autocomplétion et la validation en ligne dans VS Code, Cursor, et tout autre éditeur qui supporte le schéma JSON. Le schéma peut être en retard par rapport aux versions CLI les plus récentes, donc un avertissement de validation sur une clé récemment documentée ne signifie pas que votre configuration est invalide.

Après avoir enregistré, exécutez /status à l'intérieur de Claude Code pour confirmer que le fichier a été chargé ; Confirmez ce qui a été chargé dit ce que la ligne Setting sources affiche et comment un fichier cassé est signalé.

Pour un fichier personnel complet, un fichier d'équipe, et un fichier d'organisation, chacun affiché avec un commentaire sur chaque clé qu'il définit, voir les fichiers de paramètres d'exemple.

Modifiez un paramètre pour une session

Pour essayer une valeur sans l'enregistrer, définissez-la quand vous démarrez Claude Code. La valeur s'applique à cette session et vos fichiers de paramètres restent comme ils étaient. Vous avez trois façons de le faire :

  • --settings : passez une clé en JSON, en ligne ou comme chemin vers un fichier. Claude Code l'applique au-dessus de vos fichiers utilisateur, projet et locaux et en dessous des paramètres gérés. Il peut définir n'importe quelle clé que votre fichier de paramètres utilisateur peut définir ; il ne peut pas définir les clés Managed ou Global config.
  • Un indicateur pour cette clé : certaines clés ont leur propre indicateur, comme --model pour model et --effort pour effortLevel et modelSettings.
  • Une variable d'environnement : exportez la variable appairée de la clé avant d'exécuter claude, comme ANTHROPIC_MODEL pour model.

L'entrée de chaque clé sur la référence des paramètres énumère ses remplacements par session et lequel a la priorité, donc vérifiez l'entrée pour la clé que vous voulez modifier.

Les commandes que vous exécutez à l'intérieur d'une session enregistrent généralement votre choix : quand vous modifiez un paramètre dans /config, Claude Code l'écrit dans vos fichiers de paramètres, et /model enregistre la valeur comme votre défaut pour les nouvelles sessions.

Si vous appuyez sur s dans le sélecteur /model, Claude Code bascule le modèle sans l'enregistrer comme votre défaut utilisateur. Ajustez le niveau d'effort indique quels choix /effort Claude Code enregistre comme votre défaut pour le modèle que vous utilisez et lesquels s'appliquent à la session actuelle uniquement.

Par exemple, pour démarrer une session sur Opus sans modifier votre défaut :

claude --settings '{"model": "claude-opus-5-5"}'

Quand les modifications prennent effet

Claude Code surveille vos fichiers de paramètres et les recharge quand ils changent, donc il applique la plupart des modifications à la session en cours sans redémarrage, y compris les modifications à permissions, hooks, et les assistants d'identifiants comme apiKeyHelper. Claude Code charge aussi un fichier de paramètres que vous créez en session si son répertoire existait quand la session a commencé. Pour le dossier .claude/ du projet, il charge le fichier même quand vous créez le dossier dans la même session.

Le rechargement couvre les paramètres utilisateur, projet, locaux et gérés, et Claude Code exécute le hook ConfigChange pour chaque changement de fichier de paramètres qu'il détecte, pas pour les paramètres gérés qui arrivent de MDM ou de la console claude.ai. Les paramètres gérés qui arrivent via MDM ou de la console claude.ai atteignent une session en cours selon un calendrier plutôt que sur enregistrement ; le tableau de livraison le donne par source.

Claude Code lit certaines clés une seule fois, au démarrage de la session, donc une modification à l'une d'elles n'atteint pas la session en cours. Les clés côté administrateur qui attendent aussi un redémarrage, comme requiredMinimumVersion, sont énumérées sous où et quand une politique s'applique. Celles que vous êtes le plus susceptible de modifier en session :

Confirmez ce qui a été chargé

Exécutez /status à l'intérieur de Claude Code pour voir quelles sources de paramètres sont actives. L'onglet Status inclut une ligne Setting sources qui énumère chaque fichier de paramètres que Claude Code a chargé pour la session actuelle, comme User settings ou Project local settings. Quand les paramètres gérés sont en vigueur, l'entrée des paramètres gérés affiche entre parenthèses comment ils ont atteint votre machine.

La ligne confirme quels fichiers Claude Code a lus ; elle n'affiche pas quel fichier a fourni chaque clé. Pour énumérer les entrées que Claude Code a rejetées, exécutez claude doctor ; pour un modèle que les paramètres de projet ou gérés définissent, l'en-tête de démarrage nomme le fichier qui l'a défini. /status et /config ouvrent le même dialogue sur des onglets différents, et l'onglet Config n'est pas une vue de vos contenus settings.json.

Réparez un fichier de paramètres cassé

Si vous faites une erreur de frappe JSON ou définissez une clé à une valeur que Claude Code n'accepte pas, Claude Code vous le dit au début d'une session interactive. Ce qu'il affiche dépend de la quantité du fichier affectée :

  • Erreur de paramètres : un fichier utilisateur, projet ou local a du JSON invalide ou une valeur que le schéma rejette. Au début d'une session interactive, Claude Code affiche un dialogue qui vous permet de corriger le fichier avec l'aide de Claude, de quitter, ou de continuer sans les paramètres cassés.
  • Avertissement de paramètres : seules les entrées individuelles échouent, comme une règle de permission mal formée ou un nom d'événement hook inconnu. Claude Code ignore ces valeurs et garde le reste du fichier en vigueur.
  • Paramètres gérés : Claude Code continue d'appliquer le reste du fichier. Les entrées invalides dans les paramètres gérés dit ce qu'il supprime et quelles clés reviennent à une valeur plus stricte jusqu'à ce que vous les corrigiez. Pour un document de paramètres gérés qui n'est pas du JSON valide, voir Le document de paramètres gérés n'a pas pu être analysé.
  • Erreur de configuration : ~/.claude.json ne peut pas être analysé. Claude Code copie le fichier cassé à ~/.claude/backups/.claude.json.corrupted.<timestamp> et demande si vous voulez quitter et le corriger à la main ou réinitialiser à la configuration par défaut ; une exécution -p imprime l'erreur et quitte. Pour récupérer votre état précédent, copiez l'un des cinq fichiers .claude.json.backup.<timestamp> les plus récents dans ~/.claude/backups/, que Claude Code enregistre avant d'écrire le fichier.

Après avoir continué, exécutez /status pour voir les fichiers affectés et claude doctor pour les détails de chaque erreur.

Une exécution -p n'affiche aucun dialogue. Sauf si un document de paramètres gérés ne peut pas être analysé, Claude Code ignore le fichier cassé ou les valeurs et continue avec le reste, donc après une exécution -p qui ignore un paramètre, exécutez claude doctor pour voir ce qu'il a supprimé.

Priorité des paramètres

Quand la même clé apparaît à plus d'un endroit, Claude Code utilise la valeur du niveau le plus élevé qui la définit. La pile ci-dessous montre les niveaux, le plus élevé en haut ; une clé à un niveau plus élevé remplace la même clé n'importe où en dessous.

Settings precedence, highest first: managed settings, command line, project local, shared project, user. A key set at a higher level overrides the same key set lower down.

En ordre, priorité la plus élevée en premier :

  1. Paramètres gérés : paramètres que votre organisation déploie, par un fichier managed-settings.json, une politique MDM, ou paramètres gérés par le serveur à partir de la console claude.ai. Rien dans vos propres fichiers de paramètres ni dans --settings ne remplace une clé gérée, et un flag comme --model choisit uniquement parmi les modèles que votre organisation autorise. Un model géré est une valeur par défaut de départ, pas un verrou ; les verrous sont availableModels et deniedModels. Quand votre organisation fournit plus d'une source gérée, les règles de priorité au sein du niveau géré indiquent ce que Claude Code lit à partir de chacune.
  2. Ligne de commande : le JSON que vous passez avec --settings <file-or-json> quand vous démarrez claude, pour cette session uniquement ; voir Modifiez un paramètre pour une session. Une clé que vous y définissez remplace la même clé dans vos fichiers de paramètres de projet et utilisateur, et une clé que vous omettez garde la valeur issue de ces fichiers. D'autres flags, comme --model, définissent une seule chose pour la session et ne font pas partie de cette pile ; l'entrée d'une clé dans la référence des paramètres indique quels flags la remplacent.
  3. Paramètres de projet local (.claude/settings.local.json) : vos paramètres personnels pour ce projet.
  4. Paramètres de projet partagés (.claude/settings.json) : paramètres que votre équipe valide dans le contrôle de source.
  5. Paramètres utilisateur (~/.claude/settings.json) : vos paramètres personnels pour chaque projet.

Les variables d'environnement ne sont pas un niveau dans cette pile. Quand un comportement a à la fois une variable shell et une clé de paramètres, lequel s'applique est décidé par paire, pas par niveau : ANTHROPIC_MODEL exportée dans votre shell s'applique sur la clé model à partir de n'importe quel fichier, tandis que ANTHROPIC_DEFAULT_MODEL s'applique uniquement quand aucun fichier ne définit model. La référence des variables d'environnement dit quelles clés ont une paire et lequel Claude Code lit en premier. Un bloc env à l'intérieur d'un fichier de paramètres est une clé ordinaire et suit les niveaux ci-dessus.

Pour quelques clés sensibles à la sécurité, Claude Code honore une valeur plus stricte d'un niveau inférieur sur une valeur gérée ; Exceptions à la priorité des paramètres gérés les énumère.

Les listes fusionnent au lieu de remplacer

Quand vous définissez la même clé de liste, comme permissions.allow, dans plus d'un fichier, Claude Code combine les listes au lieu de choisir une, donc chaque fichier peut ajouter des entrées sans supprimer celles d'un autre fichier. Quatre clés qui contiennent des listes de modèles ou des entrées par modèle suivent leurs propres règles :

  • fallbackModel est une chaîne ordonnée où la position porte du sens, donc Claude Code prend la valeur entière du fichier de priorité la plus élevée qui la définit.
  • modelPicker contient une liste ordonnée de lignes plus un flag de remplacement, donc Claude Code ne fusionne jamais les lignes de deux sources. Il prend la valeur entière du plus élevé des paramètres gérés, --settings, et des paramètres utilisateur qui la définit, et ignore la clé dans les paramètres de projet et locaux. Nécessite Claude Code v2.1.242 ou ultérieur.
  • availableModels : quand les paramètres gérés que Claude Code applique la définissent, Claude Code applique cette liste telle quelle et ignore les entrées que vous ajoutez dans les paramètres utilisateur, projet ou locaux, sauf si une application qui intègre Claude Code fournit sa propre liste de modèles ; voir Exceptions à la priorité des paramètres gérés. Entre les sources gérées, la liste ne fusionne jamais non plus ; comment Claude Code combine les sources gérées dit quelle liste de source s'applique. Entre les portées non gérées, Claude Code fusionne les tableaux comme d'habitude.
  • modelSettings : Claude Code la résout un modèle à la fois, avec effortLevel. L'entrée modelSettings indique de quel fichier provient la valeur qui s'applique à un modèle.

Exemples de priorité

Pendant que Claude travaille, Claude Code affiche un conseil d'une ligne sous le spinner, comme « Utilisez /config pour modifier votre mode de permission par défaut (y compris le mode plan) ». Supposons que vous vouliez ces conseils désactivés, donc vous définissez spinnerTipsEnabled à false dans ~/.claude/settings.json. Chaque scénario ci-dessous est quelque chose qui peut les réactiver, et ce que vous pouvez faire à ce sujet.

Les paramètres d'équipe remplacent les paramètres personnels

Le .claude/settings.json de votre équipe le définit à true. Claude Code utilise la valeur du projet parce que le projet partagé se situe au-dessus de l'utilisateur, donc vous voyez des conseils dans ce projet et nulle part ailleurs.

Vous pouvez récupérer votre valeur : ajoutez "spinnerTipsEnabled": false à .claude/settings.local.json dans ce projet. Le projet local se situe au-dessus du projet partagé, donc vos sessions là-bas arrêtent d'afficher des conseils et les sessions de vos coéquipiers ne changent pas.

Les paramètres de l'organisation remplacent tout

Les paramètres gérés de votre organisation le définissent à true. Rien de ce que vous mettez dans les paramètres utilisateur, projet ou locaux n'éteint les conseils, et non plus --settings. Géré est le niveau le plus élevé.

Vous ne pouvez pas récupérer votre valeur. Exécutez /status pour voir quelle source gérée s'applique, et demandez à votre administrateur si la politique devrait changer.

La ligne de commande remplace vos fichiers pour une session

Vous avez démarré la session avec claude --settings '{"spinnerTipsEnabled": true}'. La ligne de commande se situe au-dessus de chaque fichier sauf géré, donc cette session affiche des conseils même si vos fichiers disent false.

Vous récupérez votre valeur à la session suivante ; --settings dure une session et n'écrit dans aucun fichier.

Un flag ou une variable d'environnement définit la même chose

Certaines clés ont un flag de ligne de commande ou une variable d'environnement qui remplace la valeur des paramètres indépendamment du fichier qui l'a défini : ANTHROPIC_MODEL remplace le paramètre model, et --model remplace les deux pour une session.

Que vous puissiez récupérer votre valeur dépend de la clé : supprimez la variable ou retirez le flag, et vérifiez l'entrée de la clé sur la référence des paramètres et la ligne de la variable sur la référence des variables d'environnement pour lequel Claude Code utilise.

Dépannez un paramètre qui ne s'applique pas

Quand vous définissez une clé et que Claude Code ne se comporte pas comme si vous l'aviez, commencez par /status pour voir quels fichiers il a chargés, puis trouvez votre symptôme ci-dessous. Déboguer votre configuration couvre les vérifications plus larges, y compris un test de configuration propre.

Une valeur que vous avez définie est ignorée

Quelque chose d'autre définit la même clé, le fichier ne peut pas définir cette valeur, ou le fichier n'a pas été chargé :

  • Un niveau plus élevé la définit. Un autre fichier de paramètres, un flag --settings, ou une source gérée définit la clé au-dessus de la vôtre ; la pile dit lequel. Un flag ou une variable d'environnement peut aussi remplacer la clé de son propre chef, décidé clé par clé ; l'entrée de la clé sur la référence des paramètres dit lequel Claude Code utilise, et l'entrée env couvre une valeur env gérée par rapport à une exportation shell.

  • Une clé de sécurité garde sa valeur stricte. Pour quelques clés, Claude Code honore la valeur restrictive à partir de n'importe quel fichier, donc un true de projet pour disableClaudeAiConnectors reste activé ; voir Exceptions à la priorité des paramètres gérés.

  • Le fichier ne peut pas définir cette valeur. Les valeurs permissions.defaultMode auto et bypassPermissions ne prennent pas effet à partir des paramètres de projet ou locaux ; définissez-les dans les paramètres utilisateur ou gérés à la place, ou passez --permission-mode pour une session. Avant v2.1.257, bypassPermissions prenait effet à partir de n'importe quel fichier.

    Une variable d'exportation de télémétrie dans un bloc env ne prend pas effet à partir des paramètres de projet ou locaux non plus, à part quelques valeurs off. Variables que Claude Code ignore dans env énumère les variables et ces valeurs.

  • Le fichier est cassé. Du JSON invalide ou une valeur rejetée fait que Claude Code ignore le fichier ou l'entrée ; voir Réparez un fichier de paramètres cassé.

Un changement que vous avez fait dans Claude Code est perdu dans les nouvelles sessions

Quand vous enregistrez un choix pour les nouvelles sessions à partir de Claude Code, comme un modèle par défaut avec /model, Claude Code l'écrit dans votre fichier de paramètres utilisateur, ~/.claude/settings.json. Si vous ne pouvez pas écrire dans ce fichier, par exemple parce qu'un autre outil le génère ou le lie à une copie en lecture seule, le changement s'applique à la session actuelle et est parti à la session suivante. Définissez la clé dans l'outil qui génère le fichier, ou remplacez le fichier par un que vous pouvez écrire.

Si vous pouvez écrire dans le fichier et le changement ne dure toujours pas, vérifiez si le changement était pour une session uniquement ou un niveau plus élevé définit la même clé. Pour la clé model, Une nouvelle session démarre sur un modèle différent de celui que vous avez choisi énumère plus de causes.

Un changement géré ne vous a pas atteint

Les sources gérées atteignent une session en cours selon le calendrier du tableau de livraison, donc redémarrez d'abord la session. Si /status nomme alors une source différente de celle que votre administrateur a modifiée, une source de priorité plus élevée s'applique ; Comment Claude Code combine les sources gérées donne l'ordre.

Une clé validée n'atteint pas les coéquipiers

Deux choses empêchent une clé dans .claude/settings.json de s'appliquer pour tout le monde qui la clone :

  • Claude Code ignore la clé dans un fichier de dépôt. Cherchez User, local, or managed, User or managed, User, Managed, ou Global config dans la colonne Scope de l'index des paramètres. Ces clés ne s'appliquent jamais à partir du fichier partagé, à part quelques-unes qu'un fichier de dépôt peut toujours désactiver. Chacune de ces entrées le dit sur sa ligne Scope. Les clés Global config s'appliquent uniquement à partir de ~/.claude.json.

    À l'intérieur de la clé env, les variables d'exportation de télémétrie ne s'appliquent jamais à partir du fichier partagé non plus, à part quelques valeurs off ; voir Variables que Claude Code ignore dans env.

  • La clé attend la confiance. Les règles permissions.allow, permissions.additionalDirectories, extraKnownMarketplaces, et la plupart des valeurs env s'appliquent uniquement après que chaque coéquipier fasse confiance au dossier. Jusqu'à ce qu'ils le fassent, ils voient toujours des demandes de permission et n'obtiennent pas les plugins d'une marketplace que le fichier déclare. Les règles deny et ask s'appliquent immédiatement.

Les règles de permission se combinent différemment que vous ne l'attendiez

  • Vous avez choisi « Oui, et ne plus me demander » sur une demande de permission mais on vous demande toujours la permission pour le même outil. Ce choix a enregistré une règle allow dans votre fichier local, et une règle allow là ne surclasse pas une règle ask à partir d'un fichier de projet ou géré ; comment les règles de permission se combinent explique l'ordre. Dans l'extension VS Code, la carte d'approbation vous permet de choisir le fichier de destination, y compris le fichier partagé du projet, ce qui change la règle pour tout le monde ; dans la CLI, Claude Code écrit uniquement dans votre fichier local.
  • Les règles allow de votre organisation s'appliquent toujours à côté des vôtres. C'est attendu : Claude Code fusionne permissions.allow entre les portées, sauf si votre organisation définit allowManagedPermissionRulesOnly.

Exceptions à la priorité des paramètres gérés

Pour quelques clés dont les valeurs restreignent une session, Claude Code honore une valeur restrictive d'une portée qui ne pourrait autrement pas remplacer les paramètres gérés. Trouvez la clé dans ce tableau pour voir quelle valeur elle honore et d'où.

Clé Valeur que Claude Code honore Notes
disableClaudeAiConnectors true à partir de n'importe quelle portée Honorée même quand une source gérée définit false
enableArtifact false à partir de n'importe quelle portée, et disableArtifact: true à partir de n'importe quelle portée Honorée même quand une source gérée définit true ; rien ne réactive l'outil Artifact. Nécessite Claude Code v2.1.242 ou ultérieur
isolatePeerMachines true à partir de n'importe quelle portée Honorée même quand une source gérée définit false
permissions.blockReadsOutsideWorkingDirectories true à partir de n'importe quelle portée Honorée même quand une source gérée définit false. Nécessite Claude Code v2.1.257 ou ultérieur
autoMode.classifyAllShell true à partir de ~/.claude/settings.json ou --settings Honorée même quand une source gérée définit false
remoteControlAtStartup false à partir de .claude/settings.json ou .claude/settings.local.json Honorée même quand une source gérée définit true ; un true de projet ou local est ignoré
crossSessionInbound Une valeur plus stricte à partir de .claude/settings.json ou .claude/settings.local.json, sur l'échelle accept < hold < refuse Honorée sur les valeurs gérées, --settings, et utilisateur ; une valeur de projet ou local qui n'est pas plus stricte est ignorée
useAutoModeDuringPlan false à partir de n'importe quelle source gérée, --settings, ~/.claude/settings.json, ou .claude/settings.local.json Honorée même quand la source gérée gagnante définit true ; un false dans .claude/settings.json est ignoré
syncClaudeAiSkills false à partir de n'importe quelle source gérée, --settings, ~/.claude/settings.json, ou .claude/settings.local.json Honorée même quand la source gérée gagnante définit true ; un false dans .claude/settings.json est ignoré
syncClaudeAiPlugins false à partir de n'importe quelle source gérée, --settings, ~/.claude/settings.json, ou .claude/settings.local.json Honorée même quand la source gérée gagnante définit true ; un false dans .claude/settings.json est ignoré
maxEffortLevel Un plafond inférieur à partir de n'importe quelle portée, y compris --settings Honorée même quand les paramètres gérés que Claude Code applique définissent un plafond plus élevé ; le plafond le plus bas s'applique. Nécessite Claude Code v2.1.267 ou ultérieur

Une application qui exécute Claude Code à l'intérieur d'elle-même et définit CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST est aussi une exception. Claude Code prend la configuration de modèle de cette application sur les clés model, fallbackModel, modelPicker, et modelOverrides à partir de chaque source gérée, et sur les variables de sélection de modèle dans un bloc env géré, comme ANTHROPIC_MODEL et la famille ANTHROPIC_DEFAULT_*_MODEL. Claude Code garde une liste d'autorisation availableModels gérée en vigueur sauf si l'application fournit la sienne.

Paramètres dans les sessions cloud

Une session cloud s'exécute dans un environnement cloud sur un clone frais de votre référentiel, pas sur votre machine. Cela change quels paramètres l'atteignent :

  • Threads cloud dans un projet : dans un thread cloud d'un projet, aucune des règles de permission, aucun des hooks ni aucune des valeurs env du .claude/settings.json d'un dépôt ne s'applique, quel que soit le nombre de dépôts du projet. Ce que les threads récupèrent de vos dépôts énumère ce qu'il faut utiliser à la place.
  • Paramètres de projet partagés (.claude/settings.json) : lus dans une session avec un seul dépôt en dehors des threads d'un projet, car le fichier fait partie du clone et la session démarre à l'intérieur. Commitez un paramètre à cet endroit pour l'appliquer dans ces sessions.
  • Paramètres de projet partagés avec plusieurs dépôts : dans un environnement hébergé par Anthropic, une session avec plusieurs dépôts démarre au-dessus des clones et lit uniquement les clés enabledPlugins et extraKnownMarketplaces du .claude/settings.json de chaque dépôt, pas les règles de permission, les hooks, env, ou d'autres clés. Les marketplaces et les plugins que ces deux clés déclarent ne se chargent toujours pas dans une session cloud. Pour un environnement auto-hébergé, consultez les paramètres de quel dépôt s'appliquent.
  • Paramètres utilisateur et projet local (~/.claude/settings.json et .claude/settings.local.json) : non lus. Les deux restent sur votre machine, et le fichier local n'est pas dans le clone.
  • Paramètres gérés : un fichier managed-settings.json ou un profil MDM sur votre appareil ne parvient pas à une session cloud. Les paramètres gérés par le serveur de votre organisation le font ; la couverture de surface énumère quelles sessions cloud les reçoivent. Un environnement auto-hébergé lit aussi le fichier de paramètres gérés dans son image de runner. Comment Claude Code combine les sources gérées indique quand ce fichier s'applique.
  • /config : dans votre navigateur sur claude.ai/code, ouvre la section Claude Code de vos paramètres claude.ai à la place de modifier une valeur. Pour modifier un paramètre pour une session cloud, définissez une variable d'environnement sur l'environnement. Dans une session avec un seul dépôt en dehors des threads d'un projet, vous pouvez à la place commiter la clé dans le .claude/settings.json de ce dépôt.

Ce qui se transfère de votre configuration énumère le reste : CLAUDE.md, skills, serveurs MCP, plugins, et identifiants.

Quoi de neuf