Chapitre 4 · Les fichiers de réglages
Quel fichier l'emporte ?
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementQuand la même clé est réglée à plusieurs endroits, Claude Code prend la valeur du niveau le plus haut. Du plus fort au plus faible : les réglages gérés par l'organisation, la ligne de commande, .claude/settings.local.json, .claude/settings.json, puis ~/.claude/settings.json.
Mais attention, les listes de permissions fonctionnent différemment : elles s'additionnent. Si ton fichier utilisateur contient une règle allow et le fichier du projet une autre, les deux s'appliquent. Chaque fichier ajoute ses entrées sans effacer celles des autres.
Et pour les refus, la documentation est formelle : si un outil est refusé à un niveau, aucun autre niveau ne peut l'autoriser. Un deny posé dans ton fichier utilisateur protège donc tous tes projets, même si un projet téléchargé contient une règle allow qui irait dans l'autre sens.
En pratique, voici une organisation simple et solide :
- dans
~/.claude/settings.json: tes deny universels (fichiers .env, dossiers de secrets) ; - dans
.claude/settings.jsondu projet : les allow propres au projet (ses scripts, ses commandes de test) et les ask pour les actions sensibles ; - dans
.claude/settings.local.json: tes petites préférences personnelles.