Découvre Claude Code - ton IA dans le terminal

Bienvenue à bord du dernier module ! Le Capitaine Redbeard a gardé pour toi la plus belle boussole de la flotte : Claude Code - l'outil CLI officiel d'Anthropic, celui qui transforme un terminal en assistant de développement agentique.

Qu'est-ce que Claude Code ?

Claude Code est un outil agentique en ligne de commande (CLI - Command Line Interface) créé par Anthropic. Ce n'est pas un chat de plus : Claude Code lit et modifie lui-même les fichiers de ton projet, exécute des commandes dans le terminal et mène des tâches complexes sur plusieurs fichiers à la fois.

Ce n'est donc ni une extension du navigateur Chrome, ni une bibliothèque frontend pour construire des interfaces, ni un système d'exploitation pour serveurs. C'est la différence entre une carte au trésor et un vrai navigateur qui prend la barre et mène le navire là où il faut.

Claude Code vs Cursor

Les deux équipages naviguent sur la même mer d'IA, mais chacun à sa manière :

Cursor :

• Éditeur de code propulsé par l'IA (un fork de VS Code)
• Interface graphique (GUI)
• Inline edits, autocomplétion avec la touche Tab, mode Agent/Composer, mentions par @
• Parfait pour écrire du code "en direct" dans l'éditeur

Claude Code :

• Outil agentique en ligne de commande (CLI) et SDK
• Fonctionne dans le terminal
• Parfait pour les modifications autonomes sur plusieurs fichiers, l'automatisation, la CI/CD et la composition avec d'autres commandes shell
• Compatible avec n'importe quel éditeur (et disponible en extension pour VS Code et JetBrains)

La différence tient en une phrase : Claude Code est un outil CLI dans le terminal, Cursor est un éditeur propulsé par l'IA avec interface graphique. Ce ne sont pas deux noms du même outil, et Claude Code ne remplace pas Cursor - ils se complètent, tu peux utiliser les DEUX ensemble !

Installer Claude Code

Prérequis

• Système : macOS 13+, Windows 10 (1809+), Ubuntu 20.04+, Debian 10+ ou Alpine 3.19+, avec au moins 4 Go de RAM
• Compte : un abonnement Claude (Pro, Max, Team ou Enterprise) ou un compte Anthropic Console avec des crédits API
• Node.js seulement pour l'installation via npm : version 22 ou plus récente (vérifie ta version : node --version)

Installation (recommandée : l'installateur natif)

Anthropic recommande l'installateur natif : une seule commande télécharge un programme prêt à l'emploi, qui se met ensuite à jour tout seul. Choisis la ligne qui correspond à ton système :

1# macOS, Linux, WSL
2curl -fsSL https://claude.ai/install.sh | bash
3
4# Windows PowerShell
5irm https://claude.ai/install.ps1 | iex

Une fois l'installation terminée, ouvre une nouvelle fenêtre de terminal et tape claude --version. Si le terminal ne connaît pas la commande claude, le dossier d'installation n'est pas encore dans ta variable PATH - la documentation de Claude Code consacre une page entière aux problèmes d'installation. Sur Mac, tu peux aussi passer par Homebrew (brew install --cask claude-code), et sur Windows par WinGet (winget install Anthropic.ClaudeCode).

Installation via npm

Claude Code existe aussi sous forme de paquet npm. Le paquet s'appelle @anthropic-ai/claude-code, et le flag -g l'installe globalement. Ni npm install claude, ni yarn add claude-code, ni pip install claude ne t'amèneront quoi que ce soit à bord :

1# Installation via npm (demande Node.js 22 ou plus recent)
2npm install -g @anthropic-ai/claude-code
3
4# Ensuite, lance Claude Code dans le dossier de ton projet
5claude

L'ordre des morceaux compte : npm, puis install, puis -g, puis @anthropic-ai/claude-code. N'ajoute pas sudo devant npm install : c'est le plus court chemin vers des problèmes de permissions. Tu peux aussi lancer Claude Code sans installation globale, avec npx, qui télécharge le paquet le temps d'une seule traversée (lui aussi demande Node.js 22 ou plus récent) :

1npx @anthropic-ai/claude-code

Là encore l'ordre est simple : npx d'abord, le nom complet du paquet ensuite. C'est pratique pour essayer l'outil sur une machine empruntée, mais pour le travail de tous les jours, choisis l'installateur natif ou l'installation globale. Un claude --version te confirmera que tout est bien monté à bord.

Connexion

Au premier lancement, Claude Code te demande de t'identifier. Tape dans la session la barre oblique suivie de login :

1/login

Une page OAuth s'ouvre alors : tu t'authentifies avec ton abonnement Claude Pro/Max ou avec un compte Anthropic Console alimenté en crédits API. C'est tout ce que fait /login - elle ne crée aucun compte GitHub, ne te déconnecte pas de ton système d'exploitation et n'installe aucune dépendance npm.

Autre option : définir ta clé API d'Anthropic Console dans la variable d'environnement ANTHROPIC_API_KEY, jamais dans package.json ni dans un config.json qui finirait poussé sur le dépôt. Claude Code ne lit pas les clés d'un fichier .env du projet - mieux vaut même protéger ce fichier de Claude, puisqu'il sait lire les fichiers du projet. Voici comment définir la variable :

1# macOS/Linux - ajoute cette ligne dans ~/.zshrc ou ~/.bashrc
2export ANTHROPIC_API_KEY="sk-ant-..."
3
4# Windows PowerShell - enregistre la variable durablement pour ton compte
5[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-...", "User")

Ouvre ensuite un nouveau terminal : la clé sera lue automatiquement à chaque session, et au premier lancement Claude Code te demandera s'il doit l'utiliser.

Premier lancement

Deux façons d'appareiller : ouvrir une session vide et discuter ensuite, ou embarquer ta première consigne directement sur la ligne de commande :

1# Lance une session interactive (REPL) dans le terminal
2claude
3
4# Ou lance directement avec un premier prompt
5claude "Explain what TypeScript is"

Ces deux lignes résument l'essentiel de l'outil - tout le reste vient se greffer autour.

Les modèles Claude

Claude Code s'appuie sur la famille des modèles Claude. Le plus simple est de les choisir par leur nom court (alias), qui désigne toujours la version actuelle :

• fable - le plus puissant, pour les tâches les plus grandes et les plus longues (aujourd'hui Claude Fable 5.1 ; sur certains forfaits, il consomme des crédits d'utilisation en plus)
• opus - un modèle très puissant pour le travail complexe, et le modèle par défaut des forfaits Pro, Max, Team et Enterprise (aujourd'hui Claude Opus 5.5)
• sonnet - un modèle équilibré pour le code de tous les jours (aujourd'hui Claude Sonnet 5.5)
• haiku - le plus rapide, pour les requêtes simples (aujourd'hui Claude Haiku 4.5)

Le plus souvent, tu changes de modèle de deux façons : avec la commande /model dans une session, ou avec le flag --model au démarrage. Il n'existe pas de commande /temperature, et inutile d'aller bricoler node_modules :

1# Lancer Claude avec le modele Sonnet
2claude --model sonnet

Le nom court suffit : sonnet, opus, haiku ou fable, juste après claude --model. Pour fixer ton choix durablement, il y a aussi le champ model d'un fichier de réglages et la variable d'environnement ANTHROPIC_MODEL. Le second bouton de réglage est le niveau d'effort : le flag --effort ou la commande /effort, avec low, medium, high, xhigh ou max, décide combien de temps le modèle réfléchit à chaque étape (sur les modèles qui le permettent).

Les modes de lancement

Mode interactif

C'est le mode par défaut, celui que tu obtiens en tapant simplement claude : une vraie conversation dans le terminal, où Claude garde le contexte d'un message à l'autre :

1# Demarre une session dans le terminal
2claude
3
4# Avec un premier prompt
5claude "Help me build a login form"

Tant que la session reste ouverte, tu affines ta demande message après message, comme avec un membre d'équipage qui connaît déjà le plan du navire.

Mode one-shot (-p / --print)

Le flag -p (ou sa forme longue --print) fait afficher la réponse par Claude puis quitter - idéal pour les scripts et les pipes. Rien à voir avec une imprimante physique, et rien n'est effacé de ton historique :

1# Une question, une reponse, et Claude rend la main
2claude -p "Explain what React hooks are"
3
4# Meme chose, avec le nom complet du flag
5claude --print "Summarize how useEffect works"

L'ordre est toujours claude, puis -p, puis le prompt entre guillemets. Voilà les deux modes principaux : le mode interactif, claude (aussi avec un premier prompt : claude "question"), et le mode non interactif, ponctuel, claude -p "question", qui répond une fois puis s'arrête. Pas de "mode GUI" dans le CLI : les versions graphiques de Claude Code (l'application de bureau et les extensions pour éditeurs, que tu verras à la fin du module) sont des applications et des extensions à part, pas une façon de lancer le CLI.

Continuer une conversation

Une session fermée n'est pas perdue : Claude Code garde l'historique par dossier, et deux flags courts t'y ramènent :

1# Reprendre la derniere conversation de ce dossier
2claude -c
3
4# Choisir dans la liste une conversation plus ancienne
5claude -r

Pour continuer la dernière conversation du répertoire actuel, c'est donc claude -c. Ni claude --save, ni claude --restore-all : ces flags n'existent pas.

Travailler avec les fichiers - la référence @

Dans Claude Code, il n'existe aucun flag pour attacher un fichier. Tu tapes @ avant le chemin dans le prompt, par exemple @src/auth.ts, et Claude ouvre le fichier tout seul :

1# Claude ouvre le fichier src/auth.ts et le passe en revue
2claude -p "Review @src/auth.ts"
3
4# Tu peux pointer plusieurs fichiers dans le meme prompt
5claude -p "Compare @src/old-api.ts and @src/new-api.ts"

Claude sait aussi explorer et lire le projet de lui-même : inutile de lui désigner chaque fichier. En revanche il reste confiné à son dossier de lancement. Pour lui ouvrir un répertoire supplémentaire, utilise --add-dir. Attention à l'ordre : --add-dir accepte plusieurs chemins à la fois et prend tout ce qui le suit pour d'autres répertoires. La consigne entre guillemets se place donc avant le flag :

1claude "Review the shared code" --add-dir ../shared-library

L'ordre à retenir : claude, la consigne entre guillemets, --add-dir, puis le répertoire.

Passer des données par pipe

Parce qu'il vit dans le terminal, Claude Code se marie avec les autres commandes du shell grâce au tube (|) :

1# Envoie le contenu du fichier en relecture
2cat src/index.ts | claude -p "Review this code"
3
4# Envoie le diff Git pour un resume
5git diff | claude -p "Summarize these changes"

C'est ce mécanisme qui alimente un script de revue comme code-review.sh branché en hook pre-commit : git diff --cached | claude -p "..." envoie les fichiers en staging à Claude, qui signale bugs, problèmes de sécurité et entorses aux bonnes pratiques avant que le commit ne parte.

Cela remplace une astuce des vieux tutoriels : au lieu de claude --file X "Y", qui n'attache aucun fichier, écris cat X | claude -p "Y" ou claude -p "Y @X". Quant à --glob, --output et --temperature, ces flags n'existent tout simplement pas.

Commandes slash - les commandes en session

Dans une session interactive (claude), tu disposes des commandes slash, celles qui commencent par /. Voici les vraies :

• /help - la liste des commandes disponibles et l'aide
• /clear - efface le contexte et repart de zéro
• /compact - résume la conversation et continue (économise du contexte)
• /init - génère le fichier CLAUDE.md du projet
• /model - change de modèle Claude
• /config - les réglages
• /login - la connexion
• /usage - le coût de la session et les limites d'utilisation de ton forfait (/cost en est un alias)
• /context - la place que la conversation occupe dans le contexte
• /code-review (alias /review) - la revue des changements de ta branche, ou d'une Pull Request dont tu donnes le numéro
• /mcp - la gestion des serveurs MCP
• /memory - l'édition du fichier CLAUDE.md
• /exit - ferme la session et te rend le terminal

Quand tu cherches ce que tu peux faire, tape / puis help : /help est la porte d'entrée de toutes les autres. Tes propres skills apparaissent sous la forme /<nom-du-skill>.

Attention : les commandes /file et /save n'existent pas dans Claude Code. Les anciens tutoriels décrivaient un workflow en quatre temps - démarrer avec claude, attacher le fichier avec /file code.ts, demander "Passe ce code en revue", puis enregistrer avec /save review.md - mais ces deux commandes ont été inventées. Aujourd'hui tu désignes les fichiers avec @, tu gères le contexte avec /clear et /compact, et /context te montre combien tu en consommes.

Le fichier CLAUDE.md - la mémoire du projet

CLAUDE.md est un fichier markdown à la racine du projet, où tu décris tes conventions, ton architecture et tes commandes. Claude Code le charge automatiquement à chaque session. Tu n'as même pas à l'écrire à la main :

1# Genere CLAUDE.md automatiquement
2# (tape cette commande dans une session claude)
3/init

Claude parcourt le projet et rédige un brouillon que tu n'as plus qu'à corriger. Tu peux aussi tenir un ~/.claude/CLAUDE.md global, valable partout, et des CLAUDE.md imbriqués dans les sous-dossiers.

Récapitulatif

Claude Code - le CLI agentique d'Anthropic (lit et modifie des fichiers, exécute des commandes) Installation - l'installateur natif (curl -fsSL https://claude.ai/install.sh | bash, sous Windows irm https://claude.ai/install.ps1 | iex) ou npm install -g @anthropic-ai/claude-code, puis claude Connexion - /login (Claude Pro/Max ou Console) ou ANTHROPIC_API_KEY Modes - interactif (claude) contre one-shot (claude -p "...") Fichiers - désigne-les avec @fichier, enchaîne avec un pipe (cat fichier | claude -p "...") Commandes slash - /help, /clear, /compact, /init, /model, /code-review CLAUDE.md - la mémoire du projet, générée par /init

Dans l'exercice suivant, tu découvriras des workflows concrets avec le vrai Claude Code !

À bientôt, matelot !

1#!/bin/bash
2# Exemple : utilisation de base de Claude Code
3
4# Installation (une fois) - l'installateur natif recommandé (macOS, Linux, WSL)
5curl -fsSL https://claude.ai/install.sh | bash
6# ...ou via npm (demande Node.js 22 ou plus récent)
7npm install -g @anthropic-ai/claude-code
8
9# Mode interactif (session dans le terminal)
10claude
11
12# Mode interactif avec un premier prompt
13claude "Aide-moi à construire un formulaire de connexion"
14
15# Mode non interactif : affiche la réponse puis quitte (-p / --print)
16claude -p "Explique ce que sont les hooks React"
17
18# Référence à un fichier dans le prompt avec @ (Claude le lit lui-même)
19claude -p "Passe @src/index.ts en revue pour trouver des bugs"
20
21# Plusieurs fichiers à la fois avec @
22claude -p "Compare @src/old-api.ts et @src/new-api.ts"
23
24# Envoyer des données par un pipe
25cat src/index.ts | claude -p "Passe ce code en revue"
26git diff | claude -p "Résume ces changements"
27
28# Choisir le modèle
29claude --model sonnet "Question rapide"
30
31# Reprendre la dernière conversation
32claude -c