Claude Code · In China
Claude Code in China nutzen
Bei der Nutzung von Claude Code in China liegt die Schwierigkeit nicht in der Installation, sondern bei Netzwerk, Zahlung und Accounts. Diese Seite erklärt der Reihe nach: wie du es installierst, wie du dich mit einer API verbindest, die direkt aus China erreichbar ist, wie du Fehler behebst, wenn es installiert ist, aber nicht funktioniert, und wie du zwischen einem Claude-Abo (Pro / Max) und einem API-Relay wählst.
Zuletzt geprüft
3 Hindernisse bei der Nutzung von Claude Code in China
| Hindernis | Symptom | Lösung |
|---|---|---|
| Netzwerk | Keine Verbindung zum Anthropic-Endpunkt; Anfragen laufen in ein Timeout | Setze ANTHROPIC_BASE_URL auf einen Endpunkt, der direkt aus China erreichbar ist |
| Zahlung | Sowohl das Claude-Abo als auch die Anthropic API erfordern eine ausländische Kreditkarte | Nutze einen API-Dienst, der Zahlungsmethoden in China akzeptiert und ein Prepaid-Guthaben bietet |
| Account | Registrierung und Regionseinschränkungen beim Claude-Account | Nutze den Zugang per API-Key; kein Claude-Account-Login nötig |
Installation (npm und Registry in China)
1. Node.js 22 oder höher installieren
Prüfe deine Version mit node -v.
2. (Optional) Auf eine npm-Registry in China wechseln
Wenn npm-Downloads langsam sind, kannst du zuerst die Registry wechseln.
Terminalnpm config set registry https://registry.npmmirror.com3. Claude Code installieren
Nach der globalen Installation prüfst du mit claude --version.
Terminalnpm install -g @anthropic-ai/claude-code
Wenn du command not found siehst, ist das globale npm-Verzeichnis höchstwahrscheinlich nicht in deinem PATH. Führe npm config get prefix aus, füge das bin-Verzeichnis unter dem ausgegebenen Pfad zu deinem PATH hinzu und öffne dein Terminal neu.
Mit einer in China verfügbaren API verbinden
Erstelle einen API-Key in der AICodeWith-Konsole und trage ihn in ~/.claude/settings.json ein. Öffne dein Terminal neu, starte claude und tippe /status, um zu bestätigen, dass der API-Endpunkt api.aicodewith.ai ist.
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
}
}Fehlersuche: Wenn es nicht funktioniert
- Führe /status aus und bestätige, dass der Endpunkt api.aicodewith.ai ist und nicht der Standard-Endpunkt von Anthropic.
- Führe in einem neuen Terminal echo $ANTHROPIC_API_KEY aus. Wenn ein alter Wert erscheint, entferne ihn aus ~/.zshrc oder ~/.bashrc; ANTHROPIC_API_KEY sollte leer bleiben.
- Wenn der erste Start auf dem Login-Bildschirm hängen bleibt: Füge "hasCompletedOnboarding": true in ~/.claude.json hinzu.
- Timeout bei Anfragen: Deaktiviere vorübergehend deinen lokalen Proxy oder VPN und versuche es erneut. Das Netzwerk in China kann direkt verbinden.
- Bei 401 / 429 / overloaded: siehe Fehlerleitfaden.
Häufige Fehler bei Claude Code und ihre LösungenUnterstützte Regionen
Tarifvergleich (Claude-Abo vs. API-Relay)
| Claude-Abo (Pro / Max) | API-Relay (AICodeWith) | |
|---|---|---|
| Zahlung | Ausländische Kreditkarte, fester Monatspreis | Zahlungsmethoden in China; Prepaid-Guthaben, nutzungsabhängig |
| Netzwerk | Musst du selbst lösen | Direkt aus China erreichbar |
| Account | Claude-Account erforderlich | Nur ein API-Key nötig |
| Kontingent | Limits pro 5 Stunden und pro Woche | Wird vom Prepaid-Guthaben abgezogen; es gelten Rate- und Concurrency-Limits |
| Am besten für | Intensive tägliche Nutzung ohne Netzwerk- oder Zahlungsprobleme | China-Netzwerke, schwankende Nutzung, Teams mit getrennten API-Keys |
FAQ
Kann Claude Code in China direkt genutzt werden?
Ja. Die Installation selbst unterliegt keinen Einschränkungen. Sobald du den Endpunkt auf eine API umstellst, die direkt aus China erreichbar ist (zum Beispiel api.aicodewith.ai), kannst du sie direkt nutzen.
Brauche ich einen Proxy?
Nach der Verbindung mit AICodeWith ist kein Proxy nötig. Wenn ein lokaler Proxy läuft und Anfragen in ein Timeout laufen, schalte ihn aus und versuche es erneut.
Was, wenn ich keine ausländische Kreditkarte habe?
AICodeWith akzeptiert Zahlungsmethoden in China zum Aufladen. Das Prepaid-Guthaben wird pro Nutzung abgerechnet, bleibt 12 Monate gültig und wird nicht monatlich zurückgesetzt.
Was soll ich tun, wenn die Installation fehlschlägt oder ich command not found bekomme?
Stelle zuerst sicher, dass deine Node.js-Version 22 oder höher ist. Wenn npm-Downloads langsam sind, wechsle zu einer Registry in China. command not found bedeutet, dass das globale npm-bin-Verzeichnis nicht in deinem PATH ist; füge es hinzu und öffne dein Terminal neu.
Bereit zum Ausprobieren?
Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben. Es gelten Limits für Rate und Parallelität, und du kannst für jeden API-Schlüssel tägliche, monatliche oder gesamte Ausgabenlimits festlegen.
Ähnliche Themen
AICodeWith ist ein unabhängiger Drittanbieter-API-Dienst und steht in keiner Verbindung zu Anthropic oder OpenAI. Claude, Claude Code, Codex und andere Namen gehören ihren jeweiligen Inhabern. Preise basieren auf Echtzeitdaten auf der Modellseite; es gelten Rate- und Concurrency-Limits; Erstattungen unterliegen einer Bearbeitungsgebühr von 10 %. Details findest du in der Erstattungsrichtlinie.