Claude Code installieren: Windows, macOS und Linux, API-Schlüssel ohne Abonnement und Zahlung mit Bancontact

Für die Installation von Claude Code genügt eine Zeile, aber sie ist nicht überall gleich: curl -fsSL https://claude.ai/install.sh | bash im Terminal von macOS, Linux oder WSL, irm https://claude.ai/install.ps1 | iex in PowerShell und eine install.cmd-Zeile in der Windows-Eingabeaufforderung. Die eigentliche Frage stellt sich beim ersten Start: Wer bezahlt die Anfragen? Mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto können Sie sich anmelden (der kostenlose Claude.ai-Tarif umfasst Claude Code nicht). Ohne Abonnement genügt ein API-Schlüssel: sechs Variablen, darunter ANTHROPIC_BASE_URL ohne /v1 und ANTHROPIC_AUTH_TOKEN, anschließend ein Blick auf /status. Das Kunavo-Guthaben kann per Karte, Apple Pay, Google Pay, Link oder in Belgien per Bancontact ab $10 aufgeladen werden, ohne Abonnement.

D’où viennent les informations : les commandes et les variables sont reprises de la documentation officielle de Claude Code (Installation, Umgebungsvariablen, Verbindung zu einem Gateway), relue le 3. Oktober 2026 ; les prix Kunavo et les moyens de paiement ont été contrôlés le 3. Oktober 2026. D’après la Liste der von Anthropic unterstützten Länder (lue le 3. Oktober 2026), Claude.ai et l’API sont ouverts en France, en Belgique, en Suisse, au Luxembourg et au Canada, comme au Maroc, en Tunisie, en Algérie, au Sénégal et en Côte d’Ivoire. Le même guide existe auf Englisch et, pour la Flandre, auf Niederländisch.

Welchen Befehl Sie eingeben müssen, hängt vollständig vom Fenster ab

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

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

:: Invite de commandes Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Die ersten drei Zeilen installieren die native Version, die Anthropic empfiehlt: eine eigenständige Binärdatei, abgelegt in ~/.local/bin (%USERPROFILE%\.local\bin unter Windows), die ihre Updates im Hintergrund herunterlädt und beim nächsten Start anwendet. Sobald die Installation abgeschlossen ist, schließen Sie das Terminal und öffnen Sie ein neues: Das Terminal, das für die Installation verwendet wurde, kennt den neuen PATH noch nicht.

Unter Windows ist das falsche Fenster die häufigste Fehlerursache, und die Meldung sagt dies eindeutig. The token '&&' is not a valid statement separator: Sie haben die CMD-Zeile in PowerShell eingefügt. 'irm' is not recognized as an internal or external command: Das Gegenteil ist der Fall. Auf einem französischen Windows kann diese zweite Meldung übersetzt erscheinen; die Ursache bleibt dieselbe. Die übrigen Meldungen finden Sie in der Fehlertabelle am Ende des Leitfadens.

Voraussetzungen

Windows: Was alte Anleitungen sagen und was heute gilt

Une bonne partie des tutoriels en français datent des premières versions de Claude Code. Voici leurs consignes les plus répandues, confrontées à la aktuelle Installationsdokumentation et à la Fehlerbehebungsseite (lues le 3. Oktober 2026) :

Si vous installez Git for Windows, Claude Code passe par Git Bash et garde l’outil PowerShell à côté. Il arrive qu’il ne trouve pas bash.exe : indiquez alors son chemin dans la variable CLAUDE_CODE_GIT_BASH_PATH, au sein du bloc env de ~/.claude/settings.json (la documentation donne C:\Program Files\Git\bin\bash.exe en exemple). Dernier piège : le raccourci « Windows PowerShell (x86) » lance une version 32 bits, que Claude Code refuse.

Nativ oder WSL – die Wahl hängt davon ab, wo sich Ihre Projekte befinden:

Unter WSL findet alles innerhalb der Linux-Distribution statt: Dort fügen Sie die Zeile curl … | bash ein und geben anschließend claude ein. Wird der Befehl aus PowerShell oder CMD gestartet, würde er diese Installation nicht finden.

Homebrew, WinGet, apt oder npm

Paketmanager funktionieren, haben aber einen Nachteil: Claude Code wird darüber nicht automatisch aktualisiert. Für Homebrew und WinGet sorgt die Variable CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 dafür, dass Claude Code die Aktualisierung selbst startet; ohne sie müssen Sie dies selbst tun:

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # pas de mise à jour automatique

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # pas de mise à jour automatique

Sur Debian, Ubuntu, Fedora, RHEL et Alpine, Anthropic publie aussi des dépôts apt, dnf et apk signés, mis à jour avec le reste du système ; la procédure figure sur la Installationsseite.

Dann bleibt npm, wenn Node.js bereits Teil Ihrer Toolchain ist. Das Paket verlangt mindestens Node.js 22. Bei einer älteren Version begnügt sich npm mit einer Warnung EBADENGINE und führt die Installation zu Ende, weil das Paket dieselbe native Binärdatei installiert, die zum Ausführen kein Node.js benötigt. Zwei Regeln: kein sudo npm install -g und die Aktualisierung mit @latest, da npm update -g im ursprünglichen Versionsbereich bleibt und Sie zurücklassen kann.

node -v                                       # v22 ou plus récent
npm install -g @anthropic-ai/claude-code      # jamais avec sudo

# mise à jour : avec @latest, pas avec npm update -g
npm install -g @anthropic-ai/claude-code@latest

Installation prüfen und PATH reparieren

claude --version   # affiche le numéro de version, suivi de (Claude Code)
claude doctor      # diagnostic de l’installation et des réglages, sans ouvrir de session

Eine Versionsnummer als Ausgabe – damit ist es installiert. claude doctor geht weiter, ohne eine Sitzung zu starten: Installationsstatus, Fehler in Einstellungsdateien und Ergebnis der letzten Aktualisierung. Wenn etwas nicht stimmt, ist dies der erste auszuführende Befehl.

command not found: claude sur macOS ou Linux, claude « non reconnu » sous Windows : le programme est bien installé, mais le shell ne sait pas où le chercher. Une nouvelle fenêtre suffit le plus souvent. Sinon, ajoutez ~/.local/bin au PATH dans ~/.zshrc ou ~/.bashrc. Sous Windows, la offizielle Fehlerbehebungsseite donne ces trois étapes PowerShell :

# 1. Le dossier d'installation est-il déjà dans le PATH ?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Aucun résultat ? Ajoutez-le au PATH de l'utilisateur, puis ouvrez une nouvelle fenêtre
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Dans la nouvelle fenêtre : deux chemins = deux installations concurrentes
where.exe claude

Über npm installiert, und PowerShell antwortet mit npm.ps1 cannot be loaded? Die Ausführungsrichtlinie blockiert npm-Skripte. Wechseln Sie zum nativen Installationsprogramm oder erlauben Sie lokale Skripte nur für Ihr Konto:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Wer die Anfragen bezahlt: Claude-Abonnement oder API-Schlüssel

Die Wahl erfolgt nicht bei der Installation, sondern beim ersten Start, und sie kann rückgängig gemacht werden. Ein in der Umgebung gesetzter Schlüssel hat Vorrang vor einer gespeicherten claude.ai-Anmeldung, die inaktiv bleibt; löschen Sie die Variable, übernimmt die Anmeldung beim nächsten Start wieder.

Mit einem Claude-Abonnement

Nichts zu konfigurieren: claude im Projektverzeichnis und anschließend die Anmeldung im Browser. Die einzige Ausnahme ist eine ANTHROPIC_API_KEY, die in Ihrer Umgebung vorhanden sein könnte. Claude Code fragt dann einmalig, ob sie verwendet werden soll; eine Ablehnung wird gespeichert, und der Schlüssel anschließend ohne Meldung ignoriert, wodurch es so wirkt, als würde die Variable nicht gelesen. Um diese Auswahl zu ändern: /config → Use custom API key.

Ohne Abonnement: der Kunavo-API-Schlüssel

Faire pointer Claude Code ailleurs que chez Anthropic n’a rien d’un bricolage. La offizielle Liste der Umgebungsvariablen présente ANTHROPIC_BASE_URL comme le moyen d’envoyer les requêtes vers un proxy ou une passerelle. Kunavo répond au format de l’API Messages d’Anthropic : vous gardez le Claude Code officiel, sans extension ni version modifiée.

1. Erstellen Sie ein Konto: Kunavo registrieren.
2. Laden Sie das Guthaben unter Billing mit mindestens $10 auf (Zahlungsmethoden weiter unten).
3. Erstellen Sie einen Schlüssel unter /app/keys. Er beginnt mit sk-kn- und wird nur bei der Erstellung angezeigt: Kopieren Sie ihn sofort.
4. Tragen Sie die sechs folgenden Variablen ein.

Pourquoi épingler quatre modèles ? Les alias de Claude Code suivent les sorties d’Anthropic. D’après la Dokumentation zur Modellkonfiguration (lue le 3. Oktober 2026), pour un compte API, le réglage par défaut et opus visent aujourd’hui Opus 5.5, et sonnet vise Sonnet 5.5, que Kunavo ne sert pas : sans ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, la phase d’exécution d’opusplan et les sous-agents réglés sur sonnet tombent sur une 404. L’alias opus est épinglé sur Opus 5.5 (claude-opus-5-5), qui exige Claude Code v2.1.280 ou plus récent ; sur une version plus ancienne, lancez claude update. Un modèle tout juste sorti n’est pas non plus toujours disponible chez Kunavo le jour même. Avec des noms complets, chaque requête part vers un modèle servi, au prix que vous connaissez. La Dokumentation zum Gateway-Protokoll (lue le 3. Oktober 2026) confirme le point sur les tâches de fond : avec Claude Haiku 4.5, elles coûtent peu.

Wo die Variablen eingetragen werden

Die empfohlene Version, mit dem vorhandenen Dateiinhalt zusammenzuführen, falls bereits vorhanden (fügen Sie nur den env-Block hinzu):

{
  "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"
  }
}

Dieselben Werte in der Shell unter macOS und Linux:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # le domaine seul, sans /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

Für einen schnellen Test in einem PowerShell-Fenster:

# Valable uniquement dans cette fenêtre PowerShell
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Und für die VS-Code-Erweiterung in den Benutzereinstellungen des Editors (Befehl 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" }
  ]
}

Die Claude-Desktop-App bildet eine Ausnahme: Sie liest weder ANTHROPIC_BASE_URL noch settings.json. Eine in der Shell geänderte Variable bleibt wirkungslos? Suchen Sie zuerst dieselbe Variable in einem priorisierten settings.json.

Tarifs par million de tokens tirés du catalogue Kunavo, à côté du prix public d’Anthropic relevé sur claude.com/pricing (lu le 3. Oktober 2026) :

Um für die Dauer einer Aufgabe zu Opus zu wechseln: /model opus während der Sitzung (der auf claude-opus-5-5 gesetzte Alias) oder claude --model claude-opus-5-5 beim Start. Das monatliche Budget entsprechend Ihrer Nutzung und die Schwelle, ab der das Abonnement günstiger wird, sind unter Claude-Code-Preis beziffert. Der Claude-Token-Kostenrechner berechnet dies für Ihre eigenen Mengen, und die Preisseite listet alle Modelle auf.

Mit /status prüfen

Das erste Anzeichen noch vor /status: Wenn ANTHROPIC_AUTH_TOKEN gesetzt ist, startet Claude Code ohne Anmeldebildschirm. Wenn dieser Bildschirm erscheint, wurde kein Schlüssel gelesen, oft weil er sich nur in den Projekteinstellungen (.claude/settings.json oder .claude/settings.local.json) befindet. In einer interaktiven Sitzung wird dieser env-Block erst nach dem Assistenten für den ersten Start und der Vertrauensfrage für das Verzeichnis angewendet. Verschieben Sie den Schlüssel in Ihre Shell oder nach ~/.claude/settings.json.

Une fois dans la session, /status s’ouvre sur l’onglet Status. Voici comment le lire, d’après la Dokumentation zu Gateways (lue le 3. Oktober 2026) :

Waren Sie bereits mit einem Abonnement angemeldet? Claude Code kann dann beim Start zwei aktive Identifizierungsquellen melden, in einer Warnung, die mit auth may not work as expected endet. Der Schlüssel wird für die Anfragen verwendet; /logout entfernt die alte Anmeldung und blendet die Warnung aus.

Um festzustellen, ob ein Problem von Kunavo oder Ihrer Konfiguration verursacht wird, testen Sie ohne Claude Code. Die Dokumentation schlägt eine auf ein einziges Ausgabetoken begrenzte Anfrage vor, die einen Bruchteil eines Cents kostet. Die beiden folgenden Befehle beziehen Adresse und Schlüssel aus der Shell: Wenn sie ausschließlich in settings.json definiert sind, wären sie hier nicht sichtbar.

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

Ein JSON, das mit {"id":"msg_ beginnt, oder in PowerShell ein Objekt, dessen id mit msg_ beginnt: Adresse und Schlüssel funktionieren. Ein 401: Der Schlüssel wird abgelehnt.

Was sich mit einem API-Schlüssel ändert

• Remote Control und Spracheingabe verschwinden. Beide beruhen auf einem claude.ai-Konto und bleiben nicht verfügbar, solange ANTHROPIC_AUTH_TOKEN definiert ist. Remote Control wird außerdem deaktiviert, sobald ANTHROPIC_BASE_URL auf einen anderen Host als Anthropic verweist.
• Der Schnellmodus (/fast) erscheint deaktiviert, da seine Prüfung eine claude.ai-Anmeldung oder einen Anthropic-Schlüssel erfordert, nicht nur ein Bearer-Token.
• Die Suche nach MCP-Tools ist standardmäßig deaktiviert, wenn ANTHROPIC_BASE_URL auf einen Host außerhalb von Anthropic verweist.
• /context zeigt Schätzungen an. Kunavo ne propose pas /v1/messages/count_tokens, et dans ce cas Claude Code compte à partir du nombre de caractères (Dokumentation zum Gateway-Protokoll).

Für alles andere (Lesen und Schreiben von Code, Tools, Subagenten, MCP-Server, Hooks, Prompt-Cache) ändert sich nichts. Die technischen Details auf Englisch finden Sie in der Claude-Code-Integrationsdokumentation.

Aus Frankreich oder Belgien bezahlen

Deux circuits à ne pas confondre. L’abonnement Claude acheté sur le web se règle uniquement par carte de crédit ou de débit (Anthropic-FAQ zur Abrechnung, lue le 3. Oktober 2026) ; souscrit dans l’app mobile, il passe par l’App Store ou Google Play. Les montants de claude.com/pricing sont hors taxes.

Le solde Kunavo, lui, se recharge sur une page de paiement Stripe. Le tarif est fixé en dollars américains, mais depuis la France ou la Belgique Stripe vous montre le montant en euros, à un taux garanti 24 heures qui intègre 2 à 4 % de frais de conversion à votre charge (Stripe-Dokumentation zu Adaptive Pricing, lue le 3. Oktober 2026). Vous pouvez payer en dollars pour éviter ces frais, mais votre banque applique alors son propre change, et Bancontact n’est proposé qu’en euros. Les moyens de paiement disponibles :

• Französische CB-Karte? Selon la Stripe-Dokumentation zu Cartes Bancaires (lue le 3. Oktober 2026), plus de 95 % des cartes CB sont co-badgées Visa ou Mastercard. Elles passent donc au checkout en tant que Visa ou Mastercard, et une simple carte de débit fait l’affaire.
• Bancontact est proposé aux acheteurs situés en Belgique. Stripe vous envoie sur le site ou l’app Bancontact pour valider, et le résultat est connu immédiatement (Stripe-Dokumentation zu Bancontact, lue le 3. Oktober 2026).
• Pay by Bank, le paiement depuis votre banque en ligne, n’est pas proposé depuis la France ni la Belgique : le checkout ne l’affiche qu’aux acheteurs situés au Royaume-Uni, en Irlande et en Finlande. La Stripe-Dokumentation zu Pay by Bank (lue le 3. Oktober 2026) le classe en préversion privée pour la France et ne mentionne pas la Belgique.
• Aus der Schweiz oder Kanada wird der Betrag in Schweizer Franken oder kanadischen Dollar angezeigt, mit Karte und Link sowie Apple Pay und Google Pay, die auf einer Karte beruhen.

Nicht angeboten: PayPal, SEPA-Lastschrift, Klarna, das Käufern in den Vereinigten Staaten vorbehalten ist (in Dollar zu bezahlen reicht nicht aus).

1. Registrieren Sie sich bei Kunavo; zu diesem Zeitpunkt ist keine Karte erforderlich.
2. Wählen Sie unter Billing den Betrag: mindestens $10. Höhere Beträge berechtigen zu einem Bonus ($100 payés, $110 crédités ; $1 000 payés, $1 200 crédités ; $5 000 payés, $6 250 crédités).
3. Wählen Sie auf der Stripe-Seite die Zahlungsmethode; der Eurobetrag wird vor der Bestätigung angezeigt. Bei Bancontact bestätigen Sie in der App oder mit der Karte.
4. Erstellen Sie den Schlüssel unter /app/keys und tragen Sie ihn in ANTHROPIC_AUTH_TOKEN ein.

Das Guthaben ist vorausbezahlt: keine monatlichen Gebühren, kein Ablaufdatum, und eine fehlschlagende Anfrage wird nicht berechnet. Für die automatische Aufladung ist eine gespeicherte Karte oder Link erforderlich. Bancontact unterstützt bei Stripe keine wiederkehrenden Zahlungen, daher muss jede Bancontact-Aufladung manuell gestartet werden. Kunavo stellt keine Rechnung mit Mehrwertsteuer aus – weder eine französische noch eine belgische noch eine eines anderen Landes; der Verlauf der Aufladungen ist unter Billing einsehbar. Diese Zahlungsmethoden dienen ausschließlich dem Kunavo-API-Guthaben und bezahlen kein Claude-Pro- oder Max-Abonnement. Alle weiteren Möglichkeiten, einschließlich App Store und Google Play, werden unter Claude ohne Bankkarte bezahlen behandelt.

Häufige Fehler

Erste Schritte in einem Projekt

Beginnen Sie in einem von Claude Code entdeckten Repository mit /init: Der Code wird untersucht und eine CLAUDE.md erstellt, die die Testbefehle und erkannten Konventionen festhält. Lesen Sie diese Datei durch und kürzen Sie sie, da sie bei jeder Sitzung erneut geladen wird. Für ein neues Thema startet /clear eine leere Unterhaltung; um eine lange Aufgabe fortzusetzen, fasst /compact den Verlauf zusammen.

Die Grenzen des API-Schlüssels

• Sie zahlen nach Verbrauch, nicht für einen Claude-Pro- oder Max-Tarif. Bei mehreren Stunden Claude Code täglich, jeden Tag, ist das Abonnement oft günstiger; bei unregelmäßiger Nutzung ist die Token-Abrechnung flexibler, und schwache Monate kosten nichts. Zahlen unter Claude-Code-Preis.
• Kein Remote Control und keine Spracheingabe, solange der Schlüssel aktiv ist.
• Die Kapazität von Kunavo wird gemeinsam genutzt, ohne reserviertes Kontingent oder vertragliche Zusage; wenn Sie dies benötigen, schließen Sie direkt mit Anthropic einen Vertrag ab.
• Bancontact erlaubt nur manuelle Aufladungen; automatische Aufladungen erfolgen über eine gespeicherte Karte oder Link.
• Die Eurobeträge enthalten die Stripe-Umrechnungsgebühren, und Kunavo stellt keine Rechnung mit Mehrwertsteuer aus.

Häufig gestellte Fragen