Claude Code Tutorial: The Complete Developer Guide (2026)

Claude Code est l'agent de développement en ligne de commande d'Anthropic. Il lit l'intégralité de votre codebase, exécute des commandes shell, corrige des bugs et pousse des commits — le tout en langage naturel. Si vous avez déjà vu une démo et voulu reproduire le résultat, ce tutoriel est fait pour vous. Nous allons couvrir l'installation, la configuration avancée, les commandes du quotidien et les fonctionnalités qui font vraiment la différence : Plan Mode, hooks, et serveurs MCP. Pour un avis complet sur la tarification et les cas d'usage, consultez notre avis Claude Code.

Want to try this tool yourself? Try Claude Code

Installation de Claude Code

Claude Code s'installe en une commande depuis n'importe quel terminal macOS, Linux ou Windows (WSL). Prérequis : Node.js 18+ et un compte Anthropic avec crédits API actifs.

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

Au premier lancement, Claude Code ouvre votre navigateur pour l'authentification OAuth avec votre compte Anthropic. Après autorisation, le token est stocké localement dans `~/.claude/`. Vous n'avez plus à vous réauthentifier entre les sessions. Claude Code est également disponible comme extension VS Code et JetBrains : cherchez Claude Code dans les marketplaces respectives. Le comportement est identique, mais l'interface est intégrée à l'IDE.

Configurer votre fichier CLAUDE.md

Le fichier `CLAUDE.md` à la racine de votre projet est la « constitution » de l'agent. C'est la première chose que Claude Code lit au démarrage d'une session. Un CLAUDE.md bien écrit évite 80 % des erreurs de contexte.

Structure recommandée pour un projet web :

```markdown # Mon Projet ## Stack technique - Next.js 15, TypeScript strict, Tailwind CSS 4 - Tests : Vitest + Playwright - Package manager : pnpm ## Commandes clés - `pnpm dev` : serveur de développement - `pnpm test` : tests unitaires - `pnpm build` : build de production ## Conventions - Commits en anglais, format Conventional Commits - Jamais de `console.log` en production - Les composants React sont toujours des Server Components sauf mention contraire ## Fichiers à ne JAMAIS modifier - `.env.production` - `src/migrations/` ```

Astuce avancée : vous pouvez créer plusieurs `CLAUDE.md` à différents niveaux du projet. Claude Code les fusionne hiérarchiquement. Un `src/components/CLAUDE.md` peut définir des conventions spécifiques aux composants sans polluer le CLAUDE.md racine.

Les commandes essentielles de Claude Code

Claude Code fonctionne en mode conversationnel : vous tapez une instruction en langage naturel et l'agent exécute les actions nécessaires. Mais il existe aussi des commandes slash pour contrôler l'agent lui-même.

Commandes slash intégrées :

| Commande | Usage | |---|---| | `/help` | Liste toutes les commandes disponibles | | `/clear` | Efface le contexte de la session courante | | `/model` | Change le modèle (ex: opus, sonnet, haiku) | | `/compact` | Compresse la conversation pour libérer du contexte | | `/cost` | Affiche le coût estimé de la session en cours | | `/review` | Lance une revue de code sur les changements en attente |

Flags CLI utiles :

```bash # Mode non-interactif (pour CI/CD) claude -p "Corrige tous les warnings TypeScript" --no-interactive # Limiter les permissions (pas de shell, lecture seule) claude --no-bash --read-only # Spécifier un modèle directement claude --model claude-opus-4-7 ```

Plan Mode : travaillez avant d'agir

Plan Mode est l'une des fonctionnalités les plus sous-utilisées de Claude Code. Au lieu de modifier directement des fichiers, l'agent planifie d'abord, présente le plan à valider, puis exécute. C'est la différence entre un junior qui code immédiatement et un senior qui pense avant d'agir.

Pour activer Plan Mode : appuyez sur Shift+Tab dans n'importe quelle session Claude Code, ou utilisez le raccourci `/plan` suivi de votre instruction.

Exemple concret : vous voulez refactoriser un module de 800 lignes. Sans Plan Mode, Claude Code commence à modifier des fichiers immédiatement. Avec Plan Mode, il produit d'abord un plan structuré — fichiers impactés, ordre des modifications, risques identifiés — et attend votre validation. Vous pouvez ajuster le plan avant que la première ligne soit modifiée. Pour les projets importants, l'association Plan Mode + revue humaine réduit drastiquement les régressions.

Automatiser avec les hooks Claude Code

Les hooks sont des commandes shell qui s'exécutent automatiquement en réponse à des événements Claude Code. Contrairement aux commandes slash (probabilistes), les hooks sont déterministes : ils se déclenchent à chaque fois, indépendamment du comportement du modèle.

Configuration dans `.claude/settings.json` :

```json { "hooks": { "PostToolUse": [ { "matcher": "Edit|Write", "hooks": [ { "type": "command", "command": "pnpm lint --fix" } ] } ], "Stop": [ { "hooks": [ { "type": "command", "command": "terminal-notifier -message 'Claude a terminé'" } ] } ] } } ```

Dans cet exemple : chaque fois que Claude Code modifie un fichier (`Edit` ou `Write`), le linter s'exécute automatiquement. Et quand la session se termine (`Stop`), une notification macOS est envoyée. Cas d'usage fréquents : linter + formateur après chaque écriture, tests unitaires sur les fichiers modifiés, webhook Slack en fin de session, commit automatique des changements validés.

Connecter des serveurs MCP

MCP (Model Context Protocol) est le protocole d'extension de Claude Code. Il vous permet de connecter l'agent à des systèmes externes : bases de données, APIs, systèmes de fichiers distants, outils de suivi. Un serveur MCP expose des outils que Claude Code peut appeler comme n'importe quelle commande.

Pour ajouter un serveur MCP (exemple avec le serveur filesystem officiel) :

```bash claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/vers/dossier ```

Serveurs MCP populaires en 2026 : filesystem (accès à des répertoires hors projet), github (issues, PRs, CI depuis Claude Code), postgres/sqlite (requêtes directes en langage naturel), slack (notifications, lecture de canaux), puppeteer (scraping et tests E2E automatisés). La liste officielle est maintenue sur le dépôt GitHub `awesome-claude-code`. Pour les équipes, les serveurs MCP se configurent dans `.claude/settings.json` au niveau projet pour que tous les membres bénéficient du même environnement.

Workflow complet : du ticket au merge request

Voici un workflow réel d'un développeur qui utilise Claude Code quotidiennement :

1. Analyser le contexte ``` > Lis le ticket #247 dans notre MCP GitHub et résume ce qui est attendu ```

2. Planifier (Plan Mode) ``` > [Shift+Tab] Propose un plan d'implémentation pour ce ticket. Identifie les fichiers à modifier et les risques. ```

3. Implémenter ``` > Le plan me convient. Implémente les changements. Lance les tests après chaque fichier modifié. ```

4. Revue et commit ``` > /review > Crée un commit Conventional Commits avec un message descriptif ```

5. Ouvrir la MR ``` > Pousse la branche et ouvre une pull request vers main avec une description complète ```

Ce workflow complet — du ticket à la MR — peut se faire en quelques minutes pour des tickets moyens. Pour une comparaison avec l'approche dans l'éditeur, consultez notre comparatif Cursor vs Claude Code.

FAQ — Questions fréquentes sur Claude Code

Claude Code est-il gratuit ? Non, Claude Code nécessite un plan Claude Pro (20$/mois) ou l'API Anthropic. Le plan Pro offre un usage illimité dans l'IDE ; l'API est facturée à l'usage. Pour les tarifs détaillés, voir notre avis Claude Code.

Claude Code fonctionne-t-il hors connexion ? Non, chaque requête passe par l'API Anthropic. Il faut une connexion internet active. Vos fichiers restent locaux — seul le contexte envoyé à l'API transite.

Peut-on utiliser Claude Code sur un projet monorepo ? Oui. Placez un `CLAUDE.md` à la racine et des `CLAUDE.md` spécifiques dans chaque package. Claude Code charge tous les fichiers de la hiérarchie.

Claude Code peut-il remplacer un développeur ? Non — et ce n'est pas l'objectif. C'est un multiplicateur de productivité. Les développeurs qui utilisent Claude Code livrent plus vite, mais la revue, l'architecture et les décisions techniques restent humaines.

Quelle différence avec GitHub Copilot ? Copilot complète du code ligne par ligne dans l'éditeur. Claude Code exécute des tâches complètes : il lit des fichiers, lance des commandes, gère le git. Ce sont deux niveaux d'abstraction différents.

Mes données sont-elles envoyées à Anthropic ? Le contenu de vos fichiers inclus dans le contexte est transmis à l'API. Anthropic ne s'en sert pas pour entraîner ses modèles (pour les clients API). Consultez la politique de confidentialité Anthropic pour votre type de compte.

Conclusion

Claude Code n'est pas qu'un outil d'autocomplétion. C'est un agent qui comprend votre projet, planifie des modifications complexes et s'intègre à votre workflow via hooks et MCP. La courbe d'apprentissage est courte — une après-midi suffit pour les bases — mais la maîtrise des fonctionnalités avancées (Plan Mode, hooks, orchestration multi-agents) fait une vraie différence sur des projets réels. Commencez par installer l'outil, créer un `CLAUDE.md` soigné et expérimenter avec quelques tickets simples. Vous trouverez rapidement votre propre workflow.