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.

// 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

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.