Claude Code : Guide Complet — Installation, Commandes, Cas d'Usage

Note : ce guide a été rédigé en utilisant Claude Code lui-même. Une partie des exemples cités sont des workflows réels exécutés en production sur prompt-guide.com.

Pourquoi Claude Code change la donne

La plupart des développeurs utilisent ChatGPT ou Claude dans une fenêtre de chat à côté de leur éditeur. On copie-colle du code, on bricole, on revient au chat. C'est mieux que rien, mais c'est 30% de la valeur réelle de l'IA aujourd'hui.

Claude Code joue à un autre niveau. Il ne suggère pas du code : il écrit, lit, teste, refactore et commit directement dans ton dépôt git. Il parle aux APIs externes via MCP. Il peut lancer plusieurs sous-agents en parallèle. Il déclenche des workflows complets à partir d'une seule phrase.

Cas pro : refactor d'un module en 30 minutes

Tu reçois une demande : « il faut migrer notre système d'auth de NextAuth vers Better-Auth ». Sur 12 fichiers, dans 2 langages, avec des tests à mettre à jour. Avec Claude Code : tu décris l'objectif, il analyse le code existant, propose un plan, exécute la migration fichier par fichier, lance les tests, corrige les régressions et fait un commit propre. Ce qui prenait 4-6 heures se fait en 30-45 minutes, avec une qualité supérieure à un dev junior pressé.

Cas perso : automatiser ta vie de freelance

Tu es freelance. Chaque semaine tu génères des factures, mets à jour ton suivi de revenus, envoies des relances. Avec Claude Code, tu décris une fois ton process, il écrit les scripts qui tournent ensuite tout seuls. Tu passes de « 2h le dimanche soir » à « 0 minute, ça arrive dans mon Drive ».

---

Qu'est-ce que Claude Code, exactement ?

Claude Code est l'outil en ligne de commande officiel d'Anthropic, sorti en 2025 et disponible aussi via une extension VS Code et une app desktop Mac/Windows. Sa particularité : c'est un agent autonome, pas un assistant. La nuance est cruciale.

Un assistant attend tes instructions et te répond. Un agent reçoit un objectif et le poursuit jusqu'à ce qu'il soit atteint, en prenant des décisions intermédiaires, en utilisant des outils (lecture/écriture de fichiers, exécution de commandes, requêtes web, MCP) et en s'adaptant aux résultats.

Différences clés avec les alternatives

• vs ChatGPT / Claude.ai : Claude Code agit dans ton dépôt local, pas dans une sandbox isolée. Il a accès à tes vrais fichiers et peut lancer tes vraies commandes.
• vs Cursor / Windsurf : Cursor est un éditeur (fork de VS Code) avec assistance IA. Claude Code est un agent CLI qui peut être appelé depuis n'importe quel éditeur, y compris Cursor lui-même.
• vs GitHub Copilot : Copilot suggère des complétions de code en temps réel. Claude Code orchestre des tâches multi-fichiers de bout en bout.
• vs Codex (OpenAI) : Codex est l'équivalent OpenAI, avec une approche similaire. La différence majeure aujourd'hui est le contexte (Claude Sonnet 4.6 et Opus 4.7 ont un contexte plus large et un raisonnement supérieur sur les tâches complexes).

---

Installer Claude Code en 2 minutes

Claude Code s'installe en une seule commande sur n'importe quel système. Tu as besoin de Node.js 18+ et d'un compte Anthropic (le plan Pro à 20€/mois est suffisant pour démarrer, le plan Max débloque des limites plus élevées).

macOS et Linux

Puis lance Claude Code depuis n'importe quel dossier de projet :

Au premier lancement, Claude Code te demande de t'authentifier via le navigateur. C'est fait en 30 secondes.

Windows

Sur Windows, Claude Code fonctionne via WSL2 (Windows Subsystem for Linux). Installe d'abord WSL2 depuis le Microsoft Store, puis suis les mêmes instructions que macOS/Linux dans ton terminal Ubuntu.

Configuration initiale recommandée

Une fois Claude Code lancé, prends 2 minutes pour configurer trois choses qui vont 10× ta productivité dès le jour 1 :

Conseil : Le fichier CLAUDE.md est le levier le plus sous-estimé. Un bon CLAUDE.md de 30 lignes vaut mieux que 200 prompts répétés. Claude lit ce fichier à chaque session et adapte son comportement à ton projet.

---

Les 5 commandes que tu utiliseras tous les jours

Claude Code utilise une syntaxe simple à base de slash commands. Voici les 5 essentielles à mémoriser dès le premier jour.

1. /plan — Planifier avant d'exécuter

Pour toute tâche qui touche plus de 2 fichiers, lance avec /plan. Claude analyse l'existant, propose une stratégie d'implémentation et attend ton OK. Tu corriges la trajectoire avant qu'il ne code, pas après. Gain typique : 50% de temps économisé sur les refactor.

2. /clear — Nettoyer le contexte

Quand tu changes de tâche, vide le contexte. Sinon Claude continue de raisonner avec les fichiers de la tâche précédente, ce qui pollue ses réponses. Réflexe : un /clear entre chaque chantier.

3. /compact — Résumer une longue session

Sur les sessions de plus de 1h, le contexte devient saturé. /compact demande à Claude de résumer la session jusqu'ici, libère 80% du contexte, et continue avec un état mental propre.

4. /review — Code review automatique

Avant de pusher une PR, lance /review sur ton diff. Claude relit comme un senior, identifie les bugs potentiels, les patterns douteux, les manques de tests. Bien plus rapide qu'un linter, plus utile qu'un checklist.

5. /commit — Commit propre, messages clairs

Après une série de modifications, /commit rédige un message de commit qui suit les conventions de ton repo (lu depuis CLAUDE.md ou git log). Plus jamais de « wip » ou « fix stuff ».

---

Skills, MCP et plan mode : les concepts qui changent tout

Au-delà des commandes de base, Claude Code expose trois mécanismes qui le différencient radicalement des alternatives. Maîtriser ces trois concepts, c'est passer de « utilisateur » à « employeur » de l'IA.

Les Skills : des workflows réutilisables

Un Skill est un workflow nommé que Claude déclenche automatiquement quand le contexte le justifie. Tu écris une fois la marche à suivre dans un fichier SKILL.md, et chaque fois que ton message correspond au déclencheur décrit, Claude applique le workflow sans que tu aies à le rappeler.

Exemple : un Skill « publier-article » qui, à chaque fois que tu écris « publie cet article », exécute la chaîne : lint markdown → vérification SEO → génération meta tags → insertion DB → invalidation cache → tweet annonce. Une heure à écrire le Skill = des dizaines d'heures économisées par la suite.

MCP (Model Context Protocol) : connecter Claude à tes outils

MCP est un protocole standard, créé par Anthropic fin 2024, qui permet à Claude (et à d'autres IA) de parler directement à des outils externes : Notion, Slack, GitHub, ta base de données, ton CRM, ton dashboard analytics, etc. Au lieu de copier-coller des données, Claude les lit et les écrit en direct via une API standardisée.

Pour Claude Code, MCP transforme l'usage. Plutôt que de demander « peux-tu m'expliquer comment notre table users est structurée », tu installes un MCP server PostgreSQL et Claude lit le schéma directement. Plutôt que de copier les commentaires d'une issue GitHub, tu actives le MCP GitHub et Claude consulte l'issue. Le copier-coller disparaît.

Plan mode : la sécurité quand tu joues avec du feu

Sur les tâches sensibles (refactor critique, migration de données, déploiement), active le plan mode. Claude n'exécute rien : il décrit ce qu'il ferait, fichier par fichier, commande par commande. Tu valides ou tu rejettes. C'est un filet de sécurité indispensable quand tu travailles sur de la prod.

---

5 cas d'usage concrets pour démarrer cette semaine

La théorie c'est bien, mais la vraie progression vient des cas d'usage. Voici 5 workflows que tu peux mettre en place dans les 7 prochains jours, par ordre de complexité croissante.

Cas 1 : générer la documentation manquante

Tu hérites d'un projet sans README. Lance Claude Code à la racine et demande : « Lis le code source et écris un README complet : ce que fait le projet, comment l'installer, comment lancer les tests, l'architecture en 1 paragraphe. » En 5 minutes, tu as une doc honnête, tirée du code réel.

Cas 2 : refactor d'un fichier monstre

Tu as un fichier de 800 lignes que personne n'ose toucher. Demande : « Découpe ce fichier en modules cohérents, déplace chaque fonction dans le bon module, mets à jour tous les imports, lance les tests à chaque étape. » Claude propose un plan, tu valides, il exécute. Une tâche qui prend une journée à un humain prend 30 minutes.

Cas 3 : ajouter des tests à du code legacy

« Pour chaque fonction publique de ce module, écris un test unitaire qui couvre le happy path, un test des cas limites, et un test des erreurs. Utilise Jest. » Claude lit le code, écrit les tests, les lance, corrige ses propres erreurs jusqu'à ce que tout passe. Couverture de 0 à 80% en quelques minutes.

Cas 4 : migration multi-fichiers

« Migre tous les usages de fetch() vers axios dans ce dépôt. Adapte la gestion d'erreur en conséquence. Lance les tests à la fin. » Sur 50 fichiers, c'est l'enfer manuellement. Avec Claude Code, c'est une seule commande.

Cas 5 : agent qui surveille tes tests CI

Configure un script qui, à chaque push, lance Claude Code avec : « Récupère les logs du dernier run CI, identifie les tests qui ont échoué, propose un fix pour chacun, ouvre une PR avec le diff. » Tu reçois une PR de fix dans les 5 minutes après chaque échec CI.

---

Claude Code vs Cursor vs Codex vs Aider : quand utiliser quoi

Le marché des assistants de code IA est devenu très dense en 2025-2026. Voici comment choisir selon ton cas d'usage.

Choisis Claude Code si…

• Tu veux un agent qui exécute des tâches complexes multi-fichiers de bout en bout
• Tu travailles en CLI ou via un éditeur que tu ne veux pas changer
• Tu as besoin d'orchestrer plusieurs sous-tâches en parallèle (multi-agent)
• Tu veux un raisonnement de qualité supérieure sur les tâches complexes (Opus 4.7)

Choisis Cursor si…

• Tu préfères un éditeur dédié (fork de VS Code) avec autocomplete IA intégré
• Tu veux un Tab-Tab très rapide pendant que tu codes
• Tu acceptes de quitter ton éditeur actuel

Choisis Codex (OpenAI) si…

• Tu es déjà fortement investi dans l'écosystème OpenAI (Custom GPTs, plan ChatGPT Pro)
• Tu veux tester les approches des deux labs (Anthropic et OpenAI)

Choisis Aider si…

• Tu veux un outil open-source avec contrôle total sur le modèle utilisé
• Tu veux pouvoir basculer entre Claude, GPT, modèles open-weight (Llama, Qwen)
• Tu travailles dans un environnement où tu ne peux pas envoyer de code à des APIs commerciales

Conseil : ces outils ne sont pas exclusifs. La combinaison la plus efficace en 2026 reste Cursor pour le edit rapide en éditeur + Claude Code pour les tâches agentiques de fond. Les meilleurs développeurs combinent les deux.

---

Aller plus loin : agents en parallèle et workflows avancés

Une fois les bases acquises, le vrai gain de productivité vient des agents en parallèle. Claude Code permet de lancer plusieurs sous-agents simultanés, chacun sur une sous-tâche indépendante, avec orchestration finale.

Le pattern « 4 agents pour un livrable »

Exemple typique : tu dois produire un mémo d'investissement de 8 pages sur une startup. Décompose en 4 sous-tâches indépendantes : (1) recherche marché, (2) analyse financière, (3) benchmark concurrentiel, (4) due diligence équipe. Lance 4 agents en parallèle, chacun avec son propre contexte. Pendant qu'ils travaillent, tu prépares le template Word. Quand ils ont fini, tu fusionnes. 4-6 heures de travail séquentiel deviennent 30-45 minutes de chef d'orchestre.

Hooks et automatisations

Claude Code expose des hooks qui se déclenchent à des moments précis : avant un commit, après une exécution de commande, à l'échec d'un test. Tu peux brancher des actions automatiques : envoi Slack, mise à jour Notion, push d'un dashboard. C'est ce qui transforme Claude Code d'un outil ponctuel en un membre invisible de ton équipe.

---

Limites et alternatives

Claude Code n'est pas une baguette magique. Voici les limites à connaître pour éviter les déceptions.

Ce que Claude Code fait moins bien

• Tâches très visuelles : pour du design d'interface ou du CSS très précis, le retour visuel manque cruellement. Cursor avec preview live est meilleur.
• Très gros monorepos (>500K lignes) : le contexte reste limité. Privilégie une découpe par sous-projet.
• Code propriétaire ultra-confidentiel : si tu ne peux légalement rien envoyer à Anthropic, regarde du côté d'Aider en self-hosted ou des solutions enterprise (Bedrock).

Coût réel

Le plan Anthropic Pro (20€/mois) couvre la majorité des usages individuels. Sur des projets intensifs (40h/semaine de Claude Code), le plan Max (100-200€/mois selon palier) devient nécessaire pour éviter les rate-limits. Compare au coût d'un dev junior à 4000€/mois — le ratio reste largement favorable.

---

Pour aller plus loin

Claude Code n'est qu'une brique de l'écosystème agentique. Pour comprendre les outils complémentaires :

• Cursor — l'éditeur IA-natif que beaucoup combinent avec Claude Code pour le edit rapide
• Codex (OpenAI) — l'alternative directe côté OpenAI, à comparer dans ton choix d'outillage
• MCP (Model Context Protocol) — le protocole pour brancher Claude Code à tes outils externes (Notion, GitHub, ta DB)
• Skills Claude — packager tes workflows récurrents pour qu'ils se déclenchent automatiquement
• Computer Use — la capacité connexe qui permet à Claude de piloter ton écran

---

Questions Fréquentes

Claude Code est-il gratuit ?

L'outil en lui-même est gratuit (open-source côté CLI), mais il consomme ton crédit Anthropic. Le plan Pro à 20€/mois suffit pour un usage régulier solo. Pour un usage intensif quotidien, vise le plan Max.

Peut-on utiliser Claude Code sans toucher à Claude.ai ?

Oui. Claude Code utilise ta clé API ou ton compte Pro/Max d'Anthropic, mais ne nécessite pas d'utiliser l'interface web claude.ai. Tu peux faire 100% de ton travail en CLI ou en VS Code.

Claude Code lit-il tout mon disque dur ?

Non. Claude Code ne voit que les fichiers dans le dossier où tu l'as lancé, et seulement quand il en a besoin. Tu valides chaque commande shell par défaut. Pour un dossier sensible, tu peux exclure des chemins via .claudeignore.

Quelle différence entre Claude Code et l'app Claude Desktop ?

L'app desktop (Cowork) est orientée non-développeurs : elle agit sur tes fichiers Office, ton Drive, etc. Claude Code est orienté développeurs : git, terminal, refactor de code. Les deux peuvent coexister sur la même machine.

Faut-il savoir programmer pour utiliser Claude Code ?

Pas obligatoirement. De plus en plus de non-développeurs l'utilisent pour automatiser des scripts personnels (gestion de fichiers, scraping, génération de rapports). Mais la maîtrise du terminal et de git reste utile pour exploiter 100% du potentiel.

Claude Code peut-il tourner en arrière-plan, sans surveillance ?

Oui, via les modes batch et les agents programmés. Tu peux configurer un script qui lance Claude Code chaque nuit pour traiter une queue de tâches. Garde toujours des garde-fous : limites de coût, scope restreint, validation humaine pour les actions critiques (déploiement, suppression).

Est-ce que mes données sont utilisées pour entraîner Claude ?

Non. Anthropic s'engage par contrat à ne pas utiliser les données des plans Pro/Max et API pour entraîner ses modèles. C'est l'une des différences majeures vs certains concurrents.