Skip to main content
Zed peut appeler un modèle personnalisé via deux emplacements de fournisseur distincts dans settings.json : language_models.openai_compatible et language_models.anthropic_compatible. Les deux acceptent un api_url personnalisé, ce qui fait de Zed l’endroit le plus propre pour mettre en valeur les deux aspects de Tokios — le point de terminaison compatible OpenAI à https://api.tokios.com/v1 et le point de terminaison compatible Anthropic à https://api.tokios.com. Choisissez l’un ou l’autre, ou configurez les deux et basculez selon l’assistant.

​
Prérequis

​
Option A : fournisseur compatible OpenAI

1

Ouvrez settings.json dans Zed

Ouvrez la palette de commandes et exécutez zed: open settings, ou modifiez settings.json directement.
2

Ajouter une entrée openai_compatible

Ajouter un bloc language_models.openai_compatible contenant l’URL de base de Tokios, le nom de votre déploiement et votre clé API :
settings.json
Remplacez gemma-tunnel par le nom de déploiement public que vous avez enregistré sur l’onglet Models — et non par l’ID de modèle local de votre Ollama/llama.cpp/vLLM/LM Studio. Notez que la clé est délibérément absente ici — voir l’étape suivante.
3

Définissez votre clé API en dehors de settings.json

Zed ne lit pas la clé API depuis settings.json. Fournissez votre clé sk-tok-… de l’une ou l’autre manière :
  • Via l’interface utilisateur — exécutez agent: open settings depuis la palette de commandes, trouvez Tokios sous Fournisseurs LLM, et collez la clé. Zed la stocke dans votre trousseau de clés système.
  • Via une variable d’environnement — Zed déduit le nom à partir de l’ID du fournisseur dans settings.json, en majuscules avec des traits de soulignement, et suffixé par _API_KEY. L’ID Tokios ci-dessus se lit donc TOKIOS_API_KEY.
Une variable d’environnement non vide a la priorité sur la valeur du trousseau de clés, donc désactivez-la si vous passez ultérieurement au flux de l’interface utilisateur.
4

Sélectionnez le modèle dans le panneau assistant

Ouvrez le panneau assistant de Zed et choisissez Tokios: gemma-tunnel (ou votre display_name configuré) dans le sélecteur de modèle.

​
Option B : fournisseur compatible Anthropic

1

Ajouter une entrée anthropic_compatible

Dans le même settings.json, ajoutez un bloc language_models.anthropic_compatible pointant vers le endpoint compatible Anthropic de Tokios. Notez qu’il n’y a pas de /v1 sur cette URL de base :
settings.json
Les noms exacts des champs que Zed attend sous anthropic_compatible.available_models peuvent différer légèrement de la forme openai_compatible et varier selon la version, donc confirmez avec votre version installée.
2

Définissez votre clé API

Fournissez votre clé sk-tok-… de la même manière que l’Option A — via custom_headers ou l’invite de clé de Zed. Confirmez le nom exact de l’en-tête que Zed envoie pour le slot compatible Anthropic (les clients Anthropic utilisent généralement x-api-key plutôt que Authorization: Bearer).
3

Sélectionnez le modèle dans le panneau assistant

Choisissez votre modèle compatible Anthropic configuré dans le sélecteur de modèles de Zed, à côté ou à la place de celui compatible OpenAI.
Remplacez gemma-tunnel par le nom de déploiement que vous avez enregistré, et sk-tok-YOUR_KEY par votre propre clé. Ne commitez jamais l’un ou l’autre dans un settings.json partagé ou sous contrôle de version.
Vous pouvez configurer les deux fournisseurs à la fois et conserver des entrées séparées — une pointant vers https://api.tokios.com/v1 (compatible OpenAI) et une pointant vers https://api.tokios.com (compatible Anthropic) — puis basculer entre eux depuis le sélecteur de modèles pour comparer le comportement par rapport au même déploiement sous-jacent.

​
Pourquoi cela fonctionne sans tunnel

Les deux slots de fournisseur de Zed nécessitent une URL accessible depuis l’endroit où les requêtes de modèle de Zed prennent origine. Le connecteur de Tokios est uniquement sortant : il se connecte depuis près de votre modèle et n’ouvre jamais de port entrant, donc https://api.tokios.com (ou /v1) est une URL stable et authentifiée que vous définissez une fois — aucun processus ngrok à maintenir actif, aucun port non authentifié restant ouvert sur votre LAN.

​
Dépannage

La clé API envoyée par Zed est manquante, mal formée ou a été révoquée. Vérifiez que la clé sk-tok-… complète est définie sans espaces superflus, et vérifiez son statut dans l’onglet Keys.
La valeur name dans available_models ne correspond pas à un déploiement enregistré. Confirmez qu’elle correspond exactement au nom public affiché dans l’onglet Models.
Le connecteur de ce déploiement est hors ligne ou a atteint sa limite de concurrence. Vérifiez l’onglet Connectors — il doit afficher Online.

​
Prochaines étapes

Démarrage rapide

Associez le connecteur et enregistrez votre premier déploiement à partir de zéro.

Clients compatibles

Consultez la configuration de l’URL de base et de la clé pour les autres clients compatibles OpenAI et Anthropic.