Skip to main content
Zed kann ein benutzerdefiniertes Modell über zwei separate Provider-Plätze in settings.json aufrufen: language_models.openai_compatible und language_models.anthropic_compatible. Beide akzeptieren eine benutzerdefinierte api_url, sodass Zed der übersichtlichste Ort ist, um beide Seiten von Tokios vorzuführen — den OpenAI-kompatiblen Endpunkt unter https://api.tokios.com/v1 und den Anthropic-kompatiblen Endpunkt unter https://api.tokios.com. Wählen Sie entweder einen aus oder konfigurieren Sie beide und wechseln Sie pro Assistent.

​
Voraussetzungen

  • Ein laufender Tokios-Connector, der mit Ihrem lokalen Modell gekoppelt ist — siehe Connector Install
  • Ein registrierter Name für die Modell-Deployment — siehe Register a Model
  • Ein Tokios API-Schlüssel (sk-tok-…) — siehe API Keys
  • Zed installiert

​
Option A: OpenAI-kompatibler Provider

1

Öffnen Sie Zeds settings.json

Öffnen Sie die Befehls-Palette und führen Sie zed: open settings aus, oder bearbeiten Sie settings.json direkt.
2

Fügen Sie einen openai_compatible-Eintrag hinzu

Fügen Sie einen language_models.openai_compatible-Block mit der Tokios-Basis-URL, Ihrem Deployment-Namen und Ihrem API-Schlüssel hinzu:
settings.json
Ersetzen Sie gemma-tunnel durch den öffentlichen Deployment-Namen, den Sie auf der Models-Registerkarte registriert haben — nicht Ihre lokale Modell-ID von Ollama/llama.cpp/vLLM/LM Studio. Beachten Sie, dass der Schlüssel hier bewusst fehlt — siehe den nächsten Schritt.
3

Legen Sie Ihren API-Schlüssel außerhalb von settings.json fest

Zed liest den API-Schlüssel nicht aus settings.json. Stellen Sie Ihren sk-tok-…-Schlüssel auf beide Arten bereit:
  • Über die Benutzeroberfläche — führen Sie agent: open settings aus der Befehlspalette aus, finden Sie Tokios unter LLM-Anbieter und fügen Sie den Schlüssel ein. Zed speichert ihn in Ihrem System-Schlüsselbund.
  • Über eine Umgebungsvariable — Zed leitet den Namen aus der Provider-ID in settings.json ab, in UPPER_SNAKE_CASE und mit _API_KEY als Suffix. Die oben genannte ID Tokios liest sich daher als TOKIOS_API_KEY.
Eine nicht-leere Umgebungsvariable hat Vorrang vor dem Wert im Schlüsselbund, also löschen Sie sie, wenn Sie später zum UI-Flow wechseln.
4

Wählen Sie das Modell im Assistenten-Panel

Öffnen Sie das Assistenten-Panel von Zed und wählen Sie Tokios: gemma-tunnel (oder Ihren konfigurierten display_name) aus dem Modell-Auswahlfeld.

​
Option B: Anthropic-kompatibler Provider

1

Fügen Sie einen anthropic_compatible-Eintrag hinzu

Fügen Sie im selben settings.json einen language_models.anthropic_compatible-Block hinzu, der auf den Tokios Anthropic-kompatiblen Endpunkt verweist. Beachten Sie, dass für diese Basis-URL kein /v1 vorhanden ist:
settings.json
Die genauen Feldnamen, die Zed unter anthropic_compatible.available_models erwartet, können leicht von der openai_compatible-Struktur abweichen und sich je nach Version unterscheiden; bestätigen Sie diese daher anhand Ihrer installierten Version.
2

Legen Sie Ihren API-Schlüssel fest

Geben Sie Ihren sk-tok-…-Schlüssel auf die gleiche Weise wie Option A an — über custom_headers oder Zeds Schlüsselabfrage. Bestätigen Sie den genauen Header-Namen, den Zed für den Anthropic-kompatiblen Slot sendet (Anthropic-Clients verwenden typischerweise x-api-key statt Authorization: Bearer).
3

Wählen Sie das Modell im Assistentenbereich aus

Wählen Sie Ihr konfiguriertes Anthropic-kompatibles Modell aus Zeds Modellauswahl aus, neben oder anstelle des OpenAI-kompatiblen Modells.
Ersetzen Sie gemma-tunnel durch den von Ihnen registrierten Deployment-Namen und sk-tok-YOUR_KEY durch Ihren eigenen Schlüssel. Übertragen Sie niemals eines von beiden in ein gemeinsam genutztes oder versionskontrolliertes settings.json.
Sie können beide Provider gleichzeitig konfigurieren und separate Einträge beibehalten — einen, der https://api.tokios.com/v1 (OpenAI-kompatibel) und einen, der https://api.tokios.com (Anthropic-kompatibel) anspricht — und dann über die Modellauswahl zwischen ihnen wechseln, um das Verhalten im Vergleich zur gleichen zugrunde liegenden Deployment-Instanz zu vergleichen.

​
Warum dies ohne Tunnel funktioniert

Beide Zed-Provider-Slots benötigen eine URL, die von überall dort aus erreichbar ist, woher Zeds Modell-Anfragen stammen. Der Connector von Tokios ist nur ausgehend: Er wählt von neben Ihrem Modell aus aus und öffnet niemals einen eingehenden Port, sodass https://api.tokios.com (oder /v1) eine stabile, authentifizierte URL ist, die Sie einmal festlegen — kein ngrok-Prozess, der am Leben erhalten werden muss, und kein unauthentifizierter Port, der in Ihrem LAN offen steht.

​
Fehlerbehebung

Der von Zed gesendete API-Schlüssel fehlt, ist fehlerhaft oder wurde widerrufen. Stellen Sie sicher, dass der vollständige sk-tok-…-Schlüssel ohne zusätzliche Leerzeichen festgelegt ist, und prüfen Sie seinen Status auf der Keys-Registerkarte.
Der name-Wert in available_models stimmt mit keiner registrierten Deployment überein. Stellen Sie sicher, dass er exakt mit dem öffentlichen Namen auf der Models-Registerkarte übereinstimmt.
Der Connector für dieses Deployment ist offline oder hat sein gleichzeitiges Ausführungslimit erreicht. Prüfen Sie die Connectors-Registerkarte — sie muss als Online angezeigt werden.

​
Nächste Schritte

Schnellstart

Pairen Sie den Connector und registrieren Sie Ihr erstes Deployment von Grund auf neu.

Kompatible Clients

Sehen Sie sich die Einrichtung von Basis-URL und Schlüssel für andere OpenAI- und Anthropic-kompatible Clients an.