Source: https://aiprimetech.io/de/learn/use-claude-api-with-zed/

[Startseite](/de/) / [Lernen](/de/learn/) / Zed über das Gateway mit Claude verbinden 

# Zed über das Gateway mit Claude verbinden 

Zed ist schnell und sein Assistent wirklich nützlich, doch die Möglichkeit, einen benutzerdefinierten Claude-Endpunkt einzurichten, findet sich nicht dort, wo die meisten zuerst suchen. Der native Anthropic-Anbieter bietet keine Möglichkeit, die Basis-URL zu überschreiben. Daher führt der unkomplizierte Weg zum Gateway stattdessen über den openai_compatible-Block von Zed. 

## Warum nicht den Anthropic-Anbieter verwenden? 

Zed wird mit einem nativen Anthropic-Anbieter ausgeliefert, und es liegt nahe, diesen auf das Gateway auszurichten. Der Haken ist, dass dieser Anbieter keine api_url-Einstellung hat. Es gibt also kein unterstütztes Feld, mit dem Sie ihn vom standardmäßigen Anthropic-Host auf ein anderes Ziel umleiten können. 

Diese eine Einschränkung ist der Grund, warum so viele Nutzer nicht weiterkommen. Statt dagegen anzukämpfen, leiten Sie Claude über den generischen openai_compatible-Mechanismus weiter, der eine konfigurierbare Basis-URL bietet und genau für Endpunkte von Drittanbietern vorgesehen ist. 

Es hilft, sich den nativen Anbieter als fest mit einem Ziel verbunden und den openai_compatible-Anbieter als konfigurierbar vorzustellen. Für ein Multi-Modell-Gateway ist der konfigurierbare Weg ohnehin sinnvoll, weil derselbe Block Claude und jedes andere vom Gateway bereitgestellte Modell über eine einzige api_url zugänglich machen kann. So bleibt die gesamte Modellkonfiguration des Editors an einem Ort, statt auf zwei Anbietermechanismen mit unterschiedlichen Regeln verteilt zu sein. Diese eine Entscheidung bestimmt die restliche Einrichtung, daher sollten Sie sich darüber im Klaren sein, bevor Sie etwas bearbeiten. Sobald klar ist, dass der openai_compatible-Block der unterstützte Weg ist, müssen Sie nur noch die Felder ausfüllen. 

## Einen openai_compatible-Block hinzufügen 

Fügen Sie in settings.json unter language_models.openai_compatible einen benannten Anbieter hinzu. Setzen Sie dessen api_url auf das Gateway mit /v1 am Ende. Zed adressiert darunter /chat/completions, sodass die OpenAI-kompatible Schnittstelle des Gateways die Anfragen beantwortet. 

Der gewählte Name ist frei wählbar und wird als Bezeichnung im Modellmenü von Zed angezeigt. Ein Block kann mehrere Claude-Modelle bereitstellen, die jeweils im nächsten Schritt angegeben werden. 

Das Suffix /v1 ist hier entscheidend: Zed erstellt den Pfad für Chat-Completions direkt unter dem Wert, den Sie als api_url angeben. Fehlt /v1, gehen die Anfragen daher an die falsche Stelle, und ein abschließender Schrägstrich kann den Pfad verdoppeln. Setzen Sie den Wert exakt auf den Host plus /v1, dann funktioniert das Routing. Ein kurzes Neuladen der Einstellungen nach der Bearbeitung bestätigt, dass Zed den Block ohne Beanstandung eingelesen hat. Wenn der Anbieter nicht erscheint, sollten Sie zuerst auf einen JSON-Syntaxfehler im Block prüfen. 

## available_models angeben 

Zed erkennt Modelle an einem benutzerdefinierten Endpunkt nicht automatisch. Tragen Sie sie daher manuell in available_models ein. Jeder Eintrag benötigt einen name, der mit der Gateway-ID übereinstimmt, einen display_name für das Menü und einen zum Modell passenden max_tokens-Wert. 

Verwenden Sie claude-sonnet-4-5 für alltägliche Unterstützung und fügen Sie claude-opus-4-8 als zweiten Eintrag für die anspruchsvollsten Aufgaben hinzu. Da Sie die Modelle explizit auflisten, zeigt das Menü genau die gewünschte Auswahl und nichts darüber hinaus. 

Das Feld name muss Zeichen für Zeichen mit der ID des Gateways übereinstimmen, während display_name rein kosmetisch ist und im Menü beliebig lauten kann. Ein falscher name ist die häufigste Ursache dafür, dass ein Modell zwar angezeigt wird, bei der Verwendung aber Fehler verursacht. Kopieren Sie die ID daher direkt vom Gateway, statt sie aus dem Gedächtnis einzugeben. Wenn Sie nur die tatsächlich verwendeten Modelle auflisten, bleibt das Menü kurz und die Auswahl im Alltag eindeutig. Ein weiteres Modell lässt sich später durch eine einzeilige Änderung hinzufügen. Sie müssen also nicht alles im Voraus angeben. 

## Wo der Schlüssel gespeichert wird 

Der API-Schlüssel gehört nicht in settings.json. Zed speichert ihn im Schlüsselbund des Betriebssystems oder liest ihn aus einer nach dem Anbieter benannten Umgebungsvariable wie AIPRIME_API_KEY. So bleibt der geheime Schlüssel außerhalb Ihrer synchronisierten Konfiguration. 

Öffnen Sie nach dem Speichern den Assistenten, wählen Sie Ihren Anbieter im Menü aus und geben Sie den Schlüssel ein, wenn Sie dazu aufgefordert werden. Von da an authentifiziert sich Zed über den Schlüsselbund, und Ihre Einstellungsdatei bleibt frei von Zugangsdaten. 

Diese Trennung ist besonders nützlich, wenn Sie Ihre Zed-Einstellungen zwischen Rechnern synchronisieren oder in einem Dotfiles-Repository ablegen: Die Konfiguration lässt sich problemlos übertragen, da sie keinen geheimen Schlüssel enthält, und jeder Rechner stellt seinen eigenen Schlüssel über den Schlüsselbund oder die Umgebung bereit. Das ist eine sauberere Lösung als bei Tools, die den Schlüssel fest in der Konfigurationsdatei hinterlegen. Deshalb können Sie eine Zed-Konfiguration auch sicher mit einem Kollegen teilen – er verwendet seinen eigenen Schlüssel, und Ihrer wird nie mit übertragen. Dasselbe gilt für das Einchecken von Einstellungen in ein Dotfiles-Repository. 

## Der native Weg über ACP 

Wenn Sie ausdrücklich natives Anthropic-Verhalten statt der OpenAI-kompatiblen Schnittstelle wünschen, unterstützt Zed das Agent Client Protocol mit Claude Code. Sie führen Claude Code als Agenten aus, und Zed kommuniziert über ACP mit ihm. 

In dieser Konstellation verwendet Claude Code sein eigenes ANTHROPIC_BASE_URL, das auf das Gateway verweist. Zed benötigt daher keine eigene Anthropic-api_url. Dies ist der unkomplizierteste Weg, echtes natives Messages-Verhalten im Editor zu erhalten. 

Der Kompromiss besteht darin, dass ACP die vollständige Agentenschleife von Claude Code anstelle des schlankeren integrierten Assistenten von Zed bereitstellt. Das bietet mehr Möglichkeiten, ist aber auch aufwendiger in der Nutzung. Wählen Sie den openai_compatible-Weg für schnelle Inline-Hilfe und den ACP-Weg, wenn ein vollständiger Agent mehrstufige Bearbeitungen direkt im Editor ausführen soll. Die meisten beginnen mit dem schlankeren Weg und wechseln erst zu ACP, wenn sie einen vollständigen Agenten im Editor wünschen. Sie können beide Optionen verfügbar halten und je nach Aufgabe die passende verwenden. 

Kopieren

```
// Zed settings.json
{
  "language_models": {
    "openai_compatible": {
      "aiprime": {
        "api_url": "https://aiprimetech.io/v1",
        "available_models": [
          { "name": "claude-sonnet-4-5",
            "display_name": "Claude Sonnet",
            "max_tokens": 200000 }
        ]
      }
    }
  }
}
// Key goes in the keychain / AIPRIME_API_KEY env var, NOT this file.
```

## Häufig gestellte Fragen 

 Warum kann ich in Zed keine Claude-Basis-URL festlegen?

Der native Anthropic-Anbieter von Zed hat kein api_url-Feld. Verwenden Sie den openai_compatible-Block, der api_url bereitstellt, und setzen Sie den Wert auf https://aiprimetech.io/v1. Wo trage ich die api_url ein?

Unter language_models.openai_compatible.<name>.api_url, mit /v1 am Ende. Zed adressiert darunter /chat/completions. Wo wird der API-Schlüssel hinterlegt?

Nicht in settings.json – Zed speichert ihn im Schlüsselbund des Betriebssystems oder in einer nach dem Anbieter benannten Umgebungsvariable wie AIPRIME_API_KEY. Wie erhalte ich natives Anthropic-Verhalten?

Verwenden Sie ACP mit Claude Code als Agenten. Claude Code verwendet ANTHROPIC_BASE_URL für die Verbindung zum Gateway, sodass Zed keine Anthropic-api_url benötigt.  

Claude in wenigen Minuten nutzen

Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.[API-Schlüssel erhalten](/register) 

AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.    

## Weitere Anleitungen zur Claude API

[So erhalten Sie einen Claude API-Schlüssel](/de/learn/how-to-get-a-claude-api-key/)[Claude-API-Preise erklärt](/de/learn/claude-api-pricing-explained/)[Die günstigste Möglichkeit, die Claude API zu nutzen](/de/learn/cheapest-way-to-use-claude-api/)[Cursor unbegrenzt mit der Claude API nutzen](/learn/use-claude-api-with-cursor/)[Unbegrenzter Zugang zu Claude Code](/de/learn/use-claude-api-with-claude-code/)[Claude API-Gateway vs. direkter Zugang zu Anthropic](/de/learn/claude-api-vs-anthropic-direct/)[Claude über eine OpenAI-kompatible API nutzen](/de/learn/openai-compatible-claude-api/)[Claude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)](/de/learn/claude-api-models-compared/)[Die Claude API mit Kryptowährungen bezahlen](/de/learn/claude-api-with-crypto-payment/)[Zugang zur Claude API ohne Warteliste](/de/learn/claude-api-without-waitlist/)[So reduzieren Sie den Token-Verbrauch von Claude](/de/learn/how-to-reduce-claude-token-usage/)[Cline unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-cline/)[Roo Code unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-roo-code/)[Claude unbegrenzt in JetBrains-IDEs nutzen](/de/learn/use-claude-api-with-jetbrains/)[Aider unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-aider/)[Claude unbegrenzt in VS Code nutzen](/de/learn/use-claude-api-with-vscode/)[OpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige Fehler](/de/learn/use-claude-api-with-opencode/)[Einen unbegrenzten Hermes-Agenten mit Claude betreiben](/de/learn/run-hermes-agent-with-claude-api/)[OpenClaw unbegrenzt mit Claude betreiben](/de/learn/run-openclaw-with-claude-api/)[Was eine Anthropic-kompatible API bedeutet](/de/learn/anthropic-compatible-api/)[Claude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden sollten](/de/learn/claude-code-api-key-setup/)[Claude Code-API-Kosten — Preise und Möglichkeiten zur Kostensenkung](/de/learn/claude-code-api-costs/)[Claude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige Lösung](/de/learn/claude-api-errors-troubleshooting/)[So kaufen Sie Claude API-Guthaben – und warum Claude-Guthaben besser ist als jedes Angebot zum „Kauf eines Claude-Kontos“](/de/learn/buy-claude-api-credits/)[Kostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?](/de/learn/claude-api-free-trial/)[Claude API vs. Claude Pro/Max-Abonnement — welche Option wählen?](/de/learn/claude-api-vs-subscription/)[Die Codex CLI mit Claude ausführen](/de/learn/use-claude-api-with-codex/)[Claude mit n8n verbinden](/de/learn/use-claude-api-with-n8n/)[LiteLLM-Anfragen an Claude weiterleiten](/de/learn/use-claude-api-with-litellm/)[Claude in Kilo Code verwenden](/de/learn/use-claude-api-with-kilo-code/)[Claude in GitHub Copilot integrieren](/de/learn/use-claude-api-with-github-copilot/)[Cherry Studio mit Claude verbinden](/de/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: Import, base_url, Streaming, Tools und Fehler](/de/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: installieren, base_url setzen, streamen und Fehler behandeln](/de/learn/anthropic-python-sdk/)[Claude mit dem Vercel AI SDK: createAnthropic baseURL, Streaming und Fehlerbehebung](/de/learn/use-claude-api-with-vercel-ai-sdk/)[Factory Droid mit Claude betreiben](/de/learn/use-claude-api-with-factory-droid/)[Die Claude Code API erklärt](/de/learn/claude-code-api/)[Die Claude API in Ihre Anwendung integrieren](/de/learn/claude-api-integration/)[So nutzen Sie Claude unbegrenzt – und warum es kein „gecracktes Claude Code“ gibt](/de/learn/get-unlimited-claude-usage/)