Claude Code installieren: Schritt für Schritt unter Windows, macOS und Linux, API-Schlüssel ohne Abonnement und Kartenzahlung

Kurz gesagt: Claude Code wird mit einer einzigen, für Ihr Terminal passenden Zeile installiert. Unter macOS, Linux und WSL führen Sie install.sh, in Windows PowerShell irm … | iex und in der Eingabeaufforderung (CMD) install.cmd aus; alle drei stehen direkt unten. Dieser Weg benötigt Node.js nicht; wenn Sie über npm installieren möchten, benötigen Sie Node.js 22 oder höher. Nach der Installation gibt es zwei Möglichkeiten: Anmeldung mit einem Claude-Konto (Pro, Max, Team, Enterprise oder Console; der kostenlose Plan umfasst Claude Code nicht) oder ein API-Schlüssel ohne Abonnement. Mit dem Schlüssel legen Sie ANTHROPIC_BASE_URL=https://api.kunavo.com fest (ohne am Ende /v1 hinzuzufügen), außerdem ANTHROPIC_AUTH_TOKEN und die vier Variablen zur Festlegung der Modelle; /status zeigt in der Sitzung, ob der Schlüssel aktiv ist. Berechnet werden nur die verbrauchten Token. Sie laden das Guthaben mit einer Visa- oder Mastercard-Karte, Apple Pay, Google Pay oder Link mit mindestens 10 USD auf; Ratenzahlung und Papara sind nicht verfügbar.

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

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

:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Bu satırları ve aşağıdaki değişken adlarını Claude Code'un Installation ve Gateway-Verbindung belgelerinden 3. Oktober 2026 tarihinde aldık. Anthropic bu belgeleri Türkçe yayımlamıyor; hata mesajlarını bu yüzden İngilizce asıllarıyla veriyoruz. Kunavo fiyatlarını ve ödeme yöntemlerini en son 3. Oktober 2026 tarihinde kontrol ettik. VPN ya da yurt dışı proxy'si aramanıza gerek yok: Anthropics Seite zu unterstützten Ländern Türkiye'yi hem Claude.ai hem API için sayıyor (kontrol: 3. Oktober 2026).

Welche Zeile für welches Terminal?

Die meisten Installationsprobleme liegen nicht am Befehl, sondern am falschen Terminal. Die folgende Tabelle ordnet Ihre Umgebung der richtigen Zeile zu. Wenn Sie Windows verwenden, erklären wir im nächsten Abschnitt, wie Sie Ihr Terminal erkennen.

Systemanforderungen

Anforderungen der offiziellen Installationsdokumentation (Stand 3. Oktober 2026):

• Betriebssystem: macOS 13.0 oder neuer; Windows 10 Version 1809 und höher oder Windows Server 2019 und höher; unter Linux Ubuntu 20.04, Debian 10 und Alpine Linux 3.19 oder neuer.
• Hardware: mindestens 4 GB RAM und ein x64- oder ARM64-Prozessor. 32-Bit-Windows wird nicht unterstützt.
• Shell: Bash, Zsh, PowerShell oder CMD.
• Node.js: für den nativen Installer nicht erforderlich; nur beim npm-Weg Version 22 oder höher.
• Konto: Wenn Sie sich anmelden, benötigen Sie Pro, Max, Team, Enterprise oder Console. Mit einem API-Schlüssel sind weder Abonnement noch Anmeldung erforderlich.

Einige türkische Anleitungen im Internet kopieren noch die alte Version dieser Liste: Manche nennen weiterhin Node.js 18 für npm sowie Ubuntu 18.04 oder CentOS 7 für Linux. Die aktuelle Dokumentation nennt Node.js 22 und Ubuntu 20.04 als Mindestversionen. Auch die Warnung „Jeder Schritt schlägt ohne einen festen Proxy mit US-Ausgang fehl“ gilt für die Türkei nicht; im Gegenteil, eine offen konfigurierte VPN-Verbindung kann zu einem Regionsfehler führen (siehe die Downloadfehler im Abschnitt zu macOS und Linux).

Claude-Code-Installation unter Windows

Unter Windows benötigen Sie weder Administratorrechte noch WSL oder Git. Die offizielle Dokumentation verlangt nicht, das Terminal als Administrator zu öffnen; den Schritt „PowerShell als Administrator ausführen“ aus einigen türkischen Videos können Sie überspringen. Sie müssen nur wissen, in welchem Terminal Sie sich befinden:

• Wenn die Eingabeaufforderung mit PS C:\Users\KullaniciAdi> wie PS beginnt, befinden Sie sich in PowerShell: Verwenden Sie die Zeile irm … | iex.
• Wenn PS am Anfang fehlt und nur C:\Users\KullaniciAdi> angezeigt wird, befinden Sie sich in der Eingabeaufforderung: Verwenden Sie die Zeile install.cmd.
• Öffnen Sie den Eintrag „Windows PowerShell (x86)“ im Startmenü nicht. Da es sich um einen 32-Bit-Prozess handelt, wird selbst auf einem 64-Bit-Computer der Fehler Claude Code does not support 32-bit Windows angezeigt; wählen Sie „Windows PowerShell“ ohne den Zusatz.

Das Einfügen der Zeile in das falsche Fenster gehört zu den häufigsten Fehlern unter Windows, und die Meldungen sagen dies nicht ausdrücklich. Eine in PowerShell eingefügte CMD-Zeile endet mit The token '&&' is not a valid statement separator. Eine in CMD eingefügte PowerShell-Zeile meldet unter türkischem Windows „'irm' iç ya da dış komut, çalıştırılabilir program ya da toplu iş dosyası olarak tanınmıyor.“ (auf einem englischen System 'irm' is not recognized as an internal or external command). Wenn Sie die macOS-Zeile curl … | bash in PowerShell ausprobieren, sehen Sie A parameter cannot be found that matches parameter name 'fsSL' oder 'bash' is not recognized as the name of a cmdlet; auf einem türkischen System können diese Texte auf Türkisch erscheinen. In allen drei Fällen ist die Lösung dieselbe: Verwenden Sie die Zeile für das Terminal, in dem Sie sich befinden.

Sind Git for Windows und WSL erforderlich?

İkisi de isteğe bağlı. Git for Windows kuruluysa Claude Code kabuk komutlarını onunla gelen Git Bash'te çalıştırır, değilse PowerShell aracına geçer; belge Git'i öneriyor ama şart koşmuyor. Git kurulu olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenine bash.exe dosyasının tam yolunu verin (belgedeki örnek: C:\Program Files\Git\bin\bash.exe).

Es gibt zwei Gründe, WSL zu wählen: Sie benötigen Linux-Tools oder möchten Befehle in einer Sandbox ausführen. Bei der nativen Windows-Installation gibt es keine Sandbox:

Wenn Sie bei WSL bleiben, führen Sie Installation und Nutzung auch im WSL-Terminal aus: Die macOS-/Linux-Zeile funktioniert dort, und auch claude wird von dort aus gestartet.

Der Befehl „claude“ wurde nicht gefunden

Wenn nach Abschluss der Installation 'claude' is not recognized (unter macOS und Linux command not found: claude) angezeigt wird, arbeiten Sie höchstwahrscheinlich in einem Fenster, das vor der Installation geöffnet wurde: Der Installer aktualisiert die Variable PATH, aber das alte Terminal sieht diese Änderung nicht. Schließen Sie zuerst das Terminal und öffnen Sie es erneut. Unter Windows befindet sich das Programm unter %USERPROFILE%\.local\bin\claude.exe, unter macOS und Linux unter ~/.local/bin/claude. Wenn ein neues Fenster unter Windows ebenfalls nicht hilft, fügen Sie den Ordner mit den Befehlen aus der Dokumentation zu Ihrer Benutzer-PATH-Variable hinzu:

# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Yeni terminalde
claude --version

npm.ps1 konnte nicht geladen werden

Diese Meldung erscheint nur beim npm-Weg: npm schreibt für PowerShell einen .ps1-Launcher, und die Skriptausführungsrichtlinie (Execution Policy) des Systems blockiert ihn. Das Dokument nennt drei Auswege: die Befehle mit den Namen npm.cmd und claude.cmd ausführen, in PowerShell zum nativen Installer wechseln oder nur für Ihren eigenen Benutzer lokale Skripts zulassen:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Installation unter macOS und Linux

Die obige Zeile install.sh steht im offiziellen Dokument auf der Registerkarte „Native Install (Recommended)“ und funktioniert auch unter WSL unverändert. Claude Code lädt neue Versionen bei dieser Installationsart selbstständig im Hintergrund herunter. Wenn Sie lieber einen Paketmanager verwenden, sind Homebrew und WinGet ebenfalls offizielle Optionen; laut Dokument aktualisieren sich diese Installationen jedoch standardmäßig nicht selbst, sondern Sie beziehen die neue Version über den Paketmanager:

# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code

# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCode

Wenn statt des Skripts HTML oder 403 zurückgegeben wird

syntax error near unexpected token '<' mesajı, bash'e betik yerine bir HTML sayfasının gittiğini gösterir; curl: (22) The requested URL returned error: 403 ise sunucunun indirmeyi reddettiğini. Dokument zu Installationsproblemen (kontrol: 3. Oktober 2026) ikisini de yükleyici adresinin betik döndürmemesine bağlıyor. Sayfada App unavailable in region yazıyorsa istek, belgeye göre Claude Code'un sunulmadığı bir ülkeden gelmiş görünüyor. Türkiye listede olduğuna göre bu mesajı Türkiye'den alıyorsanız trafiğiniz büyük ihtimalle bir VPN ya da proxy üzerinden başka bir ülkeye çıkıyordur; kapatıp yeniden deneyin. İçeriksiz bir 403 genellikle şirket proxy'sinden ya da güvenlik duvarından gelir: başka bir ağdan deneyin veya BT ekibinizden bu adrese izin vermesini isteyin.

Installation mit npm: Node.js 22 erforderlich

npm yolu kaldırılmadı, resmi belgede hâlâ anlatılıyor; ama paketin istediği sürüm artık Node.js 22 ve üstü. node -v daha eski bir sürüm gösteriyorsa npm kurulumu durdurmaz, yalnızca bir EBADENGINE uyarısı basar. Yine de en temizi Node.js'i nodejs.org üzerinden 22 veya üstüne yükseltmek.

node -v                                    # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code   # sudo kullanmadan

# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latest

Auf diesem Weg verursachen drei Gewohnheiten Probleme:

• Mit sudo installieren. Das Dokument warnt vor Berechtigungsproblemen und Sicherheitsrisiken bei sudo npm install -g.
• Mit npm update -g aktualisieren. Richtig ist npm install -g @anthropic-ai/claude-code@latest.
• Optionale Abhängigkeiten deaktivieren. Die eigentliche ausführbare Datei wird als optionale Abhängigkeit in einem plattformspezifischen @anthropic-ai/claude-code-*-Paket geliefert. Das Flag --omit=optional oder optional=false in .npmrc überspringt dieses Paket: Die Installation wird ohne Fehler abgeschlossen, aber beim Start von claude wird unter macOS und Linux claude native binary not installed ausgegeben.

Hat die Installation funktioniert?

Unabhängig davon, welchen Weg Sie gewählt haben, öffnen Sie ein neues Terminal und führen Sie diese beiden Befehle aus:

claude --version   # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor      # oturum açmadan kurulum ve ayar teşhisi

Wenn claude --version eine Versionsnummer ausgibt, ist das Programm vorhanden. claude doctor listet dagegen ohne Anmeldung den Installationsstatus und Probleme in den Einstellungsdateien auf; wenn im nächsten Schritt etwas schiefgeht, können Sie damit unterscheiden, ob das Problem bei der Installation oder bei der Konfiguration liegt.

Ohne Abonnement: Claude Code mit einem API-Schlüssel konfigurieren

Beim ersten Start fordert claude eine Authentifizierung an. Wenn Sie einen Claude-Tarif haben, melden Sie sich an und fahren fort; wenn Sie keinen Tarif haben oder statt einer festen monatlichen Gebühr nach Verbrauch zahlen möchten, führen Sie Claude Code mit einem API-Schlüssel aus. Der Unterschied zwischen den beiden Wegen:

Der Schlüsselweg ist eine von Anthropic vorgesehene Konfiguration: ANTHROPIC_BASE_URL ist die integrierte Variable von Claude Code, und das offizielle Gateway-Dokument beschreibt mit dieser Variable, wie Claude Code hinter einem Proxy oder Gateway ausgeführt wird. Sie installieren weder ein Plugin noch einen Patch oder einen modifizierten Client. Fügen Sie unter macOS und Linux die sechs Zeilen zu Ihrer Shell-Datei (~/.zshrc oder ~/.bashrc) hinzu:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # yalnızca alan adı, /v1 yok
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

Testen Sie die Einstellungen unter Windows zunächst in einer einzelnen PowerShell-Sitzung, ohne sie dauerhaft zu speichern; sobald das Fenster geschlossen wird, verschwinden auch die Variablen:

# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$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

Wenn die Einstellungen in jedem Terminal gelten sollen, schreiben Sie dieselben Werte in den env-Block der benutzerweiten Einstellungsdatei. Laut Dokument gilt diese Datei für alle Ihre Projekte; unter Windows befindet sie sich unter %USERPROFILE%\.claude\settings.json. %APPDATA%\Claude\settings.json, das in manchen KI-Zusammenfassungen genannt wird, ist nicht der Pfad im offiziellen Dokument. Wenn die Datei bereits vorhanden ist, löschen Sie ihren Inhalt nicht, sondern 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"
  }
}

Sechs Variablen und wichtige Hinweise

ANTHROPIC_AUTH_TOKEN oder ANTHROPIC_API_KEY? Der Kunavo-Schlüssel wird mit beiden Headern akzeptiert: Authorization: Bearer und x-api-key. Der Unterschied liegt im Verhalten von Claude Code. ANTHROPIC_AUTH_TOKEN wird als Bearer-Header gesendet und funktioniert ohne Rückfrage. ANTHROPIC_API_KEY wird dagegen als x-api-key-Header gesendet und fordert im interaktiven Modus beim ersten Mal Ihre Bestätigung an; wenn Sie diese Frage mit „Nein“ beantworten, wird der Schlüssel ohne Warnung ignoriert. Um ihn wieder zu aktivieren, müssen Sie den Pfad /config → Use custom API key aufrufen. Deshalb verwenden wir in diesem Leitfaden ANTHROPIC_AUTH_TOKEN.

Warum fixieren wir die Modelle? Zum Dokument zur Modellkonfiguration göre (kontrol: 3. Oktober 2026) API ile çalışan Claude Code, hiçbir şey ayarlanmamışsa varsayılan model ve opus takma adı için Opus 5.5'i, sonnet takma adı için Sonnet 5.5'i ister; Anthropic yeni model çıkardıkça bu takma adlar da kayar. Kunavo 3. Oktober 2026 itibarıyla Sonnet 5.5'i sunmuyor, dolayısıyla sabitlenmemiş bir sonnet isteği 404 ile döner. Claude Opus 5.5 Kunavo'da çalışıyor, ama tarifesi ($2,80 / $14,00) Claude Sonnet 5 tarifesinden ($1,40 / $7,00) yüksek; sabitlemezseniz farkında olmadan daha pahalı modelle çalışırsınız. Yukarıdaki blokta ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 satırı bu yüzden var: /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar Sonnet 5.5 yerine Claude Sonnet 5 ile çalışır. opus takma adını ise Claude Opus 5.5 modeline (claude-opus-5-5) sabitliyoruz; bu model Claude Code v2.1.280 veya üstünü ister, eski bir sürümdeyseniz claude update çalıştırın.

Tarife bei Kunavo (Eingabe / Ausgabe pro 1 Million Tokens): Claude Sonnet 5 $1,40 / $7,00 (Anthropic-Tarif: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; für Hintergrundaufgaben Claude Haiku 4.5 $0,70 / $3,50.

Wo wird der Schlüssel nicht eingetragen, und welcher Wert hat Vorrang?

Projenin kendi .claude/settings.json dosyası anahtar için yanlış yer: Gateway-Dokument bu dosyanın depoya commit edildiğini hatırlatıyor, yani anahtar depoyu klonlayan herkese gider. Aynı değişken hem kabukta hem ayar dosyasının env bloğunda tanımlıysa çoğu durumda ayar dosyasındaki geçerli olur; kabukta değiştirdiğiniz bir değer etki etmiyorsa önce oraya bakın. Ayar dosyasındaki model anahtarı bu kuralın dışında: ANTHROPIC_MODEL değişkeni ondan önce gelir, model yalnızca değişken yoksa kullanılır. VS Code eklentisinde değişkenler, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables alanına girer.

Erster Start und Kontrolle mit /status

Wenn die Variablen am richtigen Ort stehen, meldet sich der Befehl claude ohne den Anmeldebildschirm überhaupt anzuzeigen an; das Gateway-Dokument (Prüfung: 3. Oktober 2026) beschreibt dieses Verhalten, wenn ANTHROPIC_AUTH_TOKEN konfiguriert ist. Wenn der Anmeldebildschirm erscheint, hat Claude Code den Schlüssel nicht erkannt. Ein häufiger Grund ist, dass der Schlüssel nur in den Projekteinstellungen steht: Im interaktiven Modus wird der .claude/settings.json-Block in .claude/settings.local.json oder env des Projekts erst nach dem Startassistenten und der Bestätigung des Vertrauens in den Ordner gelesen. Der Schlüssel muss an einem Ort stehen, der vor dem Assistenten gelesen wird: in der Shell unter export, in der benutzerweiten Datei ~/.claude/settings.json oder in verwalteten Einstellungen (managed settings).

Geben Sie nach der Anmeldung /status ein. Zwei Zeilen liefern ausreichende Informationen:

• Anthropic base URL: wird nur angezeigt, wenn eine benutzerdefinierte Adresse festgelegt ist, und muss https://api.kunavo.com lauten. Wenn die Zeile vollständig fehlt, hat ANTHROPIC_BASE_URL die Sitzung nicht erreicht.
• Auth token: Wenn daneben der Name ANTHROPIC_AUTH_TOKEN steht, werden die Anfragen mit dem API-Schlüssel gesendet. Wenn stattdessen eine Zeile Login method angezeigt wird, die auf Ihr claude.ai-Konto verweist, verwendet Claude Code weiterhin die gespeicherte Anmeldung; melden Sie sich ab, öffnen Sie ein neues Terminal und überprüfen Sie, wo Sie die Variablen eingetragen haben.

Testen, ohne Claude Code zu öffnen

Sie können Adresse und Schlüssel auch unabhängig von Claude Code testen. Die Methode aus dem offiziellen Dokument sendet eine Anfrage mit einem Ausgabetoken; von Ihrem Guthaben wird nur ein sehr kleiner Betrag abgezogen. Der Befehl liest die Variablen aus der aktuellen Shell. Wenn der Schlüssel nur in der Einstellungsdatei steht, führen Sie zuvor in diesem Terminal export aus. Wenn die Antwort mit {"id":"msg_ beginnt, sind Adresse und Schlüssel gültig; 401 zeigt an, dass der Schlüssel abgelehnt wurde.

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

Das PowerShell-Gegenstück folgt unten; bei Erfolg enthält die Antwort ein id-Feld, das mit msg_ beginnt:

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

Was ändert sich bei Verwendung eines API-Schlüssels?

• Remote Control und Spracheingabe sind nicht verfügbar. Laut Dokument erfordern beide eine claude.ai-Identität und funktionieren nicht, wenn ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN oder ein apiKeyHelper aktiv ist. Seit v2.1.196 ist Remote Control außerdem deaktiviert, wenn ANTHROPIC_BASE_URL auf einen anderen Server als Anthropic verweist.
• /fast wird als deaktiviert angezeigt. Laut Dokument fragt Claude Code den Status des Schnellmodus (fast mode) nicht ab und nimmt ihn als deaktiviert an, wenn nur ein Bearer-Token konfiguriert ist.
• Die Suche nach MCP-Tools ist standardmäßig deaktiviert. MCP-Dokumentation (kontrol: 3. Oktober 2026) özel bir ANTHROPIC_BASE_URL ayarını, tool search kullanılmayan yapılandırmalar arasında sayıyor.
• Die Zahlen von /context sind Näherungswerte. Kunavo /v1/messages/count_tokens uç noktasını sunmuyor; bu durumda Claude Code, Zur Dokumentation zur Gateway-Kompatibilität göre (kontrol: 3. Oktober 2026) bağlam kullanımını karakter sayısından tahmin eder.

Die technischen Details der Integration stehen im englischen Claude-Code-Integrationsdokument; die englische Entsprechung dieses Leitfadens ist Install Claude Code.

Zahlung aus der Türkei: Karte, Apple Pay, Google Pay, Link

Burada ödediğiniz şey bir abonelik değil, Claude Code'un token başına harcadığı ön ödemeli API bakiyesi. Anthropic'in sitesinden alınan Pro ve Max ise yalnızca kredi veya banka kartıyla ödenebiliyor (FAQ zu kostenpflichtigen Claude-Tarifen, kontrol: 3. Oktober 2026). Kunavo'ya yaptığınız yükleme bu planların yerine geçmez ve onları ödemez. Adımlar:

1. Bei Kunavo registrieren. Eine E-Mail-Adresse oder ein Google-Konto genügt; bei der Registrierung werden keine Kartendaten abgefragt.
2. Wählen Sie auf der Seite Billing den Betrag aus. Mindestbetrag 10 USD; kein Abonnement und keine monatliche Gebühr. Bei höheren Beträgen wird ein Bonus hinzugefügt: 100 USD yükleyene 110 USD bakiye, 1.000 USD yükleyene 1.200 USD bakiye, 5.000 USD yükleyene 6.250 USD bakiye.
3. Die Stripe-Zahlungsseite wird geöffnet. Wählen Sie Karte (Visa, Mastercard), Apple Pay, Google Pay oder Link; Apple Pay und Google Pay werden nur auf Geräten und in Browsern aufgeführt, die diese unterstützen.
4. Erstellen Sie anschließend auf der Seite API Keys einen Schlüssel, der mit sk-kn- beginnt. Der Schlüssel wird nur einmal angezeigt; kopieren Sie ihn und tragen Sie ihn sofort als Wert von ANTHROPIC_AUTH_TOKEN ein.

Wird der Betrag in TL oder in Dollar angezeigt?

Kunavo fiyatları dolar cinsinden; ödeme sayfasında hangi para biriminin gösterileceğine Stripe karar verir ve tutar TL olarak da çıkabilir. Stripe-Dokumentation zu Adaptive Pricing (kontrol: 3. Oktober 2026) Türkiye'yi desteklenen pazarlar arasında sayıyor ve bu çevrimde kura %2–4 arası, alıcının ödediği bir ücret eklendiğini yazıyor. Dolarla ödemeyi seçerseniz bu ücret olmaz; o zaman kartınızın bankası kendi döviz kurunu ve varsa yurt dışı işlem ücretini uygular. Para birimi hangisi olursa olsun, kesin tutarı onaylamadan önce ödeme sayfasında görürsünüz.

Ratenzahlung, Papara, Banküberweisung und Troy

• Keine Ratenzahlung, die Zahlung erfolgt in einer Summe. Türk kartlarıyla yurt dışı sitelerden yapılan harcamalar sonradan da taksite bölünemiyor (enuygunfinans.com, kontrol: 3. Oktober 2026).
• Papara, Banküberweisung/EFT und PayPal sind nicht verfügbar. Diese Optionen erscheinen auf der Zahlungsseite nicht.
• Troy: Stripe'ın unterstützte Kartenmarken sayfasında Troy geçmiyor (kontrol: 3. Oktober 2026). Visa ya da Mastercard logolu bir kartla ödeyin.
• Keine Rechnung. Kunavo stellt keinerlei Rechnung aus, auch keine e-Arşiv-Rechnung; eine Aufstellung Ihrer Aufladungen finden Sie auf der Billing-Seite.

Wenn die Karte abgelehnt wird, prüfen Sie zuerst die mobile App Ihrer Bank: Die Karte muss für Onlinekäufe und internationale Transaktionen freigeschaltet sein. Automatisches Aufladen kann nur mit einer gespeicherten Karte oder Link eingerichtet werden. Das Guthaben hat kein Ablaufdatum, und fehlgeschlagene Anfragen werden nicht berechnet. Die Tarife aller Modelle finden Sie im Leitfaden Claude-API-Preise.

Was kostet eine Arbeitssitzung?

Beim Schlüsselweg hängen die Kosten vollständig von der Token-Anzahl ab. Claude Code sendet bei jeder Anfrage den Kontext des Gesprächs erneut; wenn der unveränderte Anfang des Kontexts aus dem Cache gelesen wird, wird er jedoch zu einem deutlich niedrigeren Tarif berechnet. Die folgende Tabelle ist keine Messung, sondern eine Berechnung mit ausdrücklich genannten Annahmen; sie sollte auch nicht als Obergrenze verstanden werden. Annahmen:

• 40.000 Eingabetokens pro Anfrage; davon werden 36.000 (%90) aus dem Cache gelesen, die verbleibenden 4.000 werden in den Cache geschrieben;
• 1.000 Ausgabetokens pro Anfrage;
• 50 Anfragen in der Sitzung; die Claude Haiku 4.5-Aufrufe im Hintergrund wurden nicht berücksichtigt;
• Für Claude Sonnet 5 beträgt das Lesen aus dem Cache %10 des Eingabetarifs, das Schreiben in den Cache das 1,25-Fache. Für jedes Modell in der Tabelle wurde mit den jeweiligen Tarifen gerechnet.

Gerçek tutarı bağlamın uzunluğu, önbellek isabeti, yanıtların uzunluğu ve konu değiştirirken sohbeti temizleyip temizlemediğiniz belirler. Offizielle Kostendokumentation (kontrol: 3. Oktober 2026) iki ayrıntı ekliyor: Claude Code siz bir şey yazmasanız da arka planda az miktarda token harcar, genellikle oturum başına 0,04 dolardan az; API anahtarında önbellek ömrü varsayılan olarak beş dakika, dolayısıyla daha uzun bir aradan sonraki ilk mesaj önbelleği ıskalar ve bağlamın tamamı yeniden işlenir. Konu değiştirirken /clear, uzun oturumlarda /compact bu maliyeti düşürür.

Alle Tarife finden Sie auf der Preisseite. Ihre eigene Nutzung können Sie mit dem Claude-Token-Kostenrechner (auf Englisch) schätzen. Die Frage, ob ein Abonnement oder die API günstiger ist, behandelt der Leitfaden Claude-Code-Preis.

Fehlermeldungen und Lösungen

Wichtige Einschränkungen

• Kunavo stellt keine Rechnung aus; auch e-Arşiv ist nicht verfügbar.
• Die Zahlung erfolgt in einer Summe: keine Ratenzahlung, kein Papara und keine Banküberweisung/EFT. Für automatisches Aufladen ist eine gespeicherte Karte oder Link erforderlich.
• Dies ist kein Claude-Pro- oder Max-Abonnement, sondern eine API, die pro Token abgerechnet wird. Beim Schlüsselweg funktionieren Remote Control und Spracheingabe nicht, /fast wird als deaktiviert angezeigt, und die Suche nach MCP-Tools ist standardmäßig deaktiviert.
• Kunavo bietet Sonnet 5.5 ab 3. Oktober 2026 nicht an; wenn die Modelle nicht fixiert werden, gibt der Alias sonnet 404 zurück.
• Die offiziellen Dokumente von Claude Code und das Kunavo-Integrationsdokument sind nur auf Englisch verfügbar (Prüfung: 3. Oktober 2026).

Häufig gestellte Fragen