CC
Le Carnet Technique — Ingénierie IA
n° 4 · avril 2026
Claude Code Tutoriel complet 15 min de lecture
— Guide pratique, édition 2026

Claude Code : tutoriel complet pour développeurs en 2026

Installation, commandes essentielles, CLAUDE.md, Plan Mode, workflows avancés et bonnes pratiques. Du débutant au power user, sans détour.

Catégorie  ·  Claude Code
Temps  ·  15 min
Niveau  ·  Débutant → Avancé
Mis à jour  ·  Avril 2026

Pourquoi Claude Code change la donne

Claude Code n'est pas un autocomplete glorifié. C'est un agent de développement autonome qui vit dans votre terminal, comprend l'intégralité de votre codebase, et exécute des tâches complexes multi-fichiers de manière autonome. Lancé en disponibilité générale en mai 2025, il a contribué à faire atteindre à Anthropic plus de 2 milliards de dollars de revenus annuels.

En février 2026, Claude Code est responsable d'environ 4 % de tous les commits publics sur GitHub. Chez Anthropic, 90 % du code interne est écrit avec assistance IA, et la productivité de l'ingénierie a augmenté de 200 % depuis l'adoption de l'outil.

Ce tutoriel vous accompagne de l'installation à la maîtrise des workflows avancés.


01
Étape 01 / 07 — Mise en place

Installation

Prérequis

Installation rapide

La méthode recommandée par Anthropic est l'installateur natif. Sur macOS ou Linux, il suffit de lancer la commande d'installation depuis le terminal. Sur Windows, un équivalent PowerShell est disponible. L'installateur natif a l'avantage de se mettre à jour automatiquement en arrière-plan.

Vous pouvez aussi passer par npm (npm install -g @anthropic-ai/claude-code), Homebrew sur Mac, ou winget sur Windows.

Premier lancement

Tapez claude dans votre terminal. Au premier lancement, vous choisirez un style de texte, puis vous vous connecterez à votre compte Anthropic.

~/projects/atlas-api — zsh
claude · sonnet 4.6
$ claude # session démarrée · CLAUDE.md chargé (4.2k tokens)
────────────────────────────────────────────────────────
you ▸Explique-moi la structure de ce projet et trouve où est gérée l'authentification.
claude ▸ J'analyse votre codebase.
lecture de package.json, tsconfig.json, prisma/schema.prisma
scan récursif de src/ (42 fichiers · 6 800 lignes)
index des routes dans src/app/api/
Atlas API · Next.js 14 / App Router / Prisma
├─ src/app/api/auth/ ← OAuth2 + session tokens
├─ src/lib/auth.ts ← middleware JWT
├─ src/middleware.ts ← protection des routes
└─ prisma/schema.prisma ← modèle User + Session
L'authentification repose sur NextAuth côté routes et un middleware JWT pour les endpoints API. Voulez-vous que je refactore le flow OAuth2, ou que j'ajoute un provider ?
you ▸/plan Ajoute un provider GitHub avec refresh token
Fig. 1 — Session Claude Code : prompt utilisateur, analyse, réponse structurée.
02
Étape 02 / 07 — Interaction

Les modes d'interaction

Mode conversationnel (par défaut)

Vous dialoguez avec Claude en langage naturel. Il lit vos fichiers, propose des modifications, et les applique après votre approbation.

session · conversationnel
You: Explique-moi la structure de ce projet
Claude: Je vais analyser votre codebase...

Plan Mode

Le mode le plus puissant pour les tâches complexes. Avec /plan, Claude analyse la situation, propose un plan détaillé, et attend votre validation avant d'agir. C'est l'approche recommandée pour toute tâche touchant plus de 3 fichiers.

session · /plan
You: /plan Refactore le module d'authentification pour supporter OAuth2
Claude: Voici mon plan en 5 étapes...

Mode autonome

Pour les tâches de confiance, Claude exécute sans demander de confirmation intermédiaire. À utiliser avec précaution et des permissions bien configurées.

03
Étape 03 / 07 — Mémoire persistante

CLAUDE.md : le cœur de votre productivité

CLAUDE.md est un fichier markdown placé à la racine de votre projet. C'est la mémoire persistante de Claude Code — les instructions qui se chargent automatiquement à chaque session. Sans ce fichier, chaque session repart de zéro.

Pour créer un CLAUDE.md initial, lancez /init dans votre projet. Claude analysera votre codebase et proposera un fichier de départ.

Structure recommandée

CLAUDE.md · racine projet
# CLAUDE.md

## Architecture
- Framework : Next.js 14 avec App Router
- Base de données : PostgreSQL via Prisma
- Tests : Vitest + Testing Library

## Conventions
- Noms de fichiers : kebab-case
- Composants React : fonctionnels avec hooks, pas de classes
- Styles : Tailwind CSS, pas de CSS modules

## Commandes importantes
- `npm run dev` — serveur local
- `npm test` — lancer les tests
- `npm run lint` — vérification du code

## Règles strictes
- JAMAIS de `any` en TypeScript
- Toujours écrire un test pour chaque nouvelle fonction
- Les migrations Prisma doivent être réversibles

L'investissement dans un bon CLAUDE.md est le meilleur levier de productivité. Comme l'explique un expert sur Dev Genius : le fichier CLAUDE.md que vous écrivez aujourd'hui améliore chaque session future indéfiniment. Les slash commands que vous définissez cette semaine vous évitent de réexpliquer vos standards pendant des années.

Couches de contexte général → spécifique
~/
CLAUDE.md global
Préférences personnelles, style de commits, alias — appliqué à chaque projet.
permanent
▼ hérite & spécialise
./
CLAUDE.md projet
Architecture, conventions, commandes, règles strictes. Chargé à chaque session.
par repo
▼ hérite & spécialise
›_
Prompt de session
La tâche du moment : « refactore l'auth », « corrige le bug mobile », etc.
éphémère
Fig. 2 — Les couches de contexte : global, projet, session.
04
Étape 04 / 07 — Compétence clé

Gestion du contexte

Claude Code lit votre codebase entier, mais la qualité de ses résultats dépend de la pertinence du contexte fourni. C'est ce qu'Andrej Karpathy appelle le context engineering.

Principes fondamentaux

Donnez exactement ce dont Claude a besoin. Ni plus, ni moins. Trop peu d'informations et il invente. Trop d'informations et les coûts explosent sans gain de qualité.

Bonnes pratiques

Une tâche par session Claude gère bien une tâche focalisée. Cinq tâches simultanées produisent cinq résultats médiocres.
Contexte explicite Au lieu de « fixe le bug », donnez : « Les utilisateurs rapportent que le formulaire de login ne se soumet pas sur mobile. Le formulaire est dans src/components/Login.jsx. »
Laissez Claude planifier Au lieu de micro-gérer (« d'abord ouvre ce fichier, puis va à la ligne 42… »), décrivez l'objectif et laissez-le trouver le chemin.

Les anti-patterns à éviter

Les erreurs les plus coûteuses identifiées par les power users :

Prompt tunneling
01
Envoyer 10+ messages sans vérifier les résultats intermédiaires. Claude dérive davantage à chaque étape non vérifiée.
symptôme : « il a cassé le fichier depuis 6 prompts »
Ghost context
02
Supposer que Claude se souvient d'une conversation précédente. Sans CLAUDE.md, chaque session repart de zéro. Ce problème cause 60 % des tickets de support.
symptôme : « mais je te l'ai dit hier ! »
Mega-prompt
03
Demander 5 fonctionnalités dans un seul message de 500 mots. Le résultat est flou, mélangé, et difficile à réviser.
symptôme : 1 PR, 47 fichiers, 0 test
Security bypass
04
Désactiver les permissions pour « aller plus vite ». Un raccourci dangereux qui transforme l'assistant en exécuteur sans garde-fou.
symptôme : --dangerously-skip-permissions
Fig. 3 — Quatre anti-patterns à éviter.
05
Étape 05 / 07 — Aller plus loin

Workflows avancés

Multi-instances avec Git worktrees

Lancez plusieurs instances de Claude Code en parallèle, chacune sur sa propre branche Git. L'une implémente une fonctionnalité pendant que l'autre écrit les tests.

Workflow multi-instances git worktree × 3
atlas-api
main · HEAD @ a3f9c12
repo principal
worktree 01
feat/oauth2-github
Implémenter le provider GitHub avec refresh token
claude · actif · 142 tokens/s
worktree 02
test/auth-coverage
Écrire les tests unitaires du flow OAuth2
claude · actif · 98 tokens/s
worktree 03
docs/auth-migration
Mettre à jour le guide de migration interne
claude · actif · 76 tokens/s
Fig. 4 — Trois branches, trois tâches, trois instances Claude Code.

Slash commands personnalisées

Créez des commandes réutilisables pour vos workflows récurrents : /pr pour préparer une pull request, /security pour un audit de sécurité, /refactor pour un refactoring guidé.

Intégration CI/CD

Claude Code peut s'intégrer à votre pipeline de build et de revue. Il analyse les PRs, détecte les problèmes potentiels, et propose des corrections avant la revue humaine.

Serveurs MCP

Le Model Context Protocol permet de connecter Claude Code à des outils externes : GitHub, bases de données, systèmes de fichiers spéciaux, APIs internes.

shell · mcp install
# Connecter Claude Code à GitHub et au filesystem
claude mcp install @anthropic-ai/mcp-server-github
claude mcp install @anthropic-ai/mcp-server-filesystem
06
Étape 06 / 07 — Économie

Optimisation des coûts

Comprendre le pricing

Claude Pro
20$/mois
Accès Claude Code avec Sonnet 4.6, environ 40-80 heures par semaine.
Claude Max 20×
200$/mois
Pour le développement intensif, sans friction.

Stratégie de modèle

90 % des tokens en session sont des cache reads, qui coûtent environ 10× moins que les tokens frais. Le coût quotidien moyen avec de bonnes habitudes : environ 6$ par développeur. Avec de mauvaises habitudes, cela monte à 20-40$/jour.

La commande /model opusplan utilise automatiquement Opus pour la planification et Sonnet pour l'exécution — un excellent compromis.

07
Étape 07 / 07 — Écosystème

Comparaison avec les alternatives

Claude Code
Anthropic · 2025
Notre choix
InterfaceTerminal
PhilosophieAgent autonome
ContexteCodebase — 1M tokens
AutonomieÉlevée · planifie + exécute
Prix20$/mois
46%« Most loved » dev survey
Cursor
Anysphere · fork VS Code
Éditeur
InterfaceIDE (VS Code fork)
PhilosophieÉditeur collaboratif
ContexteMulti-fichiers
AutonomieMoyenne · assiste l'édition
Prix20$/mois
19%« Most loved » dev survey
Copilot
GitHub · extension IDE
Autocomplete
InterfaceExtension multi-IDE
PhilosophieAutocomplete intelligent
ContexteFichiers ouverts
AutonomieFaible · suggestions inline
Prix10$/mois
9%« Most loved » dev survey
Fig. 5 — Trois outils, trois philosophies.

La conclusion pragmatique : ces outils ne sont pas mutuellement exclusifs. Le stack le plus productif combine Claude Code pour les tâches complexes avec Cursor ou Copilot pour l'édition quotidienne.


Passer de l'outil au système

Les développeurs qui tirent le plus de valeur de Claude Code ne tapent pas plus de prompts — ils structurent leur travail différemment. Sessions courtes, portées claires, plans externes qui survivent aux resets de contexte, utilisation agressive des sous-agents pour garder le contexte principal propre.

Claude Code n'est pas un outil que vous « utilisez ». C'est un environnement que vous façonnez. Le passage de la surface (prompts) à la profondeur (contexte, plans, systèmes) est ce qui sépare l'utilisateur occasionnel du power user.

Pour aller plus loin

Claude Code Deep Dive

13 modules qui vont bien au-delà des bases : architecture interne des agents, cycle d'interaction en 6 phases, orchestration multi-agents, hooks de sécurité, calcul de ROI.

Découvrir la formation 297€ · accès 1 an + mises à jour comprises