Comment installer Claude Code sous Windows, macOS et Linux — et l’utiliser sans abonnement

Une seule commande suffit pour installer Claude Code : sur macOS, Linux ou WSL, exécutez curl -fsSL https://claude.ai/install.sh | bash ; sous Windows, irm https://claude.ai/install.ps1 | iex dans PowerShell (dans l’invite de commandes, CMD, utilisez la ligne install.cmd indiquée plus bas). Ouvrez ensuite un nouveau terminal, vérifiez avec claude --version, accédez au dossier de votre projet et exécutez claude ; la première commande utile est /init. Pour vous connecter, deux possibilités : vous connecter avec un compte Pro, Max, Team, Enterprise ou Console (l’offre gratuite de Claude.ai n’inclut pas Claude Code), ou définir deux variables d’environnement, ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN, et utiliser une clé API facturée à l’usage, sans abonnement.

Commandes vérifiées le 11 septembre 2026 à partir de la documentation officielle d’installation d’Anthropic.

Prérequis

Installer sur macOS et Linux

Ouvrez le Terminal et collez :

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

C’est la méthode recommandée : elle installe un binaire autonome qui se met automatiquement à jour en arrière-plan. L’exécutable se trouve dans ~/.local/bin/claude et un terminal déjà ouvert ne voit pas le nouveau PATH ; ouvrez donc une autre fenêtre avant de tester. Dans WSL, la commande est identique.

Installer Claude Code sous Windows

Sous Windows, il existe deux lignes distinctes et seule la terminale change. Si l’invite commence par PS C:\Users\TuNombre>, vous êtes dans PowerShell ; sans le PS, avec seulement C:\Users\TuNombre>, vous êtes dans l’invite de commandes (CMD). Il n’est pas nécessaire de l’exécuter en tant qu’administrateur.

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows Símbolo del sistema (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Coller la mauvaise ligne dans le mauvais terminal est l’erreur la plus fréquente. La ligne CMD dans PowerShell renvoie The token '&&' is not a valid statement separator ; la ligne PowerShell dans CMD renvoie 'irm' is not recognized as an internal or external command (sur un Windows en français, « n’est pas reconnu comme une commande interne ou externe ») ; et le curl … | bash de macOS collé dans PowerShell renvoie A parameter cannot be found that matches parameter name 'fsSL'. Dans les trois cas, il suffit d’utiliser la ligne correspondante.

Installer Git for Windows est facultatif, mais recommandé : Claude Code utilise son Git Bash pour exécuter les commandes et, en son absence, utilise PowerShell. Si Git est installé mais que Git Bash reste introuvable, définissez CLAUDE_CODE_GIT_BASH_PATH dans le bloc env de la configuration, avec le chemin vers bash.exe.

Avec WSL, exécutez la ligne macOS/Linux dans le terminal WSL et lancez claude depuis celui-ci, et non depuis PowerShell ou CMD.

Avec un gestionnaire de paquets

Cela fonctionne également, avec une différence importante : aucun ne se met automatiquement à jour par défaut (vous devrez exécuter brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode). Il existe également des dépôts apt, dnf et apk signés pour Debian/Ubuntu, Fedora/RHEL et Alpine.

# Homebrew (macOS, Linux) — canal stable
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm — requiere Node.js 22 o posterior; nunca con sudo
npm install -g @anthropic-ai/claude-code

Avec npm, à partir de la version 2.1.198, le paquet nécessite Node.js 22 ou une version ultérieure ; avec une ancienne version de Node, npm affiche seulement un avertissement EBADENGINE et l’installation se termine. Il installe le même binaire natif, qui n’utilise pas Node.js pour s’exécuter. N’utilisez jamais sudo npm install -g : cela provoque des problèmes d’autorisations et constitue un risque de sécurité.

Vérifier l’installation

claude --version   # imprime la versión, por ejemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico de la instalación y la configuración, sin abrir sesión

Utilisez claude doctor : sans ouvrir de session, cette commande affiche l’état de l’installation, les erreurs des fichiers de configuration et la solution suggérée. C’est le moyen le plus rapide de déterminer si le problème vient de l’installation ou de la configuration.

Si vous voyez command not found: claude (ou, sous Windows, que claude n’est pas reconnu), le dossier d’installation ne se trouve pas dans le PATH. Sous macOS et Linux, ouvrez un nouveau terminal et, si le problème persiste, ajoutez ~/.local/bin au PATH dans ~/.zshrc ou ~/.bashrc. Sous Windows, le dossier est %USERPROFILE%\.local\bin ; vérifiez-le et ajoutez-le depuis PowerShell :

# 1. Comprueba si la carpeta de instalación ya está en el PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. ¿Sin salida? Añádela al PATH de usuario y abre una terminal nueva
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. En la terminal nueva: si hay dos instalaciones, verás dos rutas
where.exe claude

Première connexion : abonnement ou clé API

Option A — se connecter avec votre abonnement

Dans le dossier du projet, exécutez claude et suivez la procédure de connexion dans le navigateur avec un compte Pro, Max, Team, Enterprise ou Console. Un détail peut prêter à confusion : si la variable ANTHROPIC_API_KEY est déjà définie, Claude Code vous demande une seule fois si vous souhaitez utiliser cette clé. Si vous répondez non, il l’ignore désormais sans vous le redemander, donnant l’impression que la variable n’est pas lue. Pour la réactiver : /config → Use custom API key.

Option B — sans abonnement, avec une clé facturée à l’usage

Claude Code lit nativement ANTHROPIC_BASE_URL, ce qui permet de le pointer vers n’importe quel endpoint de l’API Messages d’Anthropic : sans plugins, sans proxy et sans binaires modifiés. Procédure : créez le compte, rechargez le solde (minimum $10), générez une clé sk-kn- dans le panneau des clés (elle ne s’affiche qu’une seule fois) et ajoutez ce bloc env à votre configuration utilisateur, ~/.claude/settings.json (sous Windows, %USERPROFILE%\.claude\settings.json). Toutes les fenêtres de terminal, l’extension de l’éditeur et les processus en arrière-plan pourront ainsi l’utiliser :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Pour tester d’abord dans une seule fenêtre PowerShell :

# Solo para esta ventana de PowerShell (en macOS/Linux: export VARIABLE=valor)
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

• ANTHROPIC_BASE_URL contient uniquement le domaine. Claude Code ajoute /v1/messages ; avec /v1 à la fin, la requête est envoyée vers /v1/v1/messages et renvoie une erreur 404.
• Utilisez ANTHROPIC_AUTH_TOKEN, pas ANTHROPIC_API_KEY. Elles figurent dans des en-têtes HTTP différents : la première envoie Authorization: Bearer et fonctionne immédiatement ; la seconde envoie x-api-key et passe en plus par l’approbation unique mentionnée plus haut.
• Écrivez le nom exact du modèle dans ANTHROPIC_MODEL. Kunavo reconnaît uniquement le nom identique et ne traduit pas les anciens noms avec une date.
• Définissez également ANTHROPIC_DEFAULT_OPUS_MODEL. Le modèle par défaut de Claude Code et son alias opus pointent vers le dernier Opus et, si Kunavo ne le propose pas encore, la première requête renvoie une erreur 404. Ici, l’alias opus est défini sur Claude Opus 5.5 (claude-opus-5-5), ce qui nécessite Claude Code v2.1.280 ou une version ultérieure ; avec une version antérieure, exécutez claude update.
• Et définissez également ANTHROPIC_DEFAULT_SONNET_MODEL. L’alias sonnet demande Sonnet 5.5, que Kunavo ne propose pas : sans cette variable, /model sonnet, la phase d’exécution de opusplan et les sous-agents configurés avec sonnet renvoient une erreur 404. La définir sur claude-sonnet-5 évite ce problème.
• ANTHROPIC_DEFAULT_HAIKU_MODEL couvre les appels en arrière-plan que Claude Code effectue de lui-même (résumés, titres) : le pointer vers Haiku permet d’économiser sans effort.

Ne placez jamais la clé dans le .claude/settings.json du projet : ce fichier est envoyé dans le dépôt. Dans l’extension VS Code, les variables doivent se trouver dans claudeCode.environmentVariables, au sein de la configuration utilisateur de VS Code, car l’extension vérifie les identifiants avant de démarrer.

Tarifs pour 1 M de tokens, relevés dans le catalogue :

Comment savoir quelle option est active

Dans Claude Code, exécutez /status. Une ligne Auth token signifie que la clé est utilisée ; une ligne Login method avec un compte claude.ai signifie que la variable n’a pas été lue. Elles ne s’additionnent pas : tant que la variable existe, l’abonnement reste désactivé ; supprimez-la et Claude Code revient à l’abonnement, sans réinstallation.

Derrière une passerelle, trois éléments changent : Remote Control et la dictée vocale ne sont pas disponibles (ils nécessitent l’identité claude.ai) ; /fast peut indiquer que le mode rapide n’est pas disponible, car cette vérification s’effectue directement auprès d’Anthropic, même si les requêtes normales ne changent pas ; et les chiffres de /context deviennent des estimations locales. Le code, les outils, les sous-agents, MCP, les hooks et la mise en cache des prompts fonctionnent de la même manière. Tous les détails se trouvent dans la documentation de l’intégration et le guide de la clé API de Claude Code (tous deux en anglais).

Comment utiliser Claude Code : les premières étapes

# 1. Arranca siempre dentro de la carpeta del proyecto
cd ~/proyectos/mi-app
claude

# 2. Primer comando: lee el repositorio y genera CLAUDE.md
> /init

# 3. Pide las tareas en español y con la ruta del archivo
> cambia la validación de src/api/user.ts a zod y arregla los tests

# 4. Para tareas que tocan muchos archivos: Shift+Tab activa el modo plan

Claude Code vous demande l’autorisation avant de modifier un fichier ou d’exécuter une commande ; s’il s’engage dans la mauvaise direction, appuyez sur Échap pour l’arrêter et sur /rewind pour revenir à un point antérieur. Le CLAUDE.md généré par /init est une ébauche : limitez-le à ce que vous répéteriez à chaque session (commandes de test, conventions, dossiers à ne pas modifier). Il est chargé à chaque session et envoyé dans chaque requête, et Anthropic recommande de ne pas dépasser 200 lignes.

• Changer de modèle : /model suivi du nom complet, par exemple /model claude-opus-5, ou démarrez avec claude --model claude-opus-5. Faites-le entre deux tâches : chaque modèle possède son propre cache, et changer en cours de tâche oblige à relire toute la conversation sans cache.
• /clear entre deux tâches sans rapport. Commencez une nouvelle conversation, cela ne coûte rien ; l’ancienne est récupérable avec /resume.
• /compact lorsqu’une tâche se prolonge : résumez l’historique et poursuivez. Avec une clé API, le cache dure cinq minutes par défaut ; compactez donc avant une longue pause, et non après.
• Ce que coûte une session : /usage affiche les tokens, mais le montant calculé est une estimation locale au tarif catalogue d’Anthropic ; avec Kunavo, le montant réel apparaît sur votre page d’utilisation.

Paiement et transparence sur le choix

Le solde est prépayé via Stripe : carte (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay ou Link ; le prélèvement SEPA n’est pas disponible. La recharge minimale est de $10, le solde n’expire pas, les requêtes échouées ne sont pas facturées et chaque clé accepte une limite de dépenses mensuelle. Tous les tarifs figurent sur la page des tarifs.

Si vous utilisez Claude Code plusieurs heures par jour, le forfait fixe d’un abonnement est généralement moins cher ; le paiement à l’usage est avantageux lorsque l’utilisation est irrégulière ou que vous ne voulez pas dépendre de la fenêtre de 5 heures, et un mois sans activité ne coûte rien. La comparaison complète, en anglais, se trouve dans Claude Code pricing. Avec Kunavo, vous utilisez une capacité partagée, sans capacité dédiée ni SLA contractuel : si vous avez besoin de ces garanties, souscrivez directement auprès d’Anthropic.

Questions fréquentes