Für Claude Code wird die native Installation mit dem offiziellen Installationsbefehl von Anthropic empfohlen; npm ist der offizielle alternative Weg und benötigt Node.js 22 oder höher. Claude Code kann auch ohne Anmeldung bei einem Claude-Konto verwendet werden: Setze ANTHROPIC_BASE_URL (nur die Domain, ohne /v1), ANTHROPIC_AUTH_TOKEN und die vier Zeilen zur Festlegung der Modelle, um stattdessen einen nach Token abgerechneten API-Schlüssel zu verwenden. Das Kunavo-API-Guthaben kann per Alipay oder WeChat Pay aufgeladen werden; die Mindestaufladung beträgt $10. Führe abschließend in Claude Code /status aus, um die Verbindung zu prüfen.
# macOS、Linux、WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows 命令提示符(CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd命令和环境变量核对于 3. Oktober 2026,依据 Offizielle Installationsdokumentation für Claude Code和 Offizielle Dokumentation zu Umgebungsvariablen;价格和付款方式核对于 3. Oktober 2026。先说明一个事实:Von Anthropic unterstützte Länder und Regionen(核对于 3. Oktober 2026)中没有中国大陆、香港和澳门,Claude Code 安装文档的系统要求里也有一行「所在地区:Anthropic 支持的国家」。本页只讲官方文档写明的安装和配置方法,不提供任何绕过地区限制的办法。Kunavo 没有在中国大陆做过网络连通性测试,下面提到的下载地址、npm 源和 api.kunavo.com 能否在你的网络里访问,需要你自己确认。
Vor der Installation prüfen
| Element | Anforderungen (offizielle Installationsdokumentation, geprüft am 3. Oktober 2026) |
|---|---|
| Betriebssystem | macOS 13.0 oder höher; Windows 10 1809 oder höher bzw. Windows Server 2019 oder höher; Ubuntu 20.04 oder höher; Debian 10 oder höher; Alpine Linux 3.19 oder höher |
| Hardware | Mindestens 4 GB Arbeitsspeicher, x64- oder ARM64-Prozessor (32-Bit-Windows wird nicht unterstützt) |
| Shell | Bash, Zsh, PowerShell oder CMD |
| Netzwerk | Internetverbindung erforderlich |
| Standort | Von Anthropic unterstützte Länder und Regionen (Festlandchina, Hongkong und Macau sind nicht in der Liste enthalten) |
| Konto | Für die Anmeldung sind ein Pro-, Max-, Team-, Enterprise- oder Console-Konto erforderlich; die kostenlose Version von Claude.ai enthält Claude Code nicht. Mit einem API-Schlüssel sind weder ein Abonnement noch eine Anmeldung erforderlich. |
| Node.js | Nur für den npm-Weg erforderlich, Version 22 oder höher; bei der nativen Installation nicht erforderlich |
Methode 1: Offizielle native Installation (empfohlen)
Die offizielle Installationsdokumentation kennzeichnet die native Installation als empfohlen. Die Befehle sind die drei Abschnitte am Anfang dieser Seite: Für macOS, Linux und WSL die Zeile mit install.sh, für Windows PowerShell irm … | iex und für Windows CMD die Zeile mit install.cmd. Die native Installation aktualisiert sich im Hintergrund automatisch auf die neueste Version; die offizielle Dokumentation weist zugleich darauf hin, dass Installationen über Homebrew und WinGet standardmäßig nicht automatisch aktualisiert werden.
Öffne nach der Installation ein neues Terminalfenster (bereits geöffnete Fenster sehen den neuen PATH nicht) und prüfe anschließend:
claude --version # 正常会打印版本号,后面跟着 (Claude Code)
claude doctor # 只读的安装与设置诊断,不会开启会话claude doctor startet keine Sitzung, sondern gibt nur Diagnoseinformationen zum Installationsstatus und zu den Einstellungsdateien aus. Damit lässt sich unterscheiden, ob die Installation oder die Konfiguration fehlerhaft ist.
Bei einem Downloadfehler
如果终端里出现 syntax error near unexpected token '<' 或 curl: (22) The requested URL returned error: 403,按 Offizielle Dokumentation zur Installationsfehlerbehebung(核对于 3. Oktober 2026)的说法,这表示安装地址返回的是一个网页或错误状态码,而不是安装脚本。如果返回的网页写着 App unavailable in region,官方的解释是:Claude Code 在你所在的国家或地区不可用。不带网页内容的 403 也可能来自公司代理或防火墙拦截下载;官方建议,在支持地区内仍然遇到 403 时,先排查网络连接,再考虑其他安装方式。
Methode 2: npm-Installation (Node.js 22 oder höher erforderlich)
npm 仍是官方文档列出的安装方式。官方文档写明 npm 包需要 Node.js 22 或更高版本;版本较旧时 npm 会打印 EBADENGINE 警告但不会失败,安装照样完成,因为这个包下载的是一个运行时不依赖 Node.js 的原生程序。没有 Node.js 的话,从 Node.js-Website安装 22 或更高版本。
node -v # 需要 v22 或更高
npm install -g @anthropic-ai/claude-code # 不要加 sudoDie offizielle Dokumentation fordert ausdrücklich, sudo npm install -g nicht zu verwenden, da dies zu Berechtigungsproblemen und Sicherheitsrisiken führt. Verwenden Sie für Upgrades npm install -g @anthropic-ai/claude-code@latest, nicht npm update -g.
Wenn der Download aus der Standardquelle fehlschlägt oder sehr langsam ist: npmmirror
如果从 npm 默认源下载失败或很慢,可以改用 npmmirror。npmmirror-Startseite(核对于 3. Oktober 2026)说明它是「完整 npmjs.com 镜像」,只读,会「尽量与官方服务实时同步」,并给出了 registry 地址和设置命令。首页没有写明具体同步频率。
# 只在这一次安装时使用 npmmirror
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
# 或者把 npmmirror 设为 npm 的默认源(之后所有 npm 安装都会走它)
npm config set registry https://registry.npmmirror.com
# 以后升级用 @latest,不要用 npm update -g
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.comBei der Installation von Claude Code über einen Mirror gibt es zwei leicht zu übersehende Voraussetzungen, die beide aus der offiziellen Fehlerbehebungsdokumentation stammen:
- Der Mirror muss gleichzeitig 8 Plattformpakete bereitstellen. Das npm-Paket selbst ist nur eine Hülle; das eigentliche Programm wird als optionale Abhängigkeit in Form von
@anthropic-ai/claude-code-*-Plattformpaketen heruntergeladen. Fehlt dem Mirror ein Plattformpaket, erscheint nach der Installation beim Ausführen vonclaudeunter macOS oder Linuxclaude native binary not installed(unter Windows melden PowerShell oder CMD, dass diese Datei nicht ausgeführt werden kann). Bei einer Prüfung durch Kunavo am 3. Oktober 2026 von außerhalb Festlandchinas stimmten das Hauptpaket sowie die Pakete für Windows x64, macOS ARM64 und Linux x64 auf npmmirror mit der neuesten npmjs-Version überein; die übrigen Plattformpakete (ARM64 Windows, Intel Mac, ARM64 Linux und zwei musl-Versionen) wurden nicht überprüft. - Optionale Abhängigkeiten dürfen nicht übersprungen werden. Füge dem Installationsbefehl nicht
--omit=optionalhinzu und prüfe außerdem, dass in.npmrcnichtoptional=falsegesetzt ist.
Besonderheiten unter Windows
Unter Windows gibt es zwei unterschiedliche Installationsbefehle; der Unterschied hängt ausschließlich davon ab, welches Terminal geöffnet ist. Der Prompt PS C:\Users\你的用户名> bezeichnet PowerShell; ohne PS und nur mit C:\Users\你的用户名> handelt es sich um die Eingabeaufforderung (CMD). Laut offizieller Dokumentation ist für die Installation keine Ausführung als Administrator erforderlich.
Ein häufiger Fehler unter Windows ist das Einfügen des falschen Terminalbefehls: Wird in PowerShell die CMD-Zeile ausgeführt, erscheint The token '&&' is not a valid statement separator; wird in CMD die PowerShell-Zeile ausgeführt, erscheint 'irm' is not recognized as an internal or external command. Wechsle in beiden Fällen zur entsprechenden Zeile. Im Startmenü gibt es außerdem „Windows PowerShell“ und „Windows PowerShell (x86)“; Letzteres ist ein 32-Bit-Prozess und führt zu Claude Code does not support 32-bit Windows. Öffne daher die Variante ohne (x86).
Git for Windows 是可选的:装了以后 Claude Code 用它附带的 Git Bash 执行命令;没装时改用 PowerShell 工具执行。装了却找不到 Git Bash 时,在 ~/.claude/settings.json 的 env 里设置 CLAUDE_CODE_GIT_BASH_PATH,指向 bash.exe,官方示例路径是 C:\Program Files\Git\bin\bash.exe。
| Methode | Was wird benötigt? | Sandbox-Ausführung | Geeignet für |
|---|---|---|---|
| Native Windows-Ausführung | Nicht erforderlich; Git for Windows ist optional | Nicht unterstützt | Projekte und Tools befinden sich bereits unter Windows |
| WSL 2 | WSL 2 aktivieren | Unterstützt | Wenn eine Linux-Toolchain benötigt wird oder Befehle in einer Sandbox ausgeführt werden sollen |
| WSL 1 | WSL 1 aktivieren | Nicht unterstützt | Wenn WSL 2 nicht verwendet werden kann |
Wenn du WSL wählst, führe die macOS-/Linux-Zeile im WSL-Terminal aus und starte claude ebenfalls in WSL, nicht in PowerShell oder CMD.
Fehler bei der Ausführungsrichtlinie des npm-Wegs
Wenn du npm in PowerShell installierst oder ausführst und npm.ps1 cannot be loaded because running scripts is disabled on this system siehst, blockiert die Ausführungsrichtlinie von PowerShell das von npm erzeugte Startskript .ps1. Die offizielle Dokumentation nennt drei Lösungen: lokale Skripte für den aktuellen Benutzer zulassen (mit der folgenden Zeile); npm.cmd oder claude.cmd verwenden; oder den nativen PowerShell-Installationsbefehl nutzen.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserNach der Installation wird claude nicht gefunden
Wenn command not found: claude oder 'claude' is not recognized erscheint, befindet sich das Installationsverzeichnis nicht im PATH. Die native Installation legt das Programm unter macOS/Linux unter ~/.local/bin/claude und unter Windows unter %USERPROFILE%\.local\bin\claude.exe ab. Öffnen Sie zunächst ein neues Terminal und versuchen Sie es erneut. Wenn es unter Windows weiterhin nicht funktioniert, prüfen Sie gemäß der offiziellen Dokumentation zur Fehlerbehebung mit PowerShell den Benutzer-PATH und fügen Sie das Installationsverzeichnis hinzu:
# 1. 检查安装目录是否已在 PATH 里
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. 没有任何输出时,把它加进「用户」PATH,然后关掉终端重新打开
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. 重新打开终端后确认
claude --versionAPI-Schlüssel konfigurieren: ohne Anmeldung bei einem Claude-Konto
ANTHROPIC_BASE_URL ist eine in Claude Code integrierte Umgebungsvariable. Laut offizieller Dokumentation überschreibt sie den API-Endpunkt, sodass Anfragen über einen Proxy oder ein Gateway laufen. Claude Code auf einen Endpunkt zu richten, der die Anthropic Messages API bereitstellt, ist daher eine offiziell unterstützte Konfiguration; Plugins oder eine modifizierte Anwendung sind nicht erforderlich. Unter macOS/Linux wird sie in die Shell-Konfigurationsdatei geschrieben:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # 只写到域名,不要加 /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Unter Windows zunächst in einem PowerShell-Fenster testen:
# 只对当前 PowerShell 窗口有效,关掉窗口就失效
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claudeFür die dauerhafte Verwendung empfiehlt es sich, sie in den Abschnitt env der benutzerweiten Einstellungsdatei ~/.claude/settings.json zu schreiben (unter Windows %USERPROFILE%\.claude\settings.json). Dort können jedes Terminal und Hintergrundaufgaben sie lesen. Wenn die Datei bereits andere Einstellungen enthält, füge env zusammengeführt 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"
}
}Bei diesen sechs Zeilen kann jeweils leicht etwas falsch gesetzt werden:
ANTHROPIC_BASE_URLdarf nur die Domain enthalten. Claude Code hängt selbst/v1/messagesan; mit dem zusätzlichen/v1entsteht/v1/v1/messagesund die Anfrage liefert 404.- Verwende
ANTHROPIC_AUTH_TOKENstattANTHROPIC_API_KEY. Laut offizieller Dokumentation wird der Wert vonANTHROPIC_AUTH_TOKENalsAuthorization-Header gesendet und automatisch um das PräfixBearerergänzt; die Einstellung wird sofort wirksam.ANTHROPIC_API_KEYerfordert dagegen zunächst eine einmalige Bestätigung im interaktiven Modus. Wenn du dabei Ablehnen auswählst, wird dieser Schlüssel anschließend stillschweigend ignoriert (du musst ihn unter/configin Use custom API key erneut aktivieren). ANTHROPIC_MODELlegt das Hauptmodell fest. Hier wird es auf Claude Sonnet 5 (claude-sonnet-5) festgelegt. Der Modellname muss exakt mit der Modellliste von Kunavo übereinstimmen; alte Namen mit Datumszusatz werden nicht automatisch zugeordnet.ANTHROPIC_DEFAULT_OPUS_MODELlegt den Aliasopusfest.按 Offizielle Dokumentation zur Modellkonfiguration(核对于 3. Oktober 2026),API 用户的默认模型和opus别名指向最新的 Opus(目前是 Opus 5.5),sonnet别名指向 Sonnet 5.5,而且别名会跟着 Anthropic 的新版本移动。官方文档写明别名「会随时间更新」,要固定版本,就写完整模型名或设置ANTHROPIC_DEFAULT_OPUS_MODEL这类变量。Kunavo 目前没有提供 Sonnet 5.5,Anthropic 以后发布新 Opus 时 Kunavo 也不一定已经上架,没上架的模型会返回 404。这就是要把主模型、opus和sonnet别名都固定下来的原因。这里opus别名固定为 Claude Opus 5.5(claude-opus-5-5),需要 Claude Code v2.1.280 或更高版本,旧版本先运行claude update升级。ANTHROPIC_DEFAULT_SONNET_MODELlegt den Aliassonnetfest. Laut offizieller Dokumentation bestimmt diese Variable, auf welches Modell der Aliassonnetzeigt, und welches Modellopusplanaußerhalb des Planungsmodus (in der Ausführungsphase) verwendet. Der Aliassonnetfordert standardmäßig Sonnet 5.5 an, das Kunavo derzeit nicht anbietet. Ohne diese Zeile liefern daher/model sonnet, die Ausführungsphase vonopusplanund Subagenten mitmodel: sonnet404 zurück. Auch hier wird Claude Sonnet 5 (claude-sonnet-5) fest eingestellt.ANTHROPIC_DEFAULT_HAIKU_MODELsteuert auch Hintergrundaufgaben. Laut offizieller Dokumentation legt diese Variable den Aliashaikufest und wird auch für Hintergrundfunktionen verwendet. Claude Haiku 4.5 kostet bei Kunavo pro Million Token $0.70 für die Eingabe und $3.50 für die Ausgabe; für das Hauptmodell Claude Sonnet 5 betragen die Preise $1.40 / $7.00(offizielle Preise von Anthropic: $2.00 / $10.00); für Claude Opus 5.5 unter dem Aliasopusbetragen sie $2.80 / $14.00.
Der Schlüssel darf nicht in .claude/settings.json des Projekts geschrieben werden: Die offizielle Dokumentation weist darauf hin, dass diese Datei übergeben und mit allen Personen geteilt wird, die das Repository klonen. Außerdem gilt folgende Priorität: Wenn dieselbe Variable sowohl in der Shell als auch in der settings-Datei gesetzt ist, hat der Wert in der settings-Datei Vorrang. Wenn eine geänderte Shell-Variable nicht wirksam wird, prüfe zuerst die settings-Datei.
Was passiert beim ersten Start?
按官方的 Dokumentation zur Gateway-Verbindung(核对于 3. Oktober 2026),设置了 ANTHROPIC_AUTH_TOKEN 后运行 claude,会直接进入会话,Keine Anmeldeseite anzeigen;这个变量立即生效,不像 ANTHROPIC_API_KEY 那样要先确认一次。如果打开后看到的是登录页,说明 Claude Code 没有读到凭据。
Die Zugangsdaten müssen an einem Ort stehen, den Claude Code bereits vor der ersten Einrichtung liest: in der Shell über export oder in env des benutzerweiten ~/.claude/settings.json. Die offizielle Dokumentation erklärt, dass im interaktiven Modus env von .claude/settings.json oder .claude/settings.local.json auf Projektebene erst nach dem erstmaligen Einrichtungsassistenten und der Aufforderung zum Vertrauen in den Ordner wirksam wird. Wenn der Schlüssel in den Projekteinstellungen steht, wird beim ersten Start daher weiterhin die Anmeldeseite angezeigt.
Nach dem Eintritt in die Sitzung führe /status aus und sieh auf der Status-Seite nach zwei Zeilen:
Anthropic base URL: Diese Zeile erscheint nur, wenn eine Gateway-Adresse gesetzt ist, und solltehttps://api.kunavo.comanzeigen. Fehlt sie, wurdeANTHROPIC_BASE_URLnicht an diese Sitzung übergeben.Auth token: Der EintragANTHROPIC_AUTH_TOKENzeigt, dass ein API-Schlüssel verwendet wird und keine gespeicherte claude.ai-Anmeldung. WennLogin methodzusammen mit einem claude.ai-Konto angezeigt wird, ist die Variable nicht wirksam geworden.
Wenn du Adresse und Schlüssel vor dem Öffnen von Claude Code separat testen möchtest, kannst du nach der Methode der offiziellen Dokumentation eine Anfrage mit nur 1 Ausgabetoken senden (dabei wird nur ein sehr kleiner Betrag tokenbasiert abgezogen). Dieser Befehl liest die Variablen aus der Shell. Selbst wenn du den Schlüssel in der settings-Datei eingetragen hast, musst du daher zunächst einmal export im aktuellen Terminal ausführen. Beginnt das zurückgegebene JSON mit {"id":"msg_, sind Adresse und Schlüssel in Ordnung; bei 401 wurde der Schlüssel nicht erkannt.
curl -sS -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": "."}]}'Was ist bei der Verwendung eines API-Schlüssels anders?
- Remote Control und Spracheingabe sind nicht verfügbar. Laut offizieller Dokumentation benötigen beide Funktionen eine claude.ai-Identität und sind bei gesetztem
ANTHROPIC_AUTH_TOKENnicht verfügbar. WennANTHROPIC_BASE_URLauf eine Nicht-Anthropic-Adresse zeigt, wird Remote Control ebenfalls deaktiviert. /fastzeigt an, dass der Fast-Modus deaktiviert ist. Laut offizieller Dokumentation behandelt Claude Code den Fast-Modus bei einem Bearer-Token grundsätzlich als deaktiviert und sendet keine Verfügbarkeitsprüfung.- Die Suche nach MCP-Tools ist standardmäßig deaktiviert. Laut offizieller Dokumentation ist die MCP-Tool-Suche standardmäßig deaktiviert, wenn
ANTHROPIC_BASE_URLauf eine Nicht-Anthropic-Adresse zeigt. - Die Zahl in
/contextist eine lokale Schätzung.Kunavo 目前不提供/v1/messages/count_tokens。按 Offizielle Dokumentation zur Gateway-Kompatibilität(核对于 3. Oktober 2026),网关没有这个端点时,Claude Code 改用按字符估算,/context显示的是近似值。
Eine vollständige Anleitung zur Anbindung findest du in der Dokumentation zur Claude-Code-Anbindung (englisch).
Was genau deaktiviert CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC?
按 Offizielle Dokumentation zu Umgebungsvariablen(核对于 3. Oktober 2026),它的作用是关闭 Claude Code 的非必要网络流量,官方列出的内容是:
- Automatische Updates, Telemetrie und Fehlerberichte;
- Der Befehl
/feedbackund von Claude entworfene Feedbacktexte; - Versionshinweise und die Prüfung von PR-/MR-Status-Badges;
- Verfügbarkeitsprüfungen wie der Fast-Modus;
- Das Abrufen von Feature Flags, weshalb Remote Control und andere von Feature Flags abhängige Funktionen nicht verfügbar sind;
- Das erneute Ausführen im Hintergrund aus dem Plugin
command(dies ist ein lokaler Befehl, kein Netzwerkverkehr, da er die Installation von Abhängigkeiten auslösen kann).
Weitere ausdrücklich in der offiziellen Dokumentation genannte Einzelheiten: Auch 0 oder false gelten als aktiviert. Anders als bei den meisten Schaltervariablen werden die Funktionen erst durch das Löschen dieser Variable wiederhergestellt. Die automatische Installation aus dem offiziellen Plugin-Markt fällt nicht darunter; die Gateway-Modellerkennung wird nicht beeinflusst. Die offizielle Gateway-Dokumentation ergänzt, dass die Domain-Sicherheitsprüfung des WebFetch-Tools nicht beeinflusst wird und weiterhin auf api.anthropic.com zugreift. Zum Deaktivieren muss zusätzlich skipWebFetchPreflight: true in den Einstellungen gesetzt werden. Die offizielle Dokumentation beschreibt diese Variable nicht als Einstellung für die Kontorisikokontrolle.
Kunavo 不要求设置它,它也不影响发往 Kunavo 的模型请求。什么时候值得开启,官方 Dokumentation zur Gateway-Verbindung(核对于 3. Oktober 2026)给了一个场景:即使 ANTHROPIC_BASE_URL 指向网关,Claude Code 仍会向 Anthropic 和 GitHub 等第三方发送版本检查、遥测、发布说明之类的后台请求;如果你的网络只允许访问网关地址,这些请求会失败,并可能在出站监控里显示为被拦截的连接,官方的做法就是和网关变量一起设置这个变量。
Der Nachteil der Aktivierung ist, dass keine automatischen Updates mehr erfolgen; laut offizieller Empfehlung solltest du eine andere Update-Methode einplanen. Bei einer npm-Installation kannst du mit @latest manuell aktualisieren (siehe die letzte Zeile des obigen npmmirror-Abschnitts).
# 可选:关闭 Claude Code 的非必要网络流量(会同时关闭自动更新)
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# 想恢复时删掉这个变量;设成 0 或 false 仍然算开启
unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICPer Alipay oder WeChat aufladen und einen Schlüssel erhalten
Anthropic 官方的网页订阅只收信用卡或借记卡(FAQ zur Abrechnung kostenpflichtiger Claude-Tarife,核对于 3. Oktober 2026)。在 Kunavo 充值可以用支付宝或微信支付,步骤概要如下,完整步骤见 Anleitung zum Aufladen der Claude API per Alipay und WeChat Pay:
- Erstelle ein Kunavo-Konto; E-Mail-Adresse oder Google-Konto sind möglich, und für die Registrierung ist keine Kartenverknüpfung erforderlich.
- Wähle unter Abrechnung den Aufladebetrag, mindestens $10, ohne Monatsgebühr. Bei größeren Aufladungen gibt es einen Bonus: 充 $100 到账 $110、充 $1000 到账 $1200、充 $5000 到账 $6250.
- Wähle auf der Stripe-Checkout-Seite Alipay oder WeChat Pay und bezahle per QR-Code. Beim Öffnen in Festlandchina wird der Betrag in Renminbi angezeigt; maßgeblich ist die Zahl auf der Checkout-Seite.
- Öffne /app/keys, erstelle einen Schlüssel mit dem Präfix
sk-kn-(er wird nur einmal angezeigt, bitte sofort speichern) und trage ihn oben beiANTHROPIC_AUTH_TOKENein.
Alipay und WeChat Pay erlauben nur manuelle Aufladungen; automatische Aufladungen können nur mit einer Bankkarte oder Link eingerichtet werden. Kunavo stellt keine chinesischen Umsatzsteuerrechnungen aus; Aufladevorgänge können auf der Billing-Seite eingesehen werden.
Was kostet es ungefähr? (Beispielrechnung)
Claude Code wird nach Token abgerechnet. Bei jeder Anfrage wird der Gesprächskontext erneut gesendet; ein mit dem vorherigen identischer Präfix kann dabei zum Preis für das Lesen aus dem Cache abgerechnet werden. Die folgende Rechnung dient nur als Beispiel für Token-Arithmetik, ist keine gemessene Abrechnung und keine Kostenobergrenze. Alle Annahmen:
- Pro Anfrage 40,000 Eingabetoken, davon 36,000 (90 %) zum Preis für das Lesen aus dem Cache; die übrigen 4,000 zum Preis für das Schreiben in den Cache;
- Pro Anfrage 1,000 Ausgabetoken;
- Während eines Arbeitszeitraums werden 50 solcher Anfragen gesendet; Hintergrundaufrufe von Claude Haiku 4.5 werden nicht berücksichtigt;
- Kunavo-Preise: Das Lesen aus dem Cache kostet 10% des Eingabepreises, das Schreiben in den Cache das 1.25-Fache des Eingabepreises (Verhältnis von Claude Sonnet 5; in der Tabelle wird jedes Modell mit seinem eigenen Verhältnis berechnet).
| Modell | Pro Anfrage | Insgesamt 50 Anfragen | Insgesamt 50 Anfragen bei vollständig fehlenden Cache-Treffern |
|---|---|---|---|
| Claude Sonnet 5 | $0.019 | $0.95 | $3.15 |
| Claude Opus 5.5 | $0.033 | $1.65 | $6.30 |
Die tatsächlichen Kosten hängen von der Länge des Kontexts, der Cache-Trefferquote, der Ausgabelänge und davon ab, ob du mit /clear zwischen Aufgaben den Dialog leerst. Wie du zwischen Claude-Code-Abonnement und API wählst und was es ungefähr pro Monat kostet, erfährst du unter Claude-Code-Preise; die vollständigen Preise aller Modelle findest du unter Claude-API-Preise und auf der Preisseite. Für eine Schätzung anhand deiner eigenen Nutzung kannst du den Claude-Tokenkostenrechner verwenden (englisch).
Übersicht häufiger Fehlermeldungen
| Angezeigte Information | Ursache und Lösung |
|---|---|
The token '&&' is not a valid statement separator | In PowerShell wurde die CMD-Zeile ausgeführt; verwende stattdessen irm … | iex. |
'irm' is not recognized as an internal or external command | In CMD wurde die PowerShell-Zeile ausgeführt; verwende stattdessen die Zeile mit install.cmd. |
syntax error near unexpected token '<'、403 | Die Installationsadresse hat eine Webseite oder einen Fehlerstatus zurückgegeben. Wenn die Webseite App unavailable in region anzeigt, bedeutet dies laut offizieller Erklärung, dass Claude Code in deinem Land oder deiner Region nicht verfügbar ist. Prüfe in anderen Fällen das Netzwerk anhand der offiziellen Fehlerbehebungsdokumentation. |
command not found: claude、'claude' is not recognized | Das Installationsverzeichnis befindet sich nicht im PATH. Öffne zunächst ein neues Terminal; unter Windows füge es mit dem obigen PowerShell-Abschnitt zum Benutzer-PATH hinzu. |
EBADENGINE-Warnung | Node.js ist älter als Version 22. Laut offizieller Dokumentation wird die Installation trotzdem abgeschlossen; ein Upgrade auf Version 22 oder höher wird empfohlen. |
claude native binary not installed (macOS, Linux) | npm hat optionale Abhängigkeiten übersprungen (--omit=optional oder optional=false), Installationsskripte übersprungen (--ignore-scripts) oder der verwendete Mirror enthält die Plattformpakete nicht. Entferne die entsprechenden Einstellungen und installiere erneut. |
npm.ps1 cannot be loaded | Die Ausführungsrichtlinie von PowerShell blockiert das Startskript von npm. Führe die Zeile mit Set-ExecutionPolicy aus oder verwende die native Installation. |
Claude Code does not support 32-bit Windows | Windows PowerShell (x86) wurde geöffnet; öffne stattdessen die Variante ohne x86. |
Obwohl ein Schlüssel gesetzt wurde, erscheint beim Ausführen von claude weiterhin die Anmeldeseite | Claude Code hat die Zugangsdaten nicht gelesen. Schreibe die Variablen in die Shell-Konfiguration oder in ~/.claude/settings.json und nicht nur in die Projekteinstellungen; öffne danach ein neues Terminal. |
401 | Der Schlüssel wurde nicht erkannt: Prüfe, ob du den vollständigen Schlüssel mit dem Präfix sk-kn- kopiert hast, keine überflüssigen Leerzeichen vorhanden sind, der Schlüssel nicht unter /app/keys gelöscht wurde und du ANTHROPIC_AUTH_TOKEN verwendest. |
404 | Bei ANTHROPIC_BASE_URL wurde /v1 zusätzlich angegeben oder der angeforderte Modellname ist nicht in der Kunavo-Modellliste enthalten (beispielsweise weil die vier Modell-Fixierungen nicht gesetzt wurden). |
Wichtige Einschränkungen
- Kunavo stellt keine chinesischen Umsatzsteuerrechnungen aus.
- Alipay und WeChat Pay erlauben nur manuelle Aufladungen; automatische Aufladungen können nur mit einer Bankkarte oder Link eingerichtet werden.
- Dies ist eine nach Token abgerechnete API, kein Claude-Pro-/Max-Abonnement; bei Verwendung eines API-Schlüssels sind Remote Control und Spracheingabe nicht verfügbar. Wie du zwischen beiden Optionen wählst, erfährst du unter Claude-Code-Preise.
- Kunavo hat keine Netzwerkkonnektivitätstests aus Festlandchina durchgeführt. Ob die Installationsadressen von claude.ai, npm-Quellen, npmmirror und
api.kunavo.comin deinem Netzwerk erreichbar sind und welche Geschwindigkeit sie haben, musst du selbst prüfen. - Festlandchina, Hongkong und Macau sind in der Liste der von Anthropic unterstützten Länder und Regionen (geprüft am 3. Oktober 2026) nicht enthalten; die offizielle Installationsdokumentation von Claude Code nennt die Region als eine der Systemanforderungen.
Häufig gestellte Fragen
Wie installiert man Claude Code in China? Mit dem offiziellen Installationsskript oder npm?
Die offizielle Installationsdokumentation von Anthropic kennzeichnet die native Installation als empfohlene Methode: Auf macOS, Linux und WSL führt man curl -fsSL https://claude.ai/install.sh | bash aus; unter Windows in PowerShell irm https://claude.ai/install.ps1 | iex und in CMD curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Die native Installation aktualisiert sich automatisch im Hintergrund. npm (npm install -g @anthropic-ai/claude-code) ist weiterhin eine in der offiziellen Dokumentation aufgeführte Installationsmethode und benötigt Node.js 22 oder höher. Zu beachten ist, dass Festlandchina in der von Anthropic unterstützten Regionenliste (geprüft am 3. Oktober 2026) nicht enthalten ist; die offizielle Installationsdokumentation nennt die Region als eine der Systemanforderungen. Kunavo hat nicht getestet, ob diese Downloadadressen in Festlandchina erreichbar sind.
Welche Node.js-Version benötigt die npm-Installation von Claude Code? Kann man den Taobao-Mirror (npmmirror) verwenden?
Die offizielle Dokumentation verlangt Node.js 22 oder höher; auch das Feld engines des npm-Pakets gibt >=22.0.0 an. Bei einer älteren Node.js-Version gibt npm lediglich eine EBADENGINE-Warnung aus, die Installation wird dennoch abgeschlossen, weil das npm-Paket ein natives Programm herunterlädt, das zur Laufzeit nicht von Node.js abhängt. Wenn der Download aus der Standardquelle fehlschlägt oder sehr langsam ist, kannst du nach dem Installationsbefehl --registry=https://registry.npmmirror.com hinzufügen oder mit npm config set registry https://registry.npmmirror.com npmmirror als Standardquelle festlegen. Auf der Startseite von npmmirror wird erklärt, dass es sich um einen schreibgeschützten vollständigen npmjs.com-Mirror handelt, der möglichst in Echtzeit mit dem offiziellen Dienst synchronisiert wird. Die offizielle Fehlerbehebungsdokumentation von Claude Code weist darauf hin, dass der Mirror gleichzeitig 8 @anthropic-ai/claude-code-* Plattformpakete bereitstellen muss und npm optionale Abhängigkeiten nicht überspringen darf, da sonst nach der Installation das native Programm fehlt. Am 3. Oktober 2026 hat Kunavo über ein Netzwerk außerhalb Festlandchinas geprüft, dass das Hauptpaket sowie die Pakete für Windows x64, macOS ARM64 und Linux x64 auf npmmirror mit den npmjs-Versionen übereinstimmen; die übrigen Plattformpakete wurden nicht überprüft.
Wie installiert man Claude Code unter Windows? Müssen WSL und Git unbedingt installiert werden?
Nicht unbedingt. Unter nativem Windows genügt es, den entsprechenden Installationsbefehl direkt in PowerShell oder CMD auszuführen; Administratorrechte sind nicht erforderlich. Git for Windows ist optional: Nach der Installation verwendet Claude Code die mitgelieferte Git-Bash zur Ausführung von Befehlen, andernfalls die PowerShell-Tools. Native Windows-Installationen unterstützen keine Sandbox-Ausführung; wenn du eine Sandbox oder eine Linux-Toolchain benötigst, wähle WSL 2 und installiere und starte claude im WSL-Terminal, nicht in PowerShell oder CMD. Öffne außerdem nicht die 32-Bit-PowerShell mit der Bezeichnung (x86), da Claude Code 32-Bit-Windows nicht unterstützt.
Kann man Claude Code direkt mit einem API-Schlüssel ausführen, ohne ein Claude-Pro-/Max-Abonnement und ohne sich anzumelden?
Ja. Für die Anmeldung über ein Claude-Konto benötigst du Pro, Max, Team, Enterprise oder ein Console-Konto; die kostenlose Version von Claude.ai enthält Claude Code nicht. Bei Verwendung eines API-Schlüssels ist keine Anmeldung erforderlich: Setze in der Shell-Konfiguration oder in ~/.claude/settings.json ANTHROPIC_BASE_URL=https://api.kunavo.com und ANTHROPIC_AUTH_TOKEN. Nach dem Start von Claude Code gelangst du direkt in eine Sitzung, ohne Anmeldeseite und ohne zusätzliche Bestätigung; die tatsächlich verwendeten Token werden vom Kunavo-Guthaben abgezogen. Remote Control und Spracheingabe benötigen eine claude.ai-Identität und sind bei Verwendung eines API-Schlüssels nicht verfügbar.
Muss ANTHROPIC_BASE_URL um /v1 ergänzt werden? Wo müssen die Umgebungsvariablen stehen, damit sie wirksam werden?
Nein. Claude Code fügt selbst /v1/messages an, daher darf ANTHROPIC_BASE_URL nur die Domain enthalten: https://api.kunavo.com. Wenn der Wert mit /v1 endet, werden Anfragen an /v1/v1/messages gesendet und liefern 404. Setze die Variable in der Shell-Konfiguration (~/.zshrc, ~/.bashrc oder $PROFILE in PowerShell) oder im env-Abschnitt der benutzerweiten ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Schreibe sie nicht in .claude/settings.json des Projekts: Diese Datei wird ins Repository committet und damit an alle Personen weitergegeben, die das Repository klonen. Außerdem wird env auf Projektebene im interaktiven Modus erst nach dem erstmaligen Einrichtungsassistenten und der Aufforderung zum Vertrauen in den Ordner wirksam. Wenn dieselbe Variable sowohl in der Shell als auch in der settings-Datei gesetzt ist, hat die settings-Datei Vorrang.
Warum sollte man ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL und ANTHROPIC_DEFAULT_SONNET_MODEL setzen? Was passiert, wenn man sie nicht setzt?
Ohne feste Modellzuweisung verwendet Claude Code Aliase, die sich mit neuen Anthropic-Versionen ändern. Laut der offiziellen Model-Konfigurationsdokumentation von Claude Code (geprüft am 3. Oktober 2026) zeigen das Standardmodell und der Opus-Alias für API-Nutzer auf Opus 5.5, der Sonnet-Alias auf Sonnet 5.5; die Aliase werden im Laufe der Zeit aktualisiert. Die von der offiziellen Dokumentation empfohlene feste Methode besteht darin, den vollständigen Modellnamen zu schreiben oder Variablen wie ANTHROPIC_DEFAULT_OPUS_MODEL zu setzen. Kunavo bietet Sonnet 5.5 derzeit nicht an: Ohne ANTHROPIC_DEFAULT_SONNET_MODEL fordern /model sonnet, die Ausführungsphase von opusplan und Subagenten mit model: sonnet Sonnet 5.5 an und erhalten 404. Auch wenn Anthropic später ein neues Opus veröffentlicht, muss es bei Kunavo nicht bereits verfügbar sein; auch dann wird 404 zurückgegeben. Nach der Fixierung lauten das Hauptmodell und der Sonnet-Alias claude-sonnet-5, der Opus-Alias claude-opus-5-5 (Opus 5.5 benötigt Claude Code v2.1.280 oder höher; führe bei älteren Versionen zuerst claude update aus), der Haiku-Alias und Hintergrundaufgaben claude-haiku-4-5. Welches Modell verwendet wird und zu welchem Preis abgerechnet wird, ist damit eindeutig.
Soll CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC aktiviert werden? Was wird dadurch deaktiviert?
Laut der offiziellen Dokumentation zu den Umgebungsvariablen von Claude Code (geprüft am 3. Oktober 2026) deaktiviert die Variable nicht notwendigen Netzwerkverkehr: automatische Updates, Telemetrie, Fehlerberichte, den Befehl /feedback, von Claude entworfene Feedbacktexte, Versionshinweise, die Prüfung von PR-/MR-Status-Badges sowie Verfügbarkeitsprüfungen wie den Fast-Modus. Außerdem werden Feature-Flag-Abrufe beendet, sodass von Feature Flags abhängige Funktionen wie Remote Control nicht verfügbar sind. Auch 0 oder false gelten als aktiviert; erst das Löschen der Variable stellt die Funktionen wieder her. Die Sicherheitsprüfung der Domain durch das WebFetch-Tool für api.anthropic.com wird dadurch nicht beeinflusst. Die offizielle Dokumentation beschreibt die Variable nicht als Einstellung für die Kontorisikokontrolle. Nach der Aktivierung erfolgen keine automatischen Updates mehr; du musst selbst regelmäßig aktualisieren. Bei einer npm-Installation verwende npm install -g @anthropic-ai/claude-code@latest. Kunavo verlangt diese Variable nicht, und sie beeinflusst keine an Kunavo gesendeten Modellanfragen. Die offizielle Gateway-Dokumentation erklärt zusätzlich, dass Claude Code selbst bei einem auf ein Gateway gerichteten ANTHROPIC_BASE_URL weiterhin Hintergrundanfragen wie Versionsprüfungen, Telemetrie und Versionshinweise an Drittanbieter wie Anthropic und GitHub sendet. Wenn dein Netzwerk nur die Gateway-Adresse zulässt, schlagen diese Anfragen fehl; offiziell wird empfohlen, die Variable gleichzeitig zu setzen.
Kann man per Alipay oder WeChat aufladen? Sind automatische Verlängerungen und Rechnungen möglich?
Du kannst per Alipay oder WeChat aufladen: Kunavos Aufladung läuft über die Stripe-Checkout-Seite; Alipay und WeChat Pay gehören zu den auswählbaren Zahlungsmethoden. Beim Öffnen in Festlandchina wird der Betrag in Renminbi angezeigt; die Mindestaufladung beträgt $10, und es gibt keine Monatsgebühr. Alipay und WeChat Pay erlauben nur manuelle Aufladungen; automatische Aufladungen können nur mit einer Bankkarte oder Link eingerichtet werden. Kunavo stellt keine chinesischen Umsatzsteuerrechnungen aus; Aufladevorgänge kannst du auf der Billing-Seite einsehen.