Guides pratiques

Installer et prendre en main Claude Code : le guide pas à pas

Prérequis, installation sur macOS, Linux et Windows, première session, forfaits et intégration à VS Code ou JetBrains : Claude Code d'après la documentation officielle d'Anthropic.

Par Audryk · 20 octobre 2026

• Guides pratiques
• Agents de code
• #guides
• #Claude Code

Claude Code est l'agent de code d'Anthropic : il lit votre projet, propose des modifications et exécute des commandes depuis le terminal, un IDE, l'application de bureau ou le web. Ce guide suit la documentation officielle ; chaque commande y a été vérifiée le 2026-10-20. Pour les chiffres d'usage et les offres, voir la fiche Claude Code.

Avant de commencer

• Systèmes : macOS 13.0 ou plus récent, Windows 10 1809 ou plus récent (ou Windows Server 2019), Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ (Anthropic).
• Matériel : 4 Go de RAM au minimum, processeur x64 ou ARM64. Une connexion Internet est obligatoire.
• Shell : Bash, Zsh, PowerShell ou CMD.
• Pays : Claude Code n'est proposé que dans les pays pris en charge par Anthropic.
• Compte : un abonnement Claude Pro, Max, Team ou Enterprise, ou un compte Claude Console (API à crédits prépayés). Le forfait gratuit de claude.ai n'inclut pas Claude Code. Amazon Bedrock, Google Cloud et Microsoft Foundry sont aussi acceptés.

Installer Claude Code

L'installateur natif est la méthode recommandée par Anthropic ; il se met à jour automatiquement 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'installation n'affiche aucune progression pendant le téléchargement. Ouvrez ensuite un nouveau terminal. Deux alternatives existent, sans mise à jour automatique par défaut :

brew install --cask claude-code

winget install Anthropic.ClaudeCode

Le cask Homebrew claude-code suit le canal stable (environ une semaine de retard, sans les versions à régression majeure) ; claude-code@latest reçoit chaque version dès sa sortie. Des dépôts signés apt, dnf et apk existent aussi pour Debian, Fedora, RHEL et Alpine.

Avec npm : le paquet exige Node.js 22 ou plus récent et installe le même binaire natif. Anthropic déconseille sudo npm install -g (problèmes de permissions et de sécurité).

npm install -g @anthropic-ai/claude-code

Notes pour Windows

Claude Code tourne nativement sous Windows ou dans WSL. L'installation native ne demande pas de droits administrateur. Git pour Windows est facultatif : s'il est présent, Claude Code utilise Git Bash pour son outil Bash ; sinon, il passe par PowerShell. Le sandboxing (exécution isolée des commandes) n'est pris en charge qu'avec WSL 2. Dans WSL, installez et lancez claude depuis le terminal Linux, pas depuis PowerShell.

Vérifier l'installation

claude --version

La commande affiche un numéro de version suivi de « (Claude Code) ». Si le terminal répond que claude est introuvable, le dossier d'installation n'est pas encore dans le PATH. Pour un diagnostic plus complet, sans ouvrir de session :

claude doctor

Première session

Placez-vous dans un projet et lancez l'agent :

cd /path/to/your/project
claude

Au premier lancement, Claude Code ouvre le navigateur pour vous connecter ; les identifiants sont ensuite conservés. Si la variable ANTHROPIC_API_KEY est définie et que vous l'approuvez, l'étape de connexion est sautée. Avec un compte Console, un espace de travail « Claude Code » est créé automatiquement pour suivre les coûts.

Commencez par des questions simples, en anglais ou en français, par exemple :

what does this project do?

Puis une petite modification. Claude Code montre le changement et demande votre accord selon le mode de permission de la session ; Shift+Tab fait défiler ces modes.

add a hello world function to the main file

Les commandes essentielles, d'après le guide de démarrage d'Anthropic (quickstart) :

• claude "task" démarre une session avec une première consigne (ex. claude "fix the build error") ; claude -p "query" répond une fois puis quitte ;
• claude -c reprend la dernière conversation du dossier ; claude -r permet d'en choisir une plus ancienne ;
• dans la session : /help liste les commandes, /resume reprend une conversation, /login change de compte, /clear efface l'historique, /exit (ou deux fois Ctrl+D) quitte.

Coût et forfaits

Claude Code est inclus dans les forfaits payants de Claude (Anthropic, vérifié le 2026-10-20) :

• Pro : 17 $/mois en facturation annuelle (200 $ payés d'avance), 20 $ au mois ;
• Max : à partir de 100 $/mois, avec 5 ou 20 fois l'usage de Pro ;
• Team : siège standard à 20 $/mois en annuel (25 $ au mois), siège Premium à 100 $ (125 $ au mois), de 2 à 150 personnes ;
• Enterprise : 20 $ par siège et par mois en annuel, plus l'usage aux tarifs de l'API, 20 sièges minimum.

Avec un compte Console, l'usage est facturé au token. Anthropic indique que, sur ses déploiements en entreprise, le coût moyen est d'environ 13 $ par développeur et par jour d'activité, et de 150 à 250 $ par développeur et par mois, sous 30 $ par jour actif pour 90 % des utilisateurs (Anthropic). La commande /usage affiche la consommation de la session ; pour les abonnés Pro et Max, l'usage est inclus dans le forfait. Pour situer ces offres face aux autres agents, voir notre guide Choisir son agent de code selon son budget.

Intégrer Claude Code à votre IDE

VS Code et Cursor : l'extension officielle demande VS Code 1.94.0 ou plus récent et un compte Claude payant ou Console, sans clé API (Anthropic). Ouvrez la vue Extensions (Cmd+Shift+X sur Mac, Ctrl+Shift+X sous Windows et Linux), cherchez « Claude Code » puis installez. L'extension embarque sa propre copie de la CLI ; pour lancer claude dans le terminal intégré, installez aussi la CLI. Les autres forks de VS Code (Devin Desktop, Kiro) passent par le registre Open VSX.

JetBrains (IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand) : le plugin n'embarque pas la CLI. Installez d'abord la CLI, puis le plugin Claude Code depuis la Marketplace JetBrains, et redémarrez l'IDE (Anthropic). Lancez claude dans le terminal intégré, ou tapez /ide dans une session ouverte depuis un terminal externe. Le raccourci Cmd+Esc (Mac) ou Ctrl+Esc (Windows et Linux) ouvre Claude Code depuis l'éditeur.

Mettre à jour et désinstaller

Les installations natives se mettent à jour seules. Pour forcer la mise à jour :

claude update

Avec Homebrew : brew upgrade claude-code ; avec WinGet : winget upgrade Anthropic.ClaudeCode. Pour supprimer une installation native sous macOS, Linux ou WSL :

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Pour aller plus loin

• Connecter Claude Code à vos outils : Configurer un serveur MCP.
• Comparer : Claude Code, Codex ou GitHub Copilot, Claude Code vs Codex, alternatives à Claude Code.
• Vocabulaire : agent de code et fenêtre de contexte dans le glossaire.

Sources

• Claude Code Docs : Advanced setup, vérifié le 2026-10-20
• Claude Code Docs : Quickstart, vérifié le 2026-10-20
• Claude Code Docs : Manage costs effectively, vérifié le 2026-10-20
• Claude Code Docs : Use Claude Code in VS Code, vérifié le 2026-10-20
• Claude Code Docs : JetBrains IDEs, vérifié le 2026-10-20
• Anthropic : tarifs Claude, vérifié le 2026-10-20

À retenir : Claude Code s'installe en une commande sur macOS, Linux et Windows, mais demande un forfait Claude payant ou un compte Console ; l'extension VS Code embarque la CLI, le plugin JetBrains non.

Une erreur dans cet article ? Signalez-la · Notre politique de corrections