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

Claude Code installieren: Installationsbefehle für Windows und macOS, API-Key-Konfiguration ohne Pro/Max-Tarif, Zahlung per Karte oder Link

Für die Installation von Claude Code genügt ein offizieller Befehl. Schwieriger sind meist die anschließenden Schritte: die Node.js-Version bei der Installation mit npm, Terminal und PATH unter Windows, die Konfiguration des API-Schlüssels ohne Pro/Max-Tarif und die Zahlung aus Vietnam ohne MoMo, ZaloPay oder VNPay.

Wenn du Claude Code ohne ein Pro-/Max-Abo verwenden möchtest, erledigst du drei Dinge: Installiere es mit dem offiziellen nativen Befehl (je Terminaltyp eine Zeile, direkt darunter), setze ANTHROPIC_BASE_URL=https://api.kunavo.com (ohne /v1) zusammen mit ANTHROPIC_AUTH_TOKEN und den vier Modell-Pins und gib anschließend /status ein, um sicherzustellen, dass Claude Code mit dem Key läuft. Die Tokenkosten werden vom Prepaid-Guthaben abgezogen, das du über 10 USD mit Visa/Mastercard oder Link auflädst; MoMo, ZaloPay und VNPay werden nicht unterstützt. Für die npm-Installation ist Node.js 22 oder höher erforderlich.

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

Lệnh cài và tên biến trong bài lấy từ tài liệu chính thức của Claude Code, gồm Installationsseite và Liste der Umgebungsvariablen, đọc lại ngày 3. Oktober 2026. Anthropic chưa có bản tiếng Việt của các trang này (đường dẫn /docs/vi/setup báo 404 cùng ngày), nên thông báo lỗi trong bài được giữ nguyên tiếng Anh để bạn tìm cho dễ. Giá và cách thanh toán của Kunavo được kiểm tra ngày 3. Oktober 2026.

Wähle den Installationsbefehl passend zum geöffneten Terminal

Alle Installationsmethoden ergeben dasselbe Programm claude; der Unterschied besteht darin, wer sich um die Aktualisierung kümmert. Die offizielle Dokumentation führt die native Methode im Tab „Native Install (Recommended)“ auf. Sie ist außerdem die einzige Methode, die sich automatisch auf eine neue Version aktualisiert, ohne dass du etwas tun musst.

Du befindest dich inBefehl verwendenAktualisierung
macOS, Linux oder WSL-Terminalinstall.sh (erste Zeile oben)Automatisch im Hintergrund
Windows PowerShell, Eingabeaufforderung im Format PS C:\Users\TenBan>irm https://claude.ai/install.ps1 | iexAutomatisch im Hintergrund
Windows-CMD, Eingabeaufforderung im Format C:\Users\TenBan> (ohne PS)Zeile mit install.cmdAutomatisch im Hintergrund
Mit Homebrew oder WinGet vertrautbrew install --cask claude-code, winget install Anthropic.ClaudeCodeStandardmäßig keine automatische Aktualisierung; Upgrade über den Paketmanager
npm erforderlichnpm install -g @anthropic-ai/claude-code, Node.js 22+ erforderlichErneut mit @latest ausführen
# Homebrew (macOS, Linux) – mặc định không tự cập nhật
brew install --cask claude-code

# WinGet (Windows) – mặc định không tự cập nhật
winget install Anthropic.ClaudeCode

Der Computer muss die folgenden Voraussetzungen erfüllen (laut Installationsseite, Stand 3. Oktober 2026):

  • Betriebssystem: macOS 13.0 oder höher; Windows 10 Version 1809 oder höher bzw. Windows Server 2019 oder höher; Ubuntu 20.04+, Debian 10+ oder Alpine Linux 3.19+.
  • Mindestens 4 GB RAM, CPU mit x64 oder ARM64. 32-Bit-Windows wird nicht unterstützt.
  • Shell: Bash, Zsh, PowerShell oder CMD; außerdem ist eine Internetverbindung erforderlich.
  • Node.js wird nur für die Installation über npm benötigt und muss Version 22 oder höher sein.

Gib nach der Installation nicht sofort claude im alten Fenster ein: Dieses Fenster kennt das neue PATH noch nicht. Öffne ein anderes Terminal und führe Folgendes aus:

claude --version   # in ra số phiên bản, kèm chữ (Claude Code)
claude doctor      # chẩn đoán cài đặt và file cấu hình, không mở phiên làm việc

Wenn claude --version eine Versionsnummer ausgibt, ist die Installation abgeschlossen; alle späteren Fehler betreffen die Konfiguration. claude doctor ist hilfreich, wenn du nicht sicher bist, wo der Fehler liegt, da sowohl die Installation als auch die Einstellungsdateien geprüft werden, ohne eine Sitzung zu öffnen.

Windows: fünf häufige Stolperfallen

  1. Die falsche Befehlszeile eingefügt. PowerShell meldet bei einer CMD-Zeile The token '&&' is not a valid statement separator; CMD meldet bei einer PowerShell-Zeile 'irm' is not recognized as an internal or external command. Achte auf die Eingabeaufforderung: Wenn PS vorhanden ist, verwende die Zeile irm, andernfalls die Zeile install.cmd.
  2. „Windows PowerShell (x86)“ versehentlich geöffnet. Dieser Eintrag im Startmenü ist ein 32-Bit-Prozess und erkennt daher auch auf einem 64-Bit-Computer Claude Code does not support 32-bit Windows. Wähle den Eintrag ohne „(x86)“.
  3. Die Ausführung mit Administratorrechten ist unnötig. Die Dokumentation verlangt dies nicht, und die native Version wird im Benutzerordner installiert: %USERPROFILE%\.local\bin\claude.exe.
  4. Bei der Eingabe von claude wird „not recognized“ angezeigt. Der obige Ordner ist noch nicht in PATH enthalten. Versuche zunächst ein neues Terminal; tritt der Fehler weiterhin auf, verwende den folgenden PowerShell-Abschnitt, um den Pfad zu prüfen und hinzuzufügen. Unter macOS/Linux lautet der entsprechende Fehler command not found: claude, und das Programm befindet sich unter ~/.local/bin/claude.
  5. npm meldet npm.ps1 cannot be loaded because running scripts is disabled on this system. Die Execution Policy von PowerShell blockiert das von npm erzeugte Skript .ps1. Die Dokumentation nennt drei Lösungen: Skripte für den aktuellen Benutzer lokal mit dem folgenden Befehl Set-ExecutionPolicy ausführen, npm.cmd und claude.cmd anstelle der Version .ps1 aufrufen oder npm nicht verwenden und den nativen Befehl nutzen.
PowerShell
# 1. Kiểm tra thư mục cài đặt đã có trong PATH chưa
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Không có kết quả nào? Thêm vào PATH của người dùng, rồi đóng và mở lại terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Trong terminal mới
claude --version
PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Nativ oder WSL? Dự án sống trên Windows thì chạy native là đủ. Lúc đó Git for Windows là tùy chọn: có nó, Claude Code chạy lệnh qua Git Bash; không có, nó dùng PowerShell. Nếu Git đã cài mà Claude Code không thấy Git Bash, khai báo CLAUDE_CODE_GIT_BASH_PATH trong khối env của ~/.claude/settings.json, trỏ tới bash.exe (tài liệu lấy ví dụ C:\Program Files\Git\bin\bash.exe). Chọn WSL 2 khi bạn cần công cụ Linux hoặc muốn lệnh chạy trong sandbox, vì sandbox chỉ có trên WSL 2; Windows native và WSL 1 đều không có. WSL 1 chỉ là phương án khi máy không bật được WSL 2. Đã chọn WSL thì cài bằng dòng install.sh và chạy claude hoàn toàn trong terminal WSL.

Installation über npm: Voraussetzungen und drei Hinweise

npm hợp lý khi bạn đã quản lý công cụ dòng lệnh bằng Node, hoặc khi mạng công ty chỉ cho tải gói qua registry npm. Điều kiện là Node.js 22 oder höher; con số Node 18 trong nhiều bài cũ không còn đúng. Đáng chú ý là Node cũ hơn không làm hỏng việc cài: npm chỉ in cảnh báo EBADENGINE, vì thứ thật sự chạy là một chương trình native mà gói npm tải về, không phụ thuộc Node. Máy chưa có Node thì lấy bản 22+ ở nodejs.org.

Terminal
node -v                                    # cần v22 trở lên
npm install -g @anthropic-ai/claude-code   # không dùng sudo

# nâng cấp bằng @latest, không dùng npm update -g
npm install -g @anthropic-ai/claude-code@latest
  • sudo npm install -g nicht verwenden: Die Dokumentation warnt, dass diese Methode zu Berechtigungsfehlern führt und ein Sicherheitsrisiko darstellt.
  • Mit npm install -g @anthropic-ai/claude-code@latest auf die neueste Version aktualisieren; npm update -g ist nicht die empfohlene Methode.
  • Das native Programm stammt aus einer optionalen Abhängigkeit (dem für deine Plattform passenden Paket @anthropic-ai/claude-code-*). Das Flag --omit=optional, die Zeile optional=false in .npmrc oder --ignore-scripts lässt diese Abhängigkeit weg; unter macOS/Linux erscheint dann claude native binary not installed.

Ist ein VPN erforderlich? Fehler beim Herunterladen des Installationsskripts

Không cần. Việt Nam nằm trong Liste der von Anthropic unterstützten Länder cho cả Claude.ai lẫn API (kiểm tra ngày 3. Oktober 2026). Chính VPN mới hay gây chuyện: theo Seite zur Fehlerbehebung bei der Installation (đọc ngày 3. Oktober 2026), khi địa chỉ cài đặt trả về App unavailable in region, Claude Code không khả dụng ở nơi mà kết nối của bạn được nhìn thấy. Ở Việt Nam mà gặp dòng này thì tắt VPN hoặc proxy đặt ở nước khác rồi chạy lại.

Die beiden verbleibenden Fehler haben dieselbe Ursache: syntax error near unexpected token '<' oder curl: (22) The requested URL returned error: 403 bedeutet, dass du statt des Skripts eine HTML-Seite oder einen Fehlercode erhalten hast. Ein Unternehmensnetzwerk mit Proxy oder Firewall, die den Dateidownload blockiert, ist der erste Verdächtige. Wechsle nicht vorschnell zu Homebrew, WinGet oder npm: Die Dokumentation empfiehlt, zuerst die Netzwerkverbindung zu prüfen, da auch alternative Installationsmethoden vom selben Server herunterladen. Versuche ein anderes Netzwerk oder bitte die IT-Abteilung, die Blockierung aufzuheben.

API-Key-Konfiguration: Claude Code ohne Pro-/Max-Abo ausführen

Claude Code authentifiziert sich auf eine von zwei Arten. Die folgende Tabelle bietet einen schnellen Vergleich; der restliche Artikel folgt der rechten Spalte.

Mit einem Claude-Konto anmeldenKunavo-API-Key
VoraussetzungenPro-, Max-, Team- oder Enterprise-Abo bzw. ein Console-Konto. Das kostenlose Claude.ai-Abo enthält Claude Code nicht.Ein sk-kn-…, der in einer Umgebungsvariable gesetzt wird. Kein Abo und keine Anmeldung erforderlich.
AbrechnungTheo tháng: Pro 20 USD/tháng (17 USD/tháng nếu trả năm, tức 200 USD một lần), Max từ 100 USD/tháng, chưa gồm thuế (claude.com/pricing, đọc ngày 3. Oktober 2026).Abrechnung nach tatsächlich verwendeten Tokens, abgezogen vom Prepaid-Guthaben aus 10 USD. Keine monatliche Gebühr, Guthaben verfällt nicht, fehlerhafte Requests werden nicht berechnet.
Zahlung mitMua trên web của Anthropic thì chỉ thẻ tín dụng hoặc ghi nợ (Claudes Zahlungs-FAQ, đọc ngày 3. Oktober 2026).Visa, Mastercard oder Link; Apple Pay oder Google Pay, sofern das Gerät dies unterstützt. MoMo, ZaloPay und VNPay werden nicht unterstützt.
Was fehlt—Remote Control und Spracheingabe. Keine VAT-Rechnung.

Claude Code auf einen anderen Dienst als Anthropic zu verweisen, ist kein Trick: Die offizielle Dokumentation beschreibt ANTHROPIC_BASE_URL als Variable zum Überschreiben des API-Endpunkts bei Verwendung eines Proxys oder Gateways. Kunavo verwendet genau das Anthropic-Messages-API-Protokoll; daher nutzt du Claude Code unverändert, ohne Plugin und ohne Patch. Benötigt werden genau sechs Variablen:

VariableWertZweck und typische Fehler
ANTHROPIC_BASE_URLhttps://api.kunavo.comNur der Hostname. Claude Code hängt /v1/messages automatisch an; wenn du zusätzlich /v1 einträgst, wird der Request zu /v1/v1/messages und liefert 404.
ANTHROPIC_AUTH_TOKENSchlüssel sk-kn-…Wird im Header Authorization: Bearer gesendet, sofort wirksam, ohne Bestätigungsschritt.
ANTHROPIC_MODELclaude-sonnet-5Hauptmodell (Claude Sonnet 5). Der Name muss zeichengetreu mit der Kunavo-Liste übereinstimmen; ältere Namen mit Datums-Suffix werden nicht automatisch umgewandelt.
ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-5-5Den Alias opus (und opusplan im Planmodus) auf Claude Opus 5.5 festsetzen, damit er nicht mit dem neuesten Opus-Release mitwandert. Claude Code v2.1.280 oder höher ist erforderlich; mit einer älteren Version führe claude update aus.
ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-5Der Alias sonnet verweist standardmäßig auf Sonnet 5.5, das Kunavo nicht anbietet. Ohne Pin erhalten /model sonnet, die Ausführungsphase von opusplan und der Subagent mit model: sonnet jeweils 404.
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5Der Alias haiku und die Hintergrundaufgaben von Claude Code verwenden dieses Modell.

Wo Variablen gesetzt werden

Für die dauerhafte Nutzung ist der Block env in der Benutzereinstellungsdatei am übersichtlichsten: ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Diese Datei gilt für alle Projekte; wenn sie bereits Inhalt enthält, füge nur den Block env hinzu:

~/.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"
  }
}

Wenn du die Variablen lieber in der Shell setzt, füge sie zu ~/.zshrc oder ~/.bashrc hinzu. Unter Windows eignet sich der zweite Abschnitt unten (die Zeilen $env:) für einen schnellen Test, aber die Variablen verschwinden, sobald das PowerShell-Fenster geschlossen wird.

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # chỉ tên miền, không thêm /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
PowerShell
# Chỉ có hiệu lực trong cửa sổ PowerShell này, đóng cửa sổ là mất
$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

Drei Dinge solltest du wissen, bevor Probleme auftreten:

  • Den Key nicht in .claude/settings.json des Projekts setzen. Dokumentation zur Gateway-Verbindung nhắc rằng file này được commit, ai clone repo cũng có.
  • Die Einstellungsdatei hat Vorrang vor der Shell. Wenn eine Variable an beiden Orten vorhanden ist, wird der Wert im Block env der Einstellungsdatei verwendet. Wenn eine Änderung in der Shell keine Wirkung zeigt, prüfe zuerst die Einstellungsdatei.
  • Beim ersten Start wird ein Key auf Benutzerebene benötigt. Im interaktiven Modus wirkt der Block env in .claude/settings.json oder .claude/settings.local.json des Projekts erst nach dem ersten Assistenten und der Frage, ob dem Ordner vertraut wird. Wenn der Key nur dort liegt, erscheint beim ersten Start weiterhin der Anmeldebildschirm.

ANTHROPIC_AUTH_TOKEN oder ANTHROPIC_API_KEY – und der „403-Fehler“

Kunavo đọc key ở cả Authorization: Bearer lẫn x-api-key, nên biến nào cũng kết nối được. Khác biệt nằm ở phía Claude Code. Theo Dokumentation zu Umgebungsvariablen (đọc ngày 3. Oktober 2026), ANTHROPIC_AUTH_TOKEN đi vào header Authorization với tiền tố Bearer và có hiệu lực ngay. ANTHROPIC_API_KEY đi vào header X-Api-Key, và ở chế độ tương tác Claude Code hỏi bạn một lần có dùng key này thay cho gói đăng ký không. Trả lời “không” thì key bị bỏ qua mà không hỏi lại; muốn bật lại thì vào /config, mục Benutzerdefinierten API-Schlüssel verwenden. Bài này chọn ANTHROPIC_AUTH_TOKEN chỉ để bỏ được bước hỏi đó.

Vài hướng dẫn tiếng Việt viết rằng ANTHROPIC_API_KEY khiến Claude Code phớt lờ ANTHROPIC_BASE_URL, gọi thẳng api.anthropic.com và nhận 403. Cả tài liệu biến môi trường lẫn Dokumentation zur Gateway-Verbindung (đọc ngày 3. Oktober 2026) đều không nói vậy: hai biến là hai cách đưa key tới cùng một gateway trong ANTHROPIC_BASE_URL. Nếu bạn thật sự gặp 403 sau khi đổi biến, hãy kiểm tra lại base URL và key thay vì đổi qua đổi lại tên biến.

Warum Modelle festsetzen und wie viel jedes Modell kostet

Alias của Claude Code không đứng yên. Theo Dokumentation zur Modellkonfiguration (đọc ngày 3. Oktober 2026), với người dùng API, mô hình mặc định và alias opus đang trỏ tới Opus 5.5, alias sonnet trỏ tới Sonnet 5.5; tài liệu cũng nói alias “được cập nhật theo thời gian” và khuyên dùng tên đầy đủ hoặc các biến ANTHROPIC_DEFAULT_*_MODEL khi cần cố định. Tính đến ngày 3. Oktober 2026, Kunavo có Opus 5.5 nhưng không có Sonnet 5.5. Hệ quả nếu bỏ qua bước ghim: phiên mặc định chạy Opus 5.5, đắt hơn Claude Sonnet 5; /model sonnet, giai đoạn thực thi của opusplan và subagent đặt model: sonnet trả về 404; và lần tới alias opus nhảy sang bản Opus mới, bản đó chưa chắc đã có trên Kunavo. Vì vậy đoạn cấu hình ở trên ghim alias sonnet vào claude-sonnet-5 bằng ANTHROPIC_DEFAULT_SONNET_MODEL, và ghim alias opus vào Opus 5.5 (claude-opus-5-5). Opus 5.5 cần Claude Code v2.1.280 trở lên; bản cũ hơn thì chạy claude update.

Die Preise bei Kunavo pro Million Tokens (Eingabe / Ausgabe): Claude Sonnet 5 1,40 USD / 7,00 USD (Anthropic-Preise: 2,00 USD / 10,00 USD); Claude Opus 5.5 2,80 USD / 14,00 USD; Claude Haiku 4.5 0,70 USD / 3,50 USD.

Mit /status prüfen

Sobald ANTHROPIC_AUTH_TOKEN gelesen wurde, öffnet der Befehl claude direkt die Sitzung, ohne Anmeldebildschirm (laut Gateway-Verbindungsdokumentation, Stand 3. Oktober 2026); beim ersten Mal gibt es weiterhin einige Einrichtungsschritte, etwa die Frage, ob dem Ordner vertraut wird. Wenn der Anmeldebildschirm erscheint, ist der Key nicht angekommen. Gib in der Sitzung /status ein und suche nach:

  • Anthropic base URL: https://api.kunavo.com. Diese Zeile erscheint nur, wenn eine Gateway-Adresse vorhanden ist; fehlt sie, bedeutet das, dass ANTHROPIC_BASE_URL nicht in die Sitzung gelangt ist.
  • Auth token: ANTHROPIC_AUTH_TOKEN. Wenn dort Login method zusammen mit einem claude.ai-Konto steht, verwendet die Sitzung weiterhin die gespeicherte Anmeldung.

Um vor dem Öffnen von Claude Code sicherzustellen, dass Key und Adresse korrekt sind, sende eine Testanfrage, die genau 1 Ausgabetoken anfordert (dies kostet einen sehr kleinen Betrag aus dem Guthaben). Der Befehl liest die Variable aus der aktuellen Shell; wenn der Key nur in der Einstellungsdatei steht, führe zuerst export in diesem Terminal aus. Beginnt das Ergebnis mit {"id":"msg_, ist alles in Ordnung; 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 desselben Tests; bei Erfolg beginnt das Feld id im Ergebnis mit msg_:

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

Was bei der Verwendung eines API-Keys fehlt

  • Remote Control und Spracheingabe benötigen eine claude.ai-Identität und funktionieren daher nicht, wenn ANTHROPIC_AUTH_TOKEN aktiv ist. Remote Control wird ebenfalls deaktiviert, wenn ANTHROPIC_BASE_URL auf einen anderen Server als api.anthropic.com zeigt.
  • /fast meldet Fast mode has been disabled by your organization: Laut Gateway-Verbindungsdokumentation erfordert die Prüfung des Fast Mode eine Anmeldung bei claude.ai oder einen Anthropic-API-Key. Mit einem Bearer-Token betrachtet Claude Code die Funktion daher als deaktiviert und fragt den Server nicht ab.
  • MCP tool search ist standardmäßig deaktiviert, wenn die Base-URL nicht von Anthropic stammt.
  • Angaben in /context là ước tính: Kunavo không có endpoint /v1/messages/count_tokens, và theo Gateway-Protokolldokumentation (đọc ngày 3. Oktober 2026), khi thiếu endpoint này Claude Code đếm token dựa trên số ký tự.

Die Integrationsdetails befinden sich in der Claude-Code-Integrationsdokumentation (auf Englisch); der entsprechende englische Artikel heißt Install Claude Code.

Aufladen aus Vietnam: Karte oder Link, keine lokalen E-Wallets

Vorweg klar gesagt: Kunavo akzeptiert MoMo, ZaloPay, VNPay und keine Banküberweisungen. Eine inländische ATM-Karte, die ausschließlich das Napas-Netz nutzt, funktioniert ebenfalls nicht, da sie keine Visa- oder Mastercard-Karte ist. Die Stripe-Zahlungsseite von Kunavo bietet Käufern in Vietnam folgende Optionen:

  • Visa- oder Mastercard-Karte, sowohl internationale Kredit- als auch Debitkarten.
  • Link, ví của Stripe, lưu phương thức thanh toán để lần sau trả nhanh hơn (Link-Dokumentation, đọc ngày 3. Oktober 2026).
  • Apple Pay oder Google Pay, chỉ xuất hiện trên thiết bị và trình duyệt đã thiết lập ví, vì chúng trả bằng thẻ có trong ví. Apple Pay có mặt ở Việt Nam từ 08/08/2023 và dùng được khi mua hàng trực tuyến (Apple Newsroom Vietnam, đọc ngày 3. Oktober 2026).

Phía Anthropic cũng vậy: gói Claude mua trên web chỉ nhận thẻ tín dụng hoặc ghi nợ (Claudes Zahlungs-FAQ, đọc ngày 3. Oktober 2026), nên ví điện tử Việt Nam không trả trực tiếp được ở đó; gói mua trong ứng dụng iOS hay Android thì đi theo phương thức của App Store hoặc Google Play. Khác ở chỗ, tiền nạp vào Kunavo thành số dư API, và Claude Code trừ dần theo token sau khi bạn cấu hình key như trên.

Zahlung in VND oder USD

Kunavo niêm yết giá bằng USD. Vì Việt Nam nằm trong các thị trường của Stripe Adaptive Pricing (đọc ngày 3. Oktober 2026), trang thanh toán có thể hiện số tiền đã quy đổi sang VND, và con số chính xác luôn hiện ra trước khi bạn bấm xác nhận. Tỷ giá Stripe đưa ra đã cộng phí chuyển đổi 2–4%, người mua chịu. Chọn trả bằng USD thì không có khoản đó, nhưng ngân hàng phát hành thẻ có thể áp tỷ giá và phí của họ.

Trả bằng VND cũng chưa chắc rẻ hơn: một số ngân hàng thu phí khi thẻ thanh toán bằng VND cho đơn vị bán hàng đăng ký ở nước ngoài. Chẳng hạn Techcombank thu “phí giao dịch nội tệ ở nước ngoài” 1,1% số tiền giao dịch (đã gồm VAT) với thẻ ghi nợ Visa, áp dụng từ 13/08/2023 (Techcombank-FAQ, đọc ngày 3. Oktober 2026). Đây chỉ là ví dụ của một ngân hàng, và Kunavo chưa xác minh được ngân hàng có xếp giao dịch của mình vào loại này hay không; xem biểu phí thẻ của bạn rồi hãy chọn VND hay USD.

Abgelehnte Karten sind häufig darauf zurückzuführen, dass Online- oder internationale Zahlungen in der Banking-App nicht aktiviert sind. Aktiviere sie und versuche es erneut oder wechsle zu Link bzw. Apple Pay/Google Pay mit einer von der jeweiligen Wallet unterstützten Karte.

Von der Registrierung zum Key

  1. Registriere dich bei Kunavo per E-Mail oder Google-Konto; in diesem Schritt wird keine Karte verlangt.
  2. Öffne Billing und wähle den Aufladebetrag (mindestens 10 USD). Bei größeren Beträgen gibt es zusätzlich: nạp 100 USD được 110 USD vào số dư; nạp 1.000 USD được 1.200 USD vào số dư; nạp 5.000 USD được 6.250 USD vào số dư.
  3. Wähle auf der Stripe-Seite eine Karte, Link oder eine auf dem Gerät verfügbare Wallet, prüfe den Betrag und bestätige.
  4. Öffne API Keys und erstelle einen Key sk-kn-…. Der Key wird nur einmal angezeigt; kopiere ihn daher sofort in ANTHROPIC_AUTH_TOKEN.

Für die automatische Aufladung bei niedrigem Guthaben musst du eine gespeicherte Karte oder Link verwenden. Das Guthaben verfällt nicht, fehlerhafte Requests werden nicht berechnet. Kunavo stellt keine VAT-Rechnung aus, auch keine elektronische Rechnung gemäß den vietnamesischen Vorschriften; den Aufladeverlauf findest du unter Billing. Dieses Guthaben kann nur für die Kunavo-API verwendet werden, nicht für Claude Pro, Claude Max oder ChatGPT Plus.

Wie viel kostet eine Coding-Sitzung ungefähr?

Bei jedem Request sendet Claude Code den gesamten Gesprächskontext erneut; daher hängen die Kosten stark vom Cache ab: Wiederholter Kontext wird zum deutlich günstigeren Cache-Lesepreis berechnet. Die folgende Tabelle ist eine theoretische Berechnung mit ausdrücklich genannten Annahmen, keine Messung aus der Praxis und keine Obergrenze:

  • pro Request 40.000 Eingabetokens: 36.000 Tokens (90 %) aus dem Cache gelesen, 4.000 Tokens in den Cache geschrieben;
  • pro Request 1.000 Ausgabetokens;
  • eine Sitzung mit 50 Requests, ohne die Claude Haiku 4.5-Hintergrundläufe;
  • mit Claude Sonnet 5 bei Kunavo, wobei das Lesen aus dem Cache 10% des Eingabepreises und das Schreiben in den Cache 1,25 des Eingabepreises kostet; jedes Modell in der Tabelle verwendet seinen eigenen Satz.
ModellEin Request50 Requests50 Requests, kein einziger Cache-Treffer
Claude Sonnet 50,019 USD0,95 USD3,15 USD
Claude Opus 5.50,033 USD1,65 USD6,30 USD

Die letzte Spalte zeigt, wie wichtig der Cache ist. Langer Kontext, lange Antworten oder das Vergessen von /clear zwischen verschiedenen Aufgaben erhöhen den Betrag. Einen Vergleich von Abo und API sowie monatliche Schätzungen findest du im Artikel Claude-Code-Preise; die Preise der einzelnen Modelle stehen in der Claude-API-Preistabelle oder auf der Preisseite; für eigene Zahlen kannst du den Claude-Tokenkostenrechner (auf Englisch) verwenden.

Fehler anhand der Meldung beheben

WannWas wird angezeigtLösung
InstallationThe token '&&' is not a valid statement separatorDu bist in PowerShell und hast eine CMD-Zeile eingefügt. Verwende irm … | iex.
Installation'irm' is not recognized as an internal or external commandDu bist in CMD und hast eine PowerShell-Zeile eingefügt. Verwende die Zeile install.cmd.
Installationsyntax error near unexpected token '<', 403, App unavailable in regionEine HTML-Seite statt des Skripts erhalten. Deaktiviere VPN/Proxy in einem anderen Land und versuche zunächst ein anderes Netzwerk, bevor du die Installationsmethode wechselst (die anderen Methoden laden vom selben Server).
InstallationClaude Code does not support 32-bit WindowsPowerShell (x86) ist geöffnet. Öffne das normale „Windows PowerShell“.
Installation (npm)Warnung EBADENGINENode.js ist älter als 22. Die Installation wird zwar abgeschlossen, aber Node sollte aktualisiert werden.
Installation (npm)claude native binary not installedOptionale Abhängigkeit fehlt aufgrund von --omit=optional, optional=false oder --ignore-scripts. Entferne diese Einstellung und installiere erneut.
Installation (npm)npm.ps1 cannot be loadedDie Execution Policy blockiert das Skript. Führe oben Set-ExecutionPolicy aus, verwende npm.cmd oder wechsle zum nativen Befehl.
Nach der Installationcommand not found: claude, 'claude' is not recognizedDer Installationsordner ist noch nicht in PATH enthalten. Öffne ein neues Terminal; unter Windows führe zusätzlich den PowerShell-Abschnitt PATH aus.
KonfigurationDer Anmeldebildschirm wird weiterhin angezeigtDer Key wurde nicht gelesen. Setze ihn in der Shell oder in ~/.claude/settings.json des Benutzers, nicht nur in der Projektkonfiguration, und öffne ein neues Terminal.
Konfiguration401Der Key wurde abgelehnt: unvollständig kopiert, mit zusätzlichen Leerzeichen versehen, unter /app/keys gelöscht oder in der falschen Variable gesetzt.
Konfiguration404Die Base-URL enthält überflüssiges /v1 oder das Modell ist bei Kunavo nicht verfügbar (häufig ist der Alias sonnet noch nicht festgesetzt und verweist auf Sonnet 5.5).
AufladenKarte abgelehntAktiviere Online- und internationale Zahlungen in der Banking-App; Karten, die nur Napas unterstützen, funktionieren nicht. Versuche alternativ Link, Apple Pay oder Google Pay.

Vor dem Aufladen

  • Nur Visa/Mastercard-Karten, Link und Wallets, die auf Karten basieren; kein MoMo, ZaloPay, VNPay und keine Banküberweisung.
  • Die automatische Aufladung funktioniert nur mit einer gespeicherten Karte oder Link. Kunavo stellt keine VAT-Rechnung aus.
  • Dies ist eine Token-basierte API und kein Claude-Pro-/Max-Abo: Remote Control und Spracheingabe sind nicht verfügbar, /fast meldet, dass es deaktiviert wurde, und MCP tool search ist standardmäßig deaktiviert.
  • Stand 3. Oktober 2026 bietet Kunavo Sonnet 5.5 nicht an; daher liefert der noch nicht festgesetzte Alias sonnet 404.
  • Die Claude-Code-Dokumentation und die Kunavo-Integrationsdokumentation sind derzeit nur auf Englisch verfügbar.

Häufig gestellte Fragen

Ist Claude Code kostenlos? Was bedeutet „Claude Code benötigt keinen Tarif“?

Das Herunterladen und Installieren von Claude Code kostet nichts, aber damit es antworten kann, brauchst du eines von zwei Dingen: eine Anmeldung mit einem kostenpflichtigen Claude-Tarif (Pro, Max, Team, Enterprise) oder einem Console-Konto oder einen API-Schlüssel. Der kostenlose Claude.ai-Tarif umfasst Claude Code nicht. „Kein Tarif erforderlich“ bezeichnet den zweiten Weg: Setze ANTHROPIC_BASE_URL=https://api.kunavo.com und ANTHROPIC_AUTH_TOKEN; Claude Code überspringt die Anmeldung und berechnet die tatsächlich verwendeten Token vom vorausbezahlten Kunavo-Guthaben, mindestens 10 USD, ohne monatliche Gebühr.

Welcher Installationsbefehl gilt für Claude Code unter Windows? Muss WSL installiert oder das Programm mit Administratorrechten ausgeführt werden?

Öffne PowerShell (die Eingabeaufforderung beginnt mit PS) und führe irm https://claude.ai/install.ps1 | iex aus; wenn du dich in CMD befindest, verwende curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Administratorrechte, WSL und Git sind nicht erforderlich. Wenn Git for Windows vorhanden ist, führt Claude Code Befehle über Git Bash aus, andernfalls über PowerShell. WSL 2 lohnt sich nur, wenn du Linux-Tools benötigst oder Befehle in einer Sandbox ausführen möchtest. Öffne „Windows PowerShell“, nicht den Eintrag mit (x86), da Claude Code unter 32-Bit-Windows nicht ausgeführt wird.

Welche Node.js-Version wird für die Installation von Claude Code mit npm benötigt?

Node.js 22 oder höher laut offizieller Installationsdokumentation, abgerufen am 3. Oktober 2026. Viele ältere Beiträge nennen weiterhin Node 18; diese Angabe ist veraltet. Eine ältere Node-Version führt lediglich dazu, dass npm die Warnung EBADENGINE ausgibt; die Installation ist trotzdem erfolgreich, weil das npm-Paket tatsächlich ein natives Programm herunterlädt, das ohne Node ausgeführt wird. Der Installationsbefehl lautet npm install -g @anthropic-ai/claude-code (ohne sudo); für ein Upgrade führe ihn erneut mit @latest aus, nicht mit npm update -g. Wenn es keinen besonderen Grund für npm gibt, ist der native Befehl kompakter.

Wo gebe ich den API-Schlüssel für Claude Code ein? Muss ANTHROPIC_BASE_URL um /v1 ergänzt werden?

Am dauerhaftesten ist der env-Block in der Benutzerdatei ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json), der für alle Projekte gilt; du kannst die Variablen auch in ~/.zshrc, ~/.bashrc oder $PROFILE von PowerShell exportieren. Die Base URL lautet ausschließlich https://api.kunavo.com, ohne /v1, da Claude Code automatisch /v1/messages hinzufügt; ein zusätzliches /v1 wird zu /v1/v1/messages und führt zu 404. Lege den Schlüssel nicht in .claude/settings.json des Projekts ab: Diese Datei liegt im Repository und wird bei jedem Klonen mitgeführt.

Stimmt es, dass ANTHROPIC_API_KEY laut manchen Beiträgen zu 403 führt?

Das stimmt laut offizieller Dokumentation nicht. Sowohl ANTHROPIC_API_KEY als auch ANTHROPIC_AUTH_TOKEN werden an die in ANTHROPIC_BASE_URL angegebene Adresse gesendet; sie unterscheiden sich im Header (X-Api-Key gegenüber Authorization: Bearer) und darin, dass ANTHROPIC_API_KEY im interaktiven Modus einmalig von dir bestätigt werden muss. Kunavo liest den Schlüssel aus beiden Headern. In dieser Anleitung wird ANTHROPIC_AUTH_TOKEN nur empfohlen, weil er sofort verwendet werden kann. Wenn du die betreffende Abfrage versehentlich abgelehnt hast, wird der Schlüssel ohne erneute Nachfrage ignoriert; öffne /config und aktiviere ihn unter Use custom API key erneut.

Welches Modell verwendet Claude Code, wenn ANTHROPIC_MODEL nicht gesetzt ist?

Es wird ein Alias verwendet, der sich im Laufe der Zeit ändern kann. Die Modelldokumentation (abgerufen am 3. Oktober 2026) besagt, dass für API-Nutzer das Standardmodell und der Alias opus derzeit Opus 5.5 und der Alias sonnet Sonnet 5.5 sind. Kunavo bietet Opus 5.5, aber nicht Sonnet 5.5; daher verwendet eine nicht festgelegte Sitzung Opus 5.5 zu einem höheren Preis von Claude Sonnet 5, während /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet jeweils mit 404 fehlschlagen. Wenn du ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 und ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 festlegst, weißt du sicher, welches Modell für jeden Durchlauf berechnet wird. Den Alias opus auf Opus 5.5 festzulegen erfordert Claude Code v2.1.280 oder höher; führe bei einer älteren Version claude update aus.

Was bedeutet es, wenn /status etwas anzeigt – läuft es dann mit dem API-Key?

Zwei Zeilen: „Anthropic base URL“ ist https://api.kunavo.com, und bei „Auth token“ steht ANTHROPIC_AUTH_TOKEN. Wenn stattdessen „Login method“ mit einem claude.ai-Konto angezeigt wird, verwendet die Sitzung weiterhin die alte Anmeldung; melde dich ab, öffne ein neues Terminal und prüfe erneut, wo die Variable gesetzt wurde. Du kannst den Key bereits vor dem Öffnen von Claude Code mit einem curl-Befehl testen, der eine Anfrage an /v1/messages mit max_tokens gleich 1 sendet: Beginnt die zurückgegebene JSON-Antwort mit {"id":"msg_, ist alles in Ordnung; 401 bedeutet, dass der Key abgelehnt wurde.

Benötige ich in Vietnam ein VPN, um Claude Code zu installieren oder zu verwenden?

Nein. Vietnam steht auf der Liste der von Anthropic unterstützten Länder – sowohl für Claude.ai als auch für die API (Stand 3. Oktober 2026). Wenn das VPN die Verbindung dagegen in ein nicht unterstütztes Land leitet, kann die Installationsadresse statt des Skripts die Seite „App unavailable in region“ zurückgeben. Wenn dieser Fehler in Vietnam auftritt, deaktiviere VPN oder Proxy und führe den Installationsbefehl erneut aus.

Kann ich mit MoMo, ZaloPay oder VNPay Geld einzahlen? Gibt es VAT-Rechnungen?

Beides gibt es nicht. Auf der Stripe-Zahlungsseite von Kunavo können Käufer in Vietnam Visa, Mastercard oder Link auswählen sowie Apple Pay oder Google Pay, sofern das Gerät entsprechend eingerichtet ist; MoMo, ZaloPay, VNPay und Banküberweisung werden nicht unterstützt. Der Betrag kann in VND angezeigt werden; in diesem Fall enthält der Stripe-Wechselkurs eine vom Käufer zu tragende Umrechnungsgebühr von 2–4 %. Bei Zahlung in USD entfällt diese Gebühr, aber deine Bank kann einen eigenen Wechselkurs und eigene Gebühren berechnen. Die Mindesteinzahlung beträgt 10 USD, das Guthaben verfällt nicht, und die automatische Aufladung funktioniert nur mit einer gespeicherten Karte oder Link. Kunavo stellt keine VAT-Rechnungen aus, auch keine elektronischen Rechnungen.