Installer Claude Code : commandes pour Windows, macOS et Linux, clé API sans abonnement et paiement avec MB WAY

Claude Code s’installe avec une commande officielle par système : sur macOS, Linux et WSL, curl -fsSL https://claude.ai/install.sh | bash ; sous Windows, dans PowerShell, irm https://claude.ai/install.ps1 | iex (dans l’invite de commandes, le CMD, la ligne de install.cmd plus bas). Vous pouvez ensuite l’utiliser de deux façons. Avec un abonnement, connectez-vous avec un compte Pro, Max, Team, Enterprise ou Console (le forfait gratuit de Claude.ai ne donne pas accès à Claude Code). Sans abonnement, utilisez une clé API : définissez ANTHROPIC_BASE_URL (uniquement le domaine, sans /v1), ANTHROPIC_AUTH_TOKEN et quatre variables de modèle, puis vérifiez avec /status. Le solde Kunavo se recharge avec MB WAY sur la page de paiement en euros, à partir de US$ 10, sans abonnement mensuel.

Comandos e variáveis verificados a 3 octobre 2026 na documentation officielle d’installation de Claude Code e na documentation des variables d’environnement; preços e meios de pagamento verificados a 3 octobre 2026. Portugal consta da liste des pays pris en charge par Anthropic (consultada a 3 octobre 2026), tanto para o Claude.ai como para a API. Este guia existe também em inglês: Installer Claude Code.

Avant l'installation

macOS, Linux et WSL : une seule ligne

Dans le Terminal (sur macOS, il se trouve dans Applications › Utilitaires), exécutez :

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

Il s’agit de l’installation native recommandée : un programme autonome qui, selon la documentation officielle, se met à jour automatiquement en arrière-plan. La commande claude se trouve dans ~/.local/bin. Un terminal déjà ouvert ne connaît pas encore le nouveau PATH ; ouvrez donc une nouvelle fenêtre avant de tester. Dans WSL, la ligne est exactement la même, exécutée dans le terminal WSL.

Installer sous Windows

Sous Windows, il existe deux lignes, et le choix dépend uniquement de la fenêtre ouverte. Si la ligne commence par PS C:\Users\Nome>, vous êtes dans PowerShell ; si seul C:\Users\Nome> apparaît, sans PS, vous êtes dans l’invite de commandes (CMD). Il n’est pas nécessaire d’utiliser « Exécuter en tant qu’administrateur » : la documentation officielle indique expressément que ce n’est pas nécessaire, contrairement à ce que recommandent certains guides en portugais.

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

:: Linha de Comandos do Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Sous Windows, l’erreur la plus fréquente consiste à utiliser la mauvaise fenêtre. Si PowerShell répond The token '&&' is not a valid statement separator, vous avez reçu la ligne du CMD ; si le CMD répond 'irm' is not recognized as an internal or external command, vous avez reçu celle de PowerShell. Dans un Windows en portugais, ce second message peut apparaître traduit, avec la même cause. Et si vous collez la ligne macOS, avec | bash, dans PowerShell, une erreur indique que bash n’est pas reconnu. Dans les trois cas, la solution consiste à utiliser la ligne correspondant à la fenêtre.

O Git for Windows é opcional. Com ele, a ferramenta Bash do Claude Code passa a correr no Git Bash, e o PowerShell continua disponível ao lado; sem ele, todos os comandos correm pelo PowerShell. Quando o Git está instalado numa pasta fora do habitual e o Claude Code não dá com o bash.exe, indica-se o caminho em CLAUDE_CODE_GIT_BASH_PATH, dentro do bloco env de ~/.claude/settings.json; o exemplo da documentação é C:\Program Files\Git\bin\bash.exe.

WSL est donc un choix, et non une exigence, contrairement à ce qu’indiquent certains guides. Si vous choisissez WSL, exécutez la ligne macOS/Linux dans le terminal WSL et démarrez claude là aussi, et non depuis PowerShell ou le CMD.

Via Homebrew, WinGet ou npm

Cela fonctionne également, avec une différence importante : selon la documentation officielle, les installations via Homebrew et WinGet ne se mettent pas à jour automatiquement. La mise à jour doit être effectuée manuellement. Il existe également des dépôts apt, dnf et apk signés pour Linux.

# Homebrew
brew install --cask claude-code
brew upgrade claude-code              # não se atualiza sozinho

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # não se atualiza sozinho

Le paquet npm exige Node.js 22 ou une version ultérieure — et non Node.js 18, encore indiqué dans certains guides. Avec une version plus ancienne de Node.js, npm affiche seulement un avertissement EBADENGINE pendant l’installation, au lieu d’échouer. N’utilisez jamais sudo npm install -g : la documentation officielle le déconseille expressément. Pour mettre à jour, utilisez @latest, et non npm update -g.

node -v                                           # tem de ser v22 ou posterior
npm install -g @anthropic-ai/claude-code          # nunca com sudo

# para atualizar mais tarde: com @latest, não com npm update -g
npm install -g @anthropic-ai/claude-code@latest

Vérifier l’installation

claude --version   # mostra o número da versão, seguido de (Claude Code)
claude doctor      # diagnóstico só de leitura da instalação e das definições, sem abrir sessão

claude doctor n’ouvre aucune session : il affiche l’état de l’installation et des fichiers de paramètres. C’est le moyen le plus rapide de déterminer si un problème vient de l’installation ou de la configuration.

Um command not found: claude (ou, no Windows, a indicação de que claude não é um comando conhecido) quer dizer que o terminal não sabe onde o programa ficou. Muitas vezes basta fechar a janela e abrir outra. Se continuar, falta a pasta no PATH: no macOS e no Linux é ~/.local/bin, a acrescentar no ficheiro de arranque da shell (~/.zshrc ou ~/.bashrc); no Windows é %USERPROFILE%\.local\bin; segundo a résolution officielle des problèmes, confirma-se e acrescenta-se assim no PowerShell:

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

# 2. Sem resultado? Acrescente-a ao PATH do utilizador e abra uma janela nova
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Na janela nova: dois caminhos significam duas instalações lado a lado
where.exe claude

Si vous avez installé via npm et que PowerShell répond npm.ps1 cannot be loaded because running scripts is disabled on this system, c’est la stratégie d’exécution de PowerShell qui bloque les scripts npm. Utilisez l’installateur natif ou autorisez les scripts locaux pour votre utilisateur :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Et si Claude Code does not support 32-bit Windows apparaît, c’est que « Windows PowerShell (x86) » a été ouvert. Windows comporte deux entrées PowerShell et la version x86 s’exécute comme un processus 32 bits ; ouvrez l’entrée « Windows PowerShell », sans (x86).

Première utilisation : abonnement ou clé API

Au premier démarrage, vous choisissez comment Claude Code est payé. Il n’est pas nécessaire de réinstaller pour changer de méthode : tout dépend de la présence ou non d’une clé définie.

Méthode A — se connecter avec l’abonnement

Dans le dossier du projet, exécutez claude et connectez-vous dans le navigateur. Attention si ANTHROPIC_API_KEY est déjà défini dans l’environnement : au lieu d’ouvrir le navigateur, Claude Code demande une approbation unique pour cette clé. Si vous refusez cette approbation, la clé est ensuite ignorée et la question ne se répète pas ; vous pouvez alors croire que la variable n’est pas lue. Pour la réactiver : /config → Use custom API key.

Méthode B — sans abonnement, avec une clé API

ANTHROPIC_BASE_URL est une variable propre à Claude Code, conçue pour acheminer les requêtes via un proxy ou une passerelle. La diriger vers un endpoint compatible avec la Messages API d’Anthropic constitue donc une configuration prise en charge, sans plug-ins ni versions modifiées. Étapes :

1. Créer un compte Kunavo.
2. Recharger le solde dans Facturation, à partir de US$ 10 (le paiement avec MB WAY est expliqué plus bas).
3. Dans /app/keys, créez une clé commençant par sk-kn-. Elle ne s’affiche qu’une seule fois ; pensez donc à la sauvegarder immédiatement.
4. Définir les variables. Sur macOS et Linux, dans ~/.zshrc ou ~/.bashrc :

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 commencer par 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 une utilisation permanente, le meilleur emplacement est le bloc env des paramètres utilisateur : ~/.claude/settings.json (sous Windows, %USERPROFILE%\.claude\settings.json). Les valeurs s’appliquent alors à tous les projets, y compris aux agents en arrière-plan ; l’extension VS Code constitue l’exception (voir ci-dessous). Une variable exportée dans le shell n’est accessible qu’aux programmes lancés depuis ce shell : un éditeur ouvert depuis le Dock ou le menu Démarrer ne la voit pas. Si le fichier contient déjà d’autres paramètres, ajoutez uniquement 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"
  }
}

Jamais ponha a chave no .claude/settings.json de um projeto: segundo a documentation officielle des passerelles (consultada a 3 octobre 2026), esse ficheiro entra nos commits e é partilhado com quem clonar o repositório. E atenção à precedência: quando a shell e um ficheiro de definições definem a mesma variável, prevalece o ficheiro de definições. Se uma alteração na shell não surtir efeito, veja primeiro o settings.json.

Les utilisateurs de l’extension VS Code définissent les variables dans claudeCode.environmentVariables, dans les paramètres utilisateur de VS Code lui-même (commande Preferences: Open User Settings (JSON)). Selon la documentation des passerelles, l’extension vérifie les identifiants dans ce paramètre avant de démarrer ; les valeurs de ~/.claude/settings.json sont transmises au processus Claude Code, mais pas à cette vérification :

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

Les quatre variables de modèle et les autres pièges

Chaque ligne du bloc comporte son propre piège :

• Le chemin ne doit pas figurer dans ANTHROPIC_BASE_URL. Le chemin /v1/messages est ajouté par Claude Code lui-même ; une adresse se terminant déjà par /v1 devient /v1/v1/messages, qui renvoie 404.
• ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY : Kunavo accepte les deux. Selon la documentation des passerelles, ANTHROPIC_AUTH_TOKEN est transmis dans l’en-tête Authorization: Bearer et s’applique immédiatement ; ANTHROPIC_API_KEY est transmis dans l’en-tête x-api-key et, en mode interactif, doit être approuvé une fois avant de prendre effet (voir Méthode A). C’est pourquoi ce guide utilise ANTHROPIC_AUTH_TOKEN.
• Le nom dans ANTHROPIC_MODEL doit être exact. Copiez-le exactement comme indiqué ici : claude-sonnet-5.
• Sans ANTHROPIC_DEFAULT_SONNET_MODEL ni ANTHROPIC_DEFAULT_OPUS_MODEL, les alias changent automatiquement. Segundo a documentation sur la configuration des modèles (consultada a 3 octobre 2026), para quem usa a API da Anthropic o alias opus aponta para o Opus 5.5 e o alias sonnet para o Sonnet 5.5, e estes aliases mudam com as novas versões. Fixa-se com o nome completo do modelo ou com variáveis como ANTHROPIC_DEFAULT_OPUS_MODEL. O Kunavo não serve o Sonnet 5.5, e um modelo que não existe devolve 404: sem ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5, falham o /model sonnet, os subagentes com model: sonnet e o passo de execução do opusplan. Já o opus aponta para claude-opus-5-5, que o Kunavo serve, mas só a partir do Claude Code v2.1.280; quem tiver uma versão anterior corre claude update.
• ANTHROPIC_DEFAULT_HAIKU_MODEL s’applique également aux tâches en arrière-plan. Selon la documentation, il définit l’alias haiku et le modèle des fonctions en arrière-plan de Claude Code. Avec Claude Haiku 4.5, ces appels utilisent le modèle le moins cher du tableau ci-dessous.

Preços por milhão de tokens, do catálogo do Kunavo; a coluna da Anthropic vem de claude.com/pricing (consultado a 3 octobre 2026):

Au sein d’une session, changez de modèle avec /model claude-opus-5-5, ou démarrez directement avec claude --model claude-opus-5-5. Le calcul en euros, avec des exemples d’utilisation mensuelle et le seuil à partir duquel un abonnement devient plus avantageux, se trouve dans Prix de Claude Code en euros ; calculez votre consommation avec la calculatrice du coût des tokens. Tous les modèles et les prix figurent sur la page des prix.

Vérifier avec /status

Exécutez claude. Avec ANTHROPIC_AUTH_TOKEN défini, aucun écran de connexion ne s’affiche : la variable s’applique immédiatement. Si l’écran de connexion apparaît, Claude Code n’a lu aucune clé. Dans ce cas, définissez-la à un emplacement que Claude Code lit avant l’assistant du premier démarrage : un export dans le shell ou le bloc env de ~/.claude/settings.json. Un bloc env dans .claude/settings.json ou .claude/settings.local.json d’un projet ne s’applique, dans une session interactive, qu’après l’assistant du premier démarrage et la question concernant la confiance envers le dossier.

Dentro da sessão, escreva /status e procure duas linhas no separador Status (fonte: a documentation officielle des passerelles, consultada a 3 octobre 2026):

• Anthropic base URL doit afficher https://api.kunavo.com. Cette ligne n’apparaît que lorsqu’une adresse de passerelle est définie ; si elle manque, ANTHROPIC_BASE_URL n’a pas été transmise à la session.
• La ligne Auth token doit indiquer ANTHROPIC_AUTH_TOKEN. Si, à la place, Login method apparaît avec un compte claude.ai, la variable n’a pas été lue et la session utilise l’abonnement.

Une personne déjà connectée avec un abonnement peut voir, au démarrage, un avertissement indiquant que deux identifiants sont actifs (le message se termine par auth may not work as expected). Les requêtes passent par la clé ; /logout supprime l’ancienne connexion.

Pour tester l’adresse et la clé avant d’ouvrir Claude Code, la documentation suggère une requête avec un seul token de sortie, qui ne consomme qu’une fraction infime du solde. Les commandes lisent les variables du shell ; définissez-les donc également à cet endroit, même si elles figurent déjà dans settings.json.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Une réponse JSON commençant par {"id":"msg_ signifie que l’adresse et la clé fonctionnent ; dans PowerShell, un id commençant par msg_ apparaît. Un 401 signifie que la clé n’a pas été reconnue.

Ce qui change avec une clé API

• Remote Control et la dictée vocale sont indisponibles. Selon la documentation des passerelles, ils restent indisponibles tant que ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN ou un apiKeyHelper sont actifs ; Remote Control est également désactivé tant que ANTHROPIC_BASE_URL pointe vers une adresse extérieure à Anthropic.
• /fast apparaît comme désactivé en mode rapide. Avec uniquement un bearer token, Claude Code considère le mode rapide comme désactivé.
• La recherche d’outils MCP (MCP tool search) est désactivée par défaut quando ANTHROPIC_BASE_URL aponta para um endereço fora da Anthropic (documentation des variables d’environnement, consultada a 3 octobre 2026).
• Les chiffres de /context sont des estimations. O Kunavo não serve /v1/messages/count_tokens e, segundo a documentation de compatibilité des passerelles (consultada a 3 octobre 2026), sem esse endpoint o Claude Code recorre a uma estimativa baseada em caracteres.

Le reste — code, outils, sous-agents, serveurs MCP, hooks et mise en cache des prompts — fonctionne comme d’habitude. Plus de détails dans la documentation d’intégration de Claude Code (en anglais) et dans Claude Code without a subscription (en anglais).

Payer le solde avec MB WAY

Primeiro, a subscrição: uma subscrição Claude comprada no site paga-se só com cartão de crédito ou de débito (article d’aide d’Anthropic sur les forfaits payants, consultado a 3 octobre 2026); numa subscrição feita na aplicação Claude para iOS ou Android, os meios de pagamento são os da App Store ou do Google Play. Os meios de pagamento do Kunavo, MB WAY incluído, não pagam o Claude Pro nem o Max: carregam o saldo da API do Kunavo, que é o que a Rota B usa.

O saldo carrega-se no checkout da Stripe. Os preços estão em dólares americanos; para quem compra em Portugal, a Stripe mostra o valor em euros. Segundo a documentation de Stripe sur Adaptive Pricing (consultada a 3 octobre 2026), essa conversão inclui uma comissão de 2–4% paga pelo comprador; quem escolhe pagar em dólares (com cartão, Apple Pay, Google Pay ou Link) não paga essa comissão, embora o banco possa aplicar a sua própria taxa de câmbio e comissões. O MB WAY só funciona em euros. No checkout em euros aparecem:

• MB WAY. Escolhe-se MB WAY, introduz-se o número de telemóvel e confirma-se a compra na aplicação MB WAY, através da notificação ou na área de atividade (Stripe sur MB WAY e MB WAY sur les achats en ligne, consultados a 3 octobre 2026). Segundo a Stripe, são aceites números internacionais, mas a maioria dos clientes usa um número português, começado por +351.
• Cartes (Visa, Mastercard), Apple Pay, Google Pay et Link.

Não aparecem: referências Multibanco (pagamento por entidade e referência), PayPal, débito direto SEPA e Klarna, que só aparece a compradores nos Estados Unidos. A conversão para euros vem do Adaptive Pricing da Stripe, e a lista de meios de pagamento que ele disponibiliza inclui o MB WAY mas não o Multibanco. O MB WAY também permite gerar cartões virtuais MB NET para compras online (MB WAY sur MB NET, consultado a 3 octobre 2026); não está confirmado que o campo do cartão do checkout os aceite, por isso o caminho seguro é escolher MB WAY diretamente.

Ce que Stripe documente au sujet de MB WAY (consulté le 3 octobre 2026) :

• Par paiement : entre 0,50 € et 5000 €.
• Par jour : 1000 € par défaut, ajustable jusqu’à 10 000 € dans l’application MB WAY. Les rechargements plus importants peuvent dépasser la limite quotidienne par défaut ; dans ce cas, augmentez-la dans l’application avant de payer. Comparez le montant en euros affiché par le checkout avec ces limites.
• Paiements récurrents : non pris en charge.
• Le relevé indique le nom de Stripe (Stripe Inc), avec le montant de l’opération.

1. Créer un compte Kunavo.
2. Dans Facturation, choisissez un montant à partir de US$ 10. Les rechargements plus importants ajoutent un solde supplémentaire : quem carrega US$ 100 recebe US$ 110; quem carrega US$ 1000 recebe US$ 1200; quem carrega US$ 5000 recebe US$ 6250.
3. Dans le checkout Stripe, avec le montant en euros, choisissez MB WAY, saisissez le numéro de téléphone et confirmez l’achat dans l’application MB WAY. Le montant en euros s’affiche avant la confirmation.
4. Dans /app/keys, créez la clé et placez-la dans ANTHROPIC_AUTH_TOKEN.

Le solde est prépayé : il n’y a pas d’abonnement mensuel, le solde n’expire pas et les requêtes qui échouent ne sont pas facturées. Le rechargement automatique ne fonctionne qu’avec une carte enregistrée ou Link ; avec MB WAY, le rechargement est toujours manuel, car selon Stripe, MB WAY n’accepte pas les paiements récurrents et ne peut pas être enregistré pour des paiements ultérieurs. Kunavo n’émet pas de factures, ni avec NIF ni avec TVA ; l’historique des rechargements se trouve dans Billing. Ces moyens de paiement ne rechargent que le solde de l’API Kunavo. Pour en savoir plus, consultez Payer Claude avec MB WAY.

Erreurs courantes

Après l'installation

Lors du premier démarrage dans un projet, saisissez /init : Claude Code parcourt le dépôt et écrit un fichier CLAUDE.md contenant ses déductions : comment exécuter le projet, tester les modifications et quelles règles de style il suit. Relisez ce fichier et gardez-le court, car il est chargé à chaque session. Entre deux tâches indépendantes, /clear démarre une nouvelle conversation ; pour une tâche longue, /compact résume l’historique afin de poursuivre.

À savoir

• Il s’agit d’une API facturée au token, et non d’un abonnement Claude Pro ou Max. Les personnes qui utilisent Claude Code plusieurs heures par jour paient généralement moins avec un abonnement ; la facturation au token est avantageuse en cas d’utilisation irrégulière, et un mois sans utilisation ne coûte rien. La comparaison en euros se trouve dans Prix de Claude Code en euros.
• Les personnes qui utilisent une clé API n’ont ni Remote Control ni dictée vocale.
• Kunavo utilise une capacité partagée, sans quota réservé ni garanties contractuelles ; les personnes qui en ont besoin doivent souscrire directement auprès d’Anthropic.
• MB WAY sert uniquement aux rechargements manuels ; le rechargement automatique nécessite une carte ou Link.
• Les montants en euros affichés lors du paiement incluent déjà les frais de conversion de Stripe.

Questions fréquentes