Tutoriel Claude Code pour debutants

Ce qu'est Claude Code (et ce qu'il n'est pas)

Claude Code est un agent harness: un logiciel qui met un modele Claude dans une boucle avec des tools (lire des fichiers, editer des fichiers, executer des commandes shell, chercher sur le web) et le jugement de les employer vers un objectif que vous fixez. Il tourne dans le terminal, dans VS Code et JetBrains, dans une appli desktop et sur le web. Ce n'est pas juste de l'autocomplete ni une fenetre de chat qui vous donne des snippets a coller: il travaille directement dans votre repository, fait des modifications multi-fichiers, execute vos tests et itere jusqu'a ce que la tache soit faite. Vous gardez le controle en verifiant ce qu'il propose et en approuvant les actions importantes.

• Il vit la ou votre code vit: dans le terminal, dans votre editeur ou dans un onglet du navigateur.
• Il agit, il ne fait pas que proposer: il edite des fichiers et execute des commandes, puis lit les resultats.
• Vous supervisez: il demande la permission pour les actions sensibles, et vous verifiez ses plans et ses diffs.
• Il faut un compte: Claude Pro, Max, Team, Enterprise ou Console (au token). Le plan gratuit Claude.ai n'inclut pas Claude Code.

Installer Claude Code

La facon recommandee d'installer Claude Code en 2026 est l'installateur natif, qui n'a pas de dependance a Node.js et se met a jour tout seul en arriere-plan. Executez la ligne unique pour votre plateforme, puis confirmez que ca a marche. Si vous preferez npm, le paquet fonctionne toujours et installe le meme binaire, mais il faut Node.js 18 ou plus recent et il ne se met pas a jour aussi proprement. N'installez jamais avec sudo: un repertoire npm appartenant a root cause des erreurs de permission a chaque installation future.

# macOS, Linux, WSL (recommended native installer)
curl -fsSL https://claude.ai/install.sh | bash

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

# npm fallback (needs Node.js 18+, do NOT use sudo)
npm install -g @anthropic-ai/claude-code

# Confirm it installed
claude --version

Si quelque chose parait bizarre, executez "claude doctor" pour un bilan de sante de votre installation et de votre configuration. Sur Windows natif, Git for Windows est optionnel mais laisse Claude Code utiliser Git Bash pour les commandes shell.

Votre premiere session

Ouvrez un terminal dans le projet sur lequel vous voulez travailler, et executez "claude". La premiere fois, il vous guide dans le login via le navigateur. Une fois entre, vous etes a un prompt interactif: tapez une requete en francais ou en anglais et appuyez sur Entree. Commencez petit pour batir la confiance, par exemple "explique ce que fait ce projet" ou "trouve ou est rendu le hero de la page d'accueil". Claude Code lit lui-meme les fichiers pertinents, vous n'avez donc pas a coller de code. Pour terminer la session, tapez /exit, et pour reprendre plus tard, executez "claude -c" pour continuer votre derniere session dans ce dossier.

# Start Claude Code in the current project
claude

# Continue your most recent session in this folder
claude -c

# Resume a specific past session from a list
claude --resume

Le workflow central: plan, edit, run, review

La seule habitude qui rend Claude Code fiable, c'est: planifier avant de le laisser editer. Appuyez sur Shift+Tab pour passer en mode plan: Claude explore votre codebase et propose ce qu'il compte faire sans changer un seul fichier, pour que vous puissiez corriger le tir a moindre cout avant qu'aucun code ne soit ecrit. Approuvez le plan, laissez-le faire les edits, laissez-le executer vos tests ou le dev server, puis verifiez le diff avant de committer. Cette boucle explore-plan-implement-commit garde l'agent honnete et attrape une mauvaise direction tant qu'elle est encore gratuite a corriger.

• Plan: appuyez sur Shift+Tab pour le mode plan, pour que Claude propose les changements avant d'editer. Utilisez-le pour tout ce qui touche plusieurs fichiers, le schema ou la securite.
• Edit: approuvez le plan et laissez Claude faire les modifications multi-fichiers.
• Run: laissez-le executer vos tests, le type-checker ou le dev server, pour qu'il voie de vrais resultats, pas des suppositions.
• Review: lisez le diff et committez. Vous etes le quality gate avant que le code ne devienne permanent.

CLAUDE.md: enseigner vos regles a l'agent

CLAUDE.md est un simple fichier Markdown a la racine de votre repo que Claude Code lit automatiquement au debut de chaque session et traite comme des instructions permanentes. C'est l'amelioration la plus puissante que vous puissiez faire: ecrivez votre stack, vos conventions, votre quality gate et votre ton une seule fois, et l'agent arrete de les redecider a chaque tache. Generez un fichier de depart avec /init, qui scanne votre projet et redige un CLAUDE.md, puis reduisez-le aux regles que vous corrigez vraiment sans cesse. Gardez-le court, car il est recharge a chaque tour et consomme le meme context window dont votre tache a besoin.

# Project Rules

## Stack
- TypeScript only. Package manager is bun, never npm.

## Conventions
- Use rounded-sm for border-radius. Never use em dashes; use "-".

## Quality
- Before saying a task is done, run: bun run lint && bun run typecheck && bun run test.

## Tone
- Direct and concise. No filler.

Aller plus loin: les quatre skills qui font de vous un power-user

Une fois les bases acquises, quatre fonctionnalites transforment Claude Code d'assistant utile en coequipier fiable. Chacune a son propre guide approfondi dans ce cluster. Les subagents vous laissent deleguer le travail annexe bruyant a un contexte frais, pour que votre session principale reste nette. Les hooks font tourner vos quality gates automatiquement, pour qu'aucune modification cassee ne passe. Les skills et slash commands emballent vos meilleurs workflows dans des declencheurs d'un mot. Et le MCP connecte l'agent a vos bases de donnees, navigateurs et services. Lisez-les dans n'importe quel ordre; ensemble, ils font la difference entre utiliser Claude Code et maitriser Claude Code.

• Subagents: deleguez recherche, review ou tests a un agent specialise dans son propre context window. Voir le guide Claude Code Subagents.
• Hooks: declenchez des commandes shell automatiquement sur les evenements du cycle de vie pour imposer formatage, tests et securite. Voir le guide Claude Code Hooks.
• Skills et slash commands: figez un workflow repete en /command ou skill reutilisable. Voir le guide Skills et Commands.
• MCP: connectez des tools et donnees externes via un protocole standard. Voir le guide de setup MCP.

Pas à pas

1. 01

   Installer Claude Code

   Executez l'installateur natif pour votre plateforme (curl sur macOS/Linux/WSL, irm dans Windows PowerShell) ou utilisez npm avec Node.js 18+. Confirmez avec "claude --version".

2. 02

   Lancer votre premiere session

   Ouvrez un terminal dans votre projet, executez "claude" et connectez-vous via le navigateur quand on vous le demande. Commencez par une requete a faible risque comme "explique ce que fait ce projet".

3. 03

   Planifier avant d'editer

   Appuyez sur Shift+Tab pour passer en mode plan. Laissez Claude proposer son approche sans toucher aux fichiers, et corrigez-le a moindre cout avant qu'aucun code ne soit ecrit.

4. 04

   Implementer et executer

   Approuvez le plan, laissez Claude faire les edits, et laissez-le executer vos tests ou le dev server, pour qu'il parte de vrais resultats plutot que de suppositions.

5. 05

   Verifier et committer

   Lisez le diff, corrigez ce qui ne va pas, et committez. Vous etes le quality gate qui decide ce qui devient permanent.

6. 06

   Ajouter un CLAUDE.md

   Executez /init pour generer un CLAUDE.md de depart, puis reduisez-le a votre stack, vos conventions et votre commande de quality gate, pour que l'agent suive vos regles a chaque session.

Questions fréquemment posées

Continuez à apprendre