Installation de Claude Code — Claude Code en action

L’installation prend quelques minutes : vous lancez la commande de votre système, vous vous authentifiez une fois, puis vous vérifiez que la boucle complète fonctionne avant d’aller plus loin. Cette dernière étape n’est pas facultative. Une session passée à croire que Claude « ne comprend pas » alors que l’authentification n’a jamais abouti est une session perdue.

Installer

La documentation recommande l’installeur natif, qui se met à jour seul en arrière-plan :

macOS, Linux, WSL :

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

Windows, PowerShell :

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

Windows, invite de commandes (CMD) :

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

La commande n’affiche aucune progression pendant le téléchargement. Sous Windows, votre invite commence par PS C:\ dans PowerShell et par C:\ sans le PS dans CMD ; si vous voyez The token '&&' is not a valid statement separator, vous êtes dans PowerShell avec la commande CMD, et inversement si irm n’est pas reconnu.

Deux gestionnaires de paquets sont aussi pris en charge, mais ne se mettent pas à jour seuls :

brew install --cask claude-code        # macOS ; brew upgrade claude-code pour mettre à jour
winget install Anthropic.ClaudeCode    # Windows ; winget upgrade Anthropic.ClaudeCode

Homebrew propose deux casks : claude-code suit le canal stable (environ une semaine de retard, sans les versions à régression majeure) et claude-code@latest le canal le plus récent. Des dépôts signés apt, dnf et apk existent pour Debian, Ubuntu, Fedora, RHEL et Alpine ; la page Advanced setup donne les commandes et l’empreinte de la clé de signature à vérifier.

Configuration requise : macOS 13, Windows 10 (1809) ou Windows Server 2019, Ubuntu 20.04, Debian 10 ou Alpine 3.19 et au-delà, 4 Go de mémoire, une connexion internet. Sous Windows, installez de préférence Git for Windows : Claude Code utilise alors Git Bash pour son outil Bash ; sans lui, il se rabat sur un outil PowerShell. Pour le bac à sable des commandes (sandboxing), il faut WSL 2.

Vérifier et s’authentifier

Ouvrez un nouveau terminal, puis :

claude --version

Une installation qui fonctionne affiche un numéro de version suivi de (Claude Code), par exemple 2.1.318 (Claude Code). Si le shell répond que claude est introuvable, le dossier d’installation n’est pas encore dans votre PATH : la page de dépannage de l’installation donne la correction. Pour un diagnostic complet sans ouvrir de session, lancez claude doctor : il vérifie l’installation, les fichiers de réglages et signale les avertissements avec leur correctif.

Placez-vous ensuite dans un projet et lancez :

cd /chemin/vers/votre/projet
claude

Au premier lancement, Claude Code vous propose de vous connecter dans le navigateur. Quatre types de comptes sont acceptés : un abonnement Claude Pro, Max, Ultra, Team ou Enterprise (recommandé) ; un compte Claude Console, facturé à l’usage en crédits prépayés, qui crée automatiquement un espace de travail « Claude Code » pour suivre les coûts ; un fournisseur cloud, Amazon Bedrock, Agent Platform de Google Cloud ou Microsoft Foundry, avec les assistants /setup-bedrock et /setup-vertex ; ou une passerelle Claude apps hébergée par votre organisation, avec connexion SSO. Si la variable d’environnement ANTHROPIC_API_KEY est définie et que vous confirmez son usage quand Claude Code le demande, l’écran de connexion est sauté. Les identifiants sont ensuite mémorisés ; /login permet de changer de compte plus tard.

Terminez par un test de bout en bout :

claude "Dis bonjour en français"

Si une réponse s’affiche, le binaire est en place, l’authentification a abouti et la connexion sortante passe. Sinon, le problème est sur l’un de ces trois maillons, dans cet ordre.

Premier lancement de Claude Code dans le terminal : choix du style de texte (Dark mode sélectionné) avec un aperçu de diff coloré — Capture réelle de Claude Code 2.1.317 (4 novembre 2026) : au premier lancement, Claude Code demande le thème du terminal, puis affiche ses notes de sécurité et le choix de la méthode de connexion.

Écran des notes de sécurité de Claude Code au premier lancement : Claude peut se tromper, relisez ses actions ; n'utilisez l'outil qu'avec du code de confiance — Capture réelle de Claude Code 2.1.317 (4 novembre 2026) : les deux notes de sécurité affichées avant la première session.

Mettre à jour

L’installeur natif vérifie les mises à jour au démarrage et les installe en arrière-plan ; elles prennent effet au lancement suivant, ou tout de suite avec /restart. Pour forcer une mise à jour : claude update. Le réglage autoUpdatesChannel (latest par défaut, ou stable) choisit le canal, depuis /config ou settings.json. Un modèle qui vient de sortir peut exiger une version plus récente que celle du canal stable ; claude doctor indique le résultat de la dernière tentative de mise à jour.

Les façons de lancer Claude Code

Commande	Ce qu’elle fait
`claude`	Session interactive : le mode du travail de fond, où le contexte accumulé a de la valeur
`claude "ta question"`	Session interactive qui démarre sur ce prompt
`claude -p "ta question"`	Mode non interactif (print) : répond puis quitte ; c’est le mode des scripts
`cat fichier.py \| claude -p "Explique ce code"`	Claude lit le flux entrant, comme n’importe quelle commande Unix
`claude -c`	Reprend la conversation la plus récente du dossier courant
`claude -r`	Ouvre le sélecteur de sessions ; `claude -r "nom"` reprend une session nommée
`claude -n "auth-refactor"`	Nomme la session au démarrage

Pour ce cours, nous utiliserons surtout la session interactive : c’est celle qui expose le mieux le raisonnement de Claude et les outils qu’il déclenche.

Les autres surfaces

Le terminal n’est qu’une surface parmi d’autres, toutes bâties sur le même moteur : vos fichiers CLAUDE.md, vos réglages et vos serveurs MCP valent partout. L’extension VS Code (et Cursor) affiche les modifications dans l’éditeur et accepte les mentions @ ; le plugin JetBrains couvre IntelliJ, PyCharm, WebStorm et les autres IDE de la gamme. L’application de bureau Claude (macOS, Windows, Linux en bêta) a un onglet Code avec sessions côte à côte, revue visuelle des diffs, terminal et navigateur intégrés, tâches planifiées ; Claude Code y est inclus, sans CLI à installer, et claude --desktop y ouvre le dossier courant. Sur le web (claude.ai/code) et dans l’application mobile, les sessions tournent dans le cloud, sur un dépôt GitHub, sans rien installer. Remote Control (claude remote-control ou /remote-control) permet de reprendre une session locale depuis votre téléphone ou un navigateur, l’exécution restant sur votre machine.

À vous de jouer

Installez Claude Code avec la commande de votre système, ouvrez un nouveau terminal et lancez claude --version, puis claude doctor.
Lancez claude dans un projet, authentifiez-vous, puis quittez avec /exit.
Depuis le shell, testez le mode non interactif : git log --oneline -10 | claude -p "Résume ces commits en trois lignes".
Relancez claude -c : la conversation précédente est reprise.

Sources officielles : Quickstart · Advanced setup · Authentication · CLI reference · Platforms and integrations

Points clés à retenir

Installeur natif recommandé (install.sh, install.ps1, install.cmd) : il se met à jour seul ; Homebrew et WinGet non
Vérifiez avec claude --version et claude doctor avant de chercher ailleurs
Comptes acceptés : abonnement Claude, Console, Bedrock, Agent Platform, Foundry ou passerelle d’entreprise ; pas l’offre gratuite
claude pour travailler, claude -p pour scripter, claude -c et claude -r pour reprendre
Terminal, VS Code, JetBrains, application de bureau, web, mobile : même moteur, mêmes réglages