Claude Code : Tutoriel Complet en Français

1. Qu’est-ce que Claude Code ?

Claude Code est un outil en ligne de commande qui connecte votre terminal aux modèles Claude d’Anthropic. Quand vous lui donnez une instruction (« Refactore cette fonction en async/await », « Ajoute des tests unitaires pour le module auth »), il parcourt votre code, comprend la structure du projet, et effectue les modifications directement dans vos fichiers.

Ce n’est ni un plugin d’IDE, ni un chatbot web : c’est un pair programmer agentique qui lit votre codebase, exécute des commandes terminal, et modifie vos fichiers — le tout avec votre approbation.

2. Claude Code vs Cursor vs Copilot

3. Installation

Méthode recommandée : installateur natif (sans Node.js)

Depuis début 2026, Anthropic propose un installateur natif qui ne nécessite plus Node.js. C’est la méthode officiellement recommandée :

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

Windows (PowerShell)winget install Anthropic.ClaudeCode

Pour Windows sans winget, utilisez WSL2 :

Windows (WSL2)wsl --install -d Ubuntu
# puis dans le terminal Ubuntu :
curl -fsSL https://claude.ai/install.sh | bash

Vérifiez l’installation :

Terminalclaude --version

Méthode alternative : npm (dépréciée)

L’installation via npm fonctionne encore mais n’est plus recommandée :

Terminalnpm install -g @anthropic-ai/claude-code

4. Authentification

Au premier lancement, Claude Code vous propose plusieurs méthodes d’authentification :

Le plus simple pour débuter : utilisez votre abonnement Claude Pro (20$/mois) qui inclut l’accès à Claude Code.

5. Première utilisation

6. Commandes essentielles

7. Workflows courants

Refactoring d’un module

Claude CodeRefactore le module auth/ pour utiliser async/await au lieu des callbacks.
Garde la compatibilité avec les tests existants.

Claude Code lit les fichiers du module, propose les modifications avec un diff, et attend votre approbation avant d’écrire.

Ajout de tests

Claude CodeAjoute des tests unitaires pour src/utils/validation.ts.
Utilise vitest. Couvre les cas limites et les entrées invalides.

Debugging

Claude CodeLe test test/api/users.test.ts échoue avec "TypeError: Cannot read
property 'id' of undefined". Trouve et corrige le bug.

Claude Code lit le test, trace l’erreur dans le code source, lance le test pour reproduire, et propose un fix.

Comprendre un projet inconnu

Claude CodeExplique-moi l'architecture de ce projet. Quels sont les principaux
modules et comment ils communiquent entre eux ?

Git workflow

Claude CodeCrée un commit avec un message conventionnel pour les changements en cours,
puis ouvre une PR sur GitHub avec une description détaillée.

8. Serveurs MCP

Le Model Context Protocol (MCP) permet à Claude Code de se connecter à des outils externes. C’est un standard ouvert créé par Anthropic et adopté par l’industrie.

Terminalclaude mcp add github
claude mcp add postgres --connection-string "postgresql://localhost/mabase"
claude mcp add filesystem --path ~/projets

Une fois connecté, Claude Code peut créer des PRs GitHub, requêter votre base de données, ou naviguer sur le web — directement depuis la conversation.

9. Le fichier CLAUDE.md

C’est l’arme secrète pour tirer le maximum de Claude Code. Créez un fichier CLAUDE.md à la racine de votre projet. Claude Code le lit automatiquement à chaque session et l’utilise comme contexte permanent.

CLAUDE.md# Mon Projet

## Stack technique
- Frontend : Next.js 15, TypeScript, Tailwind CSS
- Backend : Node.js, Express, PostgreSQL
- Tests : Vitest, Playwright

## Conventions
- Noms de variables en camelCase
- Commits conventionnels (feat:, fix:, refactor:)
- Composants React : un fichier par composant dans /components

## Architecture
- /src/api → routes Express
- /src/components → composants React
- /src/lib → utilitaires partagés
- /src/db → modèles et migrations Prisma

Plus votre CLAUDE.md est précis, plus Claude Code sera pertinent et cohérent dans ses modifications.

10. Astuces et bonnes pratiques

Utilisez --thinking high pour les tâches complexes (architecture, refactoring multi-fichiers). Le mode thinking permet à Claude de « réfléchir » plus longtemps avant d’agir, ce qui produit de meilleurs résultats.

Approuvez sélectivement : Contrairement au vibe coding pur, prenez le temps de lire les diffs, surtout pour le code touchant à l’auth, aux paiements, ou aux données sensibles.

Combinez avec un IDE : Beaucoup de développeurs lancent Claude Code dans un terminal intégré à VS Code ou Cursor, obtenant le meilleur des deux mondes.

Soyez spécifique : « Ajoute une validation email avec regex + message d’erreur custom dans le formulaire d’inscription » donne de bien meilleurs résultats que « Valide l’email ».

Utilisez les tags GitHub : Vous pouvez taguer @claude dans les PRs GitHub pour déclencher une revue de code automatique par Claude Code.

11. Coût et tarification

12. FAQ