Claude Code wird mit einem offiziellen Befehl pro System installiert: unter macOS, Linux und WSL mit curl -fsSL https://claude.ai/install.sh | bash, unter Windows in PowerShell mit irm https://claude.ai/install.ps1 | iex (in der Eingabeaufforderung CMD mit der Zeile von install.cmd weiter unten). Danach gibt es zwei Nutzungsmöglichkeiten. Mit einem Abonnement melden Sie sich mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto an (wer nur den kostenlosen Claude.ai-Tarif hat, hat keinen Zugriff auf Claude Code). Ohne Abonnement verwenden Sie einen API-Schlüssel: Setzen Sie ANTHROPIC_BASE_URL (nur die Domain, ohne /v1), ANTHROPIC_AUTH_TOKEN und vier Modellvariablen und prüfen Sie mit /status. Das Kunavo-Guthaben wird beim Checkout in Euro mit MB WAY ab US$ 10 aufgeladen, ohne Monatsgebühr.
Befehle und Variablen wurden am 3. Oktober 2026 in der offiziellen Installationsdokumentation für Claude Code und der Dokumentation zu Umgebungsvariablen geprüft; Preise und Zahlungsmethoden wurden am 3. Oktober 2026 verifiziert. Portugal steht auf der Liste der von Anthropic unterstützten Länder (abgerufen am 3. Oktober 2026), sowohl für Claude.ai als auch für die API. Diese Anleitung gibt es auch auf Englisch: Install Claude Code.
Vor der Installation
| Komponente | Anforderung (offizielle Installationsdokumentation, abgerufen am 3. Oktober 2026) |
|---|---|
| Betriebssystem | macOS 13.0 oder höher; Windows 10 1809 oder höher bzw. Windows Server 2019 oder höher; Ubuntu 20.04+; Debian 10+; Alpine Linux 3.19+ |
| Hardware | Mindestens 4 GB RAM, x64- oder ARM64-Prozessor (Windows mit 32 Bit wird nicht unterstützt) |
| Shell | Bash, Zsh, PowerShell oder CMD |
| Netzwerk und Standort | Internetverbindung in einem von Anthropic unterstützten Land (Portugal steht auf der Liste) |
| Konto | Für die Anmeldung: Pro, Max, Team, Enterprise oder Console (der kostenlose Claude.ai-Tarif reicht nicht aus). Mit einem API-Schlüssel sind weder Abonnement noch Anmeldung erforderlich. |
| Node.js | Nur für die Installation über npm, dann Version 22 oder höher; die native Installation benötigt Node.js nicht |
macOS, Linux und WSL: eine einzige Zeile
Führen Sie im Terminal (unter macOS unter Programme › Dienstprogramme) Folgendes aus:
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bashDies ist die empfohlene native Installation: ein eigenständiges Programm, das sich laut offizieller Dokumentation selbstständig im Hintergrund aktualisiert. Der Befehl claude wird unter ~/.local/bin abgelegt. Ein bereits geöffnetes Terminal kennt den neuen PATH noch nicht. Öffnen Sie daher vor dem Testen ein neues Fenster. Unter WSL ist die Zeile genau gleich und wird im WSL-Terminal ausgeführt.
Unter Windows installieren
Unter Windows gibt es zwei Zeilen; die Auswahl hängt ausschließlich vom geöffneten Fenster ab. Beginnt die Eingabezeile mit PS C:\Users\Nome>, befinden Sie sich in PowerShell; erscheint nur C:\Users\Nome> ohne PS, befinden Sie sich in der Eingabeaufforderung (CMD). „Als Administrator ausführen“ ist nicht erforderlich: Die offizielle Dokumentation sagt ausdrücklich, dass dies nicht notwendig ist, entgegen den Empfehlungen mancher portugiesischer Anleitungen.
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Linha de Comandos do Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdUnter Windows ist das häufigste Problem ein falsches Fenster. Wenn PowerShell mit The token '&&' is not a valid statement separator antwortet, haben Sie die CMD-Zeile verwendet; wenn CMD mit 'irm' is not recognized as an internal or external command antwortet, haben Sie die PowerShell-Zeile verwendet. Unter einem portugiesischen Windows kann diese zweite Meldung übersetzt erscheinen, mit derselben Ursache. Und wenn Sie die macOS-Zeile mit | bash in PowerShell einfügen, erscheint ein Fehler, dass bash nicht erkannt wird. In allen drei Fällen besteht die Lösung darin, die zum Fenster passende Zeile zu verwenden.
Git for Windows ist optional. Damit wird das Bash-Tool von Claude Code in Git Bash ausgeführt; PowerShell bleibt daneben verfügbar. Ohne Git for Windows laufen alle Befehle über PowerShell. Wenn Git in einem ungewöhnlichen Ordner installiert ist und Claude Code bash.exe nicht findet, geben Sie den Pfad in CLAUDE_CODE_GIT_BASH_PATH im Block env von ~/.claude/settings.json an. Das Beispiel aus der Dokumentation lautet C:\Program Files\Git\bin\bash.exe.
| Option | Was erforderlich ist | Sandbox | Wann auswählen |
|---|---|---|---|
| Native Windows-Installation | Nichts; Git for Windows optional | Nicht unterstützt | Projekte und Tools, die direkt unter Windows ausgeführt werden |
| WSL 2 | WSL 2 aktiviert | Unterstützt | Wenn Linux-Tools oder Befehle innerhalb einer Sandbox benötigt werden |
| WSL 1 | WSL 1 aktiviert | Nicht unterstützt | Wenn WSL 2 nicht verfügbar ist |
WSL ist daher eine Wahl und keine Voraussetzung, entgegen dem, was in manchen Anleitungen steht. Wer WSL wählt, führt die macOS-/Linux-Zeile im WSL-Terminal aus und startet claude ebenfalls dort, nicht aus PowerShell oder CMD.
Über Homebrew, WinGet oder npm
Es funktioniert ebenfalls, mit einem wichtigen Unterschied: Laut offizieller Dokumentation aktualisieren sich Installationen über Homebrew und WinGet nicht automatisch. Die Aktualisierung erfolgt manuell. Außerdem gibt es signierte apt-, dnf- und apk-Repositories für Linux.
# Homebrew
brew install --cask claude-code
brew upgrade claude-code # não se atualiza sozinho
# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode # não se atualiza sozinhoDas npm-Paket erfordert Node.js 22 oder höher – nicht Node.js 18, wie manche Anleitungen noch angeben. Mit einer älteren Node.js-Version zeigt npm während der Installation lediglich die Warnung EBADENGINE an, statt abzubrechen. Verwenden Sie niemals sudo npm install -g: Die offizielle Dokumentation rät ausdrücklich davon ab. Zum Aktualisieren verwenden Sie @latest statt npm update -g.
node -v # tem de ser v22 ou posterior
npm install -g @anthropic-ai/claude-code # nunca com sudo
# para atualizar mais tarde: com @latest, não com npm update -g
npm install -g @anthropic-ai/claude-code@latestInstallation bestätigen
claude --version # mostra o número da versão, seguido de (Claude Code)
claude doctor # diagnóstico só de leitura da instalação e das definições, sem abrir sessãoclaude doctor startet keine Sitzung: Der Befehl zeigt den Status der Installation und der Einstellungsdateien an. So lässt sich am schnellsten feststellen, ob ein Problem die Installation oder die Konfiguration betrifft.
Ein command not found: claude (oder unter Windows der Hinweis, dass claude kein bekannter Befehl ist) bedeutet, dass das Terminal nicht weiß, wo das Programm installiert wurde. Oft reicht es, das Fenster zu schließen und ein neues zu öffnen. Falls das Problem weiterhin besteht, fehlt der Ordner im PATH: Unter macOS und Linux ist es ~/.local/bin, der in die Startdatei der Shell (~/.zshrc oder ~/.bashrc) aufgenommen werden muss; unter Windows ist es %USERPROFILE%\.local\bin. Laut der offiziellen Anleitung zur Fehlerbehebung prüfen und ergänzen Sie den Pfad in PowerShell so:
# 1. A pasta de instalação já está no PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Sem resultado? Acrescente-a ao PATH do utilizador e abra uma janela nova
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Na janela nova: dois caminhos significam duas instalações lado a lado
where.exe claudeWenn Sie über npm installiert haben und PowerShell mit npm.ps1 cannot be loaded because running scripts is disabled on this system antwortet, blockiert die Ausführungsrichtlinie von PowerShell die npm-Skripte. Verwenden Sie die native Installation oder erlauben Sie lokale Skripte für Ihren Benutzer:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserWenn Claude Code does not support 32-bit Windows erscheint, wurde „Windows PowerShell (x86)“ geöffnet. Windows enthält zwei PowerShell-Einträge, und die x86-Version läuft als 32-Bit-Prozess. Öffnen Sie den Eintrag „Windows PowerShell“ ohne „(x86)“.
Erste Verwendung: Abonnement oder API-Schlüssel
Beim ersten Start entscheiden Sie, wie Claude Code bezahlt wird. Für einen Wechsel der Methode ist keine Neuinstallation erforderlich: Entscheidend ist, ob ein Schlüssel festgelegt ist oder nicht.
| Weg A: Mit einem Abonnement anmelden | Weg B: API-Schlüssel ohne Abonnement | |
|---|---|---|
| Was erforderlich ist | Pro-, Max-, Team-, Enterprise- oder Console-Konto | Ein Kunavo-Schlüssel, der mit sk-kn- beginnt |
| Zahlungsweise | Pro und Max: fester monatlicher oder jährlicher Betrag; Console: pro Token, wie bei Anthropic | Pro Token, aus einem im Voraus bezahlten Guthaben; ohne Monatsgebühr |
| Zahlungsmethode | Pro und Max über die Website gekauft: nur Kredit- oder Debitkarte | MB WAY, Karte, Apple Pay, Google Pay oder Link |
| Remote Control und Spracheingabe | Mit einem claude.ai-Konto verfügbar (Pro, Max, Team, Enterprise); nicht mit einem Console-Konto | Nicht verfügbar |
| Konfiguration | Anmeldung im Browser | Sechs Umgebungsvariablen |
Weg A – Anmeldung mit dem Abonnement
Führen Sie im Projektordner claude aus und melden Sie sich im Browser an. Achtung für alle, die bereits ANTHROPIC_API_KEY in der Umgebung haben: Statt den Browser zu öffnen, fordert Claude Code eine einmalige Genehmigung dieses Schlüssels an. Wenn Sie die Genehmigung ablehnen, wird der Schlüssel danach ignoriert, die Frage wird nicht erneut gestellt, und es wirkt, als würde die Variable nicht gelesen. So aktivieren Sie sie wieder: /config → Use custom API key.
Weg B – ohne Abonnement, mit API-Schlüssel
ANTHROPIC_BASE_URL ist eine Variable von Claude Code selbst, die dafür vorgesehen ist, Anfragen über einen Proxy oder ein Gateway zu leiten. Sie auf einen mit der Messages API von Anthropic kompatiblen Endpunkt zu verweisen, ist daher eine unterstützte Konfiguration ohne Plug-ins oder modifizierte Versionen. Die Schritte:
- Kunavo-Konto erstellen.
- Laden Sie das Guthaben unter Abrechnung ab US$ 10 auf (die Zahlung mit MB WAY wird weiter unten erklärt).
- Erstellen Sie unter /app/keys einen Schlüssel, der mit
sk-kn-beginnt. Er wird nur einmal angezeigt; speichern Sie ihn daher am besten sofort. - Legen Sie die Variablen unter macOS und Linux in
~/.zshrcoder~/.bashrcfest:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # só o domínio, sem /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-5Unter Windows zunächst zum Testen in einem PowerShell-Fenster:
# Vale só para esta janela do 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"
claudeFür die dauerhafte Verwendung ist der env-Block in den Benutzereinstellungen am besten geeignet: ~/.claude/settings.json (unter Windows: %USERPROFILE%\.claude\settings.json). Dort gelten die Werte für alle Projekte, einschließlich der Hintergrundagenten; die VS-Code-Erweiterung ist die Ausnahme (siehe unten). Eine in der Shell exportierte Variable wird nur an Programme weitergegeben, die aus dieser Shell gestartet werden: Ein über das Dock oder das Startmenü geöffnetes Programm sieht sie nicht. Wenn die Datei bereits andere Einstellungen enthält, 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"
}
}Tragen Sie den Schlüssel niemals in die Projektdatei .claude/settings.json ein: Laut der offiziellen Gateway-Dokumentation (abgerufen am 3. Oktober 2026) wird diese Datei in Commits aufgenommen und mit allen geteilt, die das Repository klonen. Beachten Sie auch die Prioritätsreihenfolge: Wenn die Shell und eine Einstellungsdatei dieselbe Variable festlegen, hat die Einstellungsdatei Vorrang. Wenn eine Änderung in der Shell keine Wirkung zeigt, prüfen Sie zuerst die Datei settings.json.
Wer die VS-Code-Erweiterung verwendet, legt die Variablen unter claudeCode.environmentVariables in den Benutzereinstellungen von VS Code selbst fest (Befehl Preferences: Open User Settings (JSON)). Laut der Gateway-Dokumentation prüft die Erweiterung die Anmeldedaten vor dem Start in dieser Einstellung; die Werte aus ~/.claude/settings.json werden zwar an den Prozess von Claude Code übergeben, aber nicht an diese Prüfung:
{
"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 vier Modellvariablen und die übrigen Stolperfallen
Jede Zeile des Blocks hat ihre eigene Stolperfalle:
- In
ANTHROPIC_BASE_URLgehört der Pfad nicht hinein. Den Pfad/v1/messagesfügt Claude Code selbst hinzu; eine Adresse, die bereits mit/v1endet, wird zu/v1/v1/messagesund liefert 404 zurück. ANTHROPIC_AUTH_TOKENoderANTHROPIC_API_KEY: Kunavo akzeptiert beide. Laut der Gateway-Dokumentation wirdANTHROPIC_AUTH_TOKENim HeaderAuthorization: Bearerübertragen und ist sofort wirksam;ANTHROPIC_API_KEYwird im Headerx-api-keyübertragen und muss im interaktiven Modus einmal genehmigt werden, bevor es wirksam wird (siehe Weg A). Deshalb verwendet diese AnleitungANTHROPIC_AUTH_TOKEN.- Der Name in
ANTHROPIC_MODELmuss exakt stimmen. Kopieren Sie ihn genau wie hier angegeben:claude-sonnet-5. - Ohne
ANTHROPIC_DEFAULT_SONNET_MODELundANTHROPIC_DEFAULT_OPUS_MODELändern sich die Aliase automatisch. Laut der Dokumentation zur Modellkonfiguration (abgerufen am 3. Oktober 2026) verweist für Nutzer der Anthropic-API der Aliasopusauf Opus 5.5 und der Aliassonnetauf Sonnet 5.5; diese Aliase ändern sich mit neuen Versionen. Das Modell lässt sich mit dem vollständigen Modellnamen oder mit Variablen wieANTHROPIC_DEFAULT_OPUS_MODELfestlegen. Kunavo bietet Sonnet 5.5 nicht an, und eine Anfrage für ein nicht vorhandenes Modell gibt 404 zurück: OhneANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5schlagen/model sonnet, Subagenten mitmodel: sonnetund der Ausführungsschritt vonopusplanfehl. Der Aliasopusverweist dagegen aufclaude-opus-5-5, das Kunavo anbietet, allerdings erst ab Claude Code v2.1.280. Mit einer älteren Version führen Sieclaude updateaus. - Lege außerdem
ANTHROPIC_DEFAULT_HAIKU_MODELfest. Der Aliashaikuverlangt eine ID, die Kunavo nicht bereitstellt: Seit v2.1.293 ist es Haiku 5.5 und davor eine datierte ID von Haiku 4.5. Ohne diese Zeile erhalten/model haikuund die Subagenten mitmodel: haikueinen 404-Fehler. ANTHROPIC_DEFAULT_HAIKU_MODELgilt auch für Hintergrundaufgaben. Laut Dokumentation legt es den Aliashaikuund das Modell der Hintergrundfunktionen von Claude Code fest. Mit Claude Haiku 4.5 verwenden diese Aufrufe das günstigste Modell aus der folgenden Tabelle.
Preise pro einer Million Token aus dem Kunavo-Modellkatalog; die Spalte für Anthropic stammt von claude.com/pricing (abgerufen am 3. Oktober 2026):
| Modell | Kunavo (Eingabe / Ausgabe) | Listenpreis von Anthropic (Eingabe / Ausgabe) | Unterschied | Wofür |
|---|---|---|---|---|
claude-haiku-4-5 | US$ 0,70 / US$ 3,50 | US$ 1,00 / US$ 5,00 | etwa 30 % günstiger | Hintergrundaufgaben von Claude Code selbst und einfache Arbeiten |
claude-sonnet-5 | US$ 1,40 / US$ 7,00 | US$ 2,00 / US$ 10,00 | etwa 30 % günstiger | Das Standardmodell für die tägliche Arbeit |
claude-opus-5-5 | US$ 2,80 / US$ 14,00 | US$ 4,00 / US$ 20,00 | etwa 30 % günstiger | Große Refactorings und Planung |
Innerhalb einer Sitzung wechseln Sie mit /model claude-opus-5-5 das Modell oder starten direkt mit claude --model claude-opus-5-5. Die Rechnung in Euro mit Beispielen zur monatlichen Nutzung und dem Punkt, ab dem sich ein Abonnement eher lohnt, finden Sie unter Claude-Code-Preis in Euro; den Verbrauch können Sie mit dem Tokenkostenrechner berechnen. Alle Modelle und Preise finden Sie auf der Preisseite.
Mit /status überprüfen
Führen Sie claude aus. Wenn ANTHROPIC_AUTH_TOKEN festgelegt ist, erscheint kein Anmeldebildschirm: Die Variable wird sofort angewendet. Wenn der Anmeldebildschirm erscheint, hat Claude Code keinen Schlüssel gelesen. Legen Sie ihn in diesem Fall an einer Stelle fest, die Claude Code vor dem Assistenten beim ersten Start liest: als export in der Shell oder im env-Block von ~/.claude/settings.json. Ein env-Block in .claude/settings.json oder .claude/settings.local.json eines Projekts gilt in einer interaktiven Sitzung erst nach dem Assistenten beim ersten Start und der Frage, ob dem Ordner vertraut werden soll.
Geben Sie in der Sitzung /status ein und suchen Sie im Tab „Status“ nach zwei Zeilen (Quelle: die offizielle Dokumentation zu Gateways, abgerufen am 3. Oktober 2026):
Anthropic base URLmusshttps://api.kunavo.comanzeigen. Diese Zeile erscheint nur, wenn eine Gateway-Adresse festgelegt ist; wenn sie fehlt, wurdeANTHROPIC_BASE_URLnicht an die Sitzung übergeben.- Die Zeile
Auth tokenmussANTHROPIC_AUTH_TOKENanzeigen. Wenn stattdessenLogin methodmit einem claude.ai-Konto erscheint, wurde die Variable nicht gelesen und die Sitzung verwendet das Abonnement.
Wer sich bereits mit einem Abonnement angemeldet hatte, sieht beim Start möglicherweise einen Hinweis, dass zwei Anmeldedaten aktiv sind (die Meldung endet mit auth may not work as expected). Die Anfragen werden über den Schlüssel gesendet; /logout löscht die alte Anmeldung.
Um Adresse und Schlüssel vor dem Öffnen von Claude Code zu testen, empfiehlt die Dokumentation eine Anfrage mit einem einzigen Ausgabetoken, die nur einen winzigen Bruchteil des Guthabens verbraucht. Die Befehle lesen die Shell-Variablen, daher müssen Sie sie auch dort festlegen, selbst wenn sie bereits in settings.json vorhanden sind.
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": "."}]}'Eine JSON-Antwort, die mit {"id":"msg_ beginnt, bedeutet, dass Adresse und Schlüssel funktionieren; in PowerShell erscheint ein id, das mit msg_ beginnt. Ein 401 bedeutet, dass der Schlüssel nicht erkannt wurde.
Was sich mit einem API-Schlüssel ändert
- Kein Remote Control und kein Diktieren per Sprache. Laut der Gateway-Kompatibilitätsdokumentation sind diese Funktionen nicht verfügbar, solange
ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKENoder einapiKeyHelperaktiv ist; Remote Control bleibt außerdem deaktiviert, solangeANTHROPIC_BASE_URLauf eine Adresse außerhalb von Anthropic zeigt. - In
/fastwird der Schnellmodus als deaktiviert angezeigt. Mit nur einem Bearer-Token behandelt Claude Code den Schnellmodus als ausgeschaltet. - Die Suche nach MCP-Tools (MCP tool search) ist standardmäßig deaktiviert, wenn
ANTHROPIC_BASE_URLauf eine Adresse außerhalb von Anthropic verweist (Dokumentation zu Umgebungsvariablen, abgerufen am 3. Oktober 2026). - Die Zahlen in
/contextsind Schätzwerte. Kunavo stellt/v1/messages/count_tokensnicht bereit. Laut der Dokumentation zur Gateway-Kompatibilität (abgerufen am 3. Oktober 2026) greift Claude Code ohne diesen Endpunkt auf eine Schätzung anhand der Zeichenanzahl zurück.
Der Rest – Code, Tools, Subagenten, MCP-Server, Hooks und Prompt-Caching – funktioniert wie gewohnt. Weitere Einzelheiten finden Sie in der Claude-Code-Integrationsdokumentation (auf Englisch) und unter Claude Code without a subscription (auf Englisch).
Guthaben mit MB WAY aufladen
Zunächst zum Abonnement: Ein Claude-Abonnement, das auf der Website gekauft wurde, kann nur mit Kredit- oder Debitkarte bezahlt werden (Anthropic-Hilfeartikel zu kostenpflichtigen Tarifen, abgerufen am 3. Oktober 2026). Bei einem Abonnement über die Claude-App für iOS oder Android gelten die Zahlungsmethoden des App Store oder von Google Play. Mit den Zahlungsmethoden von Kunavo, einschließlich MB WAY, lassen sich Claude Pro oder Max nicht bezahlen: Sie laden damit das API-Guthaben von Kunavo auf, das für Route B verwendet wird.
Das Guthaben wird an der Stripe-Kasse aufgeladen. Die Preise sind in US-Dollar angegeben; für Käufer in Portugal zeigt Stripe den Betrag in Euro an. Laut der Stripe-Dokumentation zu Adaptive Pricing (abgerufen am 3. Oktober 2026) enthält die Umrechnung eine vom Käufer gezahlte Gebühr von 2–4 %. Wer mit Karte, Apple Pay, Google Pay oder Link in US-Dollar bezahlt, zahlt diese Gebühr nicht, allerdings kann die Bank eigene Wechselkurse und Gebühren anwenden. MB WAY funktioniert nur in Euro. An der Kasse in Euro werden folgende Zahlungsmethoden angezeigt:
- MB WAY. Wählen Sie MB WAY aus, geben Sie Ihre Mobiltelefonnummer ein und bestätigen Sie den Kauf in der MB-WAY-App über die Benachrichtigung oder den Bereich „Aktivität“ (Stripe zu MB WAY und MB WAY zu Onlinekäufen, abgerufen am 3. Oktober 2026). Laut Stripe werden internationale Nummern akzeptiert, die meisten Kunden verwenden jedoch eine portugiesische Nummer mit der Vorwahl +351.
- Karten (Visa, Mastercard), Apple Pay, Google Pay und Link.
Nicht verfügbar sind Multibanco-Referenzen (Zahlung mit Anbieter- und Referenznummer), PayPal, SEPA-Lastschrift und Klarna, das nur Käufern in den Vereinigten Staaten angezeigt wird. Die Umrechnung in Euro erfolgt über Stripe Adaptive Pricing. Die dort angebotenen Zahlungsmethoden umfassen MB WAY, aber nicht Multibanco. Mit MB WAY lassen sich außerdem virtuelle MB-NET-Karten für Onlinekäufe erstellen (MB WAY zu MB NET, abgerufen am 3. Oktober 2026). Es ist nicht bestätigt, dass das Kartenfeld an der Kasse diese Karten akzeptiert. Am sichersten ist es daher, direkt MB WAY auszuwählen.
Was Stripe über MB WAY dokumentiert (abgerufen am 3. Oktober 2026):
- Pro Zahlung: zwischen 0,50 € und 5000 €.
- Pro Tag: standardmäßig 1000 €, in der MB-WAY-App bis auf 10.000 € anpassbar. Größere Aufladungen können das voreingestellte Tageslimit überschreiten; erhöhen Sie es in diesem Fall vor der Zahlung in der App. Vergleichen Sie den vom Checkout angezeigten Eurobetrag mit diesen Limits.
- Wiederkehrende Zahlungen: nicht unterstützt.
- Auf dem Kontoauszug erscheint der Name von Stripe (Stripe Inc) zusammen mit dem Transaktionsbetrag.
- Kunavo-Konto erstellen.
- Unter Abrechnung einen Betrag ab US$ 10 auswählen. Größere Aufladungen bringen zusätzliches Guthaben: wer US$ 100 auflädt, erhält US$ 110; wer US$ 1000 auflädt, erhält US$ 1200; wer US$ 5000 auflädt, erhält US$ 6250.
- Im Stripe-Checkout mit dem Eurobetrag MB WAY auswählen, die Mobiltelefonnummer eingeben und den Kauf in der MB-WAY-App bestätigen. Der Eurobetrag wird vor der Bestätigung angezeigt.
- Unter /app/keys den Schlüssel erstellen und in
ANTHROPIC_AUTH_TOKENeintragen.
Das Guthaben ist vorausbezahlt: Es gibt keine monatliche Gebühr, das Guthaben verfällt nicht und fehlgeschlagene Anfragen werden nicht berechnet. Die automatische Aufladung funktioniert nur mit einer gespeicherten Karte oder mit Link; bei MB WAY laden Sie immer manuell auf, da MB WAY laut Stripe weder wiederkehrende Zahlungen akzeptiert noch für zukünftige Zahlungen gespeichert wird. Kunavo stellt keine Rechnungen aus, weder mit NIF noch mit IVA; der Aufladeverlauf befindet sich unter Billing. Diese Zahlungsmethoden laden ausschließlich das Kunavo-API-Guthaben auf. Mehr dazu unter Claude mit MB WAY bezahlen.
Häufige Fehler
| Anzeige | Ursache und Lösung |
|---|---|
The token '&&' is not a valid statement separator | Die im PowerShell eingefügte CMD-Zeile. Verwenden Sie irm … | iex. |
'irm' is not recognized as an internal or external command (oder dieselbe Meldung auf Portugiesisch) | Die in CMD eingefügte PowerShell-Zeile. Verwenden Sie die Zeile für install.cmd. |
'bash' is not recognized as the name of a cmdlet | PowerShell hat die Zeile mit | bash erhalten, die für macOS, Linux und WSL bestimmt ist. In PowerShell ist die richtige Zeile die für install.ps1. |
| Der Befehl zeigt den Text des Skripts an, installiert aber nichts | Der Befehl wurde beim Einfügen abgeschnitten: irm lädt das Skript nur herunter, ausgeführt wird es von | iex. In CMD fehlt normalerweise der Teil -o install.cmd && install.cmd. |
syntax error near unexpected token '<' oder ein 403 | Der Download hat statt des Skripts eine Webseite oder einen Fehlercode zurückgegeben. Laut der offiziellen Fehlerbehebung (abgerufen am 3. Oktober 2026) bedeutet eine Seite mit der Meldung «App unavailable in region», dass Claude Code im betreffenden Land nicht verfügbar ist (Portugal steht auf der Liste). Ein einfacher 403 kann ebenfalls von einem Unternehmens-Proxy oder einer Firewall stammen: Überprüfen Sie in einem unterstützten Land zuerst das Netzwerk (hinter einem Proxy setzen Sie HTTPS_PROXY und HTTP_PROXY), da Homebrew und WinGet dieselben Server erreichen. Andernfalls kann es am Netzwerk, am regionalen Routing oder an einem vorübergehenden Ausfall liegen: Versuchen Sie es später erneut oder installieren Sie Claude Code unter macOS über Homebrew und unter Windows über WinGet. |
Claude Code does not support 32-bit Windows | Windows PowerShell (x86) wurde geöffnet. Öffnen Sie die normale Windows PowerShell. |
npm.ps1 cannot be loaded | Die PowerShell-Ausführungsrichtlinie blockiert npm. Führen Sie die Zeile Set-ExecutionPolicy aus oder verwenden Sie das native Installationsprogramm. |
command not found: claude oder claude wurde nicht erkannt | Das Terminal findet das Programm nicht. Schließen Sie das Fenster und öffnen Sie es erneut; falls das Problem bestehen bleibt, fügen Sie den Ordner zum PATH hinzu (unter Windows mit dem Block oben). |
| Anmeldebildschirm mit festgelegtem Schlüssel | Claude Code hat den Schlüssel nicht gelesen. Legen Sie die Variablen in der Shell oder in ~/.claude/settings.json fest, nicht nur in den Projekteinstellungen, und öffnen Sie ein neues Fenster. |
Hinweis, der mit auth may not work as expected endet | Ein Schlüssel und eine alte Anmeldung sind gleichzeitig aktiv. Verwenden Sie /logout, um nur den Schlüssel zu verwenden, oder entfernen Sie die Variable, um zum Abonnement zurückzukehren. |
401 | Der Schlüssel wurde nicht erkannt: Vergewissern Sie sich, dass Sie den vollständigen Schlüssel sk-kn- ohne Leerzeichen kopiert haben, dass er nicht unter /app/keys gelöscht wurde und dass er in einer Variable mit dem richtigen Namen wie ANTHROPIC_AUTH_TOKEN steht. |
404 | ANTHROPIC_BASE_URL endet mit /v1, das angeforderte Modell existiert bei Kunavo nicht oder /model sonnet wurde ohne ANTHROPIC_DEFAULT_SONNET_MODEL verwendet. |
Nach der Installation
Geben Sie beim ersten Start in einem Projekt /init ein: Claude Code durchsucht das Repository und schreibt eine CLAUDE.md mit den daraus abgeleiteten Informationen: wie das Projekt ausgeführt wird, wie Änderungen getestet werden und welchen Stilregeln es folgt. Überprüfen Sie diese Datei und halten Sie sie kurz, da sie in jeder Sitzung geladen wird. Zwischen unabhängigen Aufgaben startet /clear ein neues Gespräch; bei einer langen Aufgabe fasst /compact den Verlauf zusammen, um fortzufahren.
Was Sie wissen sollten
- Es handelt sich um eine pro Token abgerechnete API, nicht um ein Claude-Pro- oder-Max-Abonnement. Wer Claude Code täglich mehrere Stunden nutzt, zahlt mit einem Abonnement meist weniger; die Abrechnung pro Token lohnt sich bei unregelmäßiger Nutzung, und ein ungenutzter Monat kostet nichts. Der Vergleich in Euro steht unter Claude-Code-Preis in Euro.
- Wer mit einem API-Schlüssel arbeitet, hat keinen Zugriff auf Remote Control und kein Diktieren per Sprache.
- Über Kunavo wird gemeinsam genutzte Kapazität ohne reserviertes Kontingent und ohne vertragliche Garantien verwendet; wer diese benötigt, sollte direkt bei Anthropic einen Vertrag abschließen.
- MB WAY dient nur für manuelle Aufladungen; für die automatische Aufladung ist eine Karte oder Link erforderlich.
- Die im Checkout angezeigten Eurobeträge enthalten bereits die Umrechnungsgebühr von Stripe.
Häufig gestellte Fragen
Wie installiert man Claude Code?
Mit einem offiziellen Befehl pro System. Unter macOS, Linux und WSL: curl -fsSL https://claude.ai/install.sh | bash. Unter Windows in PowerShell: irm https://claude.ai/install.ps1 | iex. In der Windows-Eingabeaufforderung (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Dies ist die native Installation, die Anthropic empfiehlt; sie aktualisiert sich selbstständig im Hintergrund. Öffnen Sie anschließend ein neues Terminalfenster, prüfen Sie die Installation mit claude --version und beginnen Sie mit claude.
Benötigt man WSL oder Administratorrechte, um Claude Code unter Windows zu installieren?
Keines von beidem. Laut der offiziellen Installationsdokumentation wird der Befehl in PowerShell oder der Eingabeaufforderung (CMD) ausgeführt, ohne das Fenster als Administrator zu öffnen. Git for Windows ist optional: Wenn es installiert ist, führt Claude Code Befehle über Git Bash aus, andernfalls über PowerShell. WSL 2 ist sinnvoll, wenn das Projekt Linux-Tools benötigt oder Sie Befehle in einer Sandbox ausführen möchten; in diesem Fall wird Claude Code innerhalb des WSL-Terminals installiert und gestartet. Verwenden Sie nicht Windows PowerShell (x86): Claude Code unterstützt Windows mit 32 Bit nicht.
Benötigt man Node.js, um Claude Code zu installieren?
Nur bei der Installation über npm, und dann Node.js 22 oder höher – nicht Version 18, wie manche Anleitungen noch angeben. Die native Installation, Homebrew und WinGet benötigen Node.js nicht. Mit einer älteren Node.js-Version zeigt npm lediglich eine EBADENGINE-Warnung an, und die Installation wird fortgesetzt. Verwenden Sie niemals sudo npm install -g und aktualisieren Sie mit npm install -g @anthropic-ai/claude-code@latest statt mit npm update -g.
Kann man Claude Code ohne Pro- oder Max-Abonnement verwenden?
Ja. Für die Anmeldung ist ein kostenpflichtiges Konto (Pro, Max, Team oder Enterprise) oder ein Console-Konto erforderlich; der kostenlose Claude.ai-Tarif reicht nicht aus. Ohne Abonnement setzen Sie ANTHROPIC_BASE_URL=https://api.kunavo.com und ANTHROPIC_AUTH_TOKEN mit einem Kunavo-Schlüssel: Claude Code benötigt dann keine Anmeldung, und die Abrechnung erfolgt pro Token aus einem im Voraus bezahlten Guthaben, das ab US$ 10 aufgeladen wird, ohne Monatsgebühr. Auf diesem Weg fehlen zwei Funktionen: Remote Control und Spracheingabe.
Wo konfiguriert man den API-Schlüssel von Claude Code: in settings.json oder in PowerShell?
Für die dauerhafte Verwendung im env-Block von ~/.claude/settings.json (unter Windows: %USERPROFILE%\.claude\settings.json). Zum Testen mit $env:ANTHROPIC_AUTH_TOKEN in einem PowerShell-Fenster, wo die Variable nur für dieses Fenster gilt, oder mit export in ~/.zshrc oder ~/.bashrc. Niemals in .claude/settings.json eines Projekts, da diese Datei in die Commits des Repositorys gelangt. Wenn Shell und Einstellungsdatei dieselbe Variable enthalten, hat die Datei Vorrang. Kunavo akzeptiert den Schlüssel sowohl in ANTHROPIC_AUTH_TOKEN (Authorization: Bearer-Header, sofort wirksam) als auch in ANTHROPIC_API_KEY (x-api-key-Header, der im interaktiven Modus eine einmalige Genehmigung erfordert); diese Anleitung verwendet ANTHROPIC_AUTH_TOKEN. ANTHROPIC_BASE_URL enthält nur die Domain https://api.kunavo.com, ohne /v1.
Warum führt /model sonnet zu einem 404-Fehler?
Weil der Alias sonnet von Claude Code Sonnet 5.5 anfordert, das Kunavo nicht anbietet. Laut der Dokumentation zur Modellkonfiguration (abgerufen am 3. Oktober 2026) folgen die Aliase für Nutzer der Anthropic-API den neuesten Modellen: opus verweist auf Opus 5.5 und sonnet auf Sonnet 5.5. Mit ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 sowie ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 und ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 verwendet jede Anfrage ein von Kunavo angebotenes Modell; dazu gehören auch die Subagenten und der Ausführungsschritt von opusplan. Für Opus 5.5 ist Claude Code v2.1.280 oder höher erforderlich (Aktualisierung mit claude update). Ein weiterer häufiger 404-Fehler wird durch eine mit /v1 endende ANTHROPIC_BASE_URL verursacht, wodurch /v1/v1/messages entsteht.
Wie erkenne ich, ob Claude Code den Schlüssel und nicht das Abonnement verwendet?
Geben Sie in Claude Code /status ein. Auf der Registerkarte Status muss die Zeile Anthropic base URL https://api.kunavo.com anzeigen, und die Zeile Auth token muss auf ANTHROPIC_AUTH_TOKEN verweisen. Wenn unter Login method ein claude.ai-Konto erscheint, wurde die Variable nicht gelesen und die Sitzung verwendet das Abonnement. Wenn Claude Code direkt beim Start zur Anmeldung auffordert, wurde kein Schlüssel gelesen.
Kann ich Claude Code mit MB WAY bezahlen?
Das API-Guthaben von Kunavo ja: MB WAY ist beim Stripe-Checkout verfügbar, wenn dieser den Betrag in Euro anzeigt. Wählen Sie MB WAY, geben Sie Ihre Mobiltelefonnummer ein und bestätigen Sie den Kauf in der MB-WAY-App. Laut Stripe liegt jede MB-WAY-Zahlung zwischen 0,50 € und 5000 €, und das standardmäßige Tageslimit von 1000 € kann in der App auf bis zu 10.000 € erhöht werden. Die Umrechnung von Dollar in Euro enthält eine Gebühr von 2–4 %, der Mindestbetrag zum Aufladen beträgt US$ 10, und es gibt keine Monatsgebühr. MB WAY ist nur für manuelles Aufladen verfügbar: Automatisches Aufladen erfordert eine gespeicherte Karte oder Link. Multibanco-Referenzen, PayPal und SEPA-Lastschrift sind nicht verfügbar, und Kunavo stellt keine Rechnungen aus. Der Kunavo-Checkout bezahlt kein Claude-Pro- oder Max-Abonnement; dieses wird beim Kauf auf der Claude-Website nur mit einer Kredit- oder Debitkarte bezahlt.