DeepSeek V4 Flash und Pro in Claude Code: Einrichtung und Modellwechsel

Richten Sie DeepSeek in Claude Code über APIMaster ein. Konfigurieren Sie settings.json unter Windows, macOS und Linux, starten Sie claude, wählen Sie mit /model ein Modell und beginnen Sie zu chatten.

Konfigurieren Sie APIMaster in settings.json, führen Sie claude aus und geben Sie dann /model MODEL_ID im Gespräch ein, um DeepSeek zu verwenden. Die hier behandelten verfügbaren IDs sind deepseek-v4-flash und deepseek-v4-pro. Claude Code ist der Client; DeepSeek ist das Modell, das antwortet.

Bevor Sie beginnen

Schließen Sie die Umgebungsprüfung und die Claude-Code-Einrichtung ab. Besorgen Sie sich einen APIMaster-API-Schlüssel mit ausreichend Guthaben und Zugriff auf die ausgewählten Modelle.

claude --version

Die Basis-URL des Gateways lautet https://apimaster.ai, ohne /v1. Claude Code fügt /v1/messages selbst an.

1. Konfigurationsverzeichnis öffnen

Windows

Drücken Sie Win + R, geben Sie den folgenden Pfad ein und drücken Sie die Eingabetaste:

%USERPROFILE%\.claude

Erstellen Sie den Ordner bei Bedarf. Öffnen oder erstellen Sie settings.json. Stellen Sie sicher, dass die Datei nicht settings.json.txt heißt.

macOS / Linux

Drücken Sie unter macOS im Finder Command + Shift + G und geben Sie ein:

~/.claude

Öffnen Sie unter Linux dasselbe Verzeichnis mit Ihrem Dateimanager oder Editor. Erstellen Sie es bei Bedarf:

mkdir -p ~/.claude

Öffnen oder erstellen Sie dort settings.json. Falls Sie ein benutzerdefiniertes Claude-Code-Konfigurationsverzeichnis festgelegt haben, verwenden Sie stattdessen dieses Verzeichnis.

2. settings.json bearbeiten

Windows, macOS und Linux verwenden dieselbe Konfiguration. Ersetzen Sie YOUR_APIMASTER_API_KEY durch Ihren APIMaster-Schlüssel:

{
  "model": "deepseek-v4-flash",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Falls die Datei bereits existiert, sichern Sie sie und führen Sie diese Felder in das vorhandene JSON-Objekt und das env-Objekt ein. Behalten Sie andere benötigte Einstellungen bei. Hängen Sie kein zweites JSON-Objekt an und duplizieren Sie keinen env-Schlüssel. JSON erlaubt keine Kommentare oder nachgestellten Kommas.

Die allgemeine Claude-Code-Anleitung zeigt die Token-Authentifizierung. Diese Anleitung verwendet die API-Schlüssel-Authentifizierung, die in unseren Integrationstests geprüft wurde. Lassen Sie ANTHROPIC_AUTH_TOKEN leer, wenn Sie ANTHROPIC_API_KEY verwenden, und entfernen Sie widersprüchliche Anmeldeinformationen aus anderen Einstellungen oder Ihrem Terminal. Verwenden Sie für dieses Gateway einen APIMaster-Schlüssel.

Das Feld model legt das Startmodell fest. Sie können nach dem Start ein anderes auswählen. Halten Sie diese Benutzer-Einstellungsdatei privat; committen Sie keine echten Schlüssel in ein gemeinsam genutztes Repository. Speichern Sie die Datei und starten Sie Claude Code neu, um die neue Konfiguration zu laden.

3. Claude Code starten

Führen Sie in einem Terminal, das in Ihrem Projektverzeichnis geöffnet ist, Folgendes aus:

claude

Schließen Sie alle üblichen Erstinbetriebnahme-Aufforderungen ab und prüfen Sie die Projektvertrauens-Aufforderung. Das Startmodell sollte deepseek-v4-flash sein. Dies ist eine normale interaktive Sitzung mit den üblichen Werkzeugen und Projekteinstellungen.

4. Modell auswählen und chatten

Geben Sie im Claude-Code-Gespräch einen der folgenden Befehle ein und drücken Sie die Eingabetaste:

/model deepseek-v4-flash
/model deepseek-v4-pro

Führen Sie jeweils eine Zeile aus und wählen Sie das gewünschte Modell. Nachdem Claude Code den Wechsel bestätigt hat, senden Sie eine kurze Nachricht:

Reply with exactly OK.

Eine normale Textantwort bestätigt die grundlegende Verbindung. Sie können anschließend weiterschreiben oder es bitten, an Ihrem Projekt zu arbeiten. Um im selben Gespräch erneut zu wechseln, geben Sie einen weiteren Befehl /model MODEL_ID ein.

Die Eingabe von /model allein öffnet die Modellauswahl. Benutzerdefinierte Gateway-IDs erscheinen möglicherweise nicht in deren Standardliste. Geben Sie stattdessen die vollständige ID wie oben gezeigt ein. Der Slash-Befehl gehört in Claude Code, nicht in PowerShell oder Bash. Die Modellnamen bezeichnen DeepSeek-Modelle, nicht Claude Sonnet oder Opus.

Sie können beim Start aus dem Terminal auch ein Modell wählen. Führen Sie jeweils einen Befehl aus:

claude --model deepseek-v4-flash
claude --model deepseek-v4-pro

Um den Standard für zukünftige Sitzungen explizit festzulegen, bearbeiten Sie model in settings.json. Ein Start-Flag, die Umgebungsvariable ANTHROPIC_MODEL oder eine Projekt-/verwaltete Einstellung können das ausgewählte Modell beeinflussen; prüfen Sie diese, wenn das Startmodell von Ihrem gespeicherten Wert abweicht.

Fehlerbehebung

Symptom	Prüfen
401 / unerwartete Login-Aufforderung	Überprüfen Sie den APIMaster-Schlüssel, die Basis-URL und widersprüchliche Authentifizierungsvariablen; starten Sie die CLI nach dem Bearbeiten der Einstellungen neu.
404	Verwenden Sie `https://apimaster.ai`, ohne `/v1` oder `/v1/messages`.
Einstellungen greifen nicht	Prüfen Sie den Dateispeicherort, gültiges JSON und Überschreibungen durch Terminal-, Projekt- oder verwaltete Einstellungen.
Modell fehlt in der Auswahl	Geben Sie `/model MODEL_ID` mit der exakten ID ein oder starten Sie mit `claude --model MODEL_ID`.
Modell nicht verfügbar / 403	Prüfen Sie die Schreibweise, die für den Schlüssel erlaubten Modelle, das Kontoguthaben und die aktuelle Verfügbarkeit der Route.
`unrecognized_model`	In unseren Tests bei benutzerdefinierten IDs beobachtet. Prüfen Sie die tatsächliche Antwort und das Werkzeugergebnis; die Standardfähigkeiten von Claude sind für DeepSeek nicht verifiziert.
Datei- oder Befehlsberechtigung verweigert	Prüfen und genehmigen Sie die beabsichtigte Operation über die üblichen Berechtigungsabfragen.
429 / 5xx / unterbrochene Antwort	Bewahren Sie Fehler, Modell-ID, CLI-Version, UTC-Zeit und Anfrage-ID, falls verfügbar, für den Support auf.

Validierung und optionale Diagnose

Aufgezeichnete Integrationstests: 2026-09-07 UTC, Claude Code 2.1.239, Linux. Alle hier aufgeführten Modelle lieferten den erwarteten Text und lasen eine lokale Datei über ein Werkzeug. Komplexe Programmieraufgaben waren nicht Teil dieses Testumfangs. Windows und macOS waren nicht Teil dieser aufgezeichneten Läufe.

Die früheren automatisierten Prüfungen verwendeten den Bare-Modus, um die Konfiguration zu isolieren. Die normale tägliche Nutzung folgt den obigen Schritten mit settings.json und der interaktiven Vorgehensweise. Der Bare-Modus und --setting-sources "" überspringen normale Integrationen oder gespeicherte Einstellungen und sollten daher nicht zum alltäglichen Startbefehl aus dieser Anleitung hinzugefügt werden.

Für eine schnelle nicht-interaktive Prüfung mit Ihrer gespeicherten Konfiguration:

claude --model deepseek-v4-flash -p "Reply with exactly OK."

Für eine Werkzeugprüfung erstellen Sie eine Datei probe.txt mit dem Inhalt FILE_PROBE_739182, starten Claude Code in diesem Verzeichnis und bitten es, die Datei mit einem Werkzeug zu lesen und ihren exakten Inhalt zurückzugeben. Bestätigen Sie, dass das Werkzeug tatsächlich ausgeführt wird.

Dies sind begrenzte Integrationsprüfungen, keine Garantie für jede Claude-Code-Funktion, das Verhalten langer Sitzungen oder den maximalen Kontext. Die Gateway-Dokumentation von Anthropic unterstützt das Routing von Claude Code zu Nicht-Claude-Modellen nicht offiziell; diese Anleitung beschreibt die Integration von APIMaster.

FAQ

Zahlt mein Claude-Abonnement für diese Anfragen?

Nein. Mit dieser APIMaster-Konfiguration verwenden die Anfragen Ihren APIMaster-Schlüssel und Ihr Guthaben.

Kann ich nach dem Modellwechsel weiterschreiben?

Ja, verwenden Sie den Modellwechsel-Befehl im geöffneten Gespräch und warten Sie auf die Bestätigung, bevor Sie die nächste Nachricht senden. Für einen sauberen Vergleich zwischen Modellen starten Sie eine separate Sitzung mit claude --model MODEL_ID.