Retour aux guides
Installation·3 octobre 2026·14 min de lecture

Comment installer Claude Code sur Windows, macOS et Linux — clé API sans abonnement et paiement par BLIK

L’installation tient en une commande. Les difficultés commencent ensuite : version de Node.js avec npm, terminal et PATH sous Windows, clé API sans connexion et paiement depuis la Pologne.

Claude Code s’installe avec une seule commande officielle (versions ci-dessous pour macOS et Linux, PowerShell et CMD). Anthropic recommande l’installateur natif, tandis que npm est une solution alternative nécessitant Node.js 22 ou une version ultérieure. Sans abonnement Pro/Max ni connexion, il suffit de définir ANTHROPIC_BASE_URL=https://api.kunavo.com (sans /v1), ANTHROPIC_AUTH_TOKEN avec la clé API et les quatre variables qui verrouillent les modèles. Vous ne payez alors que les tokens utilisés, prélevés sur le solde rechargé par BLIK en zlotys, à partir de 10 USD. Enfin, saisissez /status dans Claude Code pour vérifier que la clé fonctionne.

Terminal
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows – wiersz polecenia (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Polecenia i zmienne sprawdziliśmy 3 octobre 2026 w la documentation officielle d’installation de Claude Code i w la documentation des variables d’environnement. Polskiej wersji tej dokumentacji nie ma. Ceny i metody płatności sprawdziliśmy 3 octobre 2026. Polska jest na la liste des pays pris en charge par Anthropic (sprawdzone 3 octobre 2026), zarówno dla Claude.ai, jak i dla API.

Connexion ou clé API ?

Après l’installation, Claude Code doit s’authentifier. Deux possibilités existent, et ce guide décrit en détail la seconde :

CritèreConnexion avec un compte ClaudeClé API (Kunavo)
Éléments nécessairesForfait Pro, Max, Team, Enterprise ou compte Console. Le forfait gratuit Claude.ai n’inclut pas Claude Code.Clé sk-kn-… et variables d’environnement. Aucun abonnement ni aucune connexion ne sont nécessaires.
Mode de paiementAbonament: Pro kosztuje 20 USD miesięcznie (albo 17 USD miesięcznie przy płatności rocznej, czyli 200 USD z góry), Max od 100 USD miesięcznie. Ceny nie zawierają podatku (tarifs de Claude, sprawdzone 3 octobre 2026).Pour les tokens utilisés, à partir d’un solde prépayé. Rechargement à partir de 10 USD, sans frais mensuels. Le solde n’expire pas.
Modes de paiementSubskrypcje kupowane przez stronę Anthropic można opłacić wyłącznie kartą kredytową lub debetową (FAQ sur la facturation Claude, sprawdzone 3 octobre 2026).BLIK (montant en zlotys), cartes Visa et Mastercard, Apple Pay, Google Pay, Link
Ce qui n’est pas disponibleNon applicableRemote Control et dictée vocale. Kunavo ne délivre pas non plus de factures TVA.

Avant de commencer

ExigenceCe qu’indique la documentation officielle (vérifiée le 3 octobre 2026)
SystèmemacOS 13.0 ou ultérieur ; Windows 10 1809 ou ultérieur, ou Windows Server 2019 ou ultérieur ; Ubuntu 20.04+ ; Debian 10+ ; Alpine Linux 3.19+
MatérielAu moins 4 Go de RAM, processeur x64 ou ARM64 (Windows 32 bits n’est pas pris en charge)
ShellBash, Zsh, PowerShell ou CMD
Réseau et localisationConnexion Internet depuis un pays pris en charge par Anthropic (la Pologne figure dans la liste)
CompteLa connexion nécessite un forfait Pro, Max, Team, Enterprise ou un compte Console. Avec une clé API, aucun abonnement ni aucune connexion ne sont nécessaires.
Node.jsUniquement lors d’une installation avec npm, en version 22 ou ultérieure. L’installateur natif n’en a pas besoin.

Méthode 1 : installateur natif (recommandé)

Dans la documentation officielle, cette méthode possède un onglet « Native Install (Recommended) ». Les commandes se trouvent au début de la page. Sur macOS, Linux et WSL, utilisez la ligne avec install.sh. Dans Windows PowerShell, utilisez irm … | iex, et dans l’invite de commandes CMD, la ligne avec install.cmd. L’installation native se met automatiquement à jour en arrière-plan. Claude Code peut également être installé avec Homebrew ou WinGet, mais selon la documentation, ces installations ne se mettent pas à jour automatiquement par défaut ; vous devez donc les mettre à jour manuellement dans le gestionnaire de paquets :

# Homebrew – kanał stable; domyślnie nie aktualizuje się sam
brew install --cask claude-code

# WinGet (Windows) – domyślnie nie aktualizuje się sam
winget install Anthropic.ClaudeCode

Après l’installation, ouvrez une nouvelle fenêtre de terminal, car une fenêtre ouverte auparavant ne voit pas la variable PATH mise à jour. Vérifiez ensuite :

claude --version   # wypisuje numer wersji, np. 2.1.280 (Claude Code)
claude doctor      # diagnostyka instalacji i ustawień, bez otwierania sesji

claude doctor n’ouvre pas de session. Il affiche uniquement l’état de l’installation et les diagnostics des fichiers de paramètres. Cela permet de distinguer rapidement un problème d’installation d’un problème de configuration.

Lorsque le téléchargement échoue

Jeśli terminal pokazuje syntax error near unexpected token '<' albo curl: (22) The requested URL returned error: 403, to według la page officielle consacrée aux problèmes d’installation (sprawdzone 3 octobre 2026) adres instalatora zwrócił stronę HTML lub kod błędu zamiast skryptu. Strona z napisem App unavailable in region oznacza według dokumentacji, że Claude Code nie jest dostępny w Twoim kraju. Polska jest jednak na liście obsługiwanych krajów, więc jeśli widzisz ten napis w Polsce, sprawdź, czy połączenie nie wychodzi przez VPN albo proxy. Samo 403 bez treści może też pochodzić z firmowego proxy lub zapory, która blokuje pobieranie. Dokumentacja radzi wtedy najpierw sprawdzić połączenie sieciowe, bo inne metody instalacji łączą się z tymi samymi serwerami. Spróbuj z innej sieci albo poproś administratora o odblokowanie tych adresów.

Méthode 2 : npm (Node.js 22 ou ultérieur)

npm nadal jest jedną z metod opisanych w oficjalnej dokumentacji. Pakiet wymaga Node.js 22 lub nowszego. Część polskich poradników wciąż podaje Node.js 18, co jest już nieaktualne. Na starszym Node.js npm wypisze ostrzeżenie EBADENGINE, ale nie przerwie instalacji, a claude będzie działać, bo pakiet pobiera natywny program, który nie korzysta z Node.js w czasie działania. Jeśli nie masz Node.js, zainstaluj wersję 22 lub nowszą ze la page nodejs.org.

Terminal
node -v                                    # potrzebna wersja v22 lub nowsza
npm install -g @anthropic-ai/claude-code   # bez sudo

# aktualizacja: @latest, a nie npm update -g
npm install -g @anthropic-ai/claude-code@latest
  • N’utilisez jamais sudo npm install -g. La documentation avertit que cela entraîne des problèmes d’autorisations et constitue un risque pour la sécurité.
  • Mettez à jour avec @latest. Pour la mise à jour, utilisez npm install -g @anthropic-ai/claude-code@latest, et non npm update -g.
  • N’ignorez pas les dépendances facultatives. Le programme approprié est installé comme dépendance facultative, c’est-à-dire le paquet @anthropic-ai/claude-code-* pour votre plateforme. Avec l’option --omit=optional ou avec optional=false dans .npmrc, l’installation sur macOS ou Linux se termine par le message claude native binary not installed.

Claude Code sous Windows : PowerShell, CMD, WSL et PATH

Windows possède deux commandes d’installation différentes, et le choix dépend uniquement du terminal. Si la ligne commence par PS C:\Users\TwojaNazwa>, vous travaillez dans PowerShell. Si vous voyez uniquement C:\Users\TwojaNazwa>, sans PS, il s’agit de l’invite de commandes (CMD). Selon la documentation, il n’est pas nécessaire d’exécuter le terminal en tant qu’administrateur, même si certains guides le recommandent.

L’erreur la plus fréquente consiste à coller la commande dans le mauvais terminal. Une ligne destinée à CMD collée dans PowerShell produit The token '&&' is not a valid statement separator. Une ligne destinée à PowerShell collée dans CMD produit 'irm' is not recognized as an internal or external command. Dans Windows en polonais, le même message est le suivant : « irm » n’est pas reconnu en tant que commande interne ou externe, programme exécutable ou fichier de commandes. À l’inverse, la ligne curl … | bash de macOS collée dans PowerShell se termine par l’erreur A parameter cannot be found that matches parameter name 'fsSL' ou 'bash' is not recognized as the name of a cmdlet. Dans tous ces cas, il suffit d’utiliser la ligne prévue pour votre terminal.

Dans le menu Démarrer, deux entrées sont disponibles : « Windows PowerShell » et « Windows PowerShell (x86) ». La seconde fonctionne comme un processus 32 bits et se termine donc par l’erreur Claude Code does not support 32-bit Windows même sur un ordinateur 64 bits. Ouvrez l’entrée sans la mention (x86).

Git for Windows jest opcjonalny, ale zalecany. Gdy jest zainstalowany, Claude Code wykonuje polecenia przez dołączony do niego Git Bash, a bez niego przez PowerShell. Jeśli Git jest zainstalowany, ale Claude Code nie znajduje Git Bash, ustaw w bloku env pliku ~/.claude/settings.json zmienną CLAUDE_CODE_GIT_BASH_PATH ze ścieżką do bash.exe. Przykładowa ścieżka z dokumentacji to C:\Program Files\Git\bin\bash.exe.

VarianteÉléments nécessairesBac à sableQuand choisir
Windows en mode natifRien ; Git for Windows facultatifNon pris en chargeLes projets et les outils fonctionnent sous Windows
WSL 2WSL 2 activéPris en chargeVous avez besoin d’outils Linux ou d’une exécution isolée des commandes
WSL 1WSL 1 activéNon pris en chargeLorsque WSL 2 n’est pas disponible

Si vous choisissez WSL, exécutez la ligne pour macOS et Linux dans le terminal WSL et lancez également claude depuis celui-ci, et non depuis PowerShell ou CMD.

Erreur de stratégie d’exécution des scripts (npm dans PowerShell)

Le message npm.ps1 cannot be loaded because running scripts is disabled on this system lors de l’installation ou du lancement avec npm signifie que les stratégies d’exécution de PowerShell bloquent le script de démarrage .ps1 généré par npm. Selon la documentation, vous pouvez autoriser l’utilisateur actuel à exécuter des scripts locaux (commande ci-dessous), utiliser npm.cmd et claude.cmd, ou passer à l’installateur natif pour PowerShell.

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

La commande « claude » n’est pas reconnue après l’installation

command not found: claude ou 'claude' is not recognized signifie que le répertoire d’installation ne figure pas dans PATH. L’installateur natif place le programme dans ~/.local/bin/claude sur macOS et Linux, et dans %USERPROFILE%\.local\bin\claude.exe sur Windows. Commencez par ouvrir un nouveau terminal. Si cela ne fonctionne toujours pas sous Windows, vérifiez et ajoutez le chemin dans PowerShell comme indiqué dans la documentation :

PowerShell
# 1. Sprawdź, czy katalog instalacji jest już w PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Brak wyniku? Dopisz go do PATH użytkownika, zamknij i otwórz terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. W nowym terminalu
claude --version

Clé API au lieu de la connexion (sans abonnement)

ANTHROPIC_BASE_URL est une variable intégrée de Claude Code. Selon la documentation officielle, elle remplace le point de terminaison de l’API afin d’acheminer les requêtes via un proxy ou une passerelle (gateway). La connexion de Claude Code à un service compatible avec l’Anthropic Messages API est donc une configuration prévue par Anthropic. Vous n’avez besoin ni de plug-ins ni d’un programme modifié. Sur macOS et Linux, ajoutez les variables au fichier de configuration du shell (~/.zshrc ou ~/.bashrc) :

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # sama domena, bez /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, vous pouvez d’abord vérifier la configuration dans une fenêtre PowerShell :

PowerShell
# Działa tylko w tym oknie PowerShella – po zamknięciu znika
$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

De manière permanente, il est préférable d’inscrire les variables dans le bloc env du fichier de paramètres utilisateur ~/.claude/settings.json (sous Windows, %USERPROFILE%\.claude\settings.json). Selon la documentation, ce fichier s’applique à tous vos projets. Si le fichier contient déjà d’autres paramètres, ajoutez uniquement le bloc env :

~/.claude/settings.json
{
  "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 six lignes peut facilement comporter une erreur :

  • ANTHROPIC_BASE_URL correspond au domaine seul. Claude Code ajoute automatiquement /v1/messages. Avec /v1 à la fin, la requête sera envoyée vers /v1/v1/messages et renverra une erreur 404.
  • ANTHROPIC_AUTH_TOKEN, et non ANTHROPIC_API_KEY. La valeur ANTHROPIC_AUTH_TOKEN est envoyée dans l’en-tête Authorization avec le préfixe Bearer et fonctionne immédiatement. ANTHROPIC_API_KEY est envoyé dans l’en-tête x-api-key et doit être approuvé une fois en mode interactif. Si vous le refusez alors, la clé sera ignorée silencieusement. Vous pouvez la réactiver dans /config → Use custom API key.
  • ANTHROPIC_MODEL sélectionne le modèle principal. Ici, il s’agit de Claude Sonnet 5 (claude-sonnet-5). Le nom doit être exactement celui qui figure dans la liste des modèles Kunavo. Kunavo ne reconnaît pas les anciens noms se terminant par une date.
  • ANTHROPIC_DEFAULT_OPUS_MODEL et ANTHROPIC_DEFAULT_SONNET_MODEL associent les alias opus et sonnet. Według de la documentation officielle sur la configuration des modèles (sprawdzone 3 octobre 2026) dla użytkowników API model domyślny i alias opus wskazują Opus 5.5, a alias sonnet wskazuje Sonnet 5.5. Aliasy z czasem się zmieniają, a wersję przypina się pełną nazwą modelu albo zmiennymi takimi jak te dwie. Zapytanie o model, którego nie ma w Kunavo, zwraca 404. Alias opus przypinamy do Claude Opus 5.5 (claude-opus-5-5), bo kolejny Opus wydany przez Anthropic nie musi być od razu dostępny w Kunavo. Opus 5.5 wymaga Claude Code w wersji 2.1.280 lub nowszej, starszą wersję zaktualizujesz poleceniem claude update. Sonnet 5.5 nie jest obecnie (stan na 3 octobre 2026) dostępny w Kunavo, więc bez przypięcia aliasu sonnet do claude-sonnet-5 błąd 404 zwracają /model sonnet, faza wykonania w trybie opusplan i subagenci ustawieni na model: sonnet.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL gère également les tâches en arrière-plan. Selon la documentation, cette variable sélectionne le modèle pour l’alias haiku et pour les fonctions exécutées en arrière-plan. Chez Kunavo, Claude Haiku 4.5 coûte 0,70 USD par million de tokens d’entrée et 3,50 USD par million de tokens de sortie. Le modèle principal Claude Sonnet 5 coûte 1,40 USD / 7,00 USD (tarifs Anthropic : 2,00 USD / 10,00 USD), tandis que Claude Opus 5.5 coûte 2,80 USD / 14,00 USD (entrée / sortie, par million de tokens).

Klucza non wpisuj do projektowego .claude/settings.json. Według de la documentation sur la connexion à une passerelle ten plik trafia do repozytorium, a więc do każdego, kto je sklonuje. Pamiętaj też o kolejności pierwszeństwa. Gdy ta sama zmienna jest ustawiona i w powłoce, i w bloku env pliku ustawień, w większości sesji obowiązuje wartość z pliku ustawień. Osobna zasada dotyczy klucza model w pliku ustawień: zmienna ANTHROPIC_MODEL ma przed nim pierwszeństwo, a model działa tylko wtedy, gdy zmiennej nie ma. Jeśli zmiana w powłoce nie działa, najpierw sprawdź plik ustawień. W rozszerzeniu Claude Code dla VS Code zmienne ustawia się w claudeCode.environmentVariables, w ustawieniach użytkownika samego VS Code.

Premier lancement et /status

Selon la documentation sur la connexion à une passerelle (vérifié le 3 octobre 2026), avec ANTHROPIC_AUTH_TOKEN configuré, la commande claude ouvre immédiatement une session sans écran de connexion. La variable prend effet immédiatement et ne doit pas être approuvée, contrairement à ANTHROPIC_API_KEY. Si un écran de connexion s’affiche à la place, Claude Code n’a pas lu la clé.

La clé doit se trouver là où Claude Code la lit avant la première configuration, c’est-à-dire définie avec la commande export dans le shell ou dans le bloc env du fichier utilisateur ~/.claude/settings.json. En mode interactif, le bloc env du .claude/settings.json ou du .claude/settings.local.json du projet ne prend effet qu’après l’assistant du premier lancement et la question concernant la confiance accordée au dossier. Avec la clé uniquement dans les paramètres du projet, vous verrez tout de même un écran de connexion au premier démarrage.

Dans la session, saisissez /status et vérifiez les deux lignes suivantes :

  • Anthropic base URL apparaît uniquement lorsqu’une adresse de passerelle est configurée. Elle doit afficher https://api.kunavo.com. Si cette ligne est absente, ANTHROPIC_BASE_URL n’est pas parvenu jusqu’à la session.
  • Auth token avec le nom ANTHROPIC_AUTH_TOKEN signifie qu’une clé API est utilisée, et non une connexion enregistrée à claude.ai. Si vous voyez Login method avec un compte claude.ai, la variable n’a pas fonctionné.

Vous pouvez également vérifier l’adresse et la clé avant de lancer Claude Code, avec la méthode de la documentation officielle. Elle consiste à envoyer une requête demandant 1 token de sortie, ce qui prélèvera un montant symbolique sur le solde. La commande lit les variables du shell actuel ; même si la clé se trouve dans le fichier de paramètres, définissez donc d’abord les variables avec la commande export dans ce terminal. Une réponse JSON commençant par {"id":"msg_ signifie que l’adresse et la clé fonctionnent. Le code 401 signifie que la clé a été refusée.

Terminal
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": "."}]}'

Dans PowerShell, la même vérification se présente ainsi. Si tout fonctionne, la réponse contient le champ id commençant par msg_ :

PowerShell
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": "."}]}'

Ce qui fonctionne différemment avec une clé API

  • Remote Control et la dictée vocale ne sont pas disponibles. Selon la documentation, ils nécessitent une identité claude.ai et ne fonctionnent pas lorsque ANTHROPIC_AUTH_TOKEN est actif. Depuis la version 2.1.196, Remote Control est également désactivé lorsque ANTHROPIC_BASE_URL pointe vers un hôte différent de api.anthropic.com.
  • /fast affiche le mode rapide comme désactivé. Selon la documentation, lorsqu’il n’y a qu’un token bearer, Claude Code considère le mode rapide comme désactivé et n’envoie pas de requête pour vérifier sa disponibilité.
  • La recherche d’outils MCP est désactivée par défaut. Cela se produit lorsque ANTHROPIC_BASE_URL pointe vers un hôte différent de celui d’Anthropic.
  • Les chiffres de /context sont des estimations. Kunavo nie udostępnia endpointu /v1/messages/count_tokens. Według de la documentation sur la compatibilité des passerelles (sprawdzone 3 octobre 2026) Claude Code liczy wtedy tokeny lokalnie na podstawie liczby znaków.

Vous trouverez la description complète de l’intégration dans la documentation de l’intégration de Claude Code (en anglais), et la version anglaise de ce guide dans l’article Install Claude Code.

Paiement par BLIK : rechargement du solde et clé API

Subskrypcje Claude kupowane przez stronę Anthropic można opłacić wyłącznie kartą kredytową lub debetową (FAQ sur la facturation Claude, sprawdzone 3 octobre 2026). BLIK-iem nie zapłacisz za Pro ani za Max. W Kunavo BLIK doładowuje przedpłacone saldo API, z którego Claude Code płaci za tokeny po ustawieniu klucza tak jak wyżej. Wszystkie kroki płatności opisuje poradnik comment payer Claude avec BLIK, a w skrócie wygląda to tak:

  1. Créez un compte Kunavo avec une adresse e-mail ou un compte Google. Vous n’avez pas besoin de fournir de carte lors de l’inscription.
  2. Dans l’onglet Facturation (Billing), choisissez le montant à créditer. Le minimum est de 10 USD et il n’y a pas de frais mensuels. Pour les montants plus élevés, vous recevez un bonus : 100 USD → 110 USD na saldzie, 1000 USD → 1200 USD na saldzie, 5000 USD → 6250 USD na saldzie.
  3. Na stronie płatności Stripe kwota jest pokazana w złotych. Wybierz BLIK, wygeneruj w aplikacji bankowej sześciocyfrowy kod, wpisz go i potwierdź płatność w aplikacji. Według la documentation Stripe (sprawdzone 3 octobre 2026) kod BLIK jest ważny 2 minuty, a po rozpoczęciu płatności masz 60 sekund na jej zatwierdzenie.
  4. Dans l’onglet Clés API, créez une clé commençant par sk-kn-. La clé ne s’affiche qu’une seule fois ; enregistrez-la donc immédiatement et saisissez-la dans ANTHROPIC_AUTH_TOKEN.

Na stronie płatności w złotych oprócz BLIK-a są też karty (Visa, Mastercard), Apple Pay i Google Pay na obsługiwanych urządzeniach oraz Link. Nie ma natomiast Przelewy24, PayU, PayPal ani zwykłego przelewu bankowego. Ceny są ustalone w dolarach, a Stripe przelicza je na złote. Według de la documentation Stripe sur Adaptive Pricing (sprawdzone 3 octobre 2026) kurs zawiera opłatę za przewalutowanie w wysokości 2–4%, którą ponosi kupujący. Płacąc kartą w dolarach, unikniesz tej opłaty, choć wtedy obowiązują kurs i opłaty Twojego banku, a BLIK działa tylko w złotych. Dokładną kwotę w złotych zobaczysz na stronie płatności przed potwierdzeniem.

BLIK fonctionne uniquement pour les rechargements manuels. Le rechargement automatique nécessite une carte enregistrée ou Link. Le solde n’expire pas et les requêtes échouées ne sont pas facturées. Kunavo n’émet pas de factures de TVA ; l’historique des rechargements se trouve dans l’onglet Facturation (Billing). N’oubliez pas qu’il s’agit d’un rechargement du solde de l’API Kunavo, et non du paiement d’un abonnement Claude Pro ou Max.

Combien cela coûte (exemple de calcul)

Avec Claude Code, vous payez les tokens. À chaque requête, Claude Code renvoie l’intégralité du contexte de la conversation, mais le début répété du contexte peut être facturé au tarif de lecture du cache. Voici un exemple de calcul fondé sur les tokens. Il ne s’agit ni d’une mesure ni d’une limite supérieure des coûts. Toutes les hypothèses sont indiquées :

  • chaque requête contient 40 000 tokens d’entrée, dont 36 000 (90 %) sont facturés comme lecture du cache, et les 4000 restants comme écriture dans le cache ;
  • chaque requête renvoie 1000 tokens de sortie ;
  • une session de travail comprend 50 requêtes de ce type, sans appels Claude Haiku 4.5 en arrière-plan ;
  • chez Kunavo, la lecture du cache coûte 10% du tarif d’entrée, et l’écriture dans le cache 1,25× le tarif d’entrée. Ces proportions concernent Claude Sonnet 5 ; chaque modèle du tableau est calculé selon ses propres proportions.
ModèleUne seule requête50 requêtes50 requêtes sans aucun accès au cache
Claude Sonnet 50,019 USD0,95 USD3,15 USD
Claude Opus 5.50,033 USD1,65 USD6,30 USD

Le coût réel dépend de la longueur du contexte, du nombre d’accès au cache, de la longueur de la réponse et du fait que vous effaciez ou non la conversation entre les tâches avec la commande /clear. Les tarifs de tous les modèles figurent dans le tarif. Vous pouvez estimer votre propre consommation avec le calculateur de coût des tokens Claude (en anglais). Le guide combien coûte Claude Code explique quand un abonnement est plus avantageux et quand l’API l’est.

Erreurs fréquentes

MessageCause et solution
The token '&&' is not a valid statement separatorLa ligne destinée à CMD a été collée dans PowerShell. Utilisez irm … | iex.
'irm' is not recognized as an internal or external commandLa ligne destinée à PowerShell a été collée dans CMD. Utilisez la ligne contenant install.cmd.
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdletLa commande pour macOS et Linux a été exécutée sous Windows. Utilisez la ligne destinée à PowerShell.
syntax error near unexpected token '<', 403L’adresse de l’installateur a renvoyé une page HTML ou un code d’erreur. Vérifiez le VPN, le proxy et le pare-feu. Les autres méthodes d’installation se connectent aux mêmes serveurs et ne contourneront donc pas ce problème à elles seules.
command not found: claude, 'claude' is not recognizedLe répertoire d’installation ne figure pas dans PATH. Ouvrez un nouveau terminal et, sous Windows, ajoutez le chemin avec les commandes PowerShell indiquées plus haut.
Avertissement EBADENGINENode.js est antérieur à la version 22. L’installation se termine malgré tout, mais il est recommandé de mettre Node.js à jour.
claude native binary not installed (macOS, Linux)npm a ignoré les dépendances facultatives (--omit=optional ou optional=false) ou les scripts d’installation (--ignore-scripts). Supprimez ces paramètres et réinstallez.
npm.ps1 cannot be loadedLes stratégies d’exécution de PowerShell bloquent le script npm. Exécutez la commande Set-ExecutionPolicy ou utilisez l’installateur natif.
Claude Code does not support 32-bit WindowsPowerShell (x86) est en cours d’exécution. Ouvrez « Windows PowerShell » standard.
Écran de connexion malgré la configuration d’une cléClaude Code n’a pas lu la clé. Saisissez les variables dans le shell ou dans ~/.claude/settings.json, et pas uniquement dans les paramètres du projet, puis ouvrez un nouveau terminal.
401La clé a été refusée. Vérifiez que la clé sk-kn- a été copiée intégralement et sans espaces, qu’elle n’a pas été supprimée dans /app/keys et qu’elle figure dans ANTHROPIC_AUTH_TOKEN.
404ANTHROPIC_BASE_URL se termine par /v1 ou le modèle ne figure pas dans la liste Kunavo, par exemple parce que les quatre variables associant les modèles n’ont pas été configurées.

Limitations

  • Kunavo n’émet pas de factures de TVA.
  • BLIK fonctionne uniquement pour les rechargements manuels. Le rechargement automatique nécessite une carte enregistrée ou Link.
  • Il s’agit d’une API facturée au token, et non d’un abonnement Claude Pro ou Max. Avec une clé API, Remote Control et la dictée vocale ne fonctionnent pas, le mode /fast est désactivé et la recherche d’outils MCP est désactivée par défaut.
  • Actuellement, Kunavo (état au 3 octobre 2026) ne propose pas Sonnet 5.5 ; la configuration ci-dessus associe donc l’alias sonnet à claude-sonnet-5. Sans modèles associés, les alias par défaut peuvent renvoyer une erreur 404. Claude Opus 5.5, associé à l’alias opus, nécessite Claude Code version 2.1.280 ou ultérieure.
  • La documentation officielle de Claude Code et la documentation de l’intégration Kunavo sont uniquement disponibles en anglais.

Questions fréquentes

Comment installer Claude Code ?

Le plus simple est d’utiliser l’installateur natif, qu’Anthropic indique comme recommandé dans sa documentation. Sur macOS, Linux et WSL, exécutez curl -fsSL https://claude.ai/install.sh | bash. Sous Windows, dans PowerShell, exécutez irm https://claude.ai/install.ps1 | iex ; dans l’invite de commandes (CMD), exécutez curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Ouvrez ensuite une nouvelle fenêtre de terminal et vérifiez l’installation avec la commande claude --version. L’installation native se met automatiquement à jour en arrière-plan.

Claude Code avec npm : quelle version de Node.js est nécessaire ?

Selon la documentation officielle d’installation (vérifiée le 3 octobre 2026), le paquet npm nécessite Node.js 22 ou une version ultérieure, et non 18 comme l’indiquent les anciens guides. Avec une version plus ancienne de Node.js, npm affiche seulement un avertissement EBADENGINE et l’installation réussit malgré tout, car le paquet télécharge un programme natif qui n’utilise pas Node.js lors de son exécution. Installez-le avec npm install -g @anthropic-ai/claude-code sans sudo, et mettez-le à jour avec npm install -g @anthropic-ai/claude-code@latest, et non avec npm update -g.

Comment installer Claude Code sous Windows ? Ai-je besoin de WSL et de Git ?

Ni WSL ni Git ne sont requis. Exécutez la commande d’installation pour PowerShell ou CMD, sans droits d’administrateur. Git for Windows est facultatif, mais recommandé : lorsqu’il est installé, Claude Code exécute les commandes via Git Bash ; sinon, via PowerShell. Choisissez WSL 2 si vous avez besoin d’outils Linux ou d’une exécution isolée des commandes (sandbox), puis installez et exécutez claude dans le terminal WSL. N’ouvrez pas « Windows PowerShell (x86) » : il s’agit d’un processus 32 bits, et Claude Code ne prend pas en charge Windows 32 bits.

Puis-je utiliser Claude Code sans abonnement Pro/Max et sans connexion ?

Oui. La connexion avec un compte Claude nécessite un forfait Pro, Max, Team, Enterprise ou un compte Console, et le forfait gratuit Claude.ai n’inclut pas Claude Code. Au lieu de vous connecter, vous pouvez définir les variables ANTHROPIC_BASE_URL=https://api.kunavo.com et ANTHROPIC_AUTH_TOKEN avec une clé API. Claude Code démarre alors sans écran de connexion et décompte les tokens utilisés du solde prépayé Kunavo, sans abonnement. Dans ce mode, Remote Control et la dictée vocale ne fonctionnent pas, car ils nécessitent une identité claude.ai.

Où saisir la clé API pour Claude Code et ANTHROPIC_BASE_URL doit-elle se terminer par /v1 ?

Sans /v1. Claude Code ajoute lui-même /v1/messages ; une adresse se terminant par /v1 dirige donc les requêtes vers /v1/v1/messages et aboutit à une erreur 404. Saisissez les variables dans le fichier de configuration du shell (~/.zshrc, ~/.bashrc ou $PROFILE dans PowerShell) ou dans le bloc env du fichier utilisateur ~/.claude/settings.json (sous Windows %USERPROFILE%\.claude\settings.json). Ne saisissez jamais la clé dans le fichier projet .claude/settings.json, car ce fichier est placé dans le dépôt. Lorsque la même variable est définie à la fois dans le shell et dans le fichier de paramètres, la valeur du fichier de paramètres est utilisée dans la plupart des sessions.

Pourquoi définir ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL et ANTHROPIC_DEFAULT_SONNET_MODEL ?

Sans ces variables, Claude Code utilise des alias qui évoluent avec les nouveaux modèles Anthropic. Selon la documentation officielle de configuration des modèles (vérifiée le 3 octobre 2026), pour les utilisateurs de l’API, le modèle par défaut et l’alias opus pointent vers Opus 5.5, tandis que l’alias sonnet pointe vers Sonnet 5.5. Actuellement, Kunavo (à la date du 3 octobre 2026) ne propose pas Sonnet 5.5 ; sans verrouiller l’alias sonnet, /model sonnet, la phase d’exécution du mode opusplan et les sous-agents configurés avec model: sonnet renvoient une erreur 404. Le nouvel Opus peut également ne pas être disponible immédiatement dans Kunavo. Après verrouillage, le modèle principal est claude-sonnet-5, l’alias opus est claude-opus-5-5 (Opus 5.5 nécessite Claude Code version 2.1.280 ou ultérieure ; mettez une version plus ancienne à jour avec claude update), l’alias sonnet est claude-sonnet-5, et l’alias haiku ainsi que les tâches en arrière-plan utilisent claude-haiku-4-5 ; vous savez donc quel modèle répond et selon quel tarif vous payez.

Comment vérifier que Claude Code utilise la clé API et non le compte claude.ai ?

Dans une session Claude Code, saisissez /status. La ligne « Anthropic base URL » doit afficher https://api.kunavo.com, et la ligne « Auth token » doit indiquer ANTHROPIC_AUTH_TOKEN. Si vous voyez à la place « Login method » avec un compte claude.ai, les variables n’ont pas été lues. Fermez la session, ouvrez un nouveau terminal et vérifiez où elles ont été saisies.

Puis-je payer avec BLIK ? Et le rechargement automatique et la facture TVA ?

Oui, vous pouvez recharger le solde API Kunavo avec BLIK. La page de paiement Stripe affiche le montant en zlotys ; en plus de BLIK, elle accepte les cartes Visa et Mastercard, Apple Pay, Google Pay et Link. Le rechargement minimal est de 10 USD, sans frais mensuels, et le solde n’expire pas. Le taux de change Stripe comprend des frais de conversion de 2 à 4 %. BLIK ne fonctionne que pour un rechargement manuel, car le rechargement automatique nécessite une carte enregistrée ou Link. Kunavo ne délivre pas de factures TVA. Il ne s’agit pas d’un paiement pour Claude Pro ou Max : les abonnements achetés sur le site Anthropic peuvent être réglés uniquement par carte.