Zum Inhalt springen
Kostenlos registrieren
Coding Agents einrichten

Zed mit eigenen Modellen einrichten: API Key und Base URL

Füge BetterToken in Zed als OpenAI-kompatiblen Provider hinzu, konfiguriere Base URL, API Key und Modell und speichere den Key im System-Schlüsselbund.

Füge in Zed unter Agent Settings einen OpenAI-kompatiblen Provider hinzu und trage dann BetterToken API Key, Base URL und Model ID ein. Zed speichert über diesen Bildschirm gespeicherte Keys im System-Schlüsselbund statt in settings.json.

Wichtige Einstellungen

FeldWert
ProviderBetterToken
API KeyYOUR_API_KEY
Base URLhttps://bettertoken.ai/v1
ModelYOUR_MODEL_ID

Voraussetzungen

Registrieren und BetterToken API Key erhalten

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Installation

Installiere oder aktualisiere auf die aktuelle Version von der Zed-Website. Starte Zed und verwende dann die folgenden Schritte, um die Agent-Einstellungen zu öffnen.

Manuelle Einrichtung

OpenAI-kompatiblen Provider hinzufügen

Klicke auf Add Provider, wähle OpenAI Compatible und trage BetterToken als Provider Name ein.

Verbindungseinstellungen eingeben

FeldWert
API URLhttps://bettertoken.ai/v1
API KeyYOUR_API_KEY
Model IDYOUR_MODEL_ID

Trage nur die Base URL ein. Diese Anleitung verwendet den standardmäßigen Chat-Completions-Modus von Zed, der den Endpunktpfad automatisch ergänzt.

API Key speichern

Speichere den Provider in den Zed-Einstellungen. Zed speichert den API Key im lokalen System-Schlüsselbund und schreibt ihn nicht in settings.json.

Modell auswählen

Öffne die Modellauswahl im Agent Panel und wähle YOUR_MODEL_ID unter BetterToken aus.

Optional: Provider und Modell in settings.json deklarieren

Wenn du dateiverwaltete Modelldeklarationen benötigst, führe zed: open settings file aus. Belasse nur Provider, api_url und Modellmetadaten in der Datei:

{
"language_models": {
"openai_compatible": {
"BetterToken": {
"api_url": "https://bettertoken.ai/v1",
"available_models": [
{
"name": "YOUR_MODEL_ID",
"display_name": "YOUR_MODEL_ID",
"max_tokens": 128000
}
]
}
}
}
}

Zed benötigt max_tokens als Deklaration des Modell-Kontextfensters. Passe den Wert an das ausgewählte Modell an. Trage den API Key in Agent Settings ein, damit ihn der System-Schlüsselbund speichert.

Verbindung überprüfen

  1. Wähle BetterToken / YOUR_MODEL_ID im Agent Panel aus.
  2. Sende eine kurze Testnachricht.
  3. Eine normale Antwort ohne Authentifizierungs- oder Modellfehler bestätigt die Einrichtung.

Beende Zed vollständig und starte es neu, nachdem du Provider- oder Modelleinstellungen geändert hast.

Modelle wechseln

Wähle in der Modellauswahl des Agent Panels ein anderes BetterToken-Modell. Um eine Model ID hinzuzufügen, kopiere den aktuellen Wert aus der model plaza und aktualisiere dann die Provider-Einstellungen oder available_models.

Häufige Fehler

FehlerLösung
401 oder UnauthorizedTrage den BetterToken API Key erneut in Agent Settings ein und entferne umgebende Leerzeichen.
404Verwende https://bettertoken.ai/v1 als API URL; hänge nicht /chat/completions an.
model not foundKopiere YOUR_MODEL_ID erneut aus der model plaza.
Einstellungen werden nicht übernommenSpeichere den Provider, beende Zed vollständig und öffne es erneut.
Zed verwendet einen alten KeyPrüfe die aus deiner Provider-ID abgeleitete Variable: Großbuchstaben in Snake Case plus _API_KEY, beispielsweise BETTERTOKEN_API_KEY für BetterToken. Ein nicht leerer Wert hat Vorrang vor dem Schlüsselbund. Entferne die Variable und starte Zed neu, um den gespeicherten Key zu verwenden. Siehe Zeds Vorrangregeln für Keys.

Technische Details

Schlüsselbund, Einstellungsdatei und Endpunkt

Zed ruft BetterToken über einen OpenAI-kompatiblen Provider auf. Der Einstellungsbildschirm speichert den Key im System-Schlüsselbund; settings.json enthält nur die Provider-, api_url- und Modelldeklaration. Verwende mit den standardmäßigen Chat-Completions-Einstellungen dieser Anleitung https://bettertoken.ai/v1 als Base URL und lasse Zed den Endpunktpfad anhängen.

Verwandte FAQ