Paramètres Claude Code

​

Portées de configuration

​

Portées disponibles

​

Quand utiliser chaque portée

• Les politiques de sécurité qui doivent être appliquées à l’échelle de l’organisation
• Les exigences de conformité qui ne peuvent pas être contournées
• Les configurations standardisées déployées par l’IT/DevOps

• Les préférences personnelles que vous voulez partout (thèmes, paramètres d’éditeur)
• Les outils et plugins que vous utilisez sur tous les projets
• Les clés API et l’authentification (stockées de manière sécurisée)

• Les paramètres partagés par l’équipe (permissions, hooks, serveurs MCP)
• Les plugins que toute l’équipe devrait avoir
• La standardisation des outils entre collaborateurs

• Les remplacements personnels pour un projet spécifique
• Les configurations de test avant de les partager avec l’équipe
• Les paramètres spécifiques à la machine qui ne fonctionneront pas pour les autres

​

Comment les portées interagissent

1. Managed (la plus élevée) - ne peut pas être remplacée par quoi que ce soit
2. Arguments de ligne de commande - remplacements de session temporaires
3. Local - remplace les paramètres du projet et de l’utilisateur
4. Project - remplace les paramètres de l’utilisateur
5. User (la plus basse) - s’applique quand rien d’autre ne spécifie le paramètre

​

Ce qui utilise les portées

​

Fichiers de paramètres

• Les paramètres utilisateur sont définis dans ~/.claude/settings.json et s’appliquent à tous les projets.
• Les paramètres du projet sont enregistrés dans votre répertoire de projet :
  • .claude/settings.json pour les paramètres qui sont vérifiés dans le contrôle de source et partagés avec votre équipe
  • .claude/settings.local.json pour les paramètres qui ne sont pas vérifiés, utiles pour les préférences personnelles et l’expérimentation. Claude Code configurera git pour ignorer .claude/settings.local.json lors de sa création.
• Paramètres gérés : Pour les organisations qui ont besoin d’un contrôle centralisé, Claude Code prend en charge plusieurs mécanismes de livraison pour les paramètres gérés. Tous utilisent le même format JSON et ne peuvent pas être remplacés par les paramètres utilisateur ou du projet :
  • Paramètres gérés par le serveur : livrés depuis les serveurs d’Anthropic via la console d’administration Claude.ai. Voir paramètres gérés par le serveur.
  • Politiques MDM/au niveau du système d’exploitation : livrées via la gestion native des appareils sur macOS et Windows :
    • macOS : domaine de préférences gérées com.anthropic.claudecode (déployé via des profils de configuration dans Jamf, Kandji ou d’autres outils MDM)
    • Windows : clé de registre HKLM\SOFTWARE\Policies\ClaudeCode avec une valeur Settings (REG_SZ ou REG_EXPAND_SZ) contenant du JSON (déployé via la stratégie de groupe ou Intune)
    • Windows (au niveau utilisateur) : HKCU\SOFTWARE\Policies\ClaudeCode (priorité de politique la plus basse, utilisée uniquement quand aucune source au niveau administrateur n’existe)
  • Basé sur fichier : managed-settings.json et managed-mcp.json déployés dans les répertoires système :
    • macOS : /Library/Application Support/ClaudeCode/
    • Linux et WSL : /etc/claude-code/
    • Windows : C:\Program Files\ClaudeCode\
  Voir paramètres gérés et Configuration MCP gérée pour plus de détails.
  Les déploiements gérés peuvent également restreindre les ajouts de marketplace de plugins en utilisant strictKnownMarketplaces. Pour plus d’informations, voir Restrictions de marketplace gérées.
• Autre configuration est stockée dans ~/.claude.json. Ce fichier contient vos préférences (thème, paramètres de notification, mode d’éditeur), session OAuth, configurations de serveur MCP pour les portées utilisateur et locale, état par projet (outils autorisés, paramètres de confiance), et divers caches. Les serveurs MCP à portée de projet sont stockés séparément dans .mcp.json.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  },
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
    "Reminder: Code reviews required for all PRs",
    "New security policy in effect"
  ]
}

​

Paramètres disponibles

​

Paramètres de permission

​

Syntaxe des règles de permission

​

Paramètres de sandbox

​

Préfixes de chemin du sandbox

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

• Paramètres sandbox.filesystem (affichés ci-dessus) : Contrôlez les chemins à la limite du sandbox au niveau du système d’exploitation. Ces restrictions s’appliquent à toutes les commandes de sous-processus (par exemple, kubectl, terraform, npm), pas seulement aux outils de fichier de Claude.
• Règles de permission : Utilisez les règles allow/deny Edit pour contrôler l’accès à l’outil de fichier de Claude, les règles deny Read pour bloquer les lectures, et les règles allow/deny WebFetch pour contrôler les domaines réseau. Les chemins de ces règles sont également fusionnés dans la configuration du sandbox.

​

Paramètres d’attribution

• Les commits utilisent les trailers git (comme Co-Authored-By) par défaut, qui peuvent être personnalisés ou désactivés
• Les descriptions des demandes de tirage sont du texte brut

🤖 Generated with [Claude Code](https://claude.com/claude-code)

   Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI <[email protected]>",
    "pr": ""
  }
}

​

Paramètres de suggestion de fichier

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

{"query": "src/comp"}

src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx

#!/bin/bash
query=$(cat | jq -r '.query')
your-repo-file-index --query "$query" | head -20

​

Configuration des hooks

• Les hooks gérés et les hooks SDK sont chargés
• Les hooks utilisateur, projet et plugin sont bloqués

{
  "allowedHttpHookUrls": ["https://hooks.example.com/*", "http://localhost:*"]
}

{
  "httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]
}

​

Précédence des paramètres

1. Paramètres gérés (gérés par le serveur, politiques MDM/au niveau du système d’exploitation, ou paramètres gérés)
   • Politiques déployées par l’IT via la livraison par serveur, les profils de configuration MDM, les politiques de registre ou les fichiers de paramètres gérés
   • Ne peuvent pas être remplacés par aucun autre niveau, y compris les arguments de ligne de commande
   • Au sein du niveau géré, la précédence est : gérés par le serveur > politiques MDM/au niveau du système d’exploitation > managed-settings.json > registre HKCU (Windows uniquement). Une seule source gérée est utilisée ; les sources ne fusionnent pas.
2. Arguments de ligne de commande
   • Remplacements temporaires pour une session spécifique
3. Paramètres du projet local (.claude/settings.local.json)
   • Paramètres personnels spécifiques au projet
4. Paramètres du projet partagé (.claude/settings.json)
   • Paramètres du projet partagés par l’équipe dans le contrôle de source
5. Paramètres utilisateur (~/.claude/settings.json)
   • Paramètres globaux personnels

​

Vérifier les paramètres actifs

​

Points clés du système de configuration

• Fichiers de mémoire (CLAUDE.md) : Contiennent les instructions et le contexte que Claude charge au démarrage
• Fichiers de paramètres (JSON) : Configurez les permissions, les variables d’environnement et le comportement des outils
• Skills : Invites personnalisées qui peuvent être invoquées avec /skill-name ou chargées automatiquement par Claude
• Serveurs MCP : Étendez Claude Code avec des outils et des intégrations supplémentaires
• Précédence : Les configurations de niveau supérieur (Managed) remplacent celles de niveau inférieur (User/Project)
• Héritage : Les paramètres sont fusionnés, les paramètres plus spécifiques s’ajoutant à ou remplaçant les paramètres plus larges

​

Invite système

​

Exclure les fichiers sensibles

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

​

Configuration des subagents

• Subagents utilisateur : ~/.claude/agents/ - Disponibles sur tous vos projets
• Subagents du projet : .claude/agents/ - Spécifiques à votre projet et peuvent être partagés avec votre équipe

​

Configuration des plugins

​

Paramètres des plugins

{
  "enabledPlugins": {
    "formatter@acme-tools": true,
    "deployer@acme-tools": true,
    "analyzer@security-plugins": false
  },
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": "github",
      "repo": "acme-corp/claude-plugins"
    }
  }
}

​

enabledPlugins

• Paramètres utilisateur (~/.claude/settings.json) : Préférences personnelles des plugins
• Paramètres du projet (.claude/settings.json) : Plugins spécifiques au projet partagés avec l’équipe
• Paramètres locaux (.claude/settings.local.json) : Remplacements par machine (non commités)

{
  "enabledPlugins": {
    "code-formatter@team-tools": true,
    "deployment-tools@team-tools": true,
    "experimental-features@personal": false
  }
}

​

extraKnownMarketplaces

1. Les membres de l’équipe sont invités à installer la marketplace lorsqu’ils font confiance au dossier
2. Les membres de l’équipe sont ensuite invités à installer les plugins de cette marketplace
3. Les utilisateurs peuvent ignorer les marketplaces ou les plugins indésirables (stockés dans les paramètres utilisateur)
4. L’installation respecte les limites de confiance et nécessite un consentement explicite

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": {
        "source": "github",
        "repo": "acme-corp/claude-plugins"
      }
    },
    "security-plugins": {
      "source": {
        "source": "git",
        "url": "https://git.example.com/security/plugins.git"
      }
    }
  }
}

• github : Référentiel GitHub (utilise repo)
• git : N’importe quelle URL git (utilise url)
• directory : Chemin du système de fichiers local (utilise path, pour le développement uniquement)
• hostPattern : Modèle regex pour correspondre aux hôtes de marketplace (utilise hostPattern)

​

strictKnownMarketplaces

• macOS : /Library/Application Support/ClaudeCode/managed-settings.json
• Linux et WSL : /etc/claude-code/managed-settings.json
• Windows : C:\Program Files\ClaudeCode\managed-settings.json

• Disponible uniquement dans les paramètres gérés (managed-settings.json)
• Ne peut pas être remplacé par les paramètres utilisateur ou projet (priorité la plus élevée)
• Appliqué AVANT les opérations de réseau/système de fichiers (les sources bloquées ne s’exécutent jamais)
• Utilise la correspondance exacte pour les spécifications de source (y compris ref, path pour les sources git), sauf hostPattern, qui utilise la correspondance regex

• undefined (par défaut) : Pas de restrictions - les utilisateurs peuvent ajouter n’importe quelle marketplace
• Tableau vide [] : Verrouillage complet - les utilisateurs ne peuvent pas ajouter de nouvelles marketplaces
• Liste de sources : Les utilisateurs ne peuvent ajouter que les marketplaces qui correspondent exactement

1. Référentiels GitHub :

{ "source": "github", "repo": "acme-corp/approved-plugins" }
{ "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }

2. Référentiels Git :

{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }
{ "source": "git", "url": "https://bitbucket.org/acme-corp/plugins.git", "ref": "production" }
{ "source": "git", "url": "ssh://[email protected]/plugins.git", "ref": "v3.1", "path": "approved" }

3. Marketplaces basées sur URL :

{ "source": "url", "url": "https://plugins.example.com/marketplace.json" }
{ "source": "url", "url": "https://cdn.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }

4. Packages NPM :

{ "source": "npm", "package": "@acme-corp/claude-plugins" }
{ "source": "npm", "package": "@acme-corp/approved-marketplace" }

5. Chemins de fichier :

{ "source": "file", "path": "/usr/local/share/claude/acme-marketplace.json" }
{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }

6. Chemins de répertoire :

{ "source": "directory", "path": "/usr/local/share/claude/acme-plugins" }
{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }

7. Correspondance de modèle d’hôte :

{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
{ "source": "hostPattern", "hostPattern": "^gitlab\\.internal\\.example\\.com$" }

• github : correspond toujours à github.com
• git : extrait le nom d’hôte de l’URL (prend en charge les formats HTTPS et SSH)
• url : extrait le nom d’hôte de l’URL
• npm, file, directory : non pris en charge pour la correspondance de modèle d’hôte

{
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "acme-corp/approved-plugins"
    },
    {
      "source": "github",
      "repo": "acme-corp/security-tools",
      "ref": "v2.0"
    },
    {
      "source": "url",
      "url": "https://plugins.example.com/marketplace.json"
    },
    {
      "source": "npm",
      "package": "@acme-corp/compliance-plugins"
    }
  ]
}

{
  "strictKnownMarketplaces": []
}

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

• Le repo ou url doit correspondre exactement
• Le champ ref doit correspondre exactement (ou les deux être non définis)
• Le champ path doit correspondre exactement (ou les deux être non définis)

// Ce sont des sources DIFFÉRENTES :
{ "source": "github", "repo": "acme-corp/plugins" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }

// Ce sont aussi DIFFÉRENTES :
{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }
{ "source": "github", "repo": "acme-corp/plugins" }

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/plugins" }
  ]
}

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "acme-corp/plugins" }
    }
  }
}

• Les restrictions sont vérifiées AVANT toute demande réseau ou opération du système de fichiers
• Lorsqu’elles sont bloquées, les utilisateurs voient des messages d’erreur clairs indiquant que la source est bloquée par la politique gérée
• La restriction s’applique uniquement à l’ajout de NOUVELLES marketplaces ; les marketplaces précédemment installées restent accessibles
• Les paramètres gérés ont la priorité la plus élevée et ne peuvent pas être remplacés

​

Gestion des plugins

• Parcourir les plugins disponibles à partir des marketplaces
• Installer/désinstaller les plugins
• Activer/désactiver les plugins
• Afficher les détails du plugin (commandes, agents, hooks fournis)
• Ajouter/supprimer les marketplaces

​

Variables d’environnement

​

Outils disponibles pour Claude

​

Comportement de l’outil Bash

• Le répertoire de travail persiste : Lorsque Claude change le répertoire de travail (par exemple, cd /path/to/dir), les commandes Bash suivantes s’exécutent dans ce répertoire. Vous pouvez utiliser CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1 pour réinitialiser le répertoire du projet après chaque commande.
• Les variables d’environnement ne persistent PAS : Les variables d’environnement définies dans une commande Bash (par exemple, export MY_VAR=value) ne sont pas disponibles dans les commandes Bash suivantes. Chaque commande Bash s’exécute dans un environnement shell frais.

conda activate myenv
# ou : source /path/to/venv/bin/activate
claude

export CLAUDE_ENV_FILE=/path/to/env-setup.sh
claude

conda activate myenv
# ou : source /path/to/venv/bin/activate
# ou : export MY_VAR=value

{
  "hooks": {
    "SessionStart": [{
      "matcher": "startup",
      "hooks": [{
        "type": "command",
        "command": "echo 'conda activate myenv' >> \"$CLAUDE_ENV_FILE\""
      }]
    }]
  }
}

​

Extension des outils avec des hooks

​

Voir aussi

• Permissions : système de permissions, syntaxe des règles, modèles spécifiques aux outils et politiques gérées
• Authentification : configurer l’accès utilisateur à Claude Code
• Dépannage : solutions pour les problèmes de configuration courants