Claude Code : le guide pour bien démarrer

00Installer et lancer

Il vous faut un abonnement Claude payant (Pro, Max ou Team) ou un compte API. Sur Mac et Linux, le terminal intégré suffit. Sur Windows, passez par PowerShell.

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

Placez-vous ensuite dans le dossier de votre projet, puis lancez l'agent. Au premier lancement, il vous demande de vous connecter.

cd mon-projet
claude

01Comprendre le contexte

Tout ce qui se passe dans une session s'accumule dans sa fenêtre de contexte : vos messages, ses réponses, les fichiers qu'il lit, les résultats des commandes. Cette mémoire de travail a une taille limite.

Plus elle se remplit, moins l'agent est précis. Les essais ratés y restent aussi : il peut reprendre une piste abandonnée vingt messages plus tôt. Une session longue et brouillonne finit par produire du travail brouillon.

Avant un /clear, demandez une note de passation. La session suivante repartira de cette note, sans les détours de la précédente.

Écris dans passation.md une note pour reprendre ce travail dans une nouvelle session :
- l'objectif ;
- ce qui est fait, avec les fichiers modifiés ;
- ce qui reste à faire, dans l'ordre ;
- les pistes essayées qui n'ont pas marché, et pourquoi.
Reste factuel, 30 lignes maximum.

Dans la nouvelle session, il suffit d'écrire : « Lis passation.md et reprends. »

02Surveiller sa consommation

Avec un abonnement, vous avez des limites d'usage. Avec l'API, vous payez au volume. Dans les deux cas, ce qui coûte, c'est le contexte relu à chaque message.

/usage montre où vous en êtes de vos limites d'abonnement, /cost le coût de la session en API.

03Le fichier CLAUDE.md

CLAUDE.md est lu au début de chaque session. C'est là que vous notez ce que l'agent doit savoir sur le projet sans que vous ayez à le répéter : comment le lancer, comment le tester, où se trouve quoi, les règles maison.

Gardez-le court : quelques dizaines de lignes. Au-delà, les consignes se diluent et certaines sont ignorées. Une procédure longue a sa place dans un skill, pas ici.

# Site vitrine Boulangerie Martin

## Lancer et tester
- Dev : npm run dev (http://localhost:3000)
- Tests : npm test, à lancer avant de dire que c'est terminé

## Organisation
- Pages dans src/pages, composants dans src/components
- Images dans public/img, en WebP, 1600 px de large maximum

## Règles
- Textes en français, vouvoiement
- Ne jamais modifier les fichiers du dossier legacy/
- Un commit par modification, message en français

Pour un projet existant, tapez /init : l'agent parcourt le dossier et rédige un premier CLAUDE.md. Relisez-le et coupez ce qui ne sert pas, car il a tendance à en mettre trop.

04Formuler une demande

Claude Code ne voit pas votre écran et ne connaît pas votre intention. Une demande vague le pousse à deviner, et il devine large. Une bonne demande dit où, quoi et comment savoir que c'est réussi.

Contexte : [ce que fait cette partie du projet, fichiers concernés]
Problème ou besoin : [ce qui se passe, ou ce que vous voulez obtenir]
Contraintes : [ce qu'il ne faut pas toucher, outils ou style à respecter]
C'est réussi quand : [test qui passe, comportement observable, capture]
Pose-moi tes questions avant de commencer si un point n'est pas clair.

Une tâche par demande. Si vous avez trois choses à faire, faites trois demandes.

05Lui donner un moyen de vérifier

Un agent qui peut contrôler son travail se corrige seul. Sans contrôle, il vous annonce « c'est fait » et c'est vous qui découvrez le problème. Donnez-lui toujours une preuve à produire : un test qui passe, un build sans erreur, une page qui s'affiche, une capture d'écran.

Une fois la modification faite, lance npm run build puis npm test.
Si l'un des deux échoue, corrige et relance jusqu'à ce que les deux passent.
Termine en me montrant la sortie des deux commandes.

06Le mode plan et les permissions

Shift + Tab fait tourner trois modes. Le mode par défaut demande votre accord avant chaque modification. Le deuxième accepte les modifications de fichiers sans demander. Le troisième, le mode plan, ne modifie rien : l'agent lit, réfléchit et propose une marche à suivre.

Pour toute tâche qui touche plus d'un fichier, commencez en mode plan. Vous relisez le plan, vous corrigez ce qui ne va pas, puis vous le laissez exécuter. Une erreur repérée dans un plan coûte une phrase. La même erreur repérée dans le code coûte une heure.

07Revenir en arrière

Appuyez deux fois sur Échap, ou tapez /rewind, pour revenir à un message précédent. Vous pouvez restaurer la conversation, le code, ou les deux. C'est le filet de sécurité quand l'agent part dans une mauvaise direction.

Pour un historique durable, utilisez git. Pas besoin de connaître les commandes : l'agent les connaît.

08Aller plus loin : les 5 couches

Une fois les bases en place, Claude Code se configure en couches. Chacune répond à un besoin différent.

Les serveurs MCP complètent l'ensemble : ils branchent des outils externes comme une base de données, Notion ou un navigateur. Nous détaillons chaque couche dans notre article sur les 5 couches.

09Les erreurs de débutant

• Tout demander d'un coup. Découpez en étapes et validez chacune.
• Garder la même session toute la journée. Une tâche, une session. /clear entre les deux.
• Corriger en boucle. Après deux corrections ratées, revenez en arrière et reformulez la demande.
• Écrire un CLAUDE.md de 300 lignes. Ce qui n'est pas utile à chaque session n'a rien à y faire.
• Traiter CLAUDE.md comme une règle absolue. C'est une consigne, pas un verrou. Pour une obligation stricte, utilisez un hook.
• Ne pas donner de critère de réussite. Sans test ni preuve, « c'est fait » ne veut rien dire.
• Laisser l'agent explorer sans limite. Indiquez les fichiers concernés, ou confiez la recherche à un subagent.
• Sauter le mode plan. Sur une tâche de plus d'un fichier, il fait gagner plus de temps qu'il n'en prend.