Skip to main content
Cette page contient trois fichiers settings.json d’exemple, un pour chaque endroit où vous enregistrez un paramètre :
  • Un ~/.claude/settings.json de développeur
  • Un .claude/settings.json d’équipe, validé dans le référentiel
  • Un managed-settings.json d’organisation
Chacun est un fichier plausible pour ce lecteur, vous pouvez donc voir la forme et copier les parties que vous voulez. Aucun d’eux n’est une ligne de base recommandée. Chaque valeur provient de l’entrée de la clé sur la référence des paramètres, qui contient son type, sa valeur par défaut et l’endroit où elle peut être définie. Chaque exemple a deux onglets. Fichier de paramètres copiable est le fichier tel que vous l’enregistreriez. Ce que chaque clé fait est le même fichier avec un commentaire au-dessus de chaque clé ; Claude Code n’accepte pas les commentaires dans un fichier de paramètres, donc copiez à partir du premier onglet.

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.
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, télémétrie et marketplace de plugins. Enregistrez un fichier comme celui-ci à .claude/settings.json en haut du référentiel. Trois choses à savoir avant de valider un :
  • Les sessions cloud le lisent aussi. Une session cloud sur Claude Code sur le web démarre à partir d’un clone du référentiel, donc le fichier validé s’applique également là.
  • Les règles d’autorisation attendent la confiance. Les règles d’autorisation et les entrées extraKnownMarketplaces prennent 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.
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 fichier managed-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 :
  • forceLoginMethod et forceLoginOrgUUID épinglent la méthode de connexion et l’organisation
  • availableModels et enforceAvailableModels limitent les modèles que les sessions peuvent utiliser
  • permissions.deny bloque deux lectures de fichiers et curl, et disableBypassPermissionsMode supprime le mode de permission de contournement
  • allowManagedPermissionRulesOnly et allowManagedMcpServersOnly font des listes blanches de permission et MCP gérées les seules qui s’appliquent
  • allowedMcpServers épingle le serveur MCP par URL
  • strictKnownMarketplaces autorise un marketplace de plugins
  • sandbox bac à sable les commandes avec une liste d’autorisation réseau fixe et pas de nouvelle tentative non bac à sable
  • requiredMinimumVersion définit une version minimale de Claude Code
  • cleanupPeriodDays raccourcit la rétention des transcriptions de session et autres données locales à sept jours
  • companyAnnouncements affiche un message au démarrage
Les administrateurs déploient un fichier comme celui-ci en tant que 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.
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