Zurück zu den Leitfäden
Installation·3. Oktober 2026·14 Min. Lesezeit

Claude Code installieren: offizielle Befehle für Windows, macOS und Linux, API-Schlüssel ohne Abonnement, /status prüfen und mit Karte oder Link bezahlen

Claude Code ist mit einem offiziellen Befehl installiert. Häufiger problematisch sind die Schritte danach: unter Windows das richtige Terminal auswählen, die Node.js-Version bei der Installation über npm beachten, den API-Schlüssel ohne Anmeldung einrichten und aus Indonesien ohne QRIS oder E-Wallet bezahlen.

Kurz gesagt: Installieren Sie Claude Code mit einem offiziellen Befehl (wählen Sie unten die Zeile für macOS/Linux, PowerShell oder CMD), und verbinden Sie es anschließend über einen API-Key statt über eine Anmeldung. Dafür genügen sechs Variablen: ANTHROPIC_BASE_URL=https://api.kunavo.com (ohne /v1), ANTHROPIC_AUTH_TOKEN mit dem Key sowie vier Variablen, die das Modell festlegen. Prüfen Sie das Ergebnis mit /status. Ein Pro- oder Max-Abonnement ist nicht erforderlich; Sie bezahlen die tatsächlich verwendeten Tokens aus einem Prepaid-Guthaben ab $10, das Sie mit einer Karte (Visa, Mastercard usw.) oder Link aufladen. QRIS, GoPay, OVO und DANA sind nicht verfügbar.

Terminal
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Semua perintah dan nama variabel di sini kami samakan dengan dokumentasi resmi Claude Code pada 3. Oktober 2026. Dokumentasi itu sudah ada dalam bahasa Indonesia, termasuk Installationsseite dan Seite zur Verbindung mit dem LLM-Gateway, jadi Anda bisa mencocokkan sendiri. Harga dan metode pembayaran Kunavo dicek 3. Oktober 2026.

Sechs Schritte von null bis zum laufenden Claude Code

  1. Stellen Sie sicher, dass Ihr Laptop die Voraussetzungen erfüllt, und entscheiden Sie: Claude-Konto anmelden oder API-Key verwenden.
  2. Führen Sie den nativen Installer passend zu Ihrem Terminal aus.
  3. Öffnen Sie ein neues Terminal, prüfen Sie claude --version und korrigieren Sie bei Bedarf PATH.
  4. Richten Sie den API-Key ein und legen Sie das Modell fest.
  5. Öffnen Sie die erste Sitzung und stellen Sie mit /status sicher, dass Ihr Key verwendet wird.
  6. Laden Sie das Guthaben mit einer Karte oder Link auf und beginnen Sie mit der Arbeit.

Schritt 1: Voraussetzungen prüfen und Anmeldung oder API-Key auswählen

Was geprüft wirdOffizielle Voraussetzungen (geprüft 3. Oktober 2026)
BetriebssystemmacOS 13.0+; Windows 10 Version 1809+ oder Windows Server 2019+; Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+
HardwareMindestens 4 GB RAM; x64- oder ARM64-Prozessor. 32-Bit-Windows wird nicht unterstützt.
TerminalBash, Zsh, PowerShell oder CMD
Node.jsFür den nativen Installer nicht erforderlich. Nur bei Verwendung von npm und dann in Version 22 oder höher.
LandTermasuk daftar Von Anthropic unterstützte Länder. Indonesia ada di daftar itu, untuk Claude.ai maupun API.

Setelah terinstal, Claude Code harus tahu siapa yang membayar. Jalan pertama adalah login akun Claude, yang mensyaratkan paket Pro, Max, Team, Enterprise, atau akun Console; paket gratis Claude.ai tidak mencakup Claude Code. Menurut Claude-Preisseite (dicek 3. Oktober 2026), Pro berharga $20 per bulan, atau $17 per bulan kalau dibayar tahunan ($200 di muka), Max mulai $100 per bulan, dan semua harga belum termasuk pajak. Untuk langganan yang dibeli lewat web, Anthropic hanya menerima kartu kredit atau debit; langganan dari aplikasi iOS atau Android dibayar lewat App Store atau Google Play (Claude-Abrechnungs-FAQ, dicek 3. Oktober 2026). Cara login dijelaskan di Offizielle Authentifizierungsseite.

Der zweite Weg, der in diesem Leitfaden vollständig behandelt wird, ist der API-Key: ohne Abonnement und ohne Anmeldebildschirm. Sie bezahlen pro tatsächlich verwendetem Token, sodass die Kosten in einem ruhigen Monat entsprechend niedrig bleiben. Es fehlen nur zwei kontogebundene Funktionen von claude.ai: Remote Control und Sprachdik­tat; eine vollständige Liste der Unterschiede finden Sie in Schritt 5.

Baru pertama kali membuka terminal? Anthropic menyediakan Terminalleitfaden auf Indonesisch untuk pemula.

Schritt 2: Installer ausführen

macOS, Linux und WSL

Fügen Sie die Zeile install.sh am Anfang dieser Seite in Terminal ein, drücken Sie die Eingabetaste und warten Sie, bis der Vorgang abgeschlossen ist. Das Skript wird direkt von claude.ai geladen, installiert das Programm unter ~/.local/bin/claude und aktualisiert Claude Code von da an automatisch im Hintergrund. In der offiziellen Dokumentation ist diese Methode als „Empfohlen“ gekennzeichnet.

Windows: Ermitteln Sie zunächst Ihr Terminal

Viele ältere Anleitungen empfehlen, PowerShell mit „Run as Administrator“ zu öffnen und zuerst WSL zu installieren. Beides ist nicht erforderlich: Die offizielle Dokumentation auf Indonesisch besagt, dass die Installation unter Windows in einem normalen Terminal ohne Administratorrechte ausgeführt wird und WSL lediglich eine Option ist. Welche Befehlszeile verwendet wird, erkennen Sie am Prompt:

  • Der Prompt PS C:\Users\NamaAnda> bedeutet PowerShell. Verwenden Sie die Zeile irm … | iex.
  • Ein Prompt C:\Users\NamaAnda> ohne PS bedeutet Command Prompt (CMD). Verwenden Sie die Zeile install.cmd.
  • Wählen Sie im Startmenü „Windows PowerShell“, nicht „Windows PowerShell (x86)“. Die x86-Version läuft mit 32 Bit und endet mit Claude Code does not support 32-bit Windows, auch wenn der Laptop 64-Bit-fähig ist.

Ein im falschen Terminal ausgeführter Befehl ist sofort an seiner Meldung erkennbar, zum Beispiel The token '&&' is not a valid statement separator (CMD-Zeile in PowerShell) oder 'irm' is not recognized as an internal or external command (PowerShell-Zeile in CMD). Unter einem indonesischen Windows können die Meldungen übersetzt angezeigt werden. Die vollständige Liste finden Sie in der Fehlertabelle weiter unten.

Git tidak wajib. Kalau Git for Windows terpasang, tool Bash Claude Code memakai Git Bash; kalau tidak, perintah dijalankan lewat PowerShell. Bila Git sudah ada tetapi Git Bash tidak ditemukan, isi CLAUDE_CODE_GIT_BASH_PATH di blok env ~/.claude/settings.json dengan lokasi bash.exe, misalnya C:\Program Files\Git\bin\bash.exe. Kapan WSL layak dipakai:

UmgebungVorbereitungSandboxingGeeignet für
Direktes WindowsKeine (Git for Windows optional)NeinProjekte, die tatsächlich unter Windows bearbeitet werden
WSL 2WSL 2 ist bereits aktiviertJaProjekte, die Linux-Tools oder isoliert ausgeführte Befehle benötigen
WSL 1WSL 1 ist bereits aktiviertNeinNur wenn WSL 2 nicht verwendet werden kann

WSL gewählt? Führen Sie die Zeile install.sh im WSL-Terminal aus und öffnen Sie claude anschließend ebenfalls immer in diesem WSL-Terminal.

Alternativen: Homebrew, WinGet oder npm

Homebrew und WinGet sind ebenfalls offiziell, aktualisieren sich laut Dokumentation jedoch standardmäßig nicht automatisch. Sie müssen sie selbst aktualisieren:

# macOS lewat Homebrew (tidak update otomatis; perbarui dengan brew upgrade)
brew install --cask claude-code

# Windows lewat WinGet (tidak update otomatis; perbarui dengan winget upgrade)
winget install Anthropic.ClaudeCode

npm masih didokumentasikan, dengan syarat Node.js 22 oder höher (unduh dari nodejs.org). Di Node.js lama npm hanya memberi peringatan EBADENGINE dan tetap memasang, karena paket ini sebenarnya mengunduh program native yang tidak bergantung pada Node.js saat berjalan.

Terminal
node -v                                    # harus v22 ke atas
npm install -g @anthropic-ai/claude-code   # jangan pakai sudo

# memperbarui ke versi terbaru
npm install -g @anthropic-ai/claude-code@latest

Drei Gewohnheiten, die npm-Installationen beschädigen: Verwendung von sudo npm install -g (in der Dokumentation als Quelle für Berechtigungsprobleme und Sicherheitsrisiken bezeichnet), Aktualisierung mit npm update -g statt mit @latest sowie Deaktivierung optionaler Abhängigkeiten über --omit=optional oder optional=false in .npmrc. Letzteres verhindert, dass das Paket @anthropic-ai/claude-code-* für Ihre Plattform heruntergeladen wird, sodass claude unter macOS oder Linux mit claude native binary not installed antwortet.

In PowerShell bleibt npm manchmal bei npm.ps1 cannot be loaded because running scripts is disabled on this system hängen. Dabei blockiert die Execution Policy das Skript .ps1. Die Dokumentation nennt drei Lösungen: Erlauben Sie lokale Skripte für Ihren Benutzer mit dem untenstehenden Befehl, rufen Sie npm.cmd und claude.cmd auf oder verzichten Sie auf npm und verwenden Sie den nativen Installer.

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Noch eine Warnung: Ignorieren Sie in Anleitungen verbreitete Installer .exe von Drittanbietern, insbesondere solche, die Administratorrechte verlangen. Der offizielle Befehl oben genügt.

Schritt 3: Sicherstellen, dass Claude Code installiert ist

Schließen Sie das Terminal, in dem Sie die Installation durchgeführt haben, und öffnen Sie ein neues. Das alte Fenster verwendet noch den PATH vor der Installation, daher wird claude dort häufig noch nicht erkannt. Im neuen Terminal:

Neues Terminal
claude --version   # muncul nomor versi = instalasi berhasil
claude doctor      # cek instalasi dan file pengaturan tanpa membuka sesi

claude doctor hilft dabei, zwei Arten von Problemen zu unterscheiden: Wenn der Bericht sauber ist, Claude Code aber weiterhin keine Verbindung herstellt, liegt die Ursache in der Konfiguration (Schritt 4) und nicht in der Installation.

Immer noch command not found: claude oder 'claude' is not recognized? Der Installationsordner ist noch nicht in PATH enthalten. Unter macOS und Linux ist dieser Ordner ~/.local/bin, unter Windows %USERPROFILE%\.local\bin. Für Windows stellt die Dokumentation den folgenden PowerShell-Befehl bereit:

PowerShell
# Ada hasilnya? Berarti PATH sudah benar, cukup buka terminal baru.
$env:PATH -split ';' | Select-String '\.local\\bin'

# Tidak ada hasil? Tambahkan folder instalasi ke PATH user:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# Tutup PowerShell, buka lagi, lalu:
claude --version

Kalau unduhan sudah gagal sejak awal, perhatikan pesannya. Menurut Seite zur Fehlerbehebung bei der Installation (dicek 3. Oktober 2026), syntax error near unexpected token '<' atau curl: (22) The requested URL returned error: 403 berarti yang terunduh adalah halaman HTML atau kode error, bukan skrip. Tulisan App unavailable in region berarti koneksi Anda terlihat berasal dari negara yang tidak didukung; karena Indonesia didukung, tersangka utamanya VPN atau proxy. 403 tanpa isi juga sering datang dari proxy kantor atau firewall kampus. Homebrew, WinGet, dan npm mengambil dari host yang sama, jadi coba jaringan lain atau minta admin jaringan membuka aksesnya sebelum berganti metode.

Schritt 4: API-Key ohne Abonnement einrichten

Claude Code verfügt über die integrierte Variable ANTHROPIC_BASE_URL, um Requests an ein anderes Gateway als Anthropic zu senden, und die offizielle Dokumentation enthält dafür eine eigene Seite. Dies ist daher eine unterstützte Konfiguration, keine Modifikation oder ein Plugin. Besorgen Sie zunächst den Key sk-kn-… (siehe Schritt 6 für Erstellung und Aufladung des Guthabens) und wählen Sie anschließend einen Speicherort.

macOS und Linux: Fügen Sie diese sechs Zeilen am Ende von ~/.zshrc (Zsh, standardmäßig unter macOS) oder ~/.bashrc ein, speichern Sie die Datei und öffnen Sie ein neues Terminal.

~/.zshrc oder ~/.bashrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # domain saja, tanpa /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

Windows, zunächst zum Ausprobieren: Setzen Sie die Variablen in einem PowerShell-Fenster und führen Sie anschließend direkt claude aus.

PowerShell
# Untuk uji coba: hanya berlaku sampai jendela PowerShell ini ditutup
$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

Alle Betriebssysteme, dauerhaft: Fügen Sie sie im Block env der Benutzereinstellungsdatei ~/.claude/settings.json ein (Windows: %USERPROFILE%\.claude\settings.json). Dies gilt für alle Projekte. Wenn die Datei bereits Inhalt hat, fügen Sie nur den Block env ein, ohne andere Einstellungen zu überschreiben.

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Was bei den sechs Variablen zu beachten ist:

VariableInhaltHäufiger Fehler
ANTHROPIC_BASE_URLhttps://api.kunavo.com/v1 hinzufügen. Claude Code ergänzt /v1/messages selbst, sodass /v1/v1/messages und ein 404-Fehler entstehen.
ANTHROPIC_AUTH_TOKENSchlüssel sk-kn-…Kunavo akzeptiert den Key sowohl aus dem Header Authorization: Bearer als auch aus x-api-key, daher ist auch ANTHROPIC_API_KEY möglich. Der Unterschied liegt auf Seiten von Claude Code: ANTHROPIC_AUTH_TOKEN wird sofort aktiviert, während ANTHROPIC_API_KEY im interaktiven Modus einmalig auf eine Zustimmung wartet. Wenn der Key zuvor abgelehnt wurde, wird er stillschweigend ignoriert, bis Sie ihn unter /config → Use custom API key erneut aktivieren.
ANTHROPIC_MODELclaude-sonnet-5 (Claude Sonnet 5)Eine veraltete Modell-ID mit Datumsendung eintragen. Der Name muss exakt dem Eintrag in der Kunavo-Modellliste entsprechen.
ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-5-5 (Claude Opus 5.5)Nicht gesetzt, sodass der Alias opus zum neuesten Anthropic-Modell wechselt. Claude Opus 5.5 erfordert Claude Code v2.1.280 oder neuer; ältere Versionen werden mit claude update aktualisiert.
ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-5 (Claude Sonnet 5)Nicht gesetzt, sodass der Alias sonnet Sonnet 5.5 anfordert, das bei Kunavo nicht verfügbar ist: /model sonnet, die Ausführungsphase opusplan und Subagents mit model: sonnet erhalten einen 404-Fehler.
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5 (Claude Haiku 4.5)Vergessen, dass diese Variable auch das Modell für Hintergrundaufgaben auswählt und nicht nur den Alias haiku.

Kenapa model dikunci? Menurut Dokumentation zur Modellkonfiguration (dicek 3. Oktober 2026), untuk pengguna API model default dan alias opus saat ini menunjuk Opus 5.5, dan alias sonnet menunjuk Sonnet 5.5. Alias itu bergeser setiap kali ada rilis baru. Per 3. Oktober 2026 Sonnet 5.5 belum tersedia di Kunavo, dan model berikutnya belum tentu langsung tersedia; request ke model yang tidak ada dijawab 404. Karena itu blok di atas juga mengunci alias sonnet dengan ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: tanpa pin itu, /model sonnet, fase eksekusi opusplan, dan subagent bermodel sonnet berakhir 404. Alias opus dikunci ke Claude Opus 5.5 (claude-opus-5-5), yang butuh Claude Code v2.1.280 atau lebih baru; kalau versi Anda lebih lama, jalankan claude update.

Kunavo-Preis pro 1 Million Tokens (Input / Output): Claude Sonnet 5 $1,40 / $7,00 (Anthropic-Listenpreis: $2,00 / $10,00), Claude Opus 5.5 $2,80 / $14,00 und Claude Haiku 4.5 $0,70 / $3,50.

Dua jebakan lain. Pertama, key jangan pernah masuk ke .claude/settings.json milik proyek: menurut Gateway-Dokumentation, file itu di-commit dan ikut ter-clone oleh siapa pun yang mengambil repositori. Kedua, kalau variabel yang sama ada di shell dan di blok env file pengaturan, umumnya nilai dari file pengaturan yang menang; jadi kalau perubahan di ~/.zshrc seperti tidak berefek, periksa file pengaturan. Pengguna ekstensi VS Code mengisi variabel yang sama di claudeCode.environmentVariables pada user settings VS Code.

Schritt 5: Erste Sitzung öffnen und /status prüfen

Wechseln Sie in den Projektordner und geben Sie claude ein. Wenn der Key erkannt wurde, wird die Sitzung direkt ohne Anmeldebildschirm geöffnet. Ein angezeigter Anmeldebildschirm bedeutet, dass der Key nicht angekommen ist. Die häufigste Ursache: Der Key befindet sich nur in .claude/settings.json oder .claude/settings.local.json des Projekts. Im interaktiven Modus wird der Block env aus der Projektdatei erst nach dem anfänglichen Assistenten und der Frage, ob diesem Ordner vertraut wird, gelesen; beim ersten Start fordert Claude Code daher weiterhin eine Anmeldung an. Verschieben Sie den Key in die Shell oder nach ~/.claude/settings.json.

Geben Sie nach dem Öffnen der Sitzung /status ein. Die Konfiguration ist korrekt, wenn:

  • eine Zeile Anthropic base URL mit https://api.kunavo.com vorhanden ist (diese Zeile erscheint nur, wenn das Gateway konfiguriert ist; fehlt sie, wurde ANTHROPIC_BASE_URL nicht erkannt), und
  • eine Zeile Auth token mit ANTHROPIC_AUTH_TOKEN vorhanden ist. Wenn Login method mit einem claude.ai-Konto angezeigt wird, verwendet Claude Code weiterhin die alte Anmeldung.

Möchten Sie den Key testen, bevor Sie Claude Code öffnen? Die offizielle Dokumentation verwendet einen Request, der nur 1 Output-Token anfordert, sodass nur ein sehr kleiner Betrag vom Guthaben abgezogen wird. Der Befehl liest die Variablen aus der aktuell aktiven Shell; wenn Ihr Key in einer Einstellungsdatei gespeichert ist, führen Sie zunächst export in diesem Terminal aus. Ein Ergebnis, das mit {"id":"msg_ beginnt, bedeutet Erfolg, 401 bedeutet, dass der Key abgelehnt wurde.

Terminal
curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Die PowerShell-Version; erfolgreich, wenn das Feld id in der Antwort mit msg_ beginnt:

PowerShell
Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Einige Dinge funktionieren anders, wenn Claude Code einen API-Key und ein Gateway verwendet:

FunktionMit Kunavo-API-KeyQuelle (geprüft 3. Oktober 2026)
Remote Control, SprachdiktatNicht verfügbar. Beide benötigen eine claude.ai-Identität, und Remote Control ist ebenfalls deaktiviert, wenn ANTHROPIC_BASE_URL kein Anthropic-Host ist.Gateway-Dokumentation
/fastAls deaktiviert angezeigt; mit einem reinen Bearer-Token fragt Claude Code nicht nach der Verfügbarkeit.Gateway-Dokumentation
MCP-ToolsucheStandardmäßig deaktiviert, daher werden MCP-Tools zu Beginn der Sitzung geladen; dies kann mit ENABLE_TOOL_SEARCH geändert werden.MCP-Dokumentation
Zahl unter /contextEine Schätzung auf Grundlage der Zeichenanzahl, da Kunavo /v1/messages/count_tokens nicht bereitstellt.Kompatibilitätsleitfaden für Gateways
Dollar unter /usageLokal anhand der Tokenanzahl mit der Anthropic-Listenpreisliste berechnet (außer der Organisationsadministrator hat eine modelPricing-Tabelle eingerichtet). Tatsächlich verringert sich das Kunavo-Guthaben auf der Billing-Seite.Kostendokumentation

Schritt 6: Guthaben mit Karte oder Link aufladen (ohne QRIS, GoPay, OVO, DANA)

Bei Kunavo bezahlen Sie ein Prepaid-API-Guthaben, kein Abonnement. Dieses Guthaben wird von Claude Code nach Einrichtung des Keys pro Token belastet. Die Reihenfolge:

  1. Erstellen Sie ein Kunavo-Konto mit einer E-Mail-Adresse oder einem Google-Konto. Bei der Registrierung wird keine Karte verlangt.
  2. Öffnen Sie Billing und wählen Sie einen Betrag. Mindestens $10, ohne monatliche Gebühren. Höhere Beträge können einen Guthabenbonus enthalten: bayar $100 → saldo $110, bayar $1.000 → saldo $1.200, bayar $5.000 → saldo $6.250.
  3. Di checkout Stripe, bayar dengan kartu (Visa, Mastercard, dll.), Link, atau Apple Pay/Google Pay kalau perangkat dan browser Anda sudah menyiapkannya. Link menyimpan data pembayaran sehingga top-up berikutnya cukup beberapa klik.
  4. Öffnen Sie API Keys und erstellen Sie einen Key. Ein Key mit dem Präfix sk-kn- wird nur einmal angezeigt; kopieren Sie ihn daher sofort nach ANTHROPIC_AUTH_TOKEN.

QRIS, GoPay, OVO, DANA, ShopeePay, virtuelle Konten und Banküberweisungen sind nicht verfügbar. Ohne eine Karte, die internationale Online-Transaktionen unterstützt, können Sie Kunavo derzeit nicht aufladen. Auch Debitkarten mit Visa- oder Mastercard-Logo gelten als Karten; wenn sie abgelehnt werden, sind Online- oder Auslandstransaktionen meist noch nicht in der Banking-App aktiviert, und die endgültige Entscheidung trifft die kartenausgebende Bank.

Harga Kunavo dalam USD. Kalau checkout menampilkan rupiah, kursnya ditentukan Stripe dan sudah memuat biaya konversi 2–4% yang ditanggung pembeli (Dokumentation zu Stripe Adaptive Pricing, dicek 3. Oktober 2026). Memilih bayar dalam USD menghindari biaya itu, meski kurs dan biaya dari bank Anda sendiri tetap berlaku.

Das Guthaben verfällt nie, und fehlgeschlagene Requests mindern es nicht. Automatische Aufladungen funktionieren nur mit einer gespeicherten Karte oder Link. Kunavo stellt keine Steuerdokumente aus. Dieses Guthaben kann auch nicht zur Bezahlung von Claude Pro oder Max verwendet werden. Eine Übersicht der Preise aller Claude-Modelle und der Zahlungsmethode aus Indonesien finden Sie unter Claude-API-Preise; einen Vergleich von Abonnement und API-Key speziell für Claude Code finden Sie unter Claude-Code-Preise.

Wie viel wird ungefähr verbraucht?

Jeder Claude-Code-Request sendet den Gesprächskontext erneut, aber derselbe Anfang jedes Requests wird zum deutlich günstigeren Cache-Lesetarif berechnet. Die folgende Berechnung ist reine Token-Arithmetik auf Grundlage der angegebenen Annahmen, kein Messergebnis und keine Obergrenze:

  • Eine Anfrage = 40.000 Eingabetoken; 36.000 (90 %) werden aus dem Cache gelesen, die übrigen 4.000 werden in den Cache geschrieben;
  • ein Request erzeugt 1.000 Output-Tokens;
  • eine Sitzung = 50 Requests, ohne Hintergrundaufrufe von Claude Haiku 4.5;
  • Cache-Lesen kostet 10% und Cache-Schreiben 1,25× des Input-Tarifs (Anteil Claude Sonnet 5 bei Kunavo; jedes Modell in der Tabelle verwendet seinen eigenen Anteil).
ModellPro RequestEine Sitzung (50 Requests)Eine Sitzung ohne Cache-Nutzung
Claude Sonnet 5$0,019$0,95$3,15
Claude Opus 5.5$0,033$1,65$6,30

Ihre tatsächlichen Werte schwanken je nach Kontextlänge, Cache-Trefferrate, Antwortlänge und danach, ob die Unterhaltung beim Wechsel der Aufgabe mit /clear geleert wird. Hintergrundprozesse von Claude Code liegen laut der Anthropic-Kostendokumentation normalerweise unter 0,04 $ pro Sitzung (geprüft 3. Oktober 2026). Die vollständigen Preise finden Sie auf der Preisseite; um Ihr eigenes Nutzungsmuster zu schätzen, steht außerdem ein Claude-Tokenkostenrechner (auf Englisch) zur Verfügung.

Claude Code im Alltag verwenden

Terminal
cd ~/proyek-saya   # Claude Code bekerja di folder tempat ia dijalankan
claude              # mulai sesi
claude -c           # lanjutkan percakapan terakhir di folder ini
  • Formulieren Sie Ihre Anfrage in normaler Sprache, zum Beispiel „Erkläre die Struktur dieses Projekts“ oder „Behebe den Fehler auf der Anmeldeseite“. Claude Code liest Dateien und fragt nach einer Berechtigung, bevor es etwas ändert oder ausführt.
  • /clear beim Aufgabenwechsel: Der alte Verlauf wird nicht erneut gesendet, daher sinkt die Tokenanzahl pro Request.
  • /model zum Wechseln des Modells. Mit der Festlegung aus Schritt 4 gilt: opus = claude-opus-5-5, sonnet = claude-sonnet-5 und haiku = claude-haiku-4-5.
  • /status zum Prüfen von Gateway und Key; /usage zur Kostenschätzung (mit Listenpreisen, siehe Tabelle in Schritt 5).

Fehlermeldungen und ihre Bedeutung

MeldungBedeutung und erforderliche Maßnahme
The token '&&' is not a valid statement separatorEine CMD-Zeile wurde in PowerShell ausgeführt. Verwenden Sie irm … | iex.
'irm' is not recognized as an internal or external commandEine PowerShell-Zeile wurde in CMD ausgeführt. Verwenden Sie die Zeile install.cmd.
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdletEine macOS/Linux-Zeile wurde in PowerShell ausgeführt. Verwenden Sie die PowerShell-Zeile.
Claude Code does not support 32-bit Windows„Windows PowerShell (x86)“ wurde geöffnet. Öffnen Sie das normale „Windows PowerShell“.
syntax error near unexpected token '<', 403Heruntergeladen wurden eine HTML-Seite oder ein Fehlercode. Prüfen Sie VPN, Proxy und Firewall; andere Methoden verwenden denselben Host.
command not found: claude, 'claude' is not recognizedPATH enthält den Installationsordner noch nicht. Öffnen Sie ein neues Terminal; führen Sie unter Windows den PATH-Befehl aus Schritt 3 aus.
EBADENGINE (Warnung)Node.js ist älter als Version 22. Die Installation läuft trotzdem, aber aktualisieren Sie Node.js.
claude native binary not installed (macOS, Linux)npm überspringt optionale Abhängigkeiten (--omit=optional, optional=false) oder Installationsskripte (--ignore-scripts). Entfernen Sie diese Einstellungen und installieren Sie erneut.
npm.ps1 cannot be loadedPowerShell-Execution-Policy. Führen Sie Set-ExecutionPolicy aus Schritt 2 aus oder verwenden Sie den nativen Installer.
Der Anmeldebildschirm erscheint weiterhinDer Key wurde nicht erkannt. Speichern Sie ihn in der Shell oder unter ~/.claude/settings.json, nicht nur in den Projekteinstellungen, und öffnen Sie ein neues Terminal.
401Der Key wurde abgelehnt. Prüfen Sie, ob der Key sk-kn- vollständig und ohne Leerzeichen kopiert wurde, nicht unter /app/keys gelöscht wurde und sich in ANTHROPIC_AUTH_TOKEN befindet.
404ANTHROPIC_BASE_URL endet mit /v1 oder das angeforderte Modell ist bei Kunavo nicht vorhanden (meist, weil die Modellvariable nicht gesetzt wurde).

Einschränkungen

  • Zahlung nur mit Karte, Link oder Apple Pay/Google Pay. QRIS, GoPay, OVO, DANA, ShopeePay, virtuelle Konten und Banküberweisungen sind nicht verfügbar; automatische Aufladungen sind nur mit einer gespeicherten Karte oder Link möglich.
  • Kunavo stellt keine Steuerdokumente aus.
  • Dies ist eine API mit Abrechnung pro Token, kein Claude-Pro- oder Max-Abonnement. Mit einem API-Key sind Remote Control und Sprachdiktat nicht verfügbar, /fast ist deaktiviert und die MCP-Tool-Suche ist standardmäßig ausgeschaltet.
  • Ab 3. Oktober 2026 ist Sonnet 5.5 bei Kunavo noch nicht verfügbar; ohne festgelegtes Modell kann der Standardalias bei einem 404-Fehler enden.
  • Die Claude-Code-Dokumentation ist auf Indonesisch verfügbar, aber die Kunavo-Integrationsdokumentation und die englische Version dieses Leitfadens (Install Claude Code) sind noch nicht auf Indonesisch verfügbar.

Häufig gestellte Fragen

Welcher Befehl installiert Claude Code auf einem Laptop?

Das hängt vom Terminal ab. Unter macOS, Linux oder WSL: curl -fsSL https://claude.ai/install.sh | bash. In Windows PowerShell: irm https://claude.ai/install.ps1 | iex. In der Eingabeaufforderung (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Alle drei sind offizielle native Installer, die kein Node.js benötigen und sich selbst aktualisieren. Öffne danach ein neues Terminal und gib claude --version ein; wenn eine Versionsnummer erscheint, ist die Installation abgeschlossen.

Muss Claude Code unter Windows über WSL oder als Administrator installiert werden?

Nein. Laut der offiziellen Dokumentation auf Indonesisch läuft Claude Code direkt unter Windows in einer normalen PowerShell oder CMD, ohne Administratorrechte; Git for Windows ist lediglich optional. WSL 2 ist erst dann sinnvoll, wenn dein Projekt Linux-Tools oder Sandboxing benötigt. Ein häufig übersehener Punkt: Öffne im Startmenü nicht „Windows PowerShell (x86)“, da dies ein 32-Bit-Prozess ist und Claude Code die Ausführung verweigert.

Ist Claude Code kostenlos? Muss ich Claude Pro abonnieren?

Das Programm kann kostenlos installiert werden, seine Nutzung ist jedoch kostenpflichtig. Wenn du dich mit einem Claude-Konto anmeldest, benötigst du ein Pro-, Max-, Team- oder Enterprise-Abo bzw. ein Console-Konto; das kostenlose Claude.ai-Abo enthält Claude Code nicht. Die andere Möglichkeit ist ein API-Key: Setze ANTHROPIC_BASE_URL=https://api.kunavo.com und ANTHROPIC_AUTH_TOKEN, dann startet Claude Code ohne Anmeldung, und jedes Token wird aus dem Prepaid-Guthaben von Kunavo bezahlt – ohne monatliche Gebühr. Remote Control und Spracheingabe sind nicht enthalten, da beide ein claude.ai-Konto benötigen.

Kann Claude Code aus Indonesien verwendet werden?

Ja. Indonesien steht auf der Liste der von Anthropic unterstützten Länder, sowohl für Claude.ai als auch für die API. Wenn der Installer oder Claude Code „App unavailable in region“ anzeigt, läuft deine Verbindung normalerweise über ein VPN oder einen Proxy in einem anderen Land; deaktiviere ihn zunächst und versuche es erneut.

Wo wird der Claude-Code-API-Key hinterlegt, und wird ANTHROPIC_BASE_URL mit /v1 gesetzt?

Nein, /v1 wird nicht verwendet, da Claude Code /v1/messages selbst anhängt; mit /v1 entstünde /v1/v1/messages und der Fehler 404. Speichere die Variablen in ~/.zshrc oder ~/.bashrc, in $PROFILE von PowerShell oder im env-Block der Benutzereinstellungsdatei ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Verwende nicht die .claude/settings.json des Projekts, da diese Datei in das Repository gelangen kann. Kunavo akzeptiert den Key sowohl im Header Authorization: Bearer als auch im Header x-api-key. Wir empfehlen ANTHROPIC_AUTH_TOKEN, da er sofort aktiv ist; ANTHROPIC_API_KEY wird erst verwendet, nachdem du dies einmal im interaktiven Modus bestätigt hast.

Warum müssen Modelle mit ANTHROPIC_MODEL und den Variablen ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU_MODEL festgesetzt werden?

Weil sich die integrierten Aliase von Claude Code ändern, sobald Anthropic ein neues Modell veröffentlicht. Laut der Dokumentation zur Modellkonfiguration (geprüft am 3. Oktober 2026) verweisen das Standardmodell und der Alias opus für API-Nutzer derzeit auf Opus 5.5, während der Alias sonnet auf Sonnet 5.5 verweist. Am 3. Oktober 2026 war Sonnet 5.5 bei Kunavo noch nicht verfügbar, und auch künftig veröffentlichte Modelle sind möglicherweise nicht sofort verfügbar; ein Request ohne Pin kann daher 404 erhalten. Mit Pins verwendet die Hauptsitzung immer claude-sonnet-5; opus verwendet immer claude-opus-5-5 (Opus 5.5, erfordert Claude Code v2.1.280 oder höher; ältere Versionen lassen sich mit claude update aktualisieren); sonnet, einschließlich der Ausführungsphase von opusplan und des Sonnet-Subagents, verwendet immer claude-sonnet-5; haiku und Hintergrundaufgaben verwenden immer claude-haiku-4-5. So weißt du genau, welcher Tarif angewendet wird.

Wie kann ich sicherstellen, dass Claude Code den API-Key statt eines claude.ai-Kontos verwendet?

Geben Sie innerhalb der Sitzung /status ein. Wenn alles stimmt, gibt es eine Zeile „Anthropic base URL“ mit https://api.kunavo.com und eine Zeile „Auth token“, die ANTHROPIC_AUTH_TOKEN nennt. Wenn stattdessen „Login method“ mit einem claude.ai-Konto erscheint, wird die Variable nicht gelesen: Beenden Sie die Sitzung, öffnen Sie ein neues Terminal und prüfen Sie die Datei, in der Sie sie gespeichert haben.

Kann das Guthaben per QRIS, GoPay, OVO, DANA oder Banküberweisung aufgeladen werden?

Nein. Das Kunavo-Guthaben kann nur mit einer Karte (Visa, Mastercard usw., einschließlich Debitkarten mit dem Logo eines dieser Netzwerke), Link oder Apple Pay/Google Pay aufgeladen werden, sofern Ihr Gerät und Browser dafür eingerichtet sind. QRIS, GoPay, OVO, DANA, ShopeePay, virtuelle Konten und Banküberweisungen sind nicht verfügbar. Wenn die Karte abgelehnt wird, prüfen Sie in der Banking-App, ob Online- oder internationale Transaktionen aktiviert sind; ob die Zahlung genehmigt wird, entscheidet die kartenausgebende Bank.

Wie hoch ist die Mindestsumme für eine Aufladung? Kann das Guthaben verfallen? Gibt es eine Steuerrechnung?

Mindestens $10, einmalige Zahlung ohne monatliche Gebühren, und das Guthaben verfällt nie. Fehlgeschlagene Requests mindern das Guthaben nicht. Die Preise sind in USD angegeben; wenn der Checkout Rupiah anzeigt, stammt der Wechselkurs von Stripe und enthält bereits eine vom Käufer getragene Umrechnungsgebühr von 2–4 %. Automatische Aufladungen sind nur mit einer gespeicherten Karte oder Link möglich. Kunavo stellt keine Steuerdokumente aus, einschließlich Steuerrechnungen. Dieses Guthaben ist ausschließlich für die Kunavo API bestimmt und kann nicht zur Bezahlung von Claude Pro oder Max verwendet werden.