Installer Claude Code : la commande pour Windows, macOS et Linux — et l’utiliser sans abonnement

Installer Claude Code ne nécessite qu'une commande : 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 (dans l'invite de commandes, le CMD, utilisez la ligne du install.cmd plus bas). Ouvrez ensuite un nouveau terminal, vérifiez avec claude --version et exécutez claude pour commencer. Lors de la première connexion, deux possibilités existent : 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 payée à l'usage — sans aucun abonnement.

Commandes vérifiées le 11 septembre 2026, dans la documentation officielle d'installation d'Anthropic.

Avant l'installation

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. Le raccourci 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. Sous WSL, la commande est identique.

Installer sous Windows

Sous Windows, il existe deux lignes différentes ; la seule différence concerne le terminal utilisé. Si l'invite commence par PS C:\Users\SeuNome>, il s'agit de PowerShell ; sans le PS, avec seulement C:\Users\SeuNome>, il s'agit de l'invite de commandes (CMD). Il n'est pas nécessaire d'exécuter la commande en tant qu'administrateur.

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

:: Windows Prompt de Comando (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

Installer Git for Windows est facultatif, mais recommandé : Claude Code utilise le Git Bash fourni avec celui-ci pour exécuter les commandes ; en son absence, il utilise PowerShell. Si Git est installé mais que Git Bash est introuvable, définissez CLAUDE_CODE_GIT_BASH_PATH dans le bloc env des paramètres en le faisant pointer vers bash.exe.

Dans WSL, exécutez la ligne macOS/Linux dans le terminal WSL et ouvrez claude au même endroit — pas depuis PowerShell ni CMD.

Avec le gestionnaire de paquets

Cela fonctionne, avec une différence importante : aucun d'entre eux ne se met automatiquement à jour par défaut. Vous les mettez à jour manuellement (brew upgrade claude-code, 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 — exige Node.js 22 ou mais novo; nunca com sudo
npm install -g @anthropic-ai/claude-code

Avec npm, depuis la version 2.1.198, le paquet exige 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. Le paquet installe le même binaire natif, qui n'utilise pas Node.js pour fonctionner. N'utilisez jamais sudo npm install -g : cela provoque des problèmes d'autorisation et constitue un risque de sécurité.

Vérifier l'installation

claude --version   # imprime a versão, por exemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico da instalação e das configurações, sem abrir sessão

Conservez le claude doctor : sans ouvrir de session, il affiche l'état de l'installation, les erreurs dans les fichiers de configuration et la correction 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 command not found: claude apparaît (ou, sous Windows, si claude n'est pas reconnu), le dossier d'installation ne se trouve pas dans le PATH. Sur macOS et Linux, ouvrez un nouveau terminal ; si cela ne résout pas le problème, ajoutez ~/.local/bin au PATH dans ~/.zshrc ou ~/.bashrc. Sous Windows, le dossier est %USERPROFILE%\.local\bin ; vérifiez-le et ajoutez-le avec PowerShell :

# 1. Veja se a pasta de instalação já está no PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sem saída? Adicione ao PATH do usuário e abra um terminal novo
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. No terminal novo: se houver duas instalações, aparecem dois caminhos
where.exe claude

Première connexion : abonnement ou clé API

Option A — connexion avec l'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 qui prête souvent à confusion : si la variable ANTHROPIC_API_KEY est déjà définie, Claude Code demande une fois s'il doit utiliser cette clé. Si vous refusez, il cesse de l'utiliser silencieusement et ne redemande pas — on peut croire que la variable n'est pas lue. Pour la réactiver, accédez à /config → Use custom API key.

Option B — sans abonnement, avec une clé payée à l'usage

Claude Code lit nativement le ANTHROPIC_BASE_URL ; le pointer vers n'importe quel endpoint de l'Anthropic Messages API est donc une configuration prise en charge — sans plugin, proxy ni binaire modifié. Procédure : créez le compte, rechargez le solde (minimum 10 $), générez une clé sk-kn- dans le tableau de bord des clés (elle ne s'affiche qu'une seule fois) et définissez les variables. Sur macOS et Linux :

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # só o domínio, sem /v1
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-5

Sous Windows, pour tester dans une fenêtre PowerShell :

# Vale só para esta janela do PowerShell
$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

Pour rendre la configuration permanente, le meilleur emplacement est le bloc env du fichier de paramètres utilisateur, ~/.claude/settings.json (sous Windows, %USERPROFILE%\.claude\settings.json). Les variables y s'appliquent à tous les terminaux, à l'extension de l'éditeur et aux processus en arrière-plan. Si le fichier contient déjà d'autres paramètres, ajoutez simplement le bloc env :

{
  "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"
  }
}

Chacune de ces lignes comporte un piège :

• ANTHROPIC_BASE_URL ne contient que le domaine. Claude Code ajoute /v1/messages ; avec /v1 à la fin, la requête est envoyée vers /v1/v1/messages et renvoie 404.
• Utilisez ANTHROPIC_AUTH_TOKEN, pas ANTHROPIC_API_KEY. Ils sont transmis dans des en-têtes HTTP différents : le premier envoie Authorization: Bearer et est valable immédiatement ; le second envoie x-api-key et nécessite encore l'approbation unique décrite plus haut.
• Écrivez le nom exact du modèle dans ANTHROPIC_MODEL. Kunavo ne reconnaît que le nom identique et ne traduit pas les anciens noms comportant une date en suffixe.
• Épinglez également ANTHROPIC_DEFAULT_OPUS_MODEL et ANTHROPIC_DEFAULT_SONNET_MODEL. Le modèle par défaut de Claude Code et l’alias opus pointent vers la version la plus récente d’Opus ; si Kunavo ne la propose pas encore, la première requête renvoie une erreur 404. L’alias sonnet demande déjà Sonnet 5.5, que Kunavo ne propose pas : sans l’épingler, /model sonnet, la phase d’exécution de opusplan et les sous-agents avec model: sonnet reçoivent une erreur 404. L’alias opus est épinglé sur Opus 5.5 (claude-opus-5-5), ce qui nécessite Claude Code v2.1.280 ou une version plus récente — sur une ancienne installation, exécutez claude update.
• ANTHROPIC_DEFAULT_HAIKU_MODEL couvre les appels en arrière-plan que Claude Code effectue automatiquement (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 git et devient accessible à toute personne qui clone le dépôt. Dans l'extension VS Code, les variables se trouvent dans claudeCode.environmentVariables, dans les paramètres utilisateur de VS Code lui-même, car l'extension vérifie les identifiants avant de démarrer.

Tarifs par million de jetons, relevés dans le catalogue :

Pour changer de modèle dans la session, utilisez /model avec le nom complet (par exemple /model claude-opus-5-5) ou démarrez Claude Code avec claude --model claude-opus-5-5. Le coût d'un mois d'utilisation et le moment où l'abonnement est le plus avantageux sont expliqués dans le guide de tarification de Claude Code.

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. Les deux ne se cumulent pas : lorsque la variable est définie, l'abonnement reste inactif ; supprimez la variable et Claude Code revient à l'abonnement, sans réinstallation.

Derrière une passerelle, trois choses changent : Remote Control et la dictée vocale ne fonctionnent pas (ils nécessitent l'identité claude.ai) ; le /fast peut indiquer que le mode rapide est indisponible, car cette vérification s'effectue directement auprès d'Anthropic, mais les requêtes normales ne changent pas ; et les chiffres du /context deviennent des estimations locales. Le code, les outils, les sous-agents, MCP, les hooks et la mise en cache des invites fonctionnent de la même manière. Les détails se trouvent dans la documentation de l'intégration (en anglais).

Payer depuis le Brésil — Pix au moment du paiement

L’abonnement claude.ai est une facturation récurrente en dollars qui nécessite une carte internationale autorisée pour les achats à l’étranger. Avec une clé API, la recharge passe par le paiement Stripe et Pix apparaît comme moyen de paiement pour les personnes payant depuis le Brésil : le prix est en USD et Stripe affiche le montant converti en réals avant la confirmation. Une carte internationale (Visa, Mastercard, American Express), Apple Pay, Google Pay et Link apparaissent également lors du paiement. Le portefeuille est prépayé — recharge minimale de 10 $, solde qui n’expire pas, requêtes échouées non facturées — et chaque clé peut avoir une limite mensuelle de dépenses. Le guide détaillé, écran par écran, se trouve dans comment payer l’API avec Pix.

Erreurs courantes

Après l'installation

Lors de la première utilisation, exécutez /init dans le projet : Claude Code lit le dépôt et génère un CLAUDE.md contenant les commandes de test et les conventions qu'il trouve. Relisez ce fichier et gardez-le court — il est chargé à chaque session. Entre deux tâches sans rapport, /clear démarre une nouvelle conversation ; pour une tâche devenue longue, /compact résume l'historique et continue.

Pour être honnête sur le choix : pour les personnes qui utilisent Claude Code plusieurs heures par jour, le forfait mensuel revient généralement moins cher ; le paiement à l'usage est avantageux lorsque l'utilisation fluctue ou lorsque vous ne voulez pas être limité par la fenêtre de 5 heures — et un mois sans activité coûte zéro. Avec Kunavo, vous utilisez une capacité partagée, sans quota dédié ni SLA contractuel ; les personnes qui ont besoin de ces garanties doivent contracter directement avec Anthropic.

Questions fréquentes