Claude Code : le guide pour bien démarrer
Lire en : English

Sommaire
- Claude Code, c'est quoi et en quoi c'est différent ?
- Quel abonnement faut-il pour Claude Code ?
- Installer Claude Code en 3 minutes
- Ta première session : les bonnes questions dans le bon ordre
- Le fichier CLAUDE.md : la mémoire de ton projet
- Les modes de permission : qui décide, toi ou l'agent ?
- Annuler une erreur avec /rewind
- Choisir le bon modèle
- Les 6 erreurs de débutant à éviter
- Questions fréquentes
- Questions fréquentes
- Sources
Claude Code est l'agent de code d'Anthropic : tu lui décris ce que tu veux en français, il lit ton projet, modifie les fichiers, lance les commandes et vérifie le résultat. Ce guide Claude Code te fait passer de l'installation à ta première fonctionnalité, avec les réglages qui évitent les mauvaises surprises. Prévois un abonnement Claude payant et un dossier de projet, c'est tout.
Claude Code, c'est quoi et en quoi c'est différent ?
Claude Code est un agent, pas un simple chat : il agit dans ton projet au lieu de te donner du code à copier-coller. La documentation officielle le décrit comme un outil qui « lit ta base de code, modifie des fichiers, exécute des commandes et s'intègre à tes outils de développement ».
À la différence d'un éditeur comme Cursor, Claude Code est né dans le terminal. Il existe aujourd'hui sur plusieurs surfaces :
| Surface | Pour qui | Ce qu'il faut savoir |
|---|---|---|
| Terminal (CLI) | Ceux qui veulent toutes les fonctions | La version la plus complète |
| VS Code (et Cursor) | Ceux qui veulent voir les diffs dans l'éditeur | Extension officielle, diffs en ligne, revue du plan |
| JetBrains | Utilisateurs d'IntelliJ, PyCharm, WebStorm | Plugin qui s'appuie sur la CLI, à installer à part |
| App de bureau | Ceux qui n'aiment pas le terminal | Onglet « Code » de l'app Claude, abonnement payant requis |
| Web et mobile | Tâches longues sans installation | Sur claude.ai/code, à partir d'un dépôt GitHub |
Si tu débutes et que le terminal te fait peur, l'app de bureau est la porte d'entrée la plus douce. Le fonctionnement décrit dans ce guide reste le même.
Quel abonnement faut-il pour Claude Code ?
Claude Code demande un abonnement Claude payant ou un compte API ; l'offre gratuite de Claude ne l'inclut pas. Tarifs relevés le 21 novembre 2026 sur la page officielle des prix de Claude :
| Offre | Prix | Usage | Claude Code |
|---|---|---|---|
| Free | 0 $ | Limité | Non inclus |
| Pro | 20 $ par mois, ou 17 $ par mois en annuel (200 $ payés d'avance) | Référence | Inclus |
| Max | 100 $ par mois | 5 fois l'usage Pro | Inclus |
| Ultra | 200 $ par mois | 10 fois l'usage Pro par semaine, sans limite sur 5 heures | Inclus |
| Team | 25 $ par siège standard (20 $ en annuel), 125 $ par siège premium (100 $ en annuel) | Selon le siège | Inclus |
| Console (API) | À l'usage, crédits prépayés | Selon tes dépenses | Inclus |
Prix en dollars, hors taxes. Pour un premier projet, Pro suffit pour apprendre. Si tu atteins souvent la limite, Max devient rentable. La documentation sur les coûts donne un repère côté entreprise : en moyenne environ 13 $ par développeur et par jour actif, entre 150 et 250 $ par mois, et moins de 30 $ par jour actif pour 90 % des utilisateurs. Ce sont des usages professionnels intensifs, pas ceux d'un side project.
Installer Claude Code en 3 minutes
L'installation se fait en une commande, puis Claude Code te demande de te connecter au premier lancement.
- Ouvre un terminal. Sur Mac : application Terminal. Sur Windows : PowerShell.
- Lance l'installateur officiel.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
- Vérifie : ouvre un nouveau terminal et tape
claude --version. Un numéro de version doit s'afficher. - Lance Claude Code dans ton projet :
cd mon-projet
claude
- Connecte-toi avec ton compte Claude dans le navigateur qui s'ouvre.
Alternatives : brew install --cask claude-code sur Mac, winget install Anthropic.ClaudeCode sur Windows. Attention, la documentation précise que ces deux méthodes ne se mettent pas à jour seules, contrairement à l'installateur natif. Sur Windows natif, installe Git for Windows pour que Claude Code puisse utiliser Bash.
Ta première session : les bonnes questions dans le bon ordre
Commence par faire parler Claude Code de ton projet avant de lui demander de le modifier. Les premiers prompts proposés par la documentation sont simples, et c'est voulu :
what does this project do?
explain the folder structure
where is the main entry point?
Tu peux écrire en français, Claude comprend. Ensuite, une première modification minuscule, pour voir comment il te demande la permission :
Ajoute un pied de page avec l'année en cours sur la page d'accueil. Montre-moi le changement avant de l'appliquer.
Claude Code n'a pas besoin que tu lui colles tes fichiers : il lit lui-même ce dont il a besoin. Tape /help pour voir les commandes disponibles et /resume pour reprendre une conversation précédente.
Le fichier CLAUDE.md : la mémoire de ton projet
Le fichier CLAUDE.md contient les consignes que Claude Code lit au début de chaque session. Chaque session repart d'une fenêtre de contexte vide : sans ce fichier, tu réexpliques tout à chaque fois.
- Où le mettre :
./CLAUDE.mdà la racine du projet (partagé avec l'équipe via Git),~/.claude/CLAUDE.mdpour tes préférences sur tous tes projets,./CLAUDE.local.mdpour tes réglages perso du projet (à ajouter au.gitignore). - Comment le créer : lance
/init. Claude analyse le projet et génère un premier fichier avec les commandes de build, de test et les conventions qu'il a repérées. - Si ton projet a déjà un AGENTS.md (le format lu par Codex et d'autres agents), Claude Code sait le lire aussi.
Voici un modèle à adapter pour un projet de vibe coding :
# Projet : app de réservation (Next.js + Supabase)
## Commandes
- Lancer en local : npm run dev
- Vérifier avant de rendre la main : npm run build && npm test
## Règles
- Explique ton plan en 3 lignes avant toute modification qui touche plus de 2 fichiers.
- Aucune clé secrète dans le code front ; les secrets vont dans .env.local.
- Toute nouvelle table Supabase a des règles RLS activées.
- Fais un commit Git après chaque étape qui fonctionne.
Les deux règles du milieu valent de l'or : elles évitent les clés API exposées dans le front et l'erreur RLS de Supabase. Pour aller plus loin sur ces fichiers de contexte, lis notre guide CLAUDE.md, AGENTS.md et rules.
Les modes de permission : qui décide, toi ou l'agent ?
Le mode de permission fixe ce que Claude Code peut faire sans te demander. Tu changes de mode à tout moment avec Maj+Tab.
| Mode | Ce qui passe sans demander | Pour quoi |
|---|---|---|
default (manuel) | Les lectures de fichiers | Code inconnu, travail sensible |
acceptEdits | Lectures, modifications de fichiers, commandes de fichiers courantes | Itérer sur du code que tu relis |
plan | Lectures et exploration, aucune modification avant ton accord | Explorer et planifier avant de toucher |
auto | Tout, avec un second modèle qui vérifie chaque action en arrière-plan | Tâches longues, moins d'interruptions |
dontAsk | Seulement les outils pré-autorisés | Scripts et intégration continue |
bypassPermissions | Tout, sans contrôle | Conteneurs et machines virtuelles isolés uniquement |
Pour un débutant, la bonne routine : mode plan pour toute fonctionnalité qui touche plusieurs fichiers, relecture du plan, puis validation. C'est la même logique que le cahier des charges avant le prompt. Le mode bypassPermissions n'a rien à faire sur ton ordinateur personnel.
Annuler une erreur avec /rewind
Claude Code enregistre un point de restauration avant chaque prompt que tu envoies. Tape /rewind, ou appuie deux fois sur Échap quand la zone de saisie est vide, pour ouvrir le menu de retour en arrière. Tu choisis ensuite de restaurer le code, la conversation, ou les deux.
La documentation indique que Claude Code garde les instantanés des 100 derniers checkpoints d'une session. C'est un filet de sécurité, pas un système de versions : continue à faire des commits avec Git, même en vibe coding.
Choisir le bon modèle
La commande /model te laisse choisir le modèle. Les alias évitent de retenir les numéros de version :
sonnetpour le travail courant ;opuspour le raisonnement complexe ;haikupour les tâches simples et rapides ;opusplanutilise Opus pendant la planification, puis Sonnet pour l'exécution.
Un modèle plus puissant consomme ton quota plus vite. Pour comparer les familles de modèles entre elles, vois quel modèle d'IA choisir pour coder.
Les 6 erreurs de débutant à éviter
- Lancer Claude Code dans ton dossier personnel au lieu du dossier du projet. Il travaille là où tu le lances.
- Demander une app entière en un message. Découpe en étapes vérifiables, comme le montre la méthode du prompt en 5 étapes.
- Ne jamais lire les diffs. Survole au moins les fichiers modifiés et lis les messages d'erreur.
- Pas de commit entre les étapes. Une étape qui marche mérite un commit.
- Oublier de demander une vérification. Termine tes demandes par « lance le build et les tests, corrige les erreurs ». Pour tester sans être développeur, lis notre guide dédié.
- Mettre en ligne sans contrôle. Passe d'abord par la checklist sécurité avant la mise en ligne.
Pour comparer Claude Code aux autres outils du moment, notre comparatif des meilleurs outils de vibe coding et notre face-à-face Cursor, Claude Code et Codex t'aideront à trancher.
Questions fréquentes
Questions fréquentes
Claude Code est-il gratuit ?
Non. Claude Code n'est pas inclus dans l'offre gratuite de Claude. Il faut au minimum l'abonnement Pro, à 20 $ par mois ou 17 $ par mois en paiement annuel au 21 novembre 2026, ou un compte Claude Console facturé à l'usage via l'API. Les offres Max, Ultra, Team et Enterprise l'incluent aussi, avec davantage d'usage.
Faut-il savoir utiliser le terminal pour Claude Code ?
Il suffit de savoir ouvrir un terminal, aller dans un dossier avec cd et taper claude. La documentation propose même un guide du terminal pour les grands débutants. Si tu préfères éviter complètement la ligne de commande, l'app de bureau Claude intègre Claude Code dans un onglet « Code » et l'extension VS Code fonctionne dans l'éditeur.
Quelle différence entre Claude Code et Claude sur claude.ai ?
Claude sur claude.ai est un assistant conversationnel : il te répond et te propose du code. Claude Code est un agent : il travaille directement dans les fichiers de ton projet, lance des commandes, exécute les tests et corrige ses erreurs. Pour construire et maintenir une vraie application, Claude Code évite les allers-retours de copier-coller.
Claude Code peut-il casser mon projet ?
Il peut faire une modification que tu ne voulais pas, comme tout agent. Trois protections réduisent le risque : le mode de permission (garde default ou plan au début), la commande /rewind qui restaure le code avant un prompt, et Git, qui garde l'historique complet. Ne lance jamais le mode bypassPermissions hors d'un environnement isolé.
Claude Code fonctionne-t-il en français ?
Oui. Tu peux écrire tes demandes et ton fichier CLAUDE.md en français, Claude comprend et répond en français. Les commandes (/init, /rewind, /model) et les noms de fichiers restent en anglais. Pour du code partagé avec une équipe internationale, demande des commentaires et messages de commit en anglais dans ton CLAUDE.md.


