Claude Code mit DeepSeek, Ollama oder anderen Modellen

Richten Sie Claude Code mit ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN auf den Anthropic-kompatiblen Endpunkt eines Anbieters und tragen Sie dessen Modelle in ANTHROPIC_MODEL und den Variablen ANTHROPIC_DEFAULT_*_MODEL ein. Das funktioniert, wird von Anthropic aber nicht unterstützt, eine Sitzung spricht mit nur einem Anbieter, und Funktionen wie Prompt-Caching können stillschweigend ignoriert werden.

Aktualisiert am

So funktioniert es

Claude Code sendet jede Anfrage im Messages-Format von Anthropic an die Adresse in ANTHROPIC_BASE_URL. Ein Anbieter, der dieses Format bedient, kann Anthropic ersetzen, und Claude Code merkt den Unterschied erst, wenn eine Anfrage etwas nutzt, das der Anbieter nicht implementiert hat. Die Gateway-Dokumentation von Anthropic stellt klar, dass das nicht unterstützt wird: Claude Code werde „nicht über irgendein Gateway an Nicht-Claude-Modelle weitergeleitet“ – das sei nicht unterstützt.

Endpunkte, die damit funktionieren

AnbieterANTHROPIC_BASE_URLHinweise
DeepSeekhttps://api.deepseek.com/anthropicOffizielle Anleitung. Namen claude-opus* werden auf V4 Pro abgebildet, alles andere auf V4 Flash
Ollama (lokal)http://localhost:11434Offizielle Integration ab Ollama 0.14; ollama launch claude richtet sie ein
Kimi (Moonshot)https://api.moonshot.ai/anthropicOffizielle Anleitung; kimi-k2.7-code braucht eingeschaltetes Thinking
Z.ai GLMhttps://api.z.ai/api/anthropicOffizielle Anleitung
Alibaba Coding Planhttps://coding-intl.dashscope.aliyuncs.com/apps/anthropicOffizielle Anleitung; Endpunkte mit nutzungsbasierter Abrechnung gibt es pro Region
OpenRouterhttps://openrouter.ai/apiNur mit Anthropic als Upstream-Anbieter garantiert; setzen Sie ANTHROPIC_API_KEY auf einen leeren String
LM Studio (lokal)http://localhost:1234Offizielle Integrationsseite

Beispiel: DeepSeek

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your 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
claude

Das sind die Werte von der Claude-Code-Seite von DeepSeek selbst. Setzen Sie jede Stufe, nicht nur ANTHROPIC_MODEL: Eine nicht gesetzte Stufe sendet weiterhin einen Claude-Modellnamen, den der Endpunkt nicht kennt, und die Hintergrundaufgaben und Subagenten, die sie nutzen, schlagen fehl.

Beispiel: ein lokales Modell mit Ollama

ollama launch claude

Das konfiguriert Claude Code für Sie. Von Hand sind es drei Variablen und ein Modell, das Tool-Aufrufe unterstützt:

export ANTHROPIC_BASE_URL=http://localhost:11434
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
claude --model qwen3.5

Ollama empfiehlt für größere Repositories ein Kontextfenster von 64K Tokens oder mehr; ein Coding-Agent sendet in jedem Durchgang das Gespräch erneut, und ein kleines Fenster ist schnell voll.

Was nicht funktioniert

  • Prompt-Caching-Markierungen. DeepSeek und Ollama ignorieren cache_control von Anthropic, und Kimi beachtet es nur auf oberster Ebene. Es gibt keinen Fehler; ob Sie trotzdem Cache-Preise bekommen, hängt vom eigenen Caching des Anbieters ab.
  • Anbieterwechsel. Claude Code liest eine einzige ANTHROPIC_BASE_URL, ein Wechsel von DeepSeek zu Claude bedeutet also einen Neustart mit anderen Einstellungen, keinen /model-Befehl.
  • Websuche. Das Tool WebSearch von Claude Code läuft auf den Servern von Anthropic. DeepSeek gibt an, dass sein Endpunkt es unterstützt; laut Ollama wird die gehostete Websuche nicht vollständig unterstützt.
  • Unbekannte Anfragefelder. Claude Code behandelt einen unbekannten Modellnamen als aktuelles Claude-Modell und sendet Thinking- und Effort-Felder, die manche Endpunkte mit 400 ablehnen. CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 entfernt Beta-Felder, auf Kosten der MCP-Tool-Suche.
  • Kontofunktionen. Remote Control und Sprachdiktat sind nicht verfügbar, solange Gateway-Zugangsdaten gesetzt sind.
  • Veraltete Zugangsdaten. Ein übrig gebliebener ANTHROPIC_API_KEY, ein gespeicherter Login oder alte env-Werte in settings.json können die Einrichtung überschreiben; /status zeigt, welche gerade verwendet werden.

Wann ein modellunabhängiger Agent besser passt

Wenn Ihnen ein Anbieter auf einmal genügt und Sie bereits in Claude Code arbeiten, reichen die Einstellungen oben. Wenn Sie Claude, DeepSeek und ein lokales Modell in derselben Aufgabe nutzen wollen, kann OHarness das nativ: Jeder Anbieter ist integriert, das Gespräch wird anbieterneutral gespeichert, und /model wechselt ohne Neustart zwischen Anbietern. OHarness vs. Claude Code vergleicht beide direkt.

npm install -g oharness
oharness -m deepseek/deepseek-v4-flash

Mitten in der Sitzung dann /model anthropic/claude-sonnet-5 für den Schritt, der es braucht, und wieder zurück.

Quellen

Häufige Fragen

Kann Claude Code DeepSeek-Modelle nutzen?

Ja, inoffiziell. DeepSeek stellt unter https://api.deepseek.com/anthropic einen Anthropic-kompatiblen Endpunkt bereit: Setzen Sie ANTHROPIC_BASE_URL darauf, ANTHROPIC_AUTH_TOKEN auf einen DeepSeek-API-Schlüssel und die Modellvariablen auf die Modellnamen von DeepSeek. Anthropic unterstützt in Claude Code keine Nicht-Claude-Modelle.

Kann Claude Code ein lokales Modell mit Ollama betreiben?

Ja. Ollama 0.14 und neuer bedient das Messages-Format von Anthropic, und `ollama launch claude` konfiguriert Claude Code dafür. Wählen Sie ein Modell, das Tool-Aufrufe unterstützt, und geben Sie ihm ein Kontextfenster von 64K Tokens oder mehr.

Kann Claude Code in einer Sitzung zwischen Claude und DeepSeek wechseln?

Nein. Claude Code liest eine einzige ANTHROPIC_BASE_URL, eine Claude-Code-Sitzung spricht also mit einem Anbieter. OHarness wechselt mitten in der Sitzung mit /model zwischen Anthropic, DeepSeek, OpenAI, Gemini und lokalen Modellen.

Warum liefert Claude Code mit dem Endpunkt eines anderen Anbieters 400-Fehler?

Claude Code nimmt an, dass ein unbekanntes Modell ein aktuelles Claude-Modell ist, und sendet Felder wie Adaptive Thinking und Effort, die manche Endpunkte ablehnen. Wenn Sie jede Variable ANTHROPIC_DEFAULT_*_MODEL auf die Namen des Anbieters setzen und CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 hinzufügen, verschwinden die meisten davon.

Verwandte Themen