Claude Code einrichten

Die CLI von Anthropic am OneProvider-Endpoint. Die Einrichtung besteht aus zwei Umgebungsvariablen und einem Prüfaufruf.

Installation

curl -fsSL https://claude.ai/install.sh | bash
# or:
brew install --cask claude-code

Option 1: Umgebungsvariablen (aktuelle Sitzung)

Am schnellsten setzen Sie die Variablen nur im aktuellen Terminal. Sie bleiben nicht über Sitzungen hinweg erhalten – wie sie einen Neustart überstehen, steht unten unter „Dauerhaft einrichten“.

export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here

Option 2: dauerhafte Einstellungen

Claude Code liest die Benutzereinstellungen aus settings.json. Das Standardmodell und die Familien-Aliase unten stammen aus den aktuell aktiven Modellen des Katalogs.

Dateipfad: ~/.claude/settings.json

{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
},
"model": "claude-sonnet-5-5"
}

Prüfen

claude -p "say hi in one sentence"

Innerhalb von ein, zwei Sekunden sollte eine einsätzige Antwort erscheinen. Bei 401 ist der Schlüssel falsch; 400 invalid_request_error bedeutet, dass der Modellname nicht zur kanonischen Liste passt (die Antwort nennt die unterstützten IDs).

Häufige Probleme

# validate the file
jq . ~/.claude/settings.json
# auto-replace smart quotes with ASCII
sed -i.bak $'s/[\u201c\u201d]/"/g' ~/.claude/settings.json

Die vollständige Liste der Symptome → Ursachen → Lösungen zu 400 / 401 / 403 / 404 / 429 / 503 / 504 finden Sie auf der Seite Fehlerbehebung .

Tool-Nutzung

Claude Code nutzt das Anthropic-native Tool-Schema. Die API akzeptiert jeden Tool-Namen (Read, Write, Edit, Bash, Grep, Glob, TodoWrite usw.) mit tool_choice: auto – das sendet die CLI standardmäßig. Ein anthropic-beta-Header ist nicht nötig.

Setzt Ihr eigener Orchestrator tool_choice: {"type": "any"} oder tool_choice: {"type": "tool", "name": "X"}, schreibt die API beides zu auto plus einem Hinweis im System-Prompt um. Die vollständige Tabelle steht unter Tool-Nutzung .

Dauerhaft einrichten

Sobald alles funktioniert und die Variablen über Terminalsitzungen hinweg erhalten bleiben sollen, tragen Sie sie in die rc-Datei Ihrer Shell (macOS / Linux) oder in die Benutzer-Umgebungsvariablen der Registry (Windows) ein. Neue Terminals übernehmen sie automatisch.

# append to ~/.zshrc (default macOS shell)
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
# apply to the current session:
source ~/.zshrc

Welches Modell wählen

Claude Code spricht das Anthropic-Protokoll und funktioniert daher am besten mit der Claude-Familie. Nutzen Sie claude-sonnet-5-5 als Alltagsstandard: ausgewogenes Verhältnis von Preis und Qualität für Änderungen, Tests und Erklärungen. Wechseln Sie zu claude-opus-5-5 für Architekturentscheidungen, große Refactorings und Fehler, die Sie nicht eingrenzen können; es kostet pro Token mehr. Nutzen Sie claude-haiku-5-5 für schnelle Fragen, Commit-Nachrichten und Hintergrundarbeit, bei der Tempo wichtiger ist als Tiefe. Innerhalb einer Sitzung wechseln Sie mit /model oder starten direkt mit claude --model claude-opus-5-5. Die Einstellungen oben ordnen die Aliase sonnet, opus und haiku diesen IDs zu. Aktuelle IDs stehen auf der Modellseite , die Preise auf der Preisseite . Die Preise gelten pro Million Tokens: Setzen Sie daher ein Ausgabenlimit für den Schlüssel und behalten Sie „Verbrauch“ im Dashboard im Blick.

Häufige Fehler und Lösungen

claude: command not found nach der Installation

Öffnen Sie zuerst ein neues Terminal: Das Installationsprogramm legt die Binärdatei in ~/.local/bin ab. Fehlt sie weiterhin, ergänzen Sie export PATH="$HOME/.local/bin:$PATH" in der rc-Datei Ihrer Shell. Bei Homebrew prüfen Sie, ob brew install --cask claude-code ohne Fehler durchgelaufen ist.

400 invalid_request_error zum Modell

Die Modell-ID steht nicht im Katalog, oft ein alter Alias wie claude-3-5-sonnet. Setzen Sie ANTHROPIC_MODEL und die drei Variablen ANTHROPIC_DEFAULT_*_MODEL wie in der settings.json oben, oder listen Sie die gültigen IDs mit curl -s https://api.oneprovider.dev/v1/models -H "x-api-key: $KEY" auf.

404 oder „The requested API endpoint does not exist“

ANTHROPIC_BASE_URL muss genau https://api.oneprovider.dev lauten: ohne /v1 und ohne /v1/messages am Ende. Claude Code hängt den Pfad selbst an.

429 „Insufficient balance on this API key“

Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht. Ein erneuter Versuch hilft nicht: Laden Sie das Guthaben auf oder erhöhen Sie das Limit im Konto und senden Sie die Anfrage dann noch einmal.

Die Antwort bricht mittendrin ab oder die Verbindung wird zurückgesetzt

Schalten Sie jedes VPN oder jeden VLESS-Proxy aus: Diese puffern Streams und stören HTTP/2. OneProvider sperrt nicht nach Region und puffert keine Streams. Eine Anfrage muss innerhalb von 6 Minuten mit der Antwort beginnen und ist insgesamt auf 10 Minuten begrenzt, siehe Fehlercodes .

Ich habe settings.json geändert, aber nichts hat sich geändert

Claude Code liest den Block env beim Start; beenden Sie claude also und starten Sie es neu. Halten Sie die Variablen in ~/.claude/settings.json oder in Ihrer Shell: Eine projektbezogene .claude/settings.json wird erst nach der Ersteinrichtung gelesen, das kann zu spät sein.

FAQ

Brauche ich ein Claude-Konto oder -Abo?

Nein. Der OneProvider-Schlüssel genügt. Claude Code muss sich nie bei claude.ai anmelden; zeigt es einen Anmeldebildschirm, folgen Sie den Schritten zu Auth conflict oben.

Kann ich in Claude Code GPT oder andere Modelle nutzen?

Claude Code sendet Anthropic-Messages-Anfragen, verwenden Sie dort also Claude-IDs. Für GPT-Modelle nutzen Sie Codex , Cursor oder Cline .

Wie komme ich zu meiner Anthropic-Anmeldung zurück?

Löschen Sie die oben gesetzten ANTHROPIC_*-Variablen aus dem env-Block der settings.json und aus der rc-Datei Ihrer Shell, öffnen Sie ein neues Terminal und führen Sie /login aus.

Wo sehe ich, was eine Sitzung gekostet hat?

Auf der Seite „Verbrauch“ im Dashboard des Schlüssels: jede Anfrage mit Modell und Token-Anzahl. Ein Ausgabenlimit pro Schlüssel stoppt einen außer Kontrolle geratenen Agenten.

Funktioniert es unter Windows?

Ja. Wählen Sie oben im Umschalter für das Betriebssystem Windows: Dieselben zwei Variablen setzen Sie mit PowerShell, und settings.json liegt in Ihrem Benutzerprofil unter .claude.

Ist die Erweiterung Claude Code für VS Code dasselbe?

Sie nutzt dieselbe Einstellungsdatei. Siehe Claude Code in VS Code .

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .