DeepSeek in Claude Code einrichten

1. Den passenden Zugang vorbereiten

Für die direkte Verbindung benötigen Sie einen API key der DeepSeek API-Plattform. Die Beispiele verwenden deren Anthropic-kompatiblen Endpunkt. Ein Chat-Login allein ersetzt keinen API key; Modellaufrufe werden über das API-Konto abgerechnet.

Wenn Sie einen Coding Plan dieses Hubs nutzen, übernehmen Sie stattdessen die zusammen gelieferten Zugangsdaten, Base URL und Modell-IDs. Mischen Sie den Schlüssel eines anderen Anbieters nicht mit dem offiziellen DeepSeek-Endpunkt. Wählen Sie zunächst eine Verbindung und testen Sie diese vollständig.

2. Claude Code installieren und prüfen

Für macOS, Linux und WSL empfiehlt Anthropic den nativen Installer. Öffnen Sie danach ein neues Terminal. Auf Windows steht der PowerShell-Installer von Anthropic zur Verfügung; für die Bash-Funktionen wird Git for Windows benötigt. Die verlinkte Installationsdokumentation beschreibt die Plattformanforderungen.

Die Alternative npm install -g @anthropic-ai/claude-code setzt nach der aktuellen Anthropic-Dokumentation Node.js 22 oder neuer voraus. Verwenden Sie einen Installationsweg, damit eine ältere Installation nicht über PATH Vorrang bekommt. claude doctor hilft bei der Diagnose, bestätigt aber noch keinen erfolgreichen DeepSeek-Aufruf.

curl -fsSL https://claude.ai/install.sh | bash

# In einem neuen Terminal prüfen:
claude --version
claude doctor

3. DeepSeek unter macOS oder Linux konfigurieren

Setzen Sie die folgenden Variablen in dem Terminal, aus dem Sie Claude Code starten. Ersetzen Sie IHR_DEEPSEEK_API_KEY durch Ihren eigenen Schlüssel und behandeln Sie ihn vertraulich. Teilen Sie weder den ausgefüllten Befehl noch Screenshots mit dem Schlüssel.

Die aktuelle DeepSeek-Anleitung verwendet Flash für Hauptmodell und Subagents. Der Zusatz [1m] gehört zu den dokumentierten Claude Code-Modellwerten. Die Einstellungen für Opus, Sonnet und Haiku bezeichnen hier Claude Code-Slots; sie bedeuten nicht, dass Anthropic-Modelle aufgerufen werden.

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="IHR_DEEPSEEK_API_KEY"
export ANTHROPIC_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

4. Einrichtung unter Windows PowerShell

Falls Claude Code noch fehlt, führen Sie den offiziellen PowerShell-Installer aus: irm https://claude.ai/install.ps1 | iex. Öffnen Sie anschließend ein neues PowerShell-Fenster und prüfen Sie claude --version.

Verwenden Sie in PowerShell $env: statt export. Die Werte unten gelten für das aktuelle Fenster und dessen gestartete Prozesse. Ein anderes Terminal übernimmt diese Sitzungseinstellungen nicht automatisch. WSL ist ein eigener Linux-Weg und verwendet die Befehle aus dem vorherigen Abschnitt.

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="IHR_DEEPSEEK_API_KEY"
$env:ANTHROPIC_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

5. Einstellungen für spätere Sitzungen speichern

Für wiederholte Verwendung können Sie die nicht geheimen Routing-Einstellungen im env-Abschnitt von ~/.claude/settings.json hinterlegen. Unter Windows liegt die Datei unter %USERPROFILE%\.claude\settings.json. Ergänzen Sie vorhandene Einstellungen, statt die gesamte Datei zu ersetzen.

Das Beispiel enthält absichtlich keinen API key. Stellen Sie ANTHROPIC_AUTH_TOKEN in Ihrer geschützten lokalen Umgebung bereit. Legen Sie Zugangsdaten nicht in die Projektdatei .claude/settings.json und nicht in Git. Starten Sie Claude Code nach Änderungen neu und kontrollieren Sie, welche Konfiguration wirksam ist.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "786432"
  }
}

6. Eine kurze Anfrage und einen Tool-Aufruf testen

Wechseln Sie in einen kleinen Testordner und starten Sie claude. Bitten Sie zunächst um eine kurze Textantwort. Prüfen Sie danach im Nutzungsverlauf Ihres Anbieters, ob die Anfrage angekommen ist und welches Modell verwendet wurde. Ein Modellname in der Oberfläche allein reicht dafür nicht aus.

Bitten Sie im nächsten Schritt darum, eine bekannte Textdatei zu lesen und deren Inhalt zusammenzufassen. Kontrollieren Sie die sichtbare Tool-Aktivität. Erst wenn Textantwort und Tool-Aufruf funktionieren, beginnen Sie mit Dateiänderungen; prüfen Sie dabei den Diff und die passenden Projekttests.

Die direkte DeepSeek-Integration unterstützt Web Search in Claude Code. Dabei können zusätzliche Modellanfragen und Tokenkosten entstehen. Aktivieren oder prüfen Sie weitere Funktionen einzeln, damit sich Fehler zuordnen lassen.

cd /pfad/zu/ihrem/testprojekt
claude

7. Häufige Fehler gezielt eingrenzen

Ändern Sie bei einem Fehler nicht gleichzeitig Installer, API key, Endpunkt und Modell. Prüfen Sie zuerst die ausgeführte CLI, danach die Verbindung und zuletzt die gewünschte Modellroute. Geben Sie beim Teilen von Diagnoseausgaben niemals den Token aus.

8. Flash, Pro und Desktop auseinanderhalten

Beginnen Sie mit der funktionierenden Flash-Konfiguration. Wenn Sie Pro für anspruchsvollere Aufgaben vergleichen möchten, wählen Sie die vom Anbieter unterstützte Pro-ID bewusst aus. Lassen Sie dieselbe Aufgabe mit denselben Tests laufen und vergleichen Sie brauchbare Ergebnisse, Wiederholungen und Kosten.

Die grafische Claude Desktop-App kann andere Modellnamen und Einstellungen verlangen. Unsere separate Desktop-Anleitung behandelt diese Zuordnung und die API-Grenzen. So bleibt klar, ob ein Problem aus dem Terminal, der Desktop-App oder der Modellroute stammt.

Häufige Fragen