Paramètres Claude Code

​

Fichiers de paramètres

• Les paramètres utilisateur sont définis dans ~/.claude/settings.json et s’appliquent à tous les projets.
• Les paramètres de 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.
• Pour les déploiements d’entreprise de Claude Code, nous supportons également les paramètres de politique gérée par l’entreprise. Ceux-ci ont la priorité 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
• Les déploiements d’entreprise peuvent également configurer des serveurs MCP gérés qui remplacent les serveurs configurés par l’utilisateur. Voir Configuration MCP d’entreprise :
  • macOS : /Library/Application Support/ClaudeCode/managed-mcp.json
  • Linux et WSL : /etc/claude-code/managed-mcp.json
  • Windows : C:\ProgramData\ClaudeCode\managed-mcp.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

​

Paramètres de sandbox

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker"],
    "network": {
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  },
  "permissions": {
    "deny": [
      "Read(.envrc)",
      "Read(~/.aws/**)"
    ]
  }
}

• Les règles de refus Read bloquent les lectures de fichiers dans le sandbox
• Les règles d’autorisation Edit permettent les écritures de fichiers (en plus des valeurs par défaut, par exemple le répertoire de travail actuel)
• Les règles de refus Edit bloquent les écritures dans les chemins autorisés

• Les règles d’autorisation WebFetch permettent les domaines réseau
• Les règles de refus WebFetch bloquent les domaines réseau

​

Précédence des paramètres

1. Politiques gérées par l’entreprise (managed-settings.json)
   • Déployées par l’informatique/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 local (.claude/settings.local.json)
   • Paramètres de projet personnels et spécifiques
4. Paramètres de projet partagés (.claude/settings.json)
   • Paramètres de projet partagés avec l’équipe dans le contrôle de source
5. Paramètres utilisateur (~/.claude/settings.json)
   • Paramètres globaux personnels

​

Points clés sur le 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
• Commandes slash : Commandes personnalisées qui peuvent être invoquées pendant une session avec /command-name
• Serveurs MCP : Étendez Claude Code avec des outils et des intégrations supplémentaires
• Précédence : Les configurations de niveau supérieur (Entreprise) remplacent les configurations de niveau inférieur (Utilisateur/Projet)
• Héritage : Les paramètres sont fusionnés, les paramètres plus spécifiques s’ajoutant à ou remplaçant les paramètres plus larges

​

Disponibilité de l’invite système

​

Exclusion des fichiers sensibles

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

​

Configuration des sous-agents

• 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

​

Configuration des plugins

​

Paramètres des plugins

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

​

enabledPlugins

• Paramètres utilisateur (~/.claude/settings.json) : Préférences de plugins personnels
• Paramètres de 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 validé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": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "company-org/claude-plugins"
      }
    },
    "security-plugins": {
      "source": {
        "source": "git",
        "url": "https://git.company.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)

​

Gestion des plugins

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

​

Variables d’environnement

​

Outils disponibles pour Claude

​

Extension des outils avec des hooks

​

Voir aussi

• Gestion des identités et des accès - En savoir plus 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