Dokumentation

Zed

Zed definiert in settings.json einen OpenAI-kompatiblen Anbieter und nimmt den Schlüssel separat über das Agent Panel entgegen. Das Array models ist keine Komfortfunktion — es enthält die gesamte Modellliste, die Zed kennt.

Ein language_models.openai_compatible-Block in settings.json definiert den Endpunkt und die Modelle; der Schlüssel kommt in die Agent-Panel-Oberfläche, nie in die Datei.

~/.config/zed/settings.json

{
  "language_models": {
    "openai_compatible": {
      "kunavo": {
        "api_url": "https://api.kunavo.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-5",
            "display_name": "Claude Sonnet 5",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": { "tools": true, "images": true }
          },
          {
            "name": "claude-haiku-4-5",
            "display_name": "Claude Haiku 4.5",
            "max_tokens": 200000
          }
        ]
      }
    }
  }
}

Der API-Schlüssel gehört nicht in diese Datei. Die Dokumentation von Zed sagt ausdrücklich, dass er in den Anbietereinstellungen des Agent Panel oder über die Umgebungsvariable eingegeben werden soll, die Zed für den Anbieternamen erstellt. settings.json wird synchronisiert und geteilt; ein darin gespeicherter Schlüssel wird mit der Datei weitergegeben.

available_models ist aus Sicht von Zed der gesamte Katalog — für einen OpenAI-kompatiblen Anbieter gibt es keinen Discovery-Aufruf. Ein Modell, das Sie nicht aufgeführt haben, erscheint daher nicht in der Auswahlliste. Fügen Sie für jede gewünschte ID einen Eintrag hinzu, wobei max_tokens auf das tatsächliche Kontextfenster dieses Modells gesetzt ist.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die Zed-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Öffnen Sie settings.json über zed: open settings in der Befehlspalette und fügen Sie den obigen Block hinzu.
Öffnen Sie die Einstellungen des Agent Panel, suchen Sie den Anbieter unter dem Namen, den Sie als Schlüssel verwendet haben (hier kunavo), und fügen Sie dort den API-Schlüssel ein.
Wählen Sie das Modell im Modellauswahlmenü des Agent Panel aus — es zeigt display_name an und sendet name.
Überschreiben Sie nur die Werte für capabilities, die von den Zed-Standardeinstellungen abweichen. Standardmäßig sind tools: true aktiviert, während Bilder und parallele Tool-Aufrufe deaktiviert sind.

Abgeglichen mit Zeds Dokumentation zum API-Zugriff am 6. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Zed.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in Zed hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	der Standard des Agenten — Tools und Bilder aktiviert
`claude-opus-5`	$3.50 / $17.50	größere Refactorings, bei denen der Plan wichtiger ist als die Geschwindigkeit
`claude-haiku-4-5`	$0.70 / $3.50	Inline-Unterstützung und schnelle Bearbeitungen
`gpt-5-6-terra`	$0.70 / $4.20	eine zweite Familie unter demselben Anbietereintrag

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Häufig gestellte Fragen

Wie füge ich Zed einen OpenAI-kompatiblen Anbieter hinzu?

Fügen Sie settings.json einen language_models.openai_compatible-Block mit dem Namen Ihres Anbieters als Schlüssel, einer api_url, die auf den /v1-Stamm des Endpunkts verweist, und einem available_models-Array hinzu, das jede gewünschte Modell-ID aufführt. Öffnen Sie anschließend die Anbietereinstellungen des Agent Panel und geben Sie dort den API-Schlüssel ein. Laut Dokumentation von Zed gehören Schlüssel ausdrücklich nicht in settings.json.

Warum wird ein Modell nicht in Zeds Modellauswahl angezeigt?

Weil es nicht in available_models enthalten ist. Zed fragt bei einem OpenAI-kompatiblen Endpunkt den Modellkatalog nicht ab. Das Array in settings.json enthält daher die vollständige Liste der Modelle dieses Anbieters. Fügen Sie einen Eintrag mit der Modell-ID als name, einem display_name für die Auswahlliste und max_tokens mit dem tatsächlichen Kontextfenster hinzu.

Wo speichert Zed den API-Schlüssel für einen benutzerdefinierten Anbieter?

In der Benutzeroberfläche der Anbietereinstellungen im Agent Panel oder in der Umgebungsvariable, die Zed aus dem Anbieternamen erstellt — nicht in settings.json. Zed speichert Zugangsdaten absichtlich außerhalb der Einstellungsdatei, weil diese portabel und teilbar sein soll, während ein Schlüssel weder das eine noch das andere ist.

Kann Zed Claude-Modelle über einen benutzerdefinierten Endpunkt verwenden?

Ja. Der Anbieter openai_compatible übergibt den Modellnamen direkt an api_url. Daher wird eine Claude-ID vom Endpunkt und nicht von Zed aufgelöst. Setzen Sie capabilities.tools für Modelle, die Tool-Aufrufe unterstützen, auf true — dies ist die Standardeinstellung von Zed für diesen Anbietertyp —, dann funktioniert der Agent wie bei einem Erstanbieter.