Zed

Zed configure les services tiers compatibles OpenAI sous language_models.openai_compatible.<provider>. Ce guide utilise l’identifiant de fournisseur getrouter.

État de l’intégration
  • Protocole : compatible OpenAI (Chat Completions par défaut)
  • Configuration vérifiée : 15 juillet 2026
  • Vérification en conditions réelles : En attente

1. Enregistrer la clé API

Ouvrez les paramètres Agent de Zed avec agent: open settings, ajoutez ou sélectionnez le fournisseur compatible OpenAI nommé getrouter, puis enregistrez YOUR_API_KEY dans l’interface des identifiants de Zed. Les identifiants gérés par l’interface sont stockés dans le trousseau du système, pas dans settings.json.

Vous pouvez également définir, avant de démarrer Zed, la variable d’environnement dérivée de l’identifiant du fournisseur :

export GETROUTER_API_KEY="YOUR_API_KEY"

2. Configurer le fournisseur et le modèle

Ouvrez le fichier settings.json de Zed et fusionnez le modèle suivant :

{
  "language_models": {
    "openai_compatible": {
      "getrouter": {
        "api_url": "https://getrouter.ai/v1",
        "available_models": [
          {
            "name": "MODEL_ID",
            "display_name": "GetRouter Model",
            "max_tokens": MODEL_MAX_TOKENS
          }
        ]
      }
    }
  }
}

MODEL_MAX_TOKENS est un marqueur de modèle, pas une valeur JSON littérale. Avant d’enregistrer le fichier, remplacez-le par un entier correspondant à la limite réelle de la fenêtre de contexte du modèle choisi. Ne copiez pas et ne devinez pas la limite d’un autre modèle.

Cette structure suit la configuration officielle des endpoints compatibles OpenAI de Zed.

3. Vérifier

Ouvrez l’Agent Panel, sélectionnez GetRouter Model et envoyez un court prompt en texte brut. Une fois le chat de base fonctionnel, ne testez les fonctions d’édition et les outils que si le modèle choisi les prend en charge. Ce guide n’a pas encore fait l’objet d’une vérification en conditions réelles.

Résolution des problèmes

  • Le modèle n’apparaît pas : vérifiez la hiérarchie openai_compatible.getrouter.available_models et remplacez MODEL_MAX_TOKENS par un entier avant d’enregistrer.
  • Les identifiants sont introuvables : l’identifiant de fournisseur getrouter correspond à GETROUTER_API_KEY ; enregistrez la clé dans l’interface du fournisseur Zed ou redémarrez Zed après avoir exporté la variable.
  • Réponse 401 : vérifiez que le processus Zed local peut accéder aux identifiants prévus.
  • Échec de l’Agent ou des outils : vérifiez les capacités du modèle choisi et utilisez la limite réelle de sa fenêtre de contexte.