Comment installer Claude Code en 2026 (Mac, Windows, Linux)

Prérequis communs (tous OS confondus)

Pour la voie native, peu de prérequis : un OS moderne, un terminal, un compte Anthropic. Pour la voie npm, il faut Node.js 18 minimum (le package l’exige strictement).

• Voie native (recommandée) : aucune dépendance, l’installateur télécharge le binaire directement.
• Voie npm : Node.js 18 minimum, idéalement Node 20 LTS. Vérifie avec node -v. Le package @anthropic-ai/claude-code refuse de s’installer sous Node 16 ou antérieur, c’est une exigence dure.
• Un compte Anthropic : un plan Pro (20 $/mois), Max 5x (100 $/mois), Max 20x (200 $/mois), Team Premium, ou une clé API depuis la console. Le plan Free permet de créer le compte mais l’usage de Claude Code n’y est pas inclus.
• Un terminal moderne : iTerm2, Alacritty, WezTerm, Windows Terminal, GNOME Terminal, Konsole, tous fonctionnent.
• Connexion Internet : Claude Code appelle les APIs Anthropic en permanence, donc pas d’usage offline.

Tableau comparatif des plans Anthropic (mai 2026)

Selon claude.com/pricing au 6 mai 2026 :

Si tu hésites entre Pro et Max 5x : compte tes heures actives par jour. Au-delà de 3h/jour de Claude Code intensif, Max 5x devient plus rentable que de hit les quotas Pro.

Si tu choisis la voie npm et que Node n’est pas installé, je recommande nvm pour macOS / Linux et nvm-windows pour Windows. Ça évite les problèmes de permissions globales.

Installation sur macOS

Sur macOS, l’installateur natif est la voie la plus rapide et la plus propre : pas de Node, pas de PATH à configurer, mises à jour automatiques en arrière-plan. Comptez environ une minute. La voie npm reste utile si tu veux pin une version exacte ou que ton workflow est déjà 100% Node.

Voie 1 : installateur natif (recommandée)

Voie 2 : installation via npm

Toujours fonctionnelle, utile si tu veux pin une version précise ou que ton équipe gère ses outils via npm.

Installation sur Linux (Ubuntu, Debian, Fedora)

Même logique : installateur natif d’abord, npm en backup. La voie native évite tous les problèmes de permissions npm globales que rencontrent la majorité des erreurs.

Voie 1 : installateur natif (recommandée)

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

Si claude --version ne fonctionne pas après l’install, ferme et rouvre ton terminal, ou recharge ton shell config avec source ~/.bashrc. Pas de Node nécessaire, pas de configuration de PATH, mises à jour automatiques.

Voie 2 : installation via npm

Installation sur Windows (via WSL 2)

Claude Code fonctionne nativement sur Windows depuis 2026, mais l’expérience reste meilleure sous WSL 2 (Windows Subsystem for Linux version 2). Les hooks shell, les commandes bash, les outils Unix attendus par beaucoup de MCP servers tournent mieux dans un environnement Linux. Sur un projet Next.js + Postgres testé sur les deux contextes, j’ai eu sensiblement moins de soucis de chemin et de permissions sous WSL (sur mes tests).

Pourquoi WSL plutôt que PowerShell direct

• Les hooks PostToolUse exécutent des commandes shell : elles attendent bash, pas PowerShell.
• Beaucoup de MCP servers tiers sont testés sur Linux/macOS en premier.
• Les paths Windows (C:\Users\...) posent parfois problème aux outils de fichier.
• Tu bénéficies d’un environnement dev Unix proche de tes serveurs de prod.

Astuce : Windows Terminal + profil WSL par défaut

Pour un workflow fluide, configure Windows Terminal avec Ubuntu comme profil par défaut. Tu ouvres le terminal, tu es directement dans WSL avec Claude Code disponible. Ça évite d’enchaîner deux clics à chaque session.

Méthodes alternatives officielles : Homebrew (macOS) et WinGet (Windows)

La documentation officielle Anthropic liste deux méthodes alternatives à l’installateur natif, recommandées au même rang.

macOS via Homebrew

Si tu utilises déjà Homebrew pour gérer tes outils, c’est l’approche la plus naturelle :

brew install --cask claude-code
claude --version

Avantage : tes mises à jour passent par brew upgrade avec le reste de tes outils. Inconvénient : Homebrew doit être installé au préalable.

Windows via WinGet

Pour Windows 10 1809+ ou Windows 11, WinGet est le gestionnaire de paquets natif Microsoft :

winget install Anthropic.ClaudeCode
claude --version

WinGet gère les mises à jour automatiques via winget upgrade. C’est la voie recommandée si tu veux Claude Code sur Windows natif sans WSL.

Tableau comparatif des 4 méthodes

Les deux options d’authentification

Une fois Claude Code installé, tu choisis comment tu paies l’usage : via un abonnement (flux OAuth navigateur) ou via une clé API en pay-as-you-go. La majorité des devs prend l’abonnement pour avoir une facture prévisible.

Option 1 : abonnement Pro, Max ou Team (recommandé)

Le flux navigateur standard : tu lances claude, une page web s’ouvre, tu te connectes avec ton compte Anthropic, tu reviens au terminal. Plans disponibles à mai 2026 (source : claude.com/pricing) :

• Pro à 20 $/mois (17 $/mois en facturation annuelle) : OK pour 1-2 sessions Claude Code par jour.
• Max 5x à 100 $/mois : 5x le quota Pro, accès Opus. Recommandé pour usage intensif quotidien.
• Max 20x à 200 $/mois : 20x le quota Pro, pour qui fait tourner plusieurs agents en parallèle.
• Team Premium à 100 $/seat/mois en facturation annuelle (ou 125 $/seat/mois en mensuel) : inclut Claude Code, minimum 5 sièges.

C’est le setup que je recommande pour la plupart des devs. Facture prévisible, pas de surprise en fin de mois.

Option 2 : clé API directe

Si tu n’as pas d’abonnement ou que tu veux un contrôle fin (pay-as-you-go) :

# Récupérer une clé sur https://console.anthropic.com/ export ANTHROPIC_API_KEY=sk-ant-... claude

Pour persister la variable entre sessions, ajoute-la à ton shell config :

echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ~/.zshrc # ou ~/.bashrc source ~/.zshrc

Conseil sécurité : ne jamais commit cette clé dans un repo. Utilise un password manager ou un outil comme direnv pour charger la variable d’env au moment d’entrer dans un projet.

Côté coût pay-as-you-go en mai 2026 : Sonnet 4.6 est facturé environ 3 $ par million de tokens en input et 15 $/M tokens en output (source officielle : tarification officielle Anthropic). Une session Claude Code typique consomme 50K-200K tokens en input et 10K-50K en output, soit autour de 0,40 $ à 1,30 $ la session sur Sonnet. Si tu fais plus de 50-100 sessions par mois, l’abonnement devient mathématiquement plus avantageux.

Troubleshoot : les erreurs courantes

Voici les 5 erreurs qui reviennent le plus souvent. Ordre de fréquence décroissante.

command not found: claude

Ton PATH ne contient pas le binaire ou le bin npm global. Trois fixes possibles selon la voie d’install :

# Fix 1 (voie native) : redémarrer le terminal complètement # L'installeur ajoute ~/.local/bin au PATH dans ~/.bashrc/.zshrc, # mais le shell courant ne l'a pas encore chargé. # Fix 2 (voie npm) : vérifier où npm installe et patcher le PATH npm config get prefix echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # Fix 3 : vérification globale which claude # doit retourner un chemin, sinon le binaire n'est pas trouvé

Problèmes de permissions npm (EACCES)

Ne jamais utiliser sudo npm install -g comme fix. La doc Anthropic le souligne explicitement : ça corrompt ton setup npm et crée des risques sécurité. Solution propre :

mkdir -p ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc source ~/.zshrc npm install -g @anthropic-ai/claude-code

Network error à l’authentification

• Vérifie que tu n’es pas derrière un proxy d’entreprise qui bloque anthropic.com.
• Teste curl -I https://api.anthropic.com : tu dois voir un 200 ou 401, pas un timeout.
• Si tu es sur WSL et que le navigateur ne s’ouvre pas, utilise l’option 2 (clé API).

Claude se bloque ou devient lent après quelques messages

• Ton contexte est probablement saturé. Lance /compact pour condenser.
• Ou /clear si tu as changé de sujet.
• Vérifie que ton plan Anthropic n’a pas atteint son quota (commande /cost en session pour voir où tu en es).

Claude Code sur serveur remote (SSH headless)

Sur un serveur sans interface graphique (SSH headless), le flux OAuth navigateur ne fonctionne pas. La documentation officielle Anthropic recommande d’utiliser une clé API directement :

export ANTHROPIC_API_KEY=sk-ant-...
claude

C’est aussi la méthode privilégiée pour intégrer Claude Code dans un pipeline CI/CD.

Configuration minimale pour être productif

Installation terminée. Voilà la config de base que je pose dès le premier jour pour ne pas réapprendre les mêmes leçons à chaque projet.

Créer un CLAUDE.md par projet

À la racine de chaque projet sur lequel tu bosses régulièrement, crée un fichier CLAUDE.md qui décrit les conventions. Exemple minimal :

# Conventions du projet ## Stack - Next.js 15, TypeScript strict - Prisma + Postgres - Tailwind, shadcn/ui ## Commandes utiles - `npm run dev`, développement - `npm test`, tests - `npm run lint`, lint ## Règles - Pas de `any` - Commits conventionnels (feat:, fix:, chore:) - Un composant = un fichier

Claude le lira automatiquement à chaque session. Plus ton CLAUDE.md est précis, moins tu auras à répéter tes préférences. Garde-le sous 200 lignes (au-delà, ça consomme du contexte sur chaque session).

Ajouter des alias bash pratiques

Dans ton ~/.zshrc ou ~/.bashrc :

# Reprendre la dernière conversation du répertoire courant alias cc='claude -c' # One-shot avec output stdout (utile pour scripter) alias ccp='claude --print' # Plan mode direct (Shift+Tab dans une session interactive fait pareil) alias ccplan='claude --permission-mode plan'

Note importante : claude -c reprend la dernière conversation du répertoire courant, pas la dernière conversation globale. Si tu changes de projet, l’alias pointera sur la conversation de ce projet-là, pas celle d’avant.

Mode verbose pour debugger Claude lui-même

Si Claude semble bizarre (plans incohérents, outils non utilisés), relance avec --verbose pour voir les tool calls en détail et identifier ce qui coince.

Maintenir, mettre à jour, désinstaller

Sur la voie native, les updates sont automatiques en arrière-plan. Sur la voie npm, c’est manuel et tu choisis quand. Cadence des releases : Anthropic publie souvent plusieurs versions par mois ((version récente) au moment où j’écris).

Mettre à jour Claude Code

Voie native : rien à faire, l’auto-update tourne en arrière-plan. Tu peux forcer une vérification avec claude doctor qui indiquera si une nouvelle version est dispo.

Voie npm :

npm update -g @anthropic-ai/claude-code claude --version

Si tu préfères pin une version spécifique (par exemple pour reproduire un bug sur un ticket) :

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

Désinstaller proprement

# Voie npm npm uninstall -g @anthropic-ai/claude-code # Voie native (binaire dans ~/.local/bin) rm ~/.local/bin/claude # Supprimer la config utilisateur si tu ne comptes plus revenir rm -rf ~/.claude

Ça laisse intacts tes CLAUDE.md dans les projets, ce qui est le comportement attendu (ce sont des fichiers versionnés en git).

Migrer vers une autre machine

Pas grand chose à transférer : tu réinstalles via la méthode de ton choix, tu te ré-authentifies, et c’est bon. Tu peux copier ton fichier ~/.claude/settings.json si tu as des hooks globaux ou des préférences custom à conserver.

Avant d’enchaîner : la config qui m’évite la frustration au jour 2

Installation terminée, authentifié, premier test passé. Avant d’attaquer les workflows complexes, voilà 4 réflexes qui évitent les regrets une semaine plus tard.

1. Créer un CLAUDE.md dans ton projet principal

Pas parfait dès le départ. Un minimum viable : stack, commandes, conventions. Tu l’enrichis à chaque fois qu’une session te fait réaliser une règle implicite que Claude aurait dû connaître.

2. Configurer un alias pour reprendre la session

Comme mentionné plus haut, alias cc='claude -c' dans ton shell config. Ça te fera gagner 10 secondes plusieurs fois par jour, ce qui est énorme en cumul sur un mois.

3. Faire un premier vrai projet de test

Ne te contente pas du « liste-moi les fichiers » de démo. Lance-toi sur une tâche réelle de ton backlog : un petit refactor, un bug à investiguer, une feature simple. C’est en utilisant Claude Code sur du vrai code que tu vas comprendre son intérêt et ses limites.

4. Activer /cost par réflexe les premières semaines

La commande /cost en session te montre où tu en es de ton quota. Les premières semaines, regarde-la 2-3 fois par session pour caler ton intuition sur ce que coûte un refactor vs une review vs un debug. Sans ça, le premier mois tu vas soit sous-utiliser (par peur du quota) soit cramer ton budget sans comprendre.

Et maintenant

Installation OK. Tu as Claude Code qui tourne, authentifié, prêt. Prochaine étape : maîtriser les commandes et les workflows qui font vraiment gagner du temps.

J’ai écrit le guide complet Claude Code 2026 qui couvre les slash commands, les workflows concrets (debug, refactor, migration, review), les hooks, les subagents, le MCP, et les pièges courants. C’est ton prochain arrêt logique.

Pour aller plus loin dans l’écosystème MCP, le guide MCP Server explique comment connecter Claude à GitHub, Supabase, Stripe et d’autres services.

Questions fréquentes