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.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows – wiersz polecenia (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdPolecenia 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ère | Connexion avec un compte Claude | Clé API (Kunavo) |
|---|---|---|
| Éléments nécessaires | Forfait 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 paiement | Abonament: 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 paiement | Subskrypcje 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 disponible | Non applicable | Remote Control et dictée vocale. Kunavo ne délivre pas non plus de factures TVA. |
Avant de commencer
| Exigence | Ce qu’indique la documentation officielle (vérifiée le 3 octobre 2026) |
|---|---|
| Système | macOS 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ériel | Au moins 4 Go de RAM, processeur x64 ou ARM64 (Windows 32 bits n’est pas pris en charge) |
| Shell | Bash, Zsh, PowerShell ou CMD |
| Réseau et localisation | Connexion Internet depuis un pays pris en charge par Anthropic (la Pologne figure dans la liste) |
| Compte | La 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.js | Uniquement 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.ClaudeCodeAprè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 sesjiclaude 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.
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, utiliseznpm install -g @anthropic-ai/claude-code@latest, et nonnpm 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=optionalou avecoptional=falsedans.npmrc, l’installation sur macOS ou Linux se termine par le messageclaude 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écessaires | Bac à sable | Quand choisir |
|---|---|---|---|
| Windows en mode natif | Rien ; Git for Windows facultatif | Non pris en charge | Les projets et les outils fonctionnent sous Windows |
| WSL 2 | WSL 2 activé | Pris en charge | Vous avez besoin d’outils Linux ou d’une exécution isolée des commandes |
| WSL 1 | WSL 1 activé | Non pris en charge | Lorsque 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.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserLa 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 :
# 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 --versionClé 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) :
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-5Sous Windows, vous pouvez d’abord vérifier la configuration dans une fenêtre 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"
claudeDe 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 :
{
"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_URLcorrespond au domaine seul. Claude Code ajoute automatiquement/v1/messages. Avec/v1à la fin, la requête sera envoyée vers/v1/v1/messageset renverra une erreur 404.ANTHROPIC_AUTH_TOKEN, et nonANTHROPIC_API_KEY. La valeurANTHROPIC_AUTH_TOKENest envoyée dans l’en-têteAuthorizationavec le préfixeBeareret fonctionne immédiatement.ANTHROPIC_API_KEYest envoyé dans l’en-têtex-api-keyet 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_MODELsé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_MODELetANTHROPIC_DEFAULT_SONNET_MODELassocient les aliasopusetsonnet. 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 aliasopuswskazują Opus 5.5, a aliassonnetwskazuje 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. Aliasopusprzypinamy 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 poleceniemclaude update. Sonnet 5.5 nie jest obecnie (stan na 3 octobre 2026) dostępny w Kunavo, więc bez przypięcia aliasusonnetdoclaude-sonnet-5błąd 404 zwracają/model sonnet, faza wykonania w trybieopusplani subagenci ustawieni namodel: sonnet.ANTHROPIC_DEFAULT_HAIKU_MODELgère également les tâches en arrière-plan. Selon la documentation, cette variable sélectionne le modèle pour l’aliashaikuet 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 URLapparaît uniquement lorsqu’une adresse de passerelle est configurée. Elle doit afficherhttps://api.kunavo.com. Si cette ligne est absente,ANTHROPIC_BASE_URLn’est pas parvenu jusqu’à la session.Auth tokenavec le nomANTHROPIC_AUTH_TOKENsignifie qu’une clé API est utilisée, et non une connexion enregistrée à claude.ai. Si vous voyezLogin methodavec 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.
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_ :
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_TOKENest actif. Depuis la version 2.1.196, Remote Control est également désactivé lorsqueANTHROPIC_BASE_URLpointe vers un hôte différent deapi.anthropic.com. /fastaffiche 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_URLpointe vers un hôte différent de celui d’Anthropic. - Les chiffres de
/contextsont 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:
- 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.
- 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.
- 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.
- 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 dansANTHROPIC_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èle | Une seule requête | 50 requêtes | 50 requêtes sans aucun accès au cache |
|---|---|---|---|
| Claude Sonnet 5 | 0,019 USD | 0,95 USD | 3,15 USD |
| Claude Opus 5.5 | 0,033 USD | 1,65 USD | 6,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
| Message | Cause et solution |
|---|---|
The token '&&' is not a valid statement separator | La ligne destinée à CMD a été collée dans PowerShell. Utilisez irm … | iex. |
'irm' is not recognized as an internal or external command | La 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 cmdlet | La commande pour macOS et Linux a été exécutée sous Windows. Utilisez la ligne destinée à PowerShell. |
syntax error near unexpected token '<', 403 | L’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 recognized | Le 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 EBADENGINE | Node.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 loaded | Les 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 Windows | PowerShell (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. |
401 | La 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. |
404 | ANTHROPIC_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
/fastest 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’aliasopus, 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.