Structuré avec Claude

Setup & configuration

Le “bloc de contexte réutilisable” qu’on a évoqué dans la section Construire un contexte efficace ? Dans Claude Code, il a un nom et un emplacement dédié : CLAUDE.md.

Installation

npm install -g @anthropic-ai/claude-code

Puis authentification :

claude
# → ouvre le browser pour connecter ton compte Anthropic

Fichiers de configuration

Claude Code utilise deux niveaux de config qui se cumulent :

Fichier	Portée	Contenu typique
`~/.claude/settings.json`	Global (tous projets)	Permissions, hooks globaux, préférences
`.claude/settings.json`	Projet (versionné)	Hooks projet, permissions spécifiques
`CLAUDE.md`	Projet (versionné)	Instructions permanentes lues à chaque session

CLAUDE.md — le fichier le plus important

C’est le fichier que Claude lit automatiquement au démarrage. Il définit le contexte permanent du projet.

# Mon projet

## Stack
- Node.js 20, PostgreSQL, React

## Conventions
- Tests obligatoires pour chaque PR
- Ne jamais modifier les migrations existantes

## Commandes utiles
npm run dev     # dev server
npm run test    # tests

Tout ce que tu écrirais en préambule à chaque conversation → mets-le dans CLAUDE.md.

Le dossier ~/.claude/ (parfois appelé claude root) est ton espace global : skills partagés entre tous tes projets, config personnelle, hooks globaux. Contrairement aux configs projet, il n’est pas versionné — il reste privé à ta machine.

Permissions

Les permissions contrôlent ce que Claude peut faire sans te demander :

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git *)",
      "Edit"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  }
}

Modes d’approbation

Mode	Comportement
`default`	Demande confirmation pour les actions risquées
`auto`	Approuve tout automatiquement (`--dangerously-skip-permissions`)
`plan`	Claude planifie sans exécuter — tu valides avant

Le mode auto peut sembler risqué au premier abord — les hooks (qu’on verra après les skills) te permettront d’ajouter des garde-fous sans sacrifier la fluidité.