Paramètres de Claude Code

Claude Code offre une variété de paramètres pour configurer son comportement selon vos besoins. Vous pouvez configurer Claude Code en exécutant la commande /config lors de l’utilisation du REPL interactif.

​

Fichiers de paramètres

Le fichier settings.json est notre mécanisme officiel pour configurer Claude Code via des paramètres hiérarchiques :

• Les paramètres utilisateur sont définis dans ~/.claude/settings.json et s’appliquent à tous les projets.
• Les paramètres de projet sont sauvegardés dans votre répertoire de projet :
  • .claude/settings.json pour les paramètres qui sont versionné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 versionnés, utiles pour les préférences personnelles et l’expérimentation. Claude Code configurera git pour ignorer .claude/settings.local.json lorsqu’il est créé.
• Pour les déploiements d’entreprise de Claude Code, nous supportons également les paramètres de politique gérés d’entreprise. Ceux-ci prennent la précédence sur les paramètres utilisateur et de projet. Les administrateurs système peuvent déployer des politiques vers :
  • macOS : /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux et WSL : /etc/claude-code/managed-settings.json
  • Windows : C:\ProgramData\ClaudeCode\managed-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"
  }
}

​

Paramètres disponibles

settings.json supporte plusieurs options :

​

Paramètres de permissions

​

Précédence des paramètres

Les paramètres sont appliqués par ordre de précédence (du plus élevé au plus bas) :

1. Politiques gérées d’entreprise (managed-settings.json)

   • Déployées par IT/DevOps
   • Ne peuvent pas être remplacées

2. Arguments de ligne de commande

   • Remplacements temporaires pour une session spécifique

3. Paramètres de projet locaux (.claude/settings.local.json)

   • Paramètres personnels spécifiques au projet

4. Paramètres de projet partagés (.claude/settings.json)

   • Paramètres de projet partagés par l’équipe dans le contrôle de source

5. Paramètres utilisateur (~/.claude/settings.json)

   • Paramètres globaux personnels

Cette hiérarchie garantit que les politiques de sécurité d’entreprise sont toujours appliquées tout en permettant aux équipes et aux individus de personnaliser leur expérience.

​

Points clés sur le système de configuration

• Fichiers de mémoire (CLAUDE.md) : Contiennent des instructions et du contexte que Claude charge au démarrage
• Fichiers de paramètres (JSON) : Configurent les permissions, variables d’environnement et comportement des outils
• Commandes slash : Commandes personnalisées qui peuvent être invoquées pendant une session avec /nom-commande
• Serveurs MCP : Étendent Claude Code avec des outils et intégrations supplémentaires
• Précédence : Les configurations de niveau supérieur (Entreprise) remplacent celles de niveau inférieur (Utilisateur/Projet)
• Héritage : Les paramètres sont fusionnés, avec des paramètres plus spécifiques ajoutant ou remplaçant les plus généraux

​

Disponibilité du prompt système

​

Exclusion de fichiers sensibles

Pour empêcher Claude Code d’accéder aux fichiers contenant des informations sensibles (par exemple, clés API, secrets, fichiers d’environnement), utilisez le paramètre permissions.deny dans votre fichier .claude/settings.json :

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

Ceci remplace la configuration ignorePatterns dépréciée. Les fichiers correspondant à ces motifs seront complètement invisibles à Claude Code, empêchant toute exposition accidentelle de données sensibles.

​

Configuration de sous-agents

Claude Code supporte des sous-agents IA personnalisés qui peuvent être configurés aux niveaux utilisateur et projet. Ces sous-agents sont stockés comme fichiers Markdown avec frontmatter YAML :

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

Les fichiers de sous-agents définissent des assistants IA spécialisés avec des prompts personnalisés et des permissions d’outils. Apprenez-en plus sur la création et l’utilisation de sous-agents dans la documentation des sous-agents.

​

Variables d’environnement

Claude Code supporte les variables d’environnement suivantes pour contrôler son comportement :

​

Options de configuration

Pour gérer vos configurations, utilisez les commandes suivantes :

• Lister les paramètres : claude config list
• Voir un paramètre : claude config get <key>
• Changer un paramètre : claude config set <key> <value>
• Pousser vers un paramètre (pour les listes) : claude config add <key> <value>
• Supprimer d’un paramètre (pour les listes) : claude config remove <key> <value>

Par défaut config change votre configuration de projet. Pour gérer votre configuration globale, utilisez le drapeau --global (ou -g).

​

Configuration globale

Pour définir une configuration globale, utilisez claude config set -g <key> <value> :

​

Outils disponibles pour Claude

Claude Code a accès à un ensemble d’outils puissants qui l’aident à comprendre et modifier votre base de code :

Les règles de permission peuvent être configurées en utilisant /allowed-tools ou dans paramètres de permission.

​

Extension des outils avec des hooks

Vous pouvez exécuter des commandes personnalisées avant ou après l’exécution de tout outil en utilisant les hooks Claude Code.

Par exemple, vous pourriez automatiquement exécuter un formateur Python après que Claude modifie des fichiers Python, ou empêcher les modifications aux fichiers de configuration de production en bloquant les opérations Write vers certains chemins.

​

Voir aussi

• Gestion d’Identité et d’Accès - Apprenez sur le système de permissions de Claude Code
• IAM et contrôle d’accès - Gestion des politiques d’entreprise
• Dépannage - Solutions pour les problèmes de configuration courants