Zum Hauptinhalt springen
Zed kann ein benutzerdefiniertes Modell über zwei separate Provider-Slots 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 zu zeigen — den OpenAI-kompatiblen Endpunkt unter https://api.tokios.com/v1 und den Anthropic-kompatiblen Endpunkt unter https://api.tokios.com. Wählen Sie einen aus oder konfigurieren Sie beide und wechseln Sie pro Assistent.

Voraussetzungen

Option A: OpenAI-kompatibler Provider

1

Open Zed's settings.json

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

Add an openai_compatible entry

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 dem Tab Models registriert haben — nicht Ihre lokale Ollama/llama.cpp/vLLM/LM Studio-Modell-ID. Beachten Sie, dass der Schlüssel hier bewusst fehlt — siehe den nächsten Schritt.
3

Set your API key outside settings.json

Zed liest den API-Schlüssel nicht aus settings.json. Übergeben Sie Ihren sk-tok-…-Schlüssel auf einem der beiden Wege:
  • Über die UI — führen Sie agent: open settings aus der Befehlspalette aus, finden Sie Tokios unter LLM Providers 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 ID Tokios oben liest sich daher als TOKIOS_API_KEY.
Eine nicht-leere Umgebungsvariable hat Vorrang vor dem Schlüsselbund-Wert, also löschen Sie sie, wenn Sie später zum UI-Flow wechseln.
4

Select the model in the assistant panel

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

Option B: Anthropic-kompatibler Provider

1

Add an anthropic_compatible entry

Fügen Sie in derselben settings.json einen language_models.anthropic_compatible-Block hinzu, der auf den Tokios Anthropic-kompatiblen Endpunkt zeigt. Beachten Sie, dass kein /v1 bei dieser Basis-URL vorhanden ist:
settings.json
Ersetzen Sie gemma-tunnel durch den öffentlichen Deployment-Namen, den Sie auf dem Tab Models registriert haben — nicht Ihre lokale Ollama/llama.cpp/vLLM/LM Studio-Modell-ID.
2

Set your API key outside settings.json

Übergeben Sie Ihren sk-tok-…-Schlüssel auf dieselbe Weise wie Option A:
  • Über die UI — führen Sie agent: open settings aus der Befehlspalette aus, finden Sie Tokios unter LLM Providers im Anthropic-kompatiblen Abschnitt und fügen Sie den Schlüssel ein. Zed speichert ihn in Ihrem System-Schlüsselbund.
  • Über eine Umgebungsvariable — dieselbe TOKIOS_API_KEY-Variable aus Option A deckt beide Provider-Slots ab, da die Provider-ID in beiden Fällen Tokios ist.
3

Select the model in the assistant panel

Öffnen Sie Zeds Assistenten-Panel und wählen Sie Tokios (Anthropic): gemma-tunnel (oder Ihren konfigurierten display_name) aus dem Modell-Picker, neben oder anstelle des OpenAI-kompatiblen.
Ersetzen Sie gemma-tunnel durch den von Ihnen registrierten Deployment-Namen und sk-tok-YOUR_KEY durch Ihren eigenen Schlüssel. Übergeben Sie niemals einen davon in ein gemeinsam genutztes oder versionskontrolliertes settings.json.
Sie können beide Provider gleichzeitig konfigurieren und separate Einträge behalten — einen, der https://api.tokios.com/v1 anspricht (OpenAI-kompatibel) und einen, der https://api.tokios.com anspricht (Anthropic-kompatibel) — und dann über den Modell-Picker zwischen ihnen wechseln, um das Verhalten bei derselben zugrunde liegenden Deployment zu vergleichen.

Warum dies ohne Tunnel funktioniert

Beide Zed-Provider-Slots benötigen eine URL, die von überall erreichbar ist, woher Zeds Modell-Anfragen stammen. Tokios’ Connector ist nur ausgehend: Er wählt sich von neben Ihrem Modell 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 gehalten werden muss, kein unauthentifizierter Port, der in Ihrem LAN offen steht.

Fehlerbehebung

Der von Zed gesendete API-Schlüssel fehlt, ist fehlerhaft oder wurde widerrufen. Bestätigen Sie, dass der vollständige sk-tok-…-Schlüssel ohne zusätzliche Leerzeichen gesetzt ist, und prüfen Sie seinen Status auf dem Tab Keys.
Der name-Wert in available_models stimmt nicht mit einem registrierten Deployment überein. Bestätigen Sie, dass er exakt dem öffentlichen Namen auf dem Tab Models entspricht.
Der Connector für dieses Deployment ist offline oder hat sein Gleichzeitigkeitslimit erreicht. Prüfen Sie den Tab Connectors — er muss als Online angezeigt werden.

Nächste Schritte

Schnellstart

Den Connector koppeln und Ihr erstes Deployment von Grund auf registrieren.

Kompatible Clients

Siehe Basis-URL und Schlüssel-Einrichtung für andere OpenAI- und Anthropic-kompatible Clients.