Fehler 401, 403, 429 und 5xx beheben

Zwölf konkrete Fehlerbilder, die wir Woche für Woche sehen. Symptom → Ursache → Lösung in einer Zeile.

Häufigste Fragen

Muss ich mich bei Claude Code anmelden? Und was ist mit 401 und „Auth conflict“

Nein. Der OneProvider-Schlüssel funktioniert ohne Claude-Konto. Setzen Sie für Claude Code ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN (der Schlüssel wird als Authorization: Bearer gesendet). Diese Variable hat Vorrang vor einer gespeicherten Anmeldung und vor den anderen Variablen und braucht keine Bestätigungsabfrage. Unser Gateway akzeptiert auch ANTHROPIC_API_KEY (Header x-api-key), aber im interaktiven Modus bittet Claude Code einmalig um Bestätigung eines solchen Schlüssels und ignoriert einen abgelehnten stillschweigend (wieder aktivieren unter /config → Use custom API key).

Sehen Sie den Anmeldebildschirm, 401 Invalid API key oder Auth conflict, gehen Sie Schritt für Schritt vor:

1. Führen Sie /status aus: Es sollte die Anthropic base URL von OneProvider und eine Zeile Auth token oder API key mit dem Namen Ihrer Variable zeigen. Eine Zeile Login method mit einem claude.ai-Konto bedeutet, dass die Variable die Sitzung nicht erreicht hat.
2. Auth conflict (sowohl claude.ai-Anmeldung als auch Schlüssel): Führen Sie /logout aus; Ihre Variablen bleiben erhalten.
3. 401 Invalid API key: Ein fremdes ANTHROPIC_AUTH_TOKEN (ein Token eines anderen Dienstes) überschreibt Ihren Schlüssel, oder der Wert enthält ein überflüssiges Anführungszeichen oder Leerzeichen. Setzen Sie den vollständigen OneProvider-Schlüssel ohne Anführungszeichen.
4. Der Anmeldebildschirm bleibt, obwohl die Variablen in der .claude/settings.json eines Projekts stehen: Dieser Block wird erst nach der Ersteinrichtung gelesen – legen Sie die Variablen daher in Ihrer Shell oder in ~/.claude/settings.json ab.

# macOS / Linux: what is actually set
env | grep -E 'ANTHROPIC_(BASE_URL|AUTH_TOKEN|API_KEY)' | sed -E 's/(sk-.{4}).*/\1.../'
grep -nE 'ANTHROPIC_(AUTH_TOKEN|API_KEY)' ~/.zshrc ~/.bashrc 2>/dev/null

Muss ich mich für die Codex-CLI bei ChatGPT anmelden?

Nein. Codex funktioniert allein mit dem Schlüssel, wenn der Provider oneprovider in ~/.codex/config.toml aktiv ist (env_key = "ONEPROVIDER_API_KEY"). Eine ChatGPT-Anmeldeaufforderung oder „You've hit your usage limit“ bedeutet, dass der Provider nicht aktiv ist und die Anfrage an ChatGPT ging.

Prüfen Sie in dieser Reihenfolge: Die Zeilen model_provider und model stehen ganz oben in der Datei, über jedem [table]-Abschnitt; Codex ist vollständig neu gestartet und die Aufgabe ist neu; der Schlüssel ist im selben Terminal exportiert:

codex logout
export ONEPROVIDER_API_KEY="sk-..."
# quick test without editing the file:
codex -c model_provider=oneprovider

Die vollständige Anleitung steht auf der Seite Codex (OpenAI) .

Brauche ich ein VPN? Gibt es regionale Beschränkungen?

Es ist kein VPN nötig – OneProvider hat keine regionalen Beschränkungen. Der Endpoint api.oneprovider.dev ist weltweit erreichbar und sperrt keinen Traffic nach Region.

Schlimmer noch: VPN- und VLESS-Proxys stören die API-Verbindung oft auf zwei Arten:

• SSE-Streaming wird im Proxy gepuffert – der Stream bricht mitten im Token ab.
• Die Aushandlung von HTTP/2 + ALPN bricht an Relay-Hops – der Client sieht connection reset.

Sehen Sie abgebrochene Streams, connection reset oder zufällige Timeouts, schalten Sie das VPN bzw. den VLESS-Proxy aus und versuchen Sie es erneut. Auf unserer Seite puffern wir keine Streams.

JSON-Parse-Fehler in der Konfiguration (oder ein 429)

Die häufigste Ursache sind „intelligente“ Anführungszeichen (“ ”) in Ihrer JSON-Konfiguration. Sie entstehen, wenn Sie aus einem Messenger, Notion, Google Docs oder einem Browser kopieren, der ASCII-Anführungszeichen automatisch durch typografische ersetzt. JSON-Parser akzeptieren nur das einfache ASCII-Zeichen ".

Manchmal zeigt sich eine fehlerhafte Konfiguration nicht als „JSON-Parse-Fehler“, sondern als 429: Der Client wertet die fehlende Antwort als Rate-Limit. Gleiche Lösung:

• Ersetzen Sie jedes “ ” von Hand durch ".
• Kopieren Sie Konfigurationen direkt aus dieser Dokumentation – die Anführungszeichen sind hier bereits korrekt.
• Prüfen Sie mit cat -v config.json oder jq . config.json – beide markieren das fehlerhafte Byte.

# Quick check: jq fails on the first smart quote
jq . ~/.claude/settings.json
# Auto-replace smart quotes with straight quotes
sed -i.bak $'s/[\u201c\u201d]/"/g' ~/.claude/settings.json

Symptom-Matrix

Diagnose-Einzeiler

Trifft die Symptom-Matrix Ihren Fall nicht, sichern Sie diese drei Belege:

# 1. Confirm reach + auth
curl -sS -o /dev/null -w "HTTP %{http_code} total %{time_total}s\n" \
https://api.oneprovider.dev/v1/models -H "x-api-key: $ANTHROPIC_API_KEY"
# 2. Reproduce the failing call with -v (verbose headers)
curl -sv https://api.oneprovider.dev/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":32,"messages":[{"role":"user","content":"hi"}]}'
# 3. Check your current balance (also shown in the cabinet: the @oneprovider_robot bot or app.oneprovider.dev)
curl -s https://api.oneprovider.dev/v1/dashboard/balance \
-H "Authorization: Bearer $ANTHROPIC_API_KEY"

Wann Sie sich an uns wenden

Senden Sie die drei Ausgaben oben + die ersten 8 Zeichen Ihres Schlüssels + einen UTC-Zeitstempel an @Oneproviderhelpbot . Damit finden wir Ihre Anfrage in unseren Logs binnen Minuten. Was wir nicht brauchen (und nie erfragen), steht unter Support erhalten .