Claude Code Cheat Sheet : `CLAUDE.md`, settings, skills, hooks, mémoire et slash commands

Le modèle mental utile est simple :

Ce qui mérite d'être compris dès le départ :

• CLAUDE.md donne le contexte durable
• settings.json contrôle permissions + hooks + comportement
• les skills encapsulent les workflows complexes
• les subagents servent à spécialiser des tâches sans polluer le contexte principal
• l'auto-memory aide Claude à conserver des habitudes opérationnelles

La hiérarchie officielle des settings est :

1. managed settings organisation
2. arguments CLI
3. .claude/settings.local.json
4. .claude/settings.json
5. ~/.claude/settings.json

En pratique : plus c'est proche du projet et de la machine courante, plus c'est prioritaire.

Un bon CLAUDE.md contient :

• la stack
• les commandes build / test / lint
• l'architecture utile
• les conventions de code
• les règles absolues

Exemple de structure :

```md # Instructions Claude

Stack

• Next.js 15
• TypeScript
• Tailwind CSS

Commandes

• Dev : npm run dev
• Lint : npm run lint
• Typecheck : npx tsc --noEmit

Règles absolues

• Ne jamais lire .env
• Ne jamais modifier main directement
• Toujours vérifier TypeScript après un changement important

```

Les bonnes pratiques qui changent vraiment la qualité :

• gardez le fichier sous 200 lignes
• préférez des règles opérationnelles à des phrases vagues
• utilisez des imports @fichier.md si vous devez découper
• placez des CLAUDE.md plus locaux dans les sous-répertoires si des zones du repo ont leurs propres conventions

Point important : CLAUDE.local.md est désormais déprécié dans la doc actuelle. Si vous avez besoin d'un complément local, passez plutôt par un import ciblé dans un fichier non commité.

Le trio prioritaire :

1. permissions
2. deny list
3. hooks de validation légère

Exemple minimal sain :

``json { "permissions": { "allow": [ "Read", "Write", "Bash(git *)", "Bash(npm *)", "Bash(node *)" ], "deny": [ "Read(./.env)", "Read(./.env.*)", "Bash(git push --force *)" ] } } ``

Les hooks rentables :

• formatter automatiquement
• lancer un lint ciblé
• bloquer l'édition directe sur main
• déclencher un contrôle sur certains fichiers sensibles

Évitez au début :

• les hooks trop lents
• les hooks qui écrivent partout
• les hooks qui bloquent sans message clair

Le bon standard équipe, c'est un hook qui aide d'abord, et qui bloque seulement sur les cas dangereux.

Anthropic recommande aujourd'hui de privilégier les skills.

Pourquoi :

• ils peuvent exposer une commande slash
• ils supportent des fichiers annexes
• ils supportent leur propre frontmatter
• ils peuvent tourner dans un sous-agent forké
• ils sont mieux adaptés aux workflows multi-étapes

Structure recommandée :

``text .claude/ └── skills/ └── review-pr/ ├── SKILL.md ├── examples.md └── scripts/ └── validate.sh ``

Quand utiliser un subagent :

• review spécialisée
• sécurité
• lecture exploratoire isolée
• vérification parallèle d'un sous-sujet

Quand rester dans l'agent principal :

• tâche fortement couplée au contexte courant
• édition fine de plusieurs fichiers liés
• tâche urgente sur le chemin critique

Deux couches mémoire :

• `CLAUDE.md` : mémoire stable que vous écrivez
• auto-memory : mémoire que Claude apprend et stocke sous ~/.claude/projects/<project>/memory/

Les commandes les plus utiles au quotidien :

Le réflexe senior :

• /compact quand la tâche continue mais que la session devient lourde
• /clear quand le sujet change réellement
• /memory quand une règle commence à se répéter trop souvent

``text mon-projet/ ├── CLAUDE.md └── .claude/ ├── settings.json ├── settings.local.json ├── rules/ │ ├── typescript.md │ ├── testing.md │ └── security.md ├── skills/ │ ├── review-pr/ │ ├── deploy/ │ └── onboard/ └── agents/ ├── code-reviewer.md └── security-auditor.md ``

À commit :

• CLAUDE.md
• .claude/settings.json
• .claude/rules/
• .claude/skills/
• .claude/agents/

À ignorer :

• .claude/settings.local.json
• secrets
• overrides machine-spécifiques

Si vous devez améliorer une équipe vite :

1. écrire un vrai CLAUDE.md
2. sécuriser settings.json
3. créer 2 skills à fort ROI
4. ajouter 1 subagent de review
5. poser 2 hooks utiles maximum