settings.json d’exemple, un pour chaque endroit où vous enregistrez un paramètre :
- Un
~/.claude/settings.jsonde développeur - Un
.claude/settings.jsond’équipe, validé dans le référentiel - Un
managed-settings.jsond’organisation
Vos propres paramètres
Les paramètres personnels d’un développeur. Il choisit un modèle et un effort, ajuste le terminal et pré-approuve une commande en lecture seule et une lecture de fichier. Tout ce qui n’est pas listé conserve sa valeur par défaut. Un fichier comme celui-ci va dans~/.claude/settings.json, où il s’applique à chaque projet que vous ouvrez.
- Fichier de paramètres copiable
- Ce que chaque clé fait
Enregistrez ceci sous
~/.claude/settings.json. C’est du JSON valide sans commentaires, vous pouvez donc le coller tel quel et supprimer les clés que vous ne voulez pas.~/.claude/settings.json
Paramètres partagés d’une équipe
Les paramètres partagés d’une équipe, validés dans le référentiel afin que tous ceux qui le clonent obtiennent les mêmes permissions, hooks et marketplace de plugins. Enregistrez un fichier comme celui-ci à.claude/settings.json en haut du référentiel. Ce qu’il faut savoir avant de valider un :
- Les sessions cloud le lisent aussi. Une session cloud démarre à partir d’un clone du référentiel, donc le fichier validé s’applique également là.
- La télémétrie va dans les paramètres gérés ou personnels. Claude Code ignore les variables d’exportateur OpenTelemetry dans les fichiers de paramètres d’un référentiel, à l’exception de certaines valeurs qui désactivent la télémétrie. Définissez-les dans les paramètres gérés de votre organisation, ou dans le fichier
~/.claude/settings.jsonde chaque personne. - Les règles d’autorisation attendent la confiance. Les règles d’autorisation et les entrées
extraKnownMarketplacesprennent effet après que chaque personne fasse confiance à ce dossier lui-même, pas seulement à un dossier parent ; les règles de refus et de demande s’appliquent dans chaque session, de confiance ou non. - Le hook est un script dans le référentiel. Le hook de ce fichier exécute
.claude/hooks/block-rm.sh; Comment un hook se résout explique comment l’écrire. - Les règles correspondent à la commande et au chemin tels qu’écrits.
Bash(git push *)ne correspond pas àgit -C . push.Read(./.env)seul arrête les outils de fichier et les commandes qui nomment le fichier, commecat .env, mais pasgrep -rexécuté sur le répertoire ; le blocsandboxdans ce fichier comble cette lacune, car le sandbox ajoute vos chemins de refusReadà ce que chaque commande en sandbox ne peut pas lire.
- Fichier de paramètres copiable
- Ce que chaque clé fait
Enregistrez ceci sous
.claude/settings.json en haut du référentiel et validez-le. C’est du JSON valide sans commentaires, vous pouvez donc le coller tel quel et supprimer les clés que vous ne voulez pas..claude/settings.json
Paramètres gérés d’une organisation
Un fichiermanaged-settings.json qui montre la forme des clés gérées, avec une valeur plausible pour chacune. Ce n’est pas une politique recommandée : choisissez les clés qui correspondent à vos propres exigences et définissez vos propres valeurs. L’exemple définit ces clés :
forceLoginMethodetforceLoginOrgUUIDépinglent la méthode de connexion et l’organisationavailableModelsetenforceAvailableModelslimitent les modèles que les sessions peuvent utiliserpermissions.denyrefuse deux lectures de fichiers et les commandescurlcomme Claude les écrit, etdisableBypassPermissionsModesupprime le mode de permission de contournementallowManagedPermissionRulesOnlyetallowManagedMcpServersOnlyfont des listes blanches de permission et MCP gérées les seules qui s’appliquentallowedMcpServersépingle le serveur MCP par URLstrictKnownMarketplacesautorise un marketplace de pluginssandboxexécute les commandes dans le sandbox avec une liste d’autorisation réseau fixe et sans nouvelle tentative hors du sandbox. Sa cléfailIfUnavailableempêche Claude Code de démarrer là où le sandbox ne peut pas s’exécuterrequiredMinimumVersiondéfinit une version minimale de Claude CodecleanupPeriodDaysraccourcit la rétention des transcriptions de session et autres données locales à sept jourscompanyAnnouncementsaffiche un message au démarrage
managed-settings.json, ou le même JSON via MDM ou paramètres gérés par serveur. Un fichier déployé s’applique à chaque machine ou compte qu’il atteint. Pour donner à un groupe des valeurs différentes, déployez un fichier ou un profil différent à ce groupe, car les paramètres gérés par serveur ne supportent pas encore la politique par groupe.
- Fichier de paramètres copiable
- Ce que chaque clé fait
Déployez ceci en tant que
managed-settings.json, ou le même JSON via MDM ou la console claude.ai. C’est du JSON valide sans commentaires ; remplacez l’UUID d’organisation d’exemple, l’URL du serveur et le marketplace par les vôtres et supprimez les clés que vous ne voulez pas.managed-settings.json