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.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdAnthropic 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
- Installer : exécutez la ligne appropriée ci-dessus, puis ouvrez une nouvelle fenêtre de terminal.
- Vérifier :
claude --versionaffiche un numéro de version. - Décider : vous connecter avec un abonnement Claude ou utiliser une clé API (comparaison ci-dessous).
- Avec une clé API : recharger le solde, créer la clé et définir six variables d’environnement.
- Contrôler : saisissez
/statusdans 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.
| Sujet | Ce qu’on lit encore souvent | Selon Anthropic |
|---|---|---|
| macOS | macOS 10.15 ou version ultérieure | macOS 13.0 ou version ultérieure |
| Windows | uniquement via WSL | nativement sous Windows 10 à partir de la version 1809 ou sous Windows Server 2019 ; WSL est une option, pas une obligation |
| Droits | Lancer PowerShell en tant qu’administrateur | pas nécessaire |
| Node.js | Node.js 18 ou version ultérieure | uniquement pour l’installation npm, puis version 22 ou ultérieure |
| npm | obsolète | toujours 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 :
| Variante | Prérequis | Mise en bac à sable | Convient lorsque |
|---|---|---|---|
| Windows natif | aucun ; Git pour Windows est facultatif | non | vos projets et outils s’exécutent directement sous Windows |
| WSL 2 | WSL 2 activé | oui | vous avez besoin d’outils Linux ou souhaitez exécuter des commandes dans un bac à sable |
| WSL 1 | WSL 1 activé | non | WSL 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 selbstVia 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.
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@latestDrei 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 Sitzungclaude 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 :
# 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 --versionPowerShell 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 :
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserAbonnement 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 Claude | Clé API Kunavo | |
|---|---|---|
| Facturation | monatlich: 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 heures | une utilisation variable ; un mois sans utilisation ne coûte rien |
| Paiement | im 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 |
| Configuration | Lancer claude et se connecter dans le navigateur | six 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.
- Créer un compte chez Kunavo, avec une adresse e-mail ou un compte Google.
- Dans Billing, rechargez votre crédit d’au moins $10 (les moyens de paiement sont indiqués dans la section consacrée au paiement).
- 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. - 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 :
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-5Dans PowerShell, les affectations $env: ne s’appliquent qu’à la fenêtre ouverte ; c’est pratique pour un premier essai :
# 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"
claudeAuf 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:
{
"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)) :
{
"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
| Variable | Valeur | Effet | Si elle est absente ou incorrecte |
|---|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | redirige toutes les requêtes vers Kunavo ; Claude Code ajoute lui-même /v1/messages | Avec /v1 à la fin, la requête est envoyée vers /v1/v1/messages et échoue avec une erreur 404. |
ANTHROPIC_AUTH_TOKEN | Votre clé (sk-kn-…) | est envoyée comme Authorization: Bearer et est immédiatement prioritaire | Toute 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_MODEL | claude-sonnet-5 | Modèle de démarrage de chaque session | Sans 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_MODEL | claude-opus-5-5 | Cible de /model opus et version utilisée par défaut sans ANTHROPIC_MODEL | Sans 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_MODEL | claude-sonnet-5 | Cible de /model sonnet, phase d’exécution de opusplan et sous-agents avec model: sonnet | Sans 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_MODEL | claude-haiku-4-5 | Cible de /model haiku et modèle des fonctions en arrière-plan | Sans 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èle | Kunavo (entrée / sortie) | Prix catalogue d’Anthropic (entrée / sortie) | Différence | Rôle dans Claude Code |
|---|---|---|---|---|
claude-haiku-4-5 | $0,70 / $3,50 | $1,00 / $5,00 | ~30 % moins cher | Alias haiku et tâches en arrière-plan de Claude Code |
claude-sonnet-5 | $1,40 / $7,00 | $2,00 / $10,00 | ~30 % moins cher | Modèle principal (ANTHROPIC_MODEL) pour le travail quotidien |
claude-opus-5-5 | $2,80 / $14,00 | $4,00 / $20,00 | ~30 % moins cher | Alias 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 cher | Aucun 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 :
| Ligne | Correct | Sinon |
|---|---|---|
Anthropic base URL | https://api.kunavo.com | La 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 token | indique ANTHROPIC_AUTH_TOKEN | Si 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.
curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
-H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
-Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json" `
-Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'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_TOKENouANTHROPIC_API_KEYest actif. Depuis la version 2.1.196, Remote Control est également bloqué lorsqueANTHROPIC_BASE_URLpointe vers un hôte situé en dehors d’Anthropic. /fastsignale 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_URLauf einen Drittanbieter zeigt; mitENABLE_TOOL_SEARCHlässt sie sich ausdrücklich einschalten. /contextaffiche des estimations. Kunavo bietet/v1/messages/count_tokensnicht 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 paiement | Où | Remarque |
|---|---|---|
| Carte (Visa, Mastercard, Amex, JCB, UnionPay) | partout | Cartes de crédit et de débit, y compris Visa Debit et Debit Mastercard ; mais pas une girocard seule |
| Apple Pay | Safari, iPhone et iPad ; pas en Inde | avec une carte dans le portefeuille, y compris une carte de débit Visa ou Mastercard ; une girocard seule ne convient pas |
| Google Pay | Chrome et Android avec Google Pay configuré ; pas en Inde | avec une carte dans le portefeuille, y compris une carte de débit Visa ou Mastercard ; une girocard seule ne convient pas |
| Link | partout sauf en Inde | Le service de paiement de Stripe, qui enregistre votre carte ; permet également la recharge automatique |
| EPS | Autriche, checkout en euros | Redirection 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.
- Créer un compte ; Kunavo ne demande aucune carte lors de l’inscription.
- 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.
- 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.
- 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èle | Une requête | 50 requêtes | 50 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
| Message | Signification et solution |
|---|---|
The token '&&' is not a valid statement separator | La 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 403 | Le 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 region | La 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 reconnu | Le dossier d’installation ne figure pas dans le PATH. Ouvrez une nouvelle fenêtre ; sous Windows, utilisez la commande PATH ci-dessus. |
Avertissement EBADENGINE | Node.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 loaded | La 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 effet | La confirmation unique a été refusée. Activez-la dans /config → Use custom API key ou passez à ANTHROPIC_AUTH_TOKEN. |
401 | La 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 ? |
404 | ANTHROPIC_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 ;
/fastest 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,opusplanet 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.