Apprendre Claude Code : le guide pour bien démarrer

#Pourquoi apprendre Claude Code ?

Claude Code est un outil de développement créé par Anthropic qui vit directement dans ton terminal. Contrairement aux assistants de code classiques qui se contentent d'auto-compléter des lignes, Claude Code est agentique : il lit tes fichiers, comprend ton projet, exécute des commandes, et peut implémenter des fonctionnalités complètes en autonomie.

Concrètement, tu lui parles en langage naturel et il agit. Pas besoin de copier-coller du code entre un chat et ton éditeur — Claude Code travaille directement dans ton projet.

#Installer Claude Code

#Prérequis

Tu as besoin de deux choses :

• Un terminal (macOS, Linux ou WSL sous Windows)
• Un abonnement Claude (Pro, Max, Teams ou Enterprise) ou un compte Anthropic Console avec des crédits API

#Installation

La méthode recommandée est l'installation native :

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

Alternatives disponibles :

# Homebrew (macOS)
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

L'installation native se met à jour automatiquement en arrière-plan. Avec Homebrew ou WinGet, il faut lancer les mises à jour manuellement.

#Première connexion

Lance Claude Code dans un projet :

cd mon-projet
claude

À la première utilisation, tu seras invité à te connecter. Suis le lien, entre le code de vérification, et c'est parti.

#Ta première session

#Explorer le projet

La première chose à faire quand tu ouvres Claude Code dans un projet, c'est de lui demander de l'explorer :

qu'est-ce que ce projet fait ?

Claude analyse les fichiers, identifie les technologies, et te donne un résumé. Tu peux enchaîner avec des questions plus précises :

quelles technologies sont utilisées ?

explique la structure des dossiers

où est le point d'entrée principal ?

#Faire une première modification

Demande quelque chose de simple pour commencer :

ajoute un commentaire explicatif au-dessus de la fonction main

Claude Code va :

1. Trouver le fichier concerné
2. Te montrer les changements proposés
3. Attendre ta validation
4. Appliquer la modification

Tu gardes le contrôle : chaque modification nécessite ton approbation.

#Travailler avec Git

Claude Code s'intègre nativement avec Git :

quels fichiers ont été modifiés ?

commit mes changements avec un message descriptif

crée une branche feature/ma-fonctionnalite

Tu peux même lui demander de résoudre des conflits de merge ou de créer une pull request.

#Les commandes essentielles

Voici les commandes que tu utiliseras le plus au quotidien :

#Configurer Claude Code avec CLAUDE.md

Le fichier CLAUDE.md est un fichier Markdown que Claude lit au début de chaque session. C'est l'endroit où tu définis tes conventions, tes commandes de build, et tes règles de travail.

#Générer un CLAUDE.md automatiquement

Lance cette commande dans ton projet :

/init

Claude analyse ton projet et génère un fichier CLAUDE.md de base. Tu peux ensuite l'affiner.

#Que mettre dans CLAUDE.md

Voici un exemple concret :

# Style de code
- Utiliser les imports ES modules (import/export), pas CommonJS (require)
- Nommer les variables en camelCase

# Commandes
- Build : `npm run build`
- Tests : `npm test`
- Lint : `npm run lint`

# Workflow
- Toujours vérifier que le build passe après des modifications
- Ne jamais push sans confirmation

#Ce qu'il faut inclure (et ce qu'il faut éviter)

#Où placer CLAUDE.md

• ~/.claude/CLAUDE.md — s'applique à tous tes projets (préférences globales)
• ./CLAUDE.md — à la racine du projet, partagé avec l'équipe via Git
• ./CLAUDE.local.md — local et ignoré par Git, pour tes préférences personnelles
• Dans les sous-dossiers — Claude les charge automatiquement quand il travaille dans ces dossiers

#Bien prompter Claude Code

La qualité de tes résultats dépend directement de la qualité de tes instructions. Voici les patterns qui fonctionnent.

#Être spécifique plutôt que vague

Au lieu de :

corrige le bug

Préfère :

le login échoue après expiration de la session. Vérifie le flux
d'authentification dans src/auth/, notamment le refresh de token.
Écris un test qui reproduit le bug, puis corrige-le.

#Explorer avant de coder

Pour les tâches complexes, utilise le Plan Mode (accessible avec Shift+Tab deux fois). Dans ce mode, Claude ne peut que lire des fichiers et poser des questions — il ne modifie rien.

Le workflow recommandé :

1. Explorer : demande à Claude de lire et comprendre le code concerné
2. Planifier : demande-lui un plan d'implémentation détaillé
3. Implémenter : repasse en mode normal et exécute le plan
4. Commiter : demande un commit avec un message descriptif

#Donner des critères de vérification

Claude est bien meilleur quand il peut vérifier son propre travail :

écris une fonction validateEmail. Cas de test :
user@example.com -> true, invalid -> false, user@.com -> false.
Lance les tests après l'implémentation.

#Utiliser les références de fichiers

Utilise @ pour référencer des fichiers directement au lieu de les décrire :

regarde @src/auth/login.ts et corrige la gestion d'erreur

#Gérer le contexte

Le contexte est la ressource la plus importante à gérer dans Claude Code. C'est la fenêtre de conversation qui contient tout : tes messages, les fichiers lus, les résultats de commandes. Quand il se remplit, les performances baissent.

#Bonnes pratiques

• /clear entre les tâches : quand tu changes de sujet, réinitialise le contexte
• Découpe les gros projets : plutôt qu'une seule session marathon, fais plusieurs sessions ciblées
• Utilise les subagents pour les recherches. Ils explorent dans un contexte séparé et te rapportent un résumé, sans polluer ta conversation principale

utilise un subagent pour analyser comment le système d'authentification
gère le refresh de tokens

• /compact : compresse le contexte en gardant les informations essentielles

#Reprendre une conversation

# Reprendre la dernière conversation
claude -c

# Choisir parmi les conversations récentes
claude -r

Tu peux nommer tes sessions avec /rename pour les retrouver facilement.

#Aller plus loin

Une fois les bases maîtrisées, trois fonctionnalités avancées vont décupler ta productivité.

#Les Skills

Les Skills sont des extensions qui ajoutent des commandes slash réutilisables. Crée un fichier SKILL.md dans .claude/skills/ :

.claude/skills/review/
└── SKILL.md

Invoque-le ensuite avec /review. Les Skills peuvent aussi se déclencher automatiquement quand Claude juge que c'est pertinent.

#Les Hooks

Les Hooks exécutent des scripts automatiquement à certains moments du workflow de Claude. Par exemple, lancer le linter après chaque modification de fichier, ou bloquer les écritures dans certains dossiers.

écris un hook qui lance eslint après chaque édition de fichier

#Le mode headless

Pour intégrer Claude Code dans des scripts ou des pipelines CI/CD :

# Question ponctuelle
claude -p "liste tous les endpoints API"

# Sortie JSON pour parsing
claude -p "analyse ce fichier" --output-format json

#Les erreurs classiques à éviter

En apprenant Claude Code, tu tomberas probablement dans certains pièges courants. Voici comment les éviter.

La session interminable — Tu commences une tâche, puis enchaînes sur un sujet différent sans faire /clear. Le contexte se remplit d'informations non pertinentes et les performances chutent.

Corriger en boucle — Claude se trompe, tu corriges, il se retrompe, tu recorriges. Après deux tentatives ratées, fais /clear et reformule ta demande initiale avec plus de détails.

Le CLAUDE.md géant — Tu ajoutes toutes les règles possibles dans ton CLAUDE.md. Résultat : Claude ignore les instructions importantes noyées dans le volume. Reste concis.

Faire confiance sans vérifier — Claude produit du code qui a l'air correct mais qui ne gère pas les cas limites. Fournis toujours des tests ou des critères de vérification.

#Récapitulatif

L'apprentissage de Claude Code suit une progression naturelle : tu commences par poser des questions sur ton code, puis tu fais des modifications simples, puis tu implémentes des fonctionnalités complètes. Le CLAUDE.md et les bonnes pratiques de prompting font la différence entre un outil gadget et un vrai multiplicateur de productivité.

La documentation officielle est disponible sur code.claude.com/docs — c'est la référence la plus à jour pour explorer toutes les fonctionnalités.