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

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

Claude Code s’installe avec une commande. Les blocages surviennent généralement ensuite : mauvaise fenêtre Windows, PATH ou version de Node.js avec npm. S’ajoutent la clé API sans abonnement et la question du paiement sans PayPal ni SEPA.

En bref : vous installez Claude Code avec une seule ligne dans le terminal, sans Node.js ni droits administrateur. La ligne dépend uniquement de la fenêtre : curl -fsSL https://claude.ai/install.sh | bash sous macOS, Linux et WSL, irm https://claude.ai/install.ps1 | iex dans Windows PowerShell, et la troisième ligne ci-dessous dans l’invite de commandes (CMD). Si vous n’avez pas d’abonnement Claude, connectez ensuite Claude Code à Kunavo avec une clé API : ANTHROPIC_BASE_URL=https://api.kunavo.com (sans /v1), ANTHROPIC_AUTH_TOKEN et quatre variables de modèle. /status indique si cela fonctionne. Le paiement se fait par token à partir d’un solde commençant à $10, rechargeable par carte de débit ou de crédit (y compris Visa Debit et Debit Mastercard), Apple Pay, Google Pay, Link ou, en Autriche, EPS. PayPal et le prélèvement SEPA ne sont pas disponibles.

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-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Anthropic pflegt die Claude-Code-Dokumentation vollständig auf Deutsch, deshalb verweist diese Anleitung auf die deutschen Seiten. Die Befehle oben sind am 3 octobre 2026 mit Configurer Claude Code abgeglichen, die Variablen mit der Liste der Variables d’environnement. Kunavos Preise und Zahlungswege sind auf dem Stand vom 3 octobre 2026. Deutschland, Österreich und die Schweiz stehen in Anthropics Liste des pays sowohl für Claude.ai als auch für die API (Stand 3 octobre 2026). Eine englische Fassung gibt es unter Installer Claude Code.

Vue d’ensemble du processus

  1. Installer : exécutez la ligne appropriée ci-dessus, puis ouvrez une nouvelle fenêtre de terminal.
  2. Vérifier : claude --version affiche un numéro de version.
  3. Décider : vous connecter avec un abonnement Claude ou utiliser une clé API (comparaison ci-dessous).
  4. Avec une clé API : recharger le solde, créer la clé et définir six variables d’environnement.
  5. Contrôler : saisissez /status dans la session.

Prérequis : ce qui s’applique aujourd’hui

Manche deutschsprachigen Anleitungen beschreiben einen älteren Stand von Claude Code. Die Tabelle stellt verbreitete Angaben neben das, was die page officielle de configuration am 3 octobre 2026 verlangt.

SujetCe qu’on lit encore souventSelon Anthropic
macOSmacOS 10.15 ou version ultérieuremacOS 13.0 ou version ultérieure
Windowsuniquement via WSLnativement sous Windows 10 à partir de la version 1809 ou sous Windows Server 2019 ; WSL est une option, pas une obligation
DroitsLancer PowerShell en tant qu’administrateurpas nécessaire
Node.jsNode.js 18 ou version ultérieureuniquement pour l’installation npm, puis version 22 ou ultérieure
npmobsolètetoujours une méthode documentée ; l’installateur natif est recommandé
Linux—Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+
Ordinateur et shell—au moins 4 Go de RAM, x64 ou ARM64, pas de Windows 32 bits ; Bash, Zsh, PowerShell ou CMD
Emplacement—un pays pris en charge par Anthropic ; l’Allemagne, l’Autriche et la Suisse en font partie
Compte—pour se connecter : Pro, Max, Team, Enterprise ou Console ; avec une clé API, ni abonnement ni connexion

Installer sous macOS, Linux et WSL

Dans le terminal, saisissez la ligne contenant install.sh. Dans la documentation officielle, cette méthode figure sous l’onglet « Native Installation (Recommended) ». Le script place le lanceur dans ~/.local/bin/claude, puis l’installation se met automatiquement à jour en arrière-plan. Sous WSL, utilisez la même ligne dans le terminal WSL.

Installer Claude Code sous Windows

Unter Windows entscheidet das offene Fenster, welche Zeile funktioniert, und ein Blick auf die Eingabezeile genügt: PS C:\Users\Name> ist PowerShell, C:\Users\Name> ohne PS ist die Eingabeaufforderung (CMD). Administratorrechte brauchen Sie laut Page de configuration für keine der beiden Varianten. Der Installer legt claude.exe unter %USERPROFILE%\.local\bin ab.

Si vous confondez les fenêtres, vous obtenez un message en anglais, ou parfois en allemand sur un Windows germanophone. La ligne CMD dans PowerShell se termine par The token '&&' is not a valid statement separator, et la ligne PowerShell dans CMD par 'irm' is not recognized as an internal or external command. Dans les deux cas, cela signifie la même chose : mauvaise fenêtre, utilisez donc l’autre ligne.

Lassen Sie im Startmenü den Eintrag „Windows PowerShell (x86)“ links liegen. Laut Dépannage startet er einen 32-Bit-Prozess, und der Installer bricht dann auch auf einem 64-Bit-PC mit Claude Code does not support 32-bit Windows ab. Gibt [Environment]::Is64BitOperatingSystem in diesem Fenster True aus, ist Ihr Windows in Ordnung, und Sie öffnen einfach „Windows PowerShell“ ohne den Zusatz.

Git pour Windows müssen Sie nicht installieren. Ist es vorhanden, führt Claude Code Shell-Befehle in der Git Bash aus, sonst in PowerShell. Findet Claude Code eine installierte Git Bash nicht, tragen Sie den Pfad zur bash.exe als CLAUDE_CODE_GIT_BASH_PATH in den env-Block von ~/.claude/settings.json ein, bei einer Standardinstallation C:\Program Files\Git\bin\bash.exe.

Le choix entre une installation native et WSL dépend de l’emplacement de vos projets :

VariantePrérequisMise en bac à sableConvient lorsque
Windows natifaucun ; Git pour Windows est facultatifnonvos projets et outils s’exécutent directement sous Windows
WSL 2WSL 2 activéouivous avez besoin d’outils Linux ou souhaitez exécuter des commandes dans un bac à sable
WSL 1WSL 1 activénonWSL 2 n’est pas disponible sur l’ordinateur

Avec WSL, installez et démarrez claude dans le terminal WSL, pas dans PowerShell ou CMD.

Alternatives : Homebrew, WinGet et npm

Si vous préférez gérer les logiciels via un gestionnaire de paquets, c’est possible, avec une réserve : selon la documentation, les installations Homebrew et WinGet ne se mettent pas à jour automatiquement ; vous devez donc exécuter régulièrement upgrade. Homebrew propose deux Casks. claude-code suit le canal stable, qui a environ une semaine de retard et ignore les versions comportant de grandes régressions ; claude-code@latest reçoit chaque version immédiatement.

# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code              # aktualisiert sich nicht von selbst

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # aktualisiert sich nicht von selbst

Via npm

npm reste une méthode officiellement documentée. Le prérequis est Node.js 22 ou version ultérieure. Le paquet npm télécharge le même binaire natif que l’installateur et n’a pas besoin de Node.js à l’exécution. C’est pourquoi l’installation ne s’interrompt pas avec une version plus ancienne de Node.js : npm affiche seulement EBADENGINE. Si Node.js n’est pas encore installé, l’installateur natif est la solution la plus courte.

Terminal
node -v                                    # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code   # niemals mit sudo

# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latest

Drei Regeln aus der Page de configuration: aucun sudo npm install -g, weil das Rechteprobleme und Sicherheitsrisiken schafft. Aktualisieren mit @latest, denn npm update -g bleibt im ursprünglichen Versionsbereich hängen. Und optionale Abhängigkeiten nicht abschalten: Die Binärdatei kommt als plattformspezifische optionale Abhängigkeit, mit --omit=optional oder optional=false in der .npmrc fehlt sie, und claude meldet unter macOS und Linux Error: claude native binary not installed.

Vérifier l’installation

Pour cela, ouvrez une nouvelle fenêtre de terminal. Une fenêtre déjà ouverte avant l’installation ne connaît pas encore le PATH étendu et ne trouve donc pas claude.

claude --version   # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor      # Diagnose von Installation und Einstellungen, startet keine Sitzung

claude doctor est l’outil à utiliser en cas de problème. Il ne démarre pas de session, mais répertorie l’état de l’installation, les erreurs dans les fichiers de paramètres et les avertissements accompagnés de suggestions de résolution. Vous pouvez ainsi déterminer si le problème vient de l’installation ou de la configuration.

En cas de problème lors de l’installation

Le téléchargement renvoie du HTML ou un 403

Beginnt die Ausgabe mit syntax error near unexpected token '<' oder meldet curl einen 403, kam laut Dépannage (Stand 3 octobre 2026) statt des Skripts eine Webseite oder ein Fehlerstatus zurück. Steht auf dieser Seite App unavailable in region, hält Anthropic die Verbindung für eine aus einem nicht unterstützten Land. Aus Deutschland, Österreich oder der Schweiz spricht das für einen VPN- oder Proxy-Ausgang im Ausland. Ein 403 ohne Text kann dieselbe Ursache haben oder von einer Firmen-Firewall kommen. Die Dokumentation rät, zuerst die Netzwerkverbindung zu prüfen, weil die anderen Installationswege dieselben Server ansprechen. Ein anderes Netz oder eine Freigabe durch die IT hilft hier mehr als ein anderer Installer.

«claude» introuvable

command not found: claude sous macOS et Linux ou claude non reconnu sous Windows signifie que le dossier d’installation ne figure pas dans le PATH. La plupart du temps, il suffit d’ouvrir une nouvelle fenêtre. Si cela ne suffit pas sous macOS ou Linux, ajoutez ~/.local/bin à ~/.zshrc ou ~/.bashrc. Sous Windows, vérifiez et ajoutez le dossier comme indiqué dans le dépannage :

PowerShell
# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Im neuen Fenster
claude --version

PowerShell bloque npm.ps1

Cela concerne uniquement la variante npm. Le message npm.ps1 cannot be loaded because running scripts is disabled on this system signifie que la stratégie d’exécution bloque le script de démarrage de npm. Vous pouvez appeler npm.cmd et claude.cmd, qui ne sont pas concernés par cette stratégie, passer à l’installateur natif ou autoriser les scripts locaux pour votre compte utilisateur :

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Abonnement ou clé API ?

Beim ersten Start will Claude Code wissen, wer bezahlt. Entweder melden Sie sich mit einem Claude-Konto an, oder Sie geben per Umgebungsvariable einen API-Key mit. Ist ein Key gesetzt, hat er laut Guide de la passerelle Vorrang: Ein gespeicherter Login bleibt ungenutzt liegen und greift wieder, sobald Sie die Variable entfernen. Neu installieren müssen Sie für den Wechsel nichts.

Abonnement ClaudeClé API Kunavo
Facturationmonatlich: Pro $20 oder $17 pro Monat bei jährlicher Zahlung ($200 im Voraus), Max ab $100, jeweils ohne etwaige Steuern (claude.com/de/pricing, Stand 3 octobre 2026)par token à partir d’un crédit prépayé, recharge à partir de $10, sans frais mensuels ni expiration
Convient àune utilisation quotidienne de plusieurs heuresune utilisation variable ; un mois sans utilisation ne coûte rien
Paiementim Web nur Kredit- oder Debitkarte, in den iOS- und Android-Apps über App Store bzw. Google Play (FAQ de facturation d’Anthropic, Stand 3 octobre 2026)Carte de débit et carte de crédit (Visa, Mastercard), Apple Pay, Google Pay, Link ; EPS en Autriche
ConfigurationLancer claude et se connecter dans le navigateursix variables d’environnement, aucune connexion
Non inclus—Remote Control et dictée vocale

Le guide des tarifs de Claude Code indique à partir de quel niveau Pro ou Max devient plus avantageux que la clé.

Configurer une clé API (sans abonnement)

Dass Claude Code einen anderen Endpunkt anspricht, ist kein Trick. ANTHROPIC_BASE_URL steht in Anthropics Liste des variables und ist genau dafür da, Anfragen über einen Proxy oder ein Gateway zu leiten. Ein Plugin oder eine veränderte Claude-Code-Version brauchen Sie nicht.

  1. Créer un compte chez Kunavo, avec une adresse e-mail ou un compte Google.
  2. Dans Billing, rechargez votre crédit d’au moins $10 (les moyens de paiement sont indiqués dans la section consacrée au paiement).
  3. Dans API-Keys, créez une clé. Elle commence par sk-kn- et n’est visible qu’une seule fois : copiez-la donc immédiatement.
  4. Définissez les variables comme indiqué ci-dessous.

Définies dans ~/.zshrc ou ~/.bashrc, les valeurs s’appliquent à chaque nouveau terminal sous macOS, Linux et WSL :

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # nur die Domain, ohne /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

Dans PowerShell, les affectations $env: ne s’appliquent qu’à la fenêtre ouverte ; c’est pratique pour un premier essai :

PowerShell
# Gilt nur für dieses PowerShell-Fenster
$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

Auf Dauer gehören die Werte in den env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Diese Datei gilt laut Guide de la passerelle (Stand 3 octobre 2026) für alle Ihre Projekte. Gibt es sie schon, ergänzen Sie nur den env-Block:

~/.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"
  }
}

L’extension VS Code lit les variables depuis claudeCode.environmentVariables dans les paramètres utilisateur de VS Code (commande Preferences: Open User Settings (JSON)) :

VS Code settings.json
{
  "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" }
  ]
}

Rôle de chaque variable

VariableValeurEffetSi elle est absente ou incorrecte
ANTHROPIC_BASE_URLhttps://api.kunavo.comredirige toutes les requêtes vers Kunavo ; Claude Code ajoute lui-même /v1/messagesAvec /v1 à la fin, la requête est envoyée vers /v1/v1/messages et échoue avec une erreur 404.
ANTHROPIC_AUTH_TOKENVotre clé (sk-kn-…)est envoyée comme Authorization: Bearer et est immédiatement prioritaireToute personne qui définit plutôt ANTHROPIC_API_KEY (en-tête x-api-key) doit confirmer la clé une fois en mode interactif. En cas de refus, Claude Code ignore la clé sans la redemander ; vous pouvez la réactiver dans /config → Use custom API key. Kunavo accepte la clé dans les deux en-têtes.
ANTHROPIC_MODELclaude-sonnet-5Modèle de démarrage de chaque sessionSans elle, la session démarre avec le modèle de l’alias Opus, c’est-à-dire Opus 5.5 ; s’il est également absent, elle utilise le modèle par défaut d’Anthropic, actuellement Opus 5.5 lui aussi.
ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-5-5Cible de /model opus et version utilisée par défaut sans ANTHROPIC_MODELSans elle, l’alias suit la configuration d’Anthropic, actuellement Opus 5.5 lui aussi ; dès qu’un Opus plus récent paraît, il peut pointer vers un modèle que Kunavo ne propose pas encore. Opus 5.5 nécessite Claude Code à partir de la version 2.1.280 ; les versions antérieures sont mises à jour par claude update.
ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-5Cible de /model sonnet, phase d’exécution de opusplan et sous-agents avec model: sonnetSans elle, l’alias des utilisateurs de l’API pointe vers Sonnet 5.5, que Kunavo ne propose actuellement pas (au 3 octobre 2026) : 404.
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5Cible de /model haiku et modèle des fonctions en arrière-planSans elle, l’alias d’Anthropic détermine quel modèle Haiku est exécuté.

Warum ein festes Startmodell? Laut Configuration du modèle (Stand 3 octobre 2026) ist Opus 5.5 der Standard für API-Nutzer, und Aliase werden im Lauf der Zeit auf neue Versionen umgestellt. Kunavo bietet Opus 5.5 an; ein Start ganz ohne Modellvariablen läuft hier also auf Opus 5.5, das coûte deux fois plus cher par token que Claude Sonnet 5. Mit festen Modellnamen wissen Sie, welches Modell antwortet und zu welchem Tarif. Der Opus-Pin hält den Alias opus auf Claude Opus 5.5 (claude-opus-5-5), auch wenn Anthropic ihn später auf ein neueres Opus umstellt. Opus 5.5 kostet bei Kunavo pro Token moins que Claude Opus 5 ($2,80 / $14,00 gegenüber $3,50 / $17,50 pro 1 Mio. Input-/Output-Tokens) und setzt Claude Code ab Version 2.1.280 voraus; eine ältere Installation bringt claude update auf den aktuellen Stand. Der Sonnet-Pin ist Pflicht: Der Alias sonnet zeigt für API-Nutzer auf Sonnet 5.5, das Kunavo nicht anbietet, und ohne ANTHROPIC_DEFAULT_SONNET_MODEL enden /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet mit 404. Claude Haiku 4.5 hält die Hintergrundaufgaben günstig, und mit /model wechseln Sie in der Sitzung jederzeit.

Deux points concernant le stockage. La clé ne doit jamais figurer dans le .claude/settings.json d’un projet, car ce fichier est versionné selon le guide de la passerelle et se retrouve chez toute personne qui clone le dépôt. Et si un export Shell et un bloc env définissent la même variable, le fichier de paramètres est prioritaire. Si vous modifiez une variable dans le Shell sans constater d’effet, l’ancienne valeur se trouve probablement encore dans un settings.json.

Die Modelle im Vergleich, Kunavo-Preise aus dem Katalog, Anthropics Listenpreise nach claude.com/de/pricing (Stand 3 octobre 2026), jeweils pro 1 Mio. Tokens:

ModèleKunavo (entrée / sortie)Prix catalogue d’Anthropic (entrée / sortie)DifférenceRôle dans Claude Code
claude-haiku-4-5$0,70 / $3,50$1,00 / $5,00~30 % moins cherAlias haiku et tâches en arrière-plan de Claude Code
claude-sonnet-5$1,40 / $7,00$2,00 / $10,00~30 % moins cherModèle principal (ANTHROPIC_MODEL) pour le travail quotidien
claude-opus-5-5$2,80 / $14,00$4,00 / $20,00~30 % moins cherAlias opus avec le verrouillage ci-dessus (refactorisations importantes, planification) ; sans verrouillage, valeur par défaut pour les utilisateurs de l’API
claude-opus-5$3,50 / $17,50$5,00 / $25,00~30 % moins cherAucun alias ; uniquement explicitement avec /model claude-opus-5

Tous les modèles et tarifs Claude figurent dans le guide des prix de l’API Claude et sur la page des tarifs.

Premier démarrage : vérifier avec /status

Wechseln Sie in Ihren Projektordner und starten Sie claude. Mit gesetztem ANTHROPIC_AUTH_TOKEN geht es direkt in die Sitzung, sans écran de connexion. Erscheint er trotzdem, hat Claude Code keinen Key gefunden. Der häufigste Grund laut Guide de la passerelle: Der Key steht nur in der .claude/settings.json oder .claude/settings.local.json des Projekts. Solche env-Blöcke wertet Claude Code in einer interaktiven Sitzung erst nach dem Einrichtungsassistenten und der Frage aus, ob Sie dem Ordner vertrauen. Legen Sie den Key deshalb in die Shell (export) oder in ~/.claude/settings.json.

Dans la session, /status affiche dans l’onglet Status d’où Claude Code obtient l’adresse et les identifiants. Deux lignes sont déterminantes :

LigneCorrectSinon
Anthropic base URLhttps://api.kunavo.comLa ligne n’apparaît que lorsqu’une adresse de passerelle est définie. Si elle manque, ANTHROPIC_BASE_URL n’est pas arrivé dans la session.
Auth tokenindique ANTHROPIC_AUTH_TOKENSi Login method affiche à la place un compte claude.ai, la variable n’a pas été lue et la session utilise votre abonnement.

Vous pouvez également tester la connexion sans Claude Code, avec la requête du guide de la passerelle (le modèle étant défini ici sur claude-sonnet-5). Elle demande exactement un token de sortie et ne coûte donc qu’un montant infime. Les commandes lisent les variables du Shell ; si vos valeurs figurent uniquement dans la settings.json, exportez-les aussi pour le test.

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

Si le JSON renvoyé commence par {"id":"msg_, ou si PowerShell renvoie un objet dont la id commence par msg_, l’adresse et la clé sont correctes. Un 401 signifie que la clé a été refusée.

Ce qui change avec une clé API

La plupart des éléments restent inchangés : la modification du code, les outils, les sous-agents, les serveurs MCP, les hooks et la mise en cache des prompts fonctionnent comme d’habitude. Voici quatre différences à connaître :

  • Remote Control et la dictée vocale ne sont pas disponibles. Selon le guide de la passerelle, ces deux fonctions nécessitent une identité claude.ai et sont bloquées tant que ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY est actif. Depuis la version 2.1.196, Remote Control est également bloqué lorsque ANTHROPIC_BASE_URL pointe vers un hôte situé en dehors d’Anthropic.
  • /fast signale que le mode rapide n’est pas disponible. Avec seulement un jeton Bearer, Claude Code le traite comme désactivé et n’envoie même pas la vérification de disponibilité.
  • La recherche d’outils pour MCP est désactivée. Laut Documentation MCP (Stand 3 octobre 2026) schaltet Claude Code sie ab, sobald ANTHROPIC_BASE_URL auf einen Drittanbieter zeigt; mit ENABLE_TOOL_SEARCH lässt sie sich ausdrücklich einschalten.
  • /context affiche des estimations. Kunavo bietet /v1/messages/count_tokens nicht an. Ohne diesen Endpunkt zählt Claude Code laut Guide de compatibilité de la passerelle (Stand 3 octobre 2026) anhand der Zeichen.

Pour en savoir plus sur l’intégration, consultez le guide d’intégration de Claude Code (en anglais).

Payer sans PayPal ni SEPA

Vorweg eine Abgrenzung: Kunavo verkauft keine Claude-Abos, sondern Guthaben für API-Zugang, von dem Claude Code jeden Token abbucht. Für Pro und Max bei Anthropic gilt: Im Web nur Kredit- oder Debitkarte, in den Apps rechnen App Store bzw. Google Play ab (FAQ sur la facturation). PayPal oder Venmo nimmt Anthropic laut dem Article d’aide sur les cartes refusées nicht an (beides Stand 3 octobre 2026).

Kunavo lädt über den Stripe-Checkout auf. Die Preise stehen in US-Dollar; wer aus Deutschland oder Österreich zahlt, sieht den Betrag in Euro. In diesem Kurs steckt laut Documentation de Stripe sur Adaptive Pricing (Stand 3 octobre 2026) eine Umrechnungsgebühr von 2–4 %, die der Käufer trägt. Wählen Sie im Checkout US-Dollar, entfällt sie; dann rechnet Ihre Bank zu ihrem eigenen Kurs um und kann eigene Gebühren verlangen. Der Checkout bietet an:

Mode de paiementOùRemarque
Carte (Visa, Mastercard, Amex, JCB, UnionPay)partoutCartes de crédit et de débit, y compris Visa Debit et Debit Mastercard ; mais pas une girocard seule
Apple PaySafari, iPhone et iPad ; pas en Indeavec une carte dans le portefeuille, y compris une carte de débit Visa ou Mastercard ; une girocard seule ne convient pas
Google PayChrome et Android avec Google Pay configuré ; pas en Indeavec une carte dans le portefeuille, y compris une carte de débit Visa ou Mastercard ; une girocard seule ne convient pas
Linkpartout sauf en IndeLe service de paiement de Stripe, qui enregistre votre carte ; permet également la recharge automatique
EPSAutriche, checkout en eurosRedirection vers la banque en ligne de votre banque

EPS ist laut Stripe ein österreichisches Verfahren, das alle österreichischen Banken unterstützen. Sie werden auf die Seite Ihrer Bank weitergeleitet und bestätigen dort; es funktioniert nur bei Zahlung in Euro. Wer aus der Schweiz zahlt, nimmt Karte, Apple Pay, Google Pay oder Link.

girocard : Eine Karte, die nur girocard ist (früher EC-Karte), wird im Kunavo-Checkout nicht angenommen, weil Stripe girocard nicht unter seinen réseaux de cartes pris en charge führt (Stand 3 octobre 2026). Trägt Ihre Karte zusätzlich das Visa- oder Mastercard-Logo, läuft die Zahlung über dieses Netz, auch in Apple Pay und Google Pay.

Non proposé : PayPal, prélèvement SEPA, virement manuel (paiement anticipé), giropay et Sofort. Klarna n’est proposé par le paiement qu’aux acheteurs aux États-Unis ; même en passant aux dollars américains depuis l’extérieur des États-Unis, Klarna ne s’affiche pas.

  1. Créer un compte ; Kunavo ne demande aucune carte lors de l’inscription.
  2. Dans Billing, choisissez un palier de recharge à partir de $10. Les paliers supérieurs donnent droit à du crédit bonus : $100 ergeben $110, $1.000 ergeben $1.200, $5.000 ergeben $6.250.
  3. Dans le paiement Stripe, choisissez le mode de paiement. Le montant en euros est affiché avant la confirmation ; avec EPS, confirmez dans votre banque en ligne.
  4. Dans API-Keys, créez une clé et renseignez-la comme valeur de ANTHROPIC_AUTH_TOKEN.

Le crédit est prépayé : aucun abonnement mensuel, aucune expiration, et les requêtes échouées ne sont pas facturées. La recharge automatique n’est possible qu’avec une carte enregistrée ou Link ; avec Apple Pay, Google Pay et EPS, vous effectuez les recharges manuellement. Kunavo n’émet pas de factures faisant apparaître la TVA ; vous pouvez consulter vos recharges dans Billing. Pour en savoir plus sur les moyens de paiement et les cartes refusées : Payer Claude sans carte de crédit.

Coût d’une session : exemple de calcul

Avec une clé API, vous payez les tokens, et Claude Code envoie à chaque étape l’intégralité du contexte accumulé. Ce contexte n’est toutefois pas entièrement facturé à chaque fois : le modèle lit le début inchangé depuis le cache, au tarif de lecture du cache, moins élevé. Le tableau applique un scénario hypothétique ; il ne s’agit ni d’une mesure ni d’un plafond. Hypothèses :

  • 40.000 tokens d’entrée par requête, dont 36.000 (90 %) lus depuis le cache et 4.000 nouvellement écrits dans le cache ;
  • 1.000 tokens de sortie par requête ;
  • 50 requêtes de ce type par session de travail, sans compter les appels en arrière-plan ;
  • La lecture du cache coûte, pour Claude Sonnet 5, 10 % du tarif d’entrée ; l’écriture du cache coûte 1,25 fois ce tarif. Chaque modèle du tableau est calculé avec ses propres facteurs.
ModèleUne requête50 requêtes50 requêtes sans aucun accès au cache
Claude Sonnet 5$0,019$0,952$3,15
Claude Opus 5$0,0476$2,38$7,88
Claude Opus 5.5$0,033$1,65$6,30

Ce que vous payez réellement dépend de la longueur du contexte, des accès au cache et de la longueur de la réponse, ainsi que du fait que vous recommenciez avec /clear entre deux tâches. Pour vos propres chiffres, utilisez le calculateur de coût des tokens Claude (en anglais) ; la comparaison avec Pro et Max est détaillée dans le guide des tarifs de Claude Code.

Messages d’erreur et leur signification

MessageSignification et solution
The token '&&' is not a valid statement separatorLa commande CMD se trouve dans la fenêtre PowerShell. C’est là qu’il faut utiliser irm … | iex.
'irm' is not recognized as an internal or external command (ou le même message en allemand)La commande PowerShell se trouve dans CMD. C’est là qu’il faut utiliser la ligne contenant install.cmd.
Claude Code does not support 32-bit Windows« Windows PowerShell (x86) » est ouvert. Choisissez l’entrée sans (x86).
syntax error near unexpected token '<' ou 403Le script a été remplacé par une page web ou un code d’erreur. Vérifiez le VPN, le proxy et le pare-feu de l’entreprise, ou essayez un autre réseau.
App unavailable in regionLa connexion semble provenir d’un pays non pris en charge. En Allemagne, en Autriche et en Suisse, il s’agit généralement d’un VPN ou d’un proxy.
command not found: claude ou claude n’est pas reconnuLe dossier d’installation ne figure pas dans le PATH. Ouvrez une nouvelle fenêtre ; sous Windows, utilisez la commande PATH ci-dessus.
Avertissement EBADENGINENode.js est antérieur à la version 22. L’installation se termine malgré tout ; une mise à jour reste recommandée.
claude native binary not installed (macOS, Linux)npm a ignoré les dépendances facultatives (--omit=optional, optional=false). Supprimez ce paramètre et réinstallez.
npm.ps1 cannot be loadedLa stratégie d’exécution bloque npm. Utilisez npm.cmd, exécutez la ligne Set-ExecutionPolicy ou utilisez l’installateur natif.
Écran de connexion malgré la présence de la cléLa clé figure uniquement dans les paramètres du projet. Définissez-la avec export ou dans ~/.claude/settings.json, puis ouvrez un nouveau terminal.
ANTHROPIC_API_KEY défini, mais sans effetLa confirmation unique a été refusée. Activez-la dans /config → Use custom API key ou passez à ANTHROPIC_AUTH_TOKEN.
401La clé a été refusée. A-t-elle été copiée entièrement et sans espaces, est-elle toujours présente dans /app/keys et est-elle renseignée dans ANTHROPIC_AUTH_TOKEN ?
404ANTHROPIC_BASE_URL se termine par /v1, ou le modèle demandé n’existe pas chez Kunavo, par exemple après /model sonnet sans épingle Sonnet.

Limites de cette méthode

  • Le paiement se fait au token, et non au forfait. Pour une utilisation quotidienne de plusieurs heures de Claude Code, Pro ou Max est souvent plus avantageux. En cas d’utilisation variable, vous ne payez que ce qui est consommé, et un mois sans utilisation ne coûte rien.
  • Sans compte claude.ai, Remote Control et la dictée vocale sont indisponibles ; /fast est considéré comme désactivé et la recherche d’outils pour MCP est désactivée par défaut.
  • Kunavo ne propose actuellement pas Sonnet 5.5 ; /model sonnet, opusplan et les sous-agents Sonnet nécessitent donc l’épingle Sonnet des exemples ci-dessus.
  • Apple Pay, Google Pay et EPS servent uniquement aux recharges manuelles ; le rechargement automatique est possible seulement avec une carte ou Link. Les montants en euros incluent les frais de conversion de Stripe.
  • Kunavo n’émet pas de factures indiquant la TVA.
  • La documentation Claude Code d’Anthropic est disponible en allemand, tandis que le guide d’intégration de Kunavo est uniquement en anglais.

Questions fréquentes

Comment se déroule l’installation de Claude Code ?

Vous ouvrez un terminal et exécutez la commande officielle correspondant à votre système. Sous macOS, Linux et WSL : curl -fsSL https://claude.ai/install.sh | bash. Dans Windows PowerShell : irm https://claude.ai/install.ps1 | iex. Dans l’invite de commandes Windows (CMD) : curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Ouvrez ensuite une nouvelle fenêtre de terminal et saisissez claude --version. Si un numéro de version apparaît, Claude Code est installé. Cette installation native se met automatiquement à jour en arrière-plan ; les installations via Homebrew ou WinGet doivent être mises à jour manuellement.

Installer Claude Code sous Windows : ai-je besoin de WSL ou de droits administrateur ?

Ni l’un ni l’autre. Claude Code fonctionne nativement sous Windows 10 à partir de la version 1809 et sous Windows Server 2019 ; selon Anthropic, l’installateur n’a pas besoin d’être exécuté en tant qu’administrateur. WSL 2 est utile uniquement si vous avez besoin d’outils Linux ou du sandboxing ; dans ce cas, installez et démarrez Claude Code dans le terminal WSL. Git pour Windows est facultatif : avec Git, Claude Code exécute les commandes dans Git Bash, sans Git dans PowerShell. Les pièges courants sont la ligne CMD dans la fenêtre PowerShell (ou l’inverse) et l’entrée du menu Démarrer « Windows PowerShell (x86) », qui s’arrête en tant que processus 32 bits.

Ai-je besoin de Node.js pour Claude Code ?

Uniquement si vous installez via npm, auquel cas Node.js 22 ou une version ultérieure est requis. Les anciens guides mentionnent souvent Node.js 18, qui est obsolète. L’installateur natif, Homebrew et WinGet fonctionnent sans Node.js. Si votre Node.js est trop ancien, npm affiche l’avertissement EBADENGINE, mais installe quand même. N’installez jamais avec sudo et mettez à jour avec npm install -g @anthropic-ai/claude-code@latest plutôt qu’avec npm update -g.

Puis-je utiliser Claude Code sans abonnement ?

Oui, avec une clé API. Pour vous connecter, vous avez besoin de Pro, Max, Team, Enterprise ou d’un compte Console ; le forfait Claude gratuit n’inclut pas Claude Code. Avec Kunavo, définissez à la place ANTHROPIC_BASE_URL=https://api.kunavo.com et ANTHROPIC_AUTH_TOKEN, et Claude Code démarre sans écran de connexion. Chaque token est déduit d’un solde prépayé que vous rechargez à partir de $10 ; il n’y a pas de frais mensuels. Vous devez renoncer à Remote Control et à la dictée vocale, car les deux nécessitent un compte claude.ai.

Comment configurer une clé API dans Claude Code ?

Le mieux est de la placer dans le bloc env de ~/.claude/settings.json (sous Windows %USERPROFILE%\.claude\settings.json), ou sous forme de lignes export dans ~/.zshrc ou ~/.bashrc. Vous avez besoin de six valeurs : ANTHROPIC_BASE_URL=https://api.kunavo.com sans /v1 (sinon la requête est envoyée à /v1/v1/messages et échoue avec 404), ANTHROPIC_AUTH_TOKEN avec votre clé, ainsi que ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 et ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5. ANTHROPIC_AUTH_TOKEN est pris en compte immédiatement. ANTHROPIC_API_KEY fonctionne également, car Kunavo accepte la clé dans les deux en-têtes, mais elle doit être confirmée une fois en mode interactif. N’écrivez jamais la clé dans le fichier .claude/settings.json d’un projet, car ce fichier est partagé avec le dépôt.

Quel modèle Claude Code utilise-t-il avec une clé API ?

Le modèle que vous définissez. Sans configuration, Claude Code démarre, selon Anthropic (au 3 octobre 2026), avec Opus 5.5 pour les utilisateurs de l’API. Kunavo propose Opus 5.5, qui coûte deux fois plus cher par token que Claude Sonnet 5. Avec ANTHROPIC_MODEL=claude-sonnet-5, Claude Sonnet 5 devient le modèle de démarrage ; une requête de l’exemple de calcul sur cette page coûte alors environ $0,019. ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 détermine le modèle lancé par /model opus ; Opus 5.5 nécessite Claude Code à partir de la version 2.1.280, et une installation plus ancienne peut être mise à jour avec claude update. ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 est également nécessaire, car l’alias sonnet pointe vers Sonnet 5.5 pour les utilisateurs de l’API et Kunavo ne propose pas Sonnet 5.5 : sans cette ligne, /model sonnet, la phase d’exécution d’opusplan et les sous-agents avec model: sonnet se terminent par une erreur 404. ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 s’applique également aux tâches en arrière-plan.

Comment savoir dans /status que Claude Code utilise la clé API ?

Dans la session en cours, saisissez /status et consultez l’onglet Status. La ligne Anthropic base URL doit afficher https://api.kunavo.com et la ligne Auth token doit mentionner ANTHROPIC_AUTH_TOKEN. Si la ligne Base-URL est absente, la variable n’a pas atteint la session. Si une ligne Login method indique un compte claude.ai, la session utilise votre abonnement. Si l’écran de connexion apparaît dès le premier démarrage, la clé se trouve probablement uniquement dans les paramètres du projet, que Claude Code n’évalue qu’après l’assistant de configuration.

Puis-je payer Claude Code avec PayPal, le prélèvement SEPA, une girocard ou EPS ?

Pour le solde Kunavo : EPS est accepté si vous payez en euros depuis l’Autriche. PayPal et le prélèvement SEPA ne sont pas disponibles, et Klarna est réservé aux acheteurs aux États-Unis. Une girocard seule échoue, car Stripe ne reconnaît pas girocard comme marque de carte. Si votre carte porte également le logo Visa ou Mastercard, vous pouvez payer via ce réseau, y compris avec Apple Pay ou Google Pay. Les cartes de crédit et de débit ainsi que Link sont également acceptés. Montant minimum $10, aucun frais mensuel, le solde n’expire pas ; selon Stripe, le montant en euros inclut des frais de conversion de 2–4 %. Le rechargement automatique fonctionne uniquement avec une carte enregistrée ou Link. Kunavo n’émet pas de factures mentionnant la TVA. Vous ne pouvez pas payer ainsi un abonnement Claude Pro ou Max ; Anthropic accepte lui-même uniquement les cartes sur le Web, et pas PayPal.