Accueil › Claude Code › Installation

Installer Claude Code : guide complet pour macOS, Windows et Linux

Claude Code s’installe en une seule commande avec l’installateur natif, sans aucune dépendance. Il faut un abonnement Claude Pro (20 $/mois) minimum pour l’utiliser.

Claude Code est l’agent de coding terminal-first d’Anthropic. Il lit votre codebase, modifie les fichiers, exécute des commandes et gère Git directement depuis le terminal. Depuis début 2026, l’installateur natif est la méthode recommandée : il ne nécessite ni Node.js ni aucun runtime, se met à jour automatiquement en arrière-plan et fonctionne sur macOS, Windows et Linux.

Ce guide couvre l’installation sur les trois plateformes, l’authentification, la configuration initiale, la migration depuis npm, les alternatives (VS Code, JetBrains, desktop app) et la résolution des problèmes courants.

Prérequis système

Systèmes d’exploitation

Matériel

Minimum : 4 Go de RAM, connexion internet. Recommandé : 8 Go de RAM ou plus pour travailler sur des codebases volumineuses. Claude Code indexe votre projet localement, ce qui consomme de la mémoire proportionnellement à la taille du repo.

Compte Anthropic requis

Claude Code nécessite un compte Claude payant. Le plan Free ne donne pas accès à Claude Code. Voici les options :

Pour la plupart des développeurs individuels, le plan Pro à 20 $/mois est le point de départ recommandé. Si vous atteignez régulièrement les limites de taux, passez au Max 5x. L’API en pay-per-use est plus adaptée aux usages ponctuels ou automatisés (CI/CD, scripts).

Installation pas à pas

macOS et Linux (méthode recommandée)

Ouvrez votre terminal et exécutez :

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

L’installateur télécharge un binaire compilé statiquement pour votre plateforme et architecture. Il l’installe dans ~/.local/bin/claude et ajoute le chemin à votre PATH (dans ~/.bashrc, ~/.zshrc ou ~/.profile selon votre shell).

Vérifiez l’installation :

claude --version

Alternative Homebrew (macOS uniquement) :

brew install --cask claude-code

Windows

Deux options sont disponibles pour Windows :

Option 1 : Windows natif avec Git Bash (recommandé)

Installez d’abord Git for Windows si ce n’est pas déjà fait. Puis ouvrez PowerShell ou CMD et exécutez :

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

Claude Code utilise Git Bash en interne pour exécuter les commandes. Vous n’avez pas besoin de lancer PowerShell en tant qu’administrateur. Le binaire est installé dans %USERPROFILE%.localbinclaude.

Alternative WinGet :

winget install Anthropic.ClaudeCode

Option 2 : WSL (Windows Subsystem for Linux)

WSL 1 et WSL 2 sont tous deux supportés. WSL 2 offre le sandboxing pour une sécurité renforcée. Si WSL est déjà installé, utilisez simplement la commande Linux :

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

Depuis l’environnement WSL, Claude Code fonctionne exactement comme sur Linux natif. Pour travailler sur des projets situés sur le disque Windows, accédez-les via /mnt/c/Users/VotreNom/... (performances légèrement réduites par rapport à un projet natif WSL).

Alpine et distributions musl

Les distributions basées sur musl/uClibc (Alpine, Void) nécessitent des dépendances supplémentaires :

# Alpine
apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0
curl -fsSL https://claude.ai/install.sh | bash

Authentification

Après l’installation, lancez Claude Code dans un répertoire de projet :

cd ~/mon-projet
claude

Votre navigateur s’ouvre automatiquement sur claude.ai pour une authentification OAuth. Connectez-vous avec votre compte Claude (Pro, Max ou Console). Revenez dans le terminal : vous êtes authentifié. Les identifiants sont stockés localement dans ~/.claude/ et persistent entre les sessions.

Pour l’API en pay-per-use, vous pouvez aussi configurer une clé API via variable d’environnement :

export ANTHROPIC_API_KEY="sk-ant-..."

Ajoutez cette ligne à votre fichier de profil shell (~/.bashrc, ~/.zshrc) pour la rendre persistante.

Pour les providers tiers (Amazon Bedrock, Google Vertex AI, Microsoft Foundry), consultez la documentation officielle de configuration spécifique sur code.claude.com/docs.

Première session

Une fois authentifié, Claude Code est prêt. Naviguez dans un répertoire de projet et lancez claude. L’agent indexe automatiquement votre codebase et attend vos instructions.

Commandes essentielles pour démarrer :

Conseil important : créez un fichier CLAUDE.md à la racine de votre projet dès votre première session. Ce fichier contient les instructions, conventions et contexte que l’agent lit automatiquement à chaque démarrage. C’est l’équivalent des Cursor Rules pour Claude Code.

Interfaces alternatives

Le CLI terminal n’est pas la seule façon d’utiliser Claude Code. Plusieurs interfaces sont disponibles :

Extension VS Code : recherchez « Claude Code » dans le marketplace VS Code et installez l’extension. Elle se connecte au même binaire CLI. Ouvrez le panneau avec l’icône Spark en haut à droite ou le label Claude Code dans la barre de statut. Fonctionne aussi dans Cursor puisque Cursor supporte les extensions VS Code. Voir notre guide Claude Code dans VS Code.

Plugin JetBrains : disponible pour IntelliJ, PyCharm, WebStorm, GoLand et les autres IDE JetBrains. Ouvrez avec Cmd+Esc (Mac) ou Ctrl+Esc (Windows/Linux). Voir notre guide Claude Code dans JetBrains.

Application desktop : Anthropic propose une app desktop avec revue visuelle des diffs, preview d’applications et connecteurs pour GitHub, Slack, Linear et Notion. Téléchargez-la depuis claude.ai après connexion.

Version web : claude.ai/code permet d’utiliser Claude Code directement dans le navigateur, sans installation. Utile pour tester ou pour les machines où l’installation n’est pas possible.

Migration depuis npm

Si vous utilisez encore l’ancienne installation npm (npm install -g @anthropic-ai/claude-code), migrez vers l’installateur natif. La méthode npm est officiellement dépréciée depuis début 2026 et ne recevra plus de mises à jour à terme.

# Installer le binaire natif
curl -fsSL https://claude.ai/install.sh | bash

# Supprimer l'ancienne installation npm
npm uninstall -g @anthropic-ai/claude-code

Vos fichiers de configuration (~/.claude/settings.json) et les paramètres de projet (.claude/) sont préservés pendant la migration. La transition est transparente.

Mises à jour

L’installateur natif gère les mises à jour automatiquement. Claude Code vérifie les nouvelles versions à chaque démarrage et périodiquement pendant l’exécution. Les mises à jour sont téléchargées et installées en arrière-plan, puis prennent effet au prochain lancement.

Pour forcer une mise à jour immédiate :

claude update

Vous pouvez configurer le canal de mise à jour via /config dans Claude Code :

latest (défaut) : vous recevez les nouvelles fonctionnalités dès leur sortie. stable : environ une semaine de retard, les versions avec des bugs majeurs sont ignorées. Recommandé pour les équipes ou les environnements de production.

Sécurité à l’installation

En 2026, des chercheurs en sécurité ont identifié de fausses pages d’installation Claude Code promues via Google Ads, distribuant un malware appelé « InstallFix ». Pour vous protéger :

Utilisez uniquement les URLs officielles : claude.ai/install.sh pour macOS/Linux et claude.ai/install.ps1 pour Windows. Ne téléchargez jamais Claude Code depuis un site tiers ou un résultat sponsorisé dans un moteur de recherche.

Vérifiez les checksums : Anthropic publie des checksums SHA256 et des signatures de code pour vérifier l’intégrité des binaires.

Ne jamais utiliser sudo : n’exécutez jamais sudo npm install -g ou sudo curl ... | bash. L’installateur natif n’a pas besoin de droits administrateur. Si une installation demande sudo, c’est suspect.

Configuration initiale recommandée

Une fois Claude Code installé et authentifié, quelques étapes de configuration améliorent significativement l’expérience dès la première session.

Créer un fichier CLAUDE.md

Le fichier CLAUDE.md est l’équivalent des fichiers Cursor Rules pour Claude Code. Placé à la racine de votre projet, il contient les instructions, conventions et contexte que l’agent lit automatiquement à chaque démarrage de session. C’est le levier le plus efficace pour améliorer la qualité des réponses.

Exemple minimal pour démarrer :

# Mon Projet

## Stack
- TypeScript, React 19, Next.js 15
- Prisma + PostgreSQL
- Tailwind CSS
- Tests : Vitest + Testing Library

## Conventions
- Composants fonctionnels uniquement
- Hooks custom dans src/hooks/ avec préfixe "use"
- État global via Zustand
- Pas de "any" en TypeScript

## Commandes
- `npm run dev` : serveur de développement
- `npm run test` : lancer les tests
- `npm run build` : build de production

L’agent consulte ce fichier avant chaque action. Plus il est détaillé et à jour, plus le code généré sera conforme à vos attentes.

Choisir le bon modèle

Par défaut, Claude Code utilise Claude Sonnet 4.6. Vous pouvez changer le modèle avec la commande /model dans une session :

Sonnet 4.6 (défaut) : meilleur rapport qualité/prix pour le développement quotidien. Excellent en codage, cohérent et rapide. C’est le choix recommandé pour 80 % des tâches.

Opus 4.6 : le modèle le plus puissant. Contexte de 1M tokens, extended thinking, Agent Teams. Réservez-le aux refactorings majeurs, à l’analyse architecturale et aux tâches nécessitant un raisonnement profond. Disponible sur les plans Max et supérieurs.

Haiku 4.5 : le plus rapide et le moins coûteux. Utile pour les tâches simples (formatting, documentation, corrections mineures). Qualité nettement inférieure pour les tâches complexes.

Configurer les serveurs MCP essentiels

Les serveurs MCP (Model Context Protocol) connectent Claude Code à vos outils externes. Voici les plus utiles à configurer dès le départ :

# GitHub : PR, issues, review de code
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Filesystem étendu (accès à des dossiers hors du projet)
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/docs

# Vérifier les serveurs configurés
claude mcp list

Les serveurs MCP transforment Claude Code d’un assistant de codage en un véritable agent capable d’interagir avec vos systèmes. Voir notre guide complet MCP dans Claude Code pour plus de détails.

Git : le filet de sécurité

Git n’est pas techniquement requis pour installer Claude Code, mais il est fortement recommandé. L’agent peut créer des commits, des branches et des PR directement. Plus important : Git vous permet de revenir en arrière instantanément si l’agent produit un résultat inattendu.

Bonne pratique : faites un git commit avant chaque session Claude Code. Si l’agent s’éloigne de votre intention, un simple git checkout . vous ramène à l’état propre.

Créer des commandes personnalisées

Les commandes slash personnalisées sont des fichiers Markdown dans .claude/commands/ qui fonctionnent comme des raccourcis pour des instructions fréquentes :

# .claude/commands/review.md
Review le diff Git courant pour :
- Vulnérabilités de sécurité
- Problèmes de performance
- Gestion d'erreurs manquante
- Violations de style selon CLAUDE.md
Concentre-toi sur $ARGUMENTS ou le diff entier si aucune zone n'est spécifiée.

Tapez /review dans une session pour exécuter cette commande. $ARGUMENTS est remplacé par le texte que vous ajoutez après la commande (ex : /review src/auth/). Partagez ces commandes avec votre équipe via Git pour standardiser les workflows.

Résolution de problèmes courants

Pour un diagnostic complet, lancez claude doctor. Cette commande vérifie votre configuration système, l’état de l’authentification et les problèmes détectés, puis produit un rapport détaillé.