DeepSeek in Claude Code verwenden: V4 Flash / Pro Setup-Anleitung

Führen Sie DeepSeek V4 Flash und Pro in Claude Code über APIMaster aus. Legen Sie Gateway und API-Schlüssel fest, wechseln Sie Modelle, verifizieren Sie Dateilesewerkzeuge und beheben Sie Konfigurationsfehler.

Kann Claude Code DeepSeek verwenden? Unsere Tests mit Claude Code 2.1.239 haben deepseek-v4-flash und deepseek-v4-pro erfolgreich über den Messages-Endpunkt von APIMaster verwendet. Setzen Sie ANTHROPIC_BASE_URL auf https://apimaster.ai, geben Sie einen APIMaster-Schlüssel an und wählen Sie das Modell explizit aus. Diese Konfiguration führt DeepSeek aus, auch wenn der Client Claude Code heißt.

Zuletzt getestet: 2026-09-07, Claude Code 2.1.239, Linux. Beide Modelle lieferten den erwarteten Text und führten einen Dateilesewerkzeug-Roundtrip durch. Alle Läufe endeten mit Exit-Code 0. Die CLI gab unrecognized_model aus, aber die getesteten Anfragen waren erfolgreich. Diese Prüfungen belegen keine Unterstützung für jede Claude-Code-Funktion, lange Sitzungen oder zukünftige Versionen. Windows-/macOS-Setup-Befehle sind enthalten; der aufgezeichnete Test lief auf Linux.

1. CLI und API-Schlüssel vorbereiten

Folgen Sie der Umgebungsanleitung und der Claude-Code-Setup-Anleitung für die Installation. Überprüfen Sie Ihre Version:

claude --version

Holen Sie sich einen APIMaster-API-Schlüssel mit Zugriff auf das ausgewählte DeepSeek-Modell und ausreichendem Kontingent. Verwenden Sie die folgenden Sitzungseinstellungen für dieses Tutorial; es ist nicht erforderlich, Ihre normale settings.json zu überschreiben.

2. Gateway und Schlüssel festlegen

Öffnen Sie ein neues Terminal, um diese Einstellungen von Ihrer üblichen CLI-Sitzung getrennt zu halten.

macOS / Linux:

export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue

Verwenden Sie hier den Site-Ursprung, ohne /v1: Claude Code hängt /v1/messages an. Der API-Schlüssel muss von APIMaster stammen. Diese Befehle betreffen dieses Terminal und seine Unterprozesse, nicht Ihre gespeicherten Anmeldedateien. Legen Sie keinen echten Schlüssel in eine gemeinsame Einstellungsdatei oder ein Repository.

3. Minimale Testanfrage senden

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"

Erwartet: is_error ist false, result ist DEEPSEEK_TEST_OK, und der Prozess endet mit Exit-Code 0. Ändern Sie --model auf deepseek-v4-pro und führen Sie es erneut aus.

Der --bare-Modus der getesteten Version verwendet explizite API-Schlüssel-Authentifizierung und überspringt normale Hintergrundintegrationen. --setting-sources "" schließt gespeicherte Einstellungsquellen aus, während --tools "" Werkzeuge für diesen einen Texttest deaktiviert. Dies sind bewusste Diagnoseeinstellungen, keine Anforderungen, Werkzeuge während der normalen Nutzung zu deaktivieren. Ältere CLI-Versionen akzeptieren möglicherweise nicht alle diese Flags.

4. Dateilesewerkzeuge verifizieren

Erstellen Sie probe.txt im aktuellen Verzeichnis mit diesem Inhalt:

TOOL_PROBE_739182

Führen Sie aus:

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

Erwartet: Die CLI liest die Datei und gibt TOOL_PROBE_739182 zurück. Wiederholen Sie mit deepseek-v4-pro. Dies prüft, ob das Modell ein Werkzeug anfordern, sein Ergebnis empfangen und dann antworten kann. Für diesen Test ist nur das Read-Werkzeug aktiviert.

Für normale interaktive Arbeit mit denselben Terminaleinstellungen:

claude --bare --setting-sources "" --model deepseek-v4-flash

Um mit Pro zu starten:

claude --bare --setting-sources "" --model deepseek-v4-pro

Die interaktiven Befehle lassen --tools "" weg, sodass die Standardwerkzeuge verfügbar sind. Überprüfen Sie Berechtigungsaufforderungen wie gewohnt. --bare überspringt Annehmlichkeiten wie Hooks und automatische Projektanweisungen; aktivieren Sie Ihre normalen Einstellungen bewusst, nachdem das minimale Setup funktioniert, und stellen Sie sicher, dass sie Gateway oder Modell nicht überschreiben. Schließen Sie dieses Terminal, wenn Sie fertig sind, um die Umgebung dieser Sitzung zu verlassen.

Fehlerbehebung

Symptom	Was zu prüfen ist
`unrecognized_model`	Bei beiden DeepSeek-IDs in 2.1.239 beobachtet. Es verhinderte nicht den Abschluss unserer Anfragen. Überprüfen Sie das Endergebnis, anstatt die Warnung allein als Fehler zu behandeln.
401 oder eine unerwartete Anmeldeaufforderung	Bestätigen Sie, dass `ANTHROPIC_API_KEY` gesetzt ist, entfernen Sie ein widersprüchliches `ANTHROPIC_AUTH_TOKEN` in diesem Terminal und versuchen Sie den Bare-Modus erneut.
404	`ANTHROPIC_BASE_URL` sollte `https://apimaster.ai` sein, nicht der vollständige `/v1/messages`-Endpunkt oder eine Basis, die mit `/v1` endet.
Unbekannte `--bare`-Option	Überprüfen Sie Ihre Version gegen die getestete 2.1.239. Verwenden Sie bei Bedarf die allgemeine Installationsanleitung zum Aktualisieren.
`probe.txt` kann nicht gelesen werden	Führen Sie vom Verzeichnis der Datei aus. Aktivieren Sie für den Werkzeugtest Read anstelle von `--tools ""`.
Ein anderes Modell ist ausgewählt	Übergeben Sie die vollständige Modell-ID mit `--model` und überprüfen Sie gespeicherte Einstellungen oder Modell-Alias-Überschreibungen, bevor Sie sie aktivieren.
Rate-Limit, unzureichendes Kontingent oder Upstream-Fehler	Lesen Sie den Fehlertext, überprüfen Sie Kontingent und Modellberechtigungen und notieren Sie den Zeitstempel für den Support.

Häufig gestellte Fragen

Ist das dasselbe wie die Verwendung eines Claude-Modells?

Nein. Claude Code ist hier der Client; das ausgewählte Modell ist DeepSeek. Funktionen, die von einem bestimmten Claude-Modell abhängen, werden durch dieses Setup nicht automatisch abgedeckt.

Warum unterscheidet sich die Basis-URL vom Python-SDK-Beispiel?

Das Python-OpenAI-SDK verwendet https://apimaster.ai/v1 und hängt /chat/completions an. Claude Code verwendet https://apimaster.ai und hängt /v1/messages an. Verwenden Sie das dokumentierte Basisformat des jeweiligen Clients.

Kann ich einen offiziellen DeepSeek-Schlüssel mit diesem Gateway verwenden?

Dieses Tutorial erfordert einen von APIMaster ausgestellten Schlüssel. Schlüssel sind spezifisch für den Anbieter, der sie ausstellt; das Ändern nur des Endpunkts überträgt keine Anmeldeinformationen oder Kontingente.

Wurde die tatsächliche Werkzeugnutzung getestet oder nur eine Textantwort?

Beides wurde für beide Modelle getestet. Der Werkzeugtest las eine lokale Datei und gab deren Inhalt zurück. Er belegt nicht, dass alle Werkzeuge, Hintergrundagenten oder lange Codierungsaufgaben unterstützt werden.