Claude Code s’installe au moyen d’une seule commande sur chaque plateforme prise en charge, et le premier lancement complet se résume à : installer, saisir claude, se connecter. Ce guide fournit la commande exacte pour chaque système d’exploitation, les vérifications à effectuer en cas de problème et la manière de le faire pointer vers un autre point de terminaison une fois installé.
Commandes vérifiées le 3 octobre 2026 dans la documentation de configuration de Claude Code d’Anthropic.
Avant de commencer
| Exigence | Prise en charge |
|---|---|
| Système d’exploitation | macOS 13.0 ou version ultérieure, Windows 10 1809 ou version ultérieure / Server 2019 ou version ultérieure, Ubuntu 20.04 ou version ultérieure, Debian 10 ou version ultérieure, Alpine Linux 3.19 ou version ultérieure |
| Matériel | Au moins 4 Go de RAM, x64 ou ARM64 |
| Shell | Bash, Zsh, PowerShell ou CMD |
| Réseau | Connexion Internet requise |
| Compte | Pro, Max, Team, Enterprise ou Console — l’offre gratuite Claude.ai n’inclut pas Claude Code |
Installation — le programme d’installation natif
C’est la méthode recommandée sur toutes les plateformes. Elle installe un binaire autonome et le met à jour 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 CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdSi vous ne savez pas quel shell Windows vous utilisez, l’invite vous l’indique : PowerShell affiche PS C:\, tandis que CMD affiche C:\ sans PS. Exécuter la mauvaise commande est la cause la plus fréquente d’échec de l’installation sous Windows — consultez le tableau de dépannage ci-dessous pour connaître l’erreur exacte dans chaque cas.
Gestionnaires de paquets
Utilisez-les si vous préférez que votre gestionnaire de paquets existant gère l’installation. Le compromis concerne les mises à jour : aucun de ces gestionnaires ne se met automatiquement à jour par défaut, contrairement au programme d’installation natif.
# Homebrew (macOS, Linux) — stable channel
brew install --cask claude-code
# WinGet (Windows)
winget install Anthropic.ClaudeCode
# npm — requires Node.js 22+; never with sudo
npm install -g @anthropic-ai/claude-codeHomebrew publie deux casks : claude-code suit le canal stable (généralement avec environ une semaine de retard et en ignorant les versions présentant des régressions majeures) et claude-code@latest publie immédiatement chaque version. Des dépôts apt, dnf et apk signés existent pour Debian / Ubuntu, Fedora / RHEL et Alpine, chacun avec les canaux stable et latest.
Avec npm, n’utilisez jamais sudo npm install -g : cela entraîne des problèmes d’autorisations et constitue un risque de sécurité. Le paquet npm installe exactement le même binaire natif que le programme d’installation autonome ; il n’existe donc dans aucun des deux cas de dépendance à Node à l’exécution.
Vérifier l’installation
claude --version # prints e.g. "2.1.211 (Claude Code)"
claude doctor # read-only install + settings diagnostics
claude # start a session in the current projectclaude doctor est la commande à retenir : elle affiche l’état de l’installation, les erreurs de validation des fichiers de paramètres et les correctifs suggérés sans démarrer de session. C’est donc le moyen le plus rapide de distinguer une installation défectueuse d’une configuration défectueuse.
Premier lancement et connexion
Ouvrez un terminal dans le projet sur lequel vous souhaitez travailler et exécutez claude. Une session interactive s’ouvre et vous guide dans la connexion via le navigateur. Claude Code nécessite un compte Pro, Max, Team, Enterprise ou Console.
Un comportement mérite d’être connu avant de vous surprendre : si ANTHROPIC_API_KEY est déjà défini dans votre environnement, Claude Code vous invite une seule fois à approuver cette clé au lieu d’ouvrir un navigateur. Refusez cette invite et la clé sera ensuite ignorée silencieusement, sans nouvelle invite — ce qui donne exactement l’impression que la variable n’est pas lue. Réactivez-la sous /config → Use custom API key.
Windows : natif ou WSL
| Option | Nécessite | Mise en bac à sable | Choisissez-le lorsque |
|---|---|---|---|
| Windows natif | Rien ; Git for Windows facultatif | Non pris en charge | Vos projets et outils sont natifs de Windows |
| WSL 2 | WSL 2 activé | Pris en charge | Chaînes d’outils Linux, ou besoin d’exécuter les commandes en bac à sable |
| WSL 1 | WSL 1 activé | Non pris en charge | WSL 2 n’est pas disponible |
Sous Windows natif, l’installation de Git for Windows est facultative mais recommandée : elle fournit Git Bash, qui sert de base à l’outil Bash. Sans lui, Claude Code exécute les commandes shell via l’outil PowerShell. Dans WSL, installez et lancez claude depuis le terminal WSL, et non depuis PowerShell.
Dépannage
| Symptôme | Cause et solution |
|---|---|
The token '&&' is not a valid statement separator | Vous avez exécuté la commande CMD dans PowerShell. Utilisez plutôt la ligne irm … | iex. |
'irm' is not recognized… | L’inverse : vous avez exécuté la commande PowerShell dans CMD. Utilisez la ligne curl … install.cmd. |
syntax error near unexpected token '<', une 403 ou une autre erreur curl | Le téléchargement n’a pas renvoyé le script — généralement à cause d’un proxy ou d’un filtre réseau entre vous et le programme d’installation. Réessayez ou utilisez plutôt une installation via un gestionnaire de paquets. |
claude: command not found après une installation propre | Ouvrez un nouveau terminal pour que votre shell détecte le répertoire d’installation, puis exécutez claude doctor. Une seconde installation plus ancienne ou un alias shell obsolète constitue l’autre cause fréquente. |
| Erreurs d’autorisation pendant une installation npm | Vous avez utilisé sudo, ou le répertoire global npm n’est pas accessible en écriture. Corrigez les droits de propriété du répertoire au lieu de relancer avec sudo ; un répertoire global non accessible en écriture bloque également les mises à jour automatiques. |
Binaire natif absent après npm install -g | Votre gestionnaire de paquets est configuré pour ignorer les dépendances facultatives. Le binaire de la plateforme est fourni sous cette forme ; autorisez donc ces dépendances et réinstallez. |
| L’installation échoue sur Alpine ou une autre distribution musl | Alpine est fourni sans bash ni curl. Installez bash curl libgcc libstdc++ ripgrep, puis définissez USE_BUILTIN_RIPGREP sur "0" dans le bloc env de votre fichier de paramètres. |
| La recherche et la découverte de fichiers échouent | ripgrep est normalement inclus. S’il ne peut pas s’exécuter sur votre plateforme, installez le ripgrep système et définissez USE_BUILTIN_RIPGREP=0. |
| Outil Bash absent sous Windows natif | Installez Git for Windows. Si Claude Code ne trouve toujours pas Git Bash, définissez CLAUDE_CODE_GIT_BASH_PATH dans le bloc env de ~/.claude/settings.json. |
401 une fois la clé configurée | La clé se trouve dans l’en-tête que le serveur ne lit pas — alternez entre ANTHROPIC_AUTH_TOKEN et ANTHROPIC_API_KEY. Consultez le guide des clés API pour plus de détails. |
Faire pointer Claude Code vers Kunavo
Une fois opérationnel, Claude Code fonctionnera avec tout point de terminaison qui fournit l’Anthropic Messages API — il lit ANTHROPIC_BASE_URL nativement. Il s’agit donc d’une configuration prise en charge, et non d’un contournement. Aucun plugin, aucun proxy, aucun binaire modifié :
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Cinq points à propos de ce bloc, dont chacun peut vous faire perdre une heure s’il est mal configuré :
ANTHROPIC_BASE_URLcorrespond uniquement à l’origine. Claude Code ajoute lui-même/v1/messages— inclure le chemin entraîne une erreur 404.- Utilisez
ANTHROPIC_AUTH_TOKEN, et nonANTHROPIC_API_KEY. Ils sont placés dans des en-têtes HTTP différents. Le jeton bearer prend effet immédiatement, tandis queANTHROPIC_API_KEYnécessite l’approbation unique décrite ci-dessus. Kunavo lit la clé depuis l’un ou l’autre en-tête, y compris/v1/models, de sorte que sur Kunavo, c’est cette étape d’approbation qui les distingue. - Définissez explicitement
ANTHROPIC_MODEL. Kunavo fait correspondre les identifiants de modèle exactement et ne crée pas d’alias pour les noms suffixés par une date ;claude-sonnet-4-5-20250929renvoie donc une erreur 404, contrairement àclaude-sonnet-5. - Définissez aussi
ANTHROPIC_DEFAULT_OPUS_MODELetANTHROPIC_DEFAULT_SONNET_MODEL. La valeur par défaut intégrée de Claude Code et son aliasopusse résolvent tous deux vers le dernier Opus ; si Kunavo ne sert pas encore ce modèle, la première requête renvoie 404. Le bloc définitopussur Opus 5.5 (claude-opus-5-5), qui nécessite Claude Code v2.1.280 ou une version ultérieure — exécutezclaude updatesur une installation plus ancienne. L’aliassonnetdemande Sonnet 5.5, que Kunavo ne sert pas ; sans le pin sonnet/model sonnet, la phase d’exécution deopusplanet tout sous-agent défini surmodel: sonnetrenvoient 404. ANTHROPIC_DEFAULT_HAIKU_MODELcouvre les appels en arrière-plan que Claude Code effectue de lui-même pour les résumés et les titres.claude-haiku-4-5coûte $0.70 / $3.50 par million contre $1.40 / $7.00 pour le modèle principal, soit une seule ligne de configuration pour réaliser des économies durables.
Placez ces valeurs dans le bloc env de ~/.claude/settings.json plutôt que dans une variable exportée par le shell si vous voulez que les éditeurs et les agents en arrière-plan les voient également — et jamais dans le .claude/settings.json versionné d’un projet. Créez la clé sk-kn- dans le tableau de bord après vous être inscrit ; le rechargement de $10 est le minimum, il n’y a pas de frais mensuels et le solde n’expire pas. Le coût de chaque modèle par jeton, comparé à la tarification officielle de l’API d’Anthropic, détermine jusqu’où vous mènera cette somme de $10.
Ce qui change derrière une passerelle
Le codage, les outils, les sous-agents, MCP, les hooks et la mise en cache des prompts ne sont pas affectés. Trois éléments changent toutefois et méritent d’être connus avant de conclure à un problème :
- Remote Control et la dictée vocale sont indisponibles. Les deux nécessitent une identité claude.ai, que les identifiants de la passerelle remplacent.
/fastpeut signaler que le mode rapide est désactivé. La vérification de disponibilité appelle directement Anthropic au lieu de suivre votre URL de base. Les requêtes normales ne sont pas affectées.- Les valeurs de
/contextdeviennent des estimations locales. Le comptage des jetons est le seul point de terminaison que la spécification de passerelle d’Anthropic marque comme facultatif. Lorsqu’il est absent, Claude Code effectue une estimation locale ; Kunavo ne fournit pas/v1/messages/count_tokensactuellement. La compactation automatique et la session elle-même ne sont pas affectées.
La liste complète, ainsi que le choix entre routeur et absence de routeur, figurent dans le guide du routeur Claude Code.
Questions fréquentes
Comment installer Claude Code ?
Sur macOS, Linux ou WSL, exécutez `curl -fsSL https://claude.ai/install.sh | bash`. Sous Windows, exécutez `irm https://claude.ai/install.ps1 | iex` dans PowerShell, ou `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` dans CMD. Le programme d’installation natif est la méthode recommandée et se met à jour en arrière-plan. Homebrew (`brew install --cask claude-code`), WinGet (`winget install Anthropic.ClaudeCode`), npm et les dépôts apt/dnf/apk signés sont également pris en charge, mais aucun d’eux ne se met automatiquement à jour par défaut.
Ai-je besoin de Node.js pour installer Claude Code ?
Pas avec le programme d’installation natif, Homebrew, WinGet ou les dépôts de paquets Linux : ils installent tous un binaire natif qui n’utilise pas Node à l’exécution. Seul le chemin d’installation npm implique Node et, depuis la version v2.1.198, ce paquet nécessite Node.js 22 ou une version ultérieure. Même dans ce cas, npm récupère simplement le même binaire natif via une dépendance facultative spécifique à la plateforme.
Quelle est la configuration système requise pour Claude Code ?
macOS 13.0 ou version ultérieure, Windows 10 1809 ou version ultérieure, Windows Server 2019 ou version ultérieure, Ubuntu 20.04 ou version ultérieure, Debian 10 ou version ultérieure, ou Alpine Linux 3.19 ou version ultérieure ; au moins 4 Go de RAM sur un processeur x64 ou ARM64 ; une connexion Internet ; et Bash, Zsh, PowerShell ou CMD comme shell. Vous devez également vous trouver dans un pays pris en charge par Anthropic.
Comment me connecter à Claude Code la première fois ?
Exécutez `claude` dans un répertoire de projet et suivez les instructions affichées dans le navigateur. Claude Code nécessite un compte Pro, Max, Team, Enterprise ou Console ; l’offre gratuite Claude.ai n’inclut pas l’accès à Claude Code. Si la variable d’environnement ANTHROPIC_API_KEY est définie, Claude Code vous invite une fois à approuver cette clé au lieu d’ouvrir un navigateur.
Puis-je installer Claude Code sous Windows sans WSL ?
Oui. Exécutez le programme d’installation PowerShell ou CMD et lancez `claude` depuis n’importe quel terminal ; vous n’avez pas besoin des droits d’administrateur. Git for Windows est facultatif, mais recommandé, car il fournit Git Bash, qui sert de base à l’outil Bash ; sans lui, Claude Code exécute les commandes shell via l’outil PowerShell. WSL 2 est l’option à choisir si vous voulez des chaînes d’outils Linux ou l’exécution de commandes en bac à sable, ce que Windows natif ne prend pas en charge.
Pourquoi `claude` indique-t-il que la commande est introuvable après l’installation ?
Le répertoire d’installation ne figure pas dans votre PATH dans le shell que vous utilisez. Ouvrez d’abord un nouveau terminal : le programme d’installation ajoute ~/.local/bin sous macOS et Linux, et une session existante ne le prendra pas en compte. Exécutez `claude doctor` pour obtenir des diagnostics en lecture seule de l’installation et de vos fichiers de paramètres. Une seconde installation plus ancienne ou un alias shell restant constitue l’autre cause fréquente.
Comment faire pointer Claude Code vers un autre point de terminaison d’API ?
Définissez ANTHROPIC_BASE_URL sur l’origine de tout point de terminaison qui sert l’API Anthropic Messages — Claude Code le lit nativement et ajoute lui-même /v1/messages ; aucun plugin ni proxy n’intervient. Associez-le à ANTHROPIC_AUTH_TOKEN pour les identifiants et à un ANTHROPIC_MODEL explicite, puis définissez ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL et ANTHROPIC_DEFAULT_HAIKU_MODEL sur des modèles servis par le point de terminaison, car les alias opus et sonnet suivent sinon les modèles les plus récents d’Anthropic. Sur Kunavo, cela exécute les mêmes modèles Claude à 30% du prix catalogue d’Anthropic, en paiement à l’utilisation.
Étapes suivantes
- Clé API Claude Code — où en obtenir une, où la placer et quelle incompatibilité d’en-tête est à l’origine de la plupart des erreurs 401.
- Tarification de Claude Code — abonnement contre API, tarifs par modèle et coût mensuel.
- Claude Code est-il gratuit ? — ce qui est gratuit, ce qui ne l’est pas et où se situe la limite.
- L’exécuter sans invites d’autorisation — ce que
--dangerously-skip-permissionssupprime réellement et trois mesures de confinement qui prennent environ une minute chacune. - Claude Code contre Codex CLI — si vous choisissez encore un agent de terminal.