~/.claude/CLAUDE.md : vos préférences personnelles

# Préférences personnelles (~/.claude/CLAUDE.md)
 
<!-- Ce fichier s'applique à TOUS vos projets et n'est partagé avec personne.
     N'y mettez que des préférences valables partout ; les règles d'un projet
     vont dans le CLAUDE.md du dépôt. -->
 
## Communication
 
- Répondre en français, de façon concise ; pas de résumé final inutile.
- Signaler clairement une hypothèse ou une incertitude plutôt que deviner.
- Avant une modification de plus de trois fichiers, présenter un plan court.
 
## Style de code
 
- Noms de variables et de fonctions en anglais, commentaires en français.
- Préférer des fonctions courtes et des retours anticipés aux imbrications.
- Pas de commentaire qui paraphrase le code ; expliquer le « pourquoi ».
 
## Outils
 
- Gestionnaire de paquets JavaScript : pnpm si un `pnpm-lock.yaml` existe, sinon npm.
- Recherche dans le code : privilégier les outils de recherche intégrés.
- Éditeur : VS Code.
 
## Git
 
- Ne jamais pousser (`git push`) ni réécrire l'historique sans demande explicite.
- Messages de commit en français, à l'impératif, 72 caractères max pour le titre.
 
## Sécurité
 
- Ne jamais afficher de jeton, de clé d'API ou de mot de passe dans une réponse.
- Demander avant toute commande qui supprime des fichiers hors du dépôt.

Claude Code lit plusieurs fichiers d'instructions. Celui-ci se trouve dans votre dossier personnel, à l'emplacement ~/.claude/CLAUDE.md. Il s'applique à tous les projets ouverts sur votre machine et n'est jamais partagé avec votre équipe : c'est l'endroit idéal pour vos habitudes de travail, par opposition aux règles d'un dépôt particulier.

Ce que contient le modèle

• Communication : langue des réponses, niveau de concision, obligation de signaler une hypothèse, plan préalable pour les modifications importantes.
• Style de code : conventions de nommage et de commentaires que vous appliquez partout.
• Outils : gestionnaire de paquets préféré, éditeur utilisé.
• Git : pas de push ni de réécriture d'historique sans demande explicite, format des messages de commit.
• Sécurité : ne jamais afficher de secrets, demander avant toute suppression hors du dépôt.

Comment il se combine avec les autres fichiers

Les fichiers d'instructions ne s'écrasent pas : ils sont concaténés. Le fichier utilisateur est chargé avant celui du projet, qui apparaît donc plus tard dans le contexte. En pratique, gardez ici ce qui est vrai partout et laissez le CLAUDE.md du dépôt préciser le reste. Si une règle d'équipe et une préférence personnelle s'opposent frontalement, supprimez l'une des deux : la documentation prévient qu'en cas de contradiction, Claude peut retenir l'une ou l'autre de façon arbitraire.

Comment l'adapter

1. Créez le dossier ~/.claude/ s'il n'existe pas, puis le fichier CLAUDE.md.
2. Conservez uniquement les préférences que vous appliquez réellement sur tous vos projets.
3. Pour des consignes réservées à un seul projet mais que vous ne voulez pas versionner, utilisez plutôt un CLAUDE.local.md à la racine de ce projet, ajouté au .gitignore.
4. Vous pouvez aussi découper vos préférences en plusieurs fichiers dans ~/.claude/rules/, qui s'appliquent eux aussi à tous vos projets.

Pièges fréquents

• Y mettre des règles d'équipe : vos collègues ne les verront jamais. Tout ce qui concerne le projet doit aller dans le dépôt.
• Accumuler : ce fichier est chargé à chaque session, dans chaque projet. Chaque ligne a un coût en contexte ; élaguez-le régulièrement.
• Y stocker des secrets : même personnel, ce fichier est injecté dans le contexte envoyé au modèle. N'y écrivez ni jeton ni mot de passe.

La commande /memory affiche ce fichier parmi les emplacements de mémoire et permet de l'ouvrir directement dans votre éditeur.

La leçon Le fichier CLAUDE.md présente l'ensemble de la hiérarchie : fichier d'organisation, fichier utilisateur, fichier de projet et fichiers locaux.