Tutoriel Claude Code : installation et première tâche

Ce tutoriel Claude Code vous mène de zéro à votre première session opérationnelle : une commande d’installation, la connexion avec votre compte Claude, une première tâche dans votre propre projet et le fichier CLAUDE.md, grâce auquel l’agent retient les règles du projet. Il vous faut un terminal, n’importe quel projet de code et un abonnement Claude payant (Pro, Max, Team ou Enterprise) ou un compte Claude Console avec des crédits API. Le tout prend un quart d’heure.

J’écris en tant qu’utilisateur : je gère ce site avec Claude Code, du code jusqu’à la publication des articles. Toutes les commandes ci-dessous viennent de la documentation officielle.

Qu’est-ce que Claude Code

Claude Code est l’agent de programmation d’Anthropic, et il tourne dans le terminal. Contrairement à un chat, il ne se contente pas de répondre : il lit les fichiers du dépôt, les modifie, lance des commandes, écrit des tests et fait des commits. Vous décrivez ce que vous voulez obtenir, et Claude cherche lui-même les bons fichiers et propose des modifications.

Le même moteur fonctionne aussi hors du terminal : dans VS Code et JetBrains, dans l’application de bureau, dans le navigateur sur claude.ai/code et dans l’application mobile. Dans ce tutoriel, je reste dans le terminal, parce que c’est là qu’on voit le plus de choses.

Tutoriel Claude Code : l’installation en une commande

La méthode recommandée est l’installateur natif, qui se met à jour tout seul en arrière-plan.

macOS, Linux et WSL :

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

Windows PowerShell :

irm https://claude.ai/install.ps1 | iex

Windows CMD :

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

L’installateur n’affiche pas de progression. Une fois terminé, ouvrez une nouvelle fenêtre de terminal et vérifiez :

claude --version

Si vous voyez un numéro de version suivi de (Claude Code), tout fonctionne. Un message indiquant que claude n’est pas reconnu signifie généralement que le dossier d’installation manque dans le PATH ; la documentation y consacre une section dédiée.

Alternatives : brew install --cask claude-code sur macOS et winget install Anthropic.ClaudeCode sur Windows. Ces deux méthodes ne se mettent pas à jour automatiquement. Sous Windows sans WSL, mieux vaut installer Git for Windows pour que Claude ait accès à Bash.

Connexion et première session

Placez-vous dans le dossier du projet et lancez l’agent :

cd /chemin/vers/projet
claude

Au premier lancement, Claude Code vous demande de vous connecter dans le navigateur. Vous vous connectez avec un compte Claude (abonnement Pro, Max, Team ou Enterprise) ou avec un compte Claude Console, c’est-à-dire un accès à l’API avec des crédits prépayés. Les identifiants sont enregistrés, vous ne le faites donc qu’une fois. Si la variable ANTHROPIC_API_KEY est définie, Claude vous demande s’il doit l’utiliser et saute la connexion.

Une fois connecté, vous voyez un prompt avec le numéro de version, le nom du modèle et le dossier de travail. Tapez /help pour voir les commandes disponibles.

La première tâche

Commencez par des questions avant de laisser l’agent modifier quoi que ce soit. Claude lit les fichiers lui-même, inutile de les coller :

que fait ce projet ?
où se trouve le point d'entrée principal ?
explique la structure des dossiers

Ensuite, une petite modification :

ajoute une fonction hello world au fichier principal

Claude trouve le bon fichier et affiche un diff. S’il demande votre accord, validez. Ce pour quoi l’agent doit demander la permission dépend du mode d’autorisations, que vous changez avec Shift+Tab. Dans les versions récentes, le mode par défaut est le mode auto, où un modèle classificateur distinct vérifie les actions et ne bloque que celles qui sont risquées.

Git aussi se pilote en phrases :

quels fichiers ai-je modifiés ?
fais un commit avec un message descriptif
crée une branche feature/quickstart

CLAUDE.md, la mémoire du projet

Chaque session démarre avec un contexte vide. Pour ne pas réexpliquer à chaque fois comment le projet se compile et quelles conventions vous suivez, notez-le dans un fichier CLAUDE.md à la racine du dépôt. Claude le lit au début de chaque conversation.

Le plus rapide est de commencer par la commande /init : Claude analyse le dépôt et génère un fichier avec les commandes de build, les tests et les conventions qu’il découvre lui-même. Ensuite, vous ajoutez ce qu’on ne peut pas déduire du code.

Ce qu’il vaut la peine d’y mettre selon la documentation :

• les commandes que Claude ne devinera pas (build, tests, lint),
• les règles de style qui s’écartent des conventions par défaut,
• l’étiquette du dépôt (noms de branches, conventions de PR),
• les décisions d’architecture et les pièges propres au projet.

Ce qu’il ne faut pas y mettre : ce que Claude lit tout seul dans le code, et les généralités du genre « écris du code propre ». La documentation conseille de garder le fichier sous les 200 lignes. Les fichiers plus longs consomment du contexte et sont moins bien respectés.

Quelques faits qui vous éviteront des recherches :

• ~/.claude/CLAUDE.md contient vos règles personnelles pour tous les projets, ./CLAUDE.md les règles du projet partagées avec l’équipe, et ./CLAUDE.local.md des notes privées pour un dépôt donné (ajoutez-le au .gitignore).
• Le fichier peut inclure d’autres fichiers avec la syntaxe @chemin/vers/fichier.
• Si le dépôt contient déjà un AGENTS.md pour d’autres agents, Claude Code le lira à la place de CLAUDE.md.
• /context montre quels fichiers de mémoire ont été chargés.

Les commandes à connaître

Commande	Ce qu’elle fait
claude	lance une session interactive
claude "tâche"	démarre directement avec une première instruction
claude -p "question"	une requête unique sans session, résultat dans le terminal
claude -c	reprend la dernière conversation dans ce dossier
claude -r	choisit une conversation précédente à reprendre
/init	génère un CLAUDE.md de départ
/clear	vide le contexte entre des tâches sans rapport
/compact	résume la conversation pour libérer du contexte
/rewind (ou deux fois Esc)	ramène la conversation et les modifications de fichiers à un point choisi
/permissions	liste des outils de confiance, moins de demandes d’accord
Shift+Tab	change le mode d’autorisations, y compris le mode plan
/exit	quitter

Le mode -p est particulièrement pratique dans les scripts : cat error.log | claude -p "explique cette erreur" envoie le fichier directement au modèle.

Cinq habitudes qui font la différence

La plupart des conseils des bonnes pratiques officielles se ramènent à une contrainte : la fenêtre de contexte se remplit vite, et la qualité baisse avec elle.

1. D’abord explorer et planifier, ensuite coder. Pour les changements importants, activez le mode plan (Shift+Tab jusqu’à ce que plan mode on apparaisse). Claude lit les fichiers et propose un plan, mais ne modifie rien tant que vous ne l’avez pas validé. Pour une correction d’une ligne, le plan est une surcharge inutile.
2. Soyez précis. Au lieu de « corrige le bug de connexion », dites quel est le symptôme, où se trouve probablement la cause et ce que « corrigé » veut dire. Désignez les fichiers avec @nom-du-fichier.
3. Donnez à l’agent un moyen de vérifier son travail. Des tests, un build, un lint ou une capture d’écran de référence. Sans cela, « ça a l’air fini » est le seul signal, et c’est vous qui devenez le testeur.
4. Nettoyez le contexte. /clear entre des tâches sans rapport. Si vous avez corrigé Claude deux fois sur le même point, recommencez avec un meilleur prompt.
5. Revenez en arrière sans crainte. Chaque prompt crée un point de contrôle. Quand une expérience échoue, /rewind restaure la conversation et les fichiers. Ça ne remplace pas git, mais ça encourage des essais plus audacieux.

Questions fréquentes

Claude Code est-il gratuit ?

Non. La documentation exige un abonnement Claude payant (Pro, Max, Team ou Enterprise) ou un compte Claude Console, où vous payez les tokens API. Les tarifs actuels des abonnements sont sur claude.com/pricing.

Claude Code fonctionne-t-il sous Windows ?

Oui, en natif (PowerShell ou CMD) et dans WSL. Sous Windows natif, mieux vaut avoir Git for Windows, car l’agent utilise alors Bash ; sans lui, il utilise PowerShell.

Dois-je utiliser le terminal ?

Non. Le même agent existe en extension pour VS Code et JetBrains, en application de bureau et en version navigateur. Les fichiers CLAUDE.md, les réglages et les serveurs MCP fonctionnent de la même façon sur toutes ces interfaces.

En quoi Claude Code diffère-t-il du chat Claude ?

Le chat répond à des questions. Claude Code travaille dans votre dépôt : il lit et modifie des fichiers, lance des commandes et des tests, fait des commits et ouvre des pull requests. Il reçoit donc une tâche, pas une question.