Configuration des Coding Agents

Zed : modèles personnalisés, API Key et Base URL

Ajoutez BetterToken comme fournisseur OpenAI compatible dans Zed, configurez la Base URL, l’API Key et le modèle, et conservez la Key dans le trousseau système.

Ajoutez un fournisseur OpenAI compatible dans les Agent Settings de Zed, puis saisissez la BetterToken API Key, la Base URL et le Model ID. Zed enregistre les Key sauvegardées depuis cet écran dans le trousseau système plutôt que dans settings.json.

Paramètres principaux

Champ	Valeur
Provider	`BetterToken`
API Key	`YOUR_API_KEY`
Base URL	`https://bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`

Prérequis

Installez la version actuelle de Zed
Créez une BetterToken API Key
Copiez YOUR_MODEL_ID depuis le model plaza

Inscrivez-vous et obtenez une BetterToken API Key

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Installation

Installez ou mettez à jour la version actuelle depuis le site Zed. Démarrez Zed, puis suivez les étapes ci-dessous pour ouvrir les Agent Settings.

Configuration manuelle

Ajouter un fournisseur OpenAI compatible

Cliquez sur Add Provider, choisissez OpenAI Compatible et saisissez BetterToken comme Provider Name.

Saisir les paramètres de connexion

Champ	Valeur
API URL	`https://bettertoken.ai/v1`
API Key	`YOUR_API_KEY`
Model ID	`YOUR_MODEL_ID`

Saisissez uniquement la Base URL. Ce guide utilise le mode Chat Completions par défaut de Zed, qui ajoute donc le chemin de cet endpoint.

Enregistrer l’API Key

Enregistrez le fournisseur dans les paramètres Zed. Zed stocke l’API Key dans le trousseau système local et ne l’écrit pas dans settings.json.

Sélectionner le modèle

Ouvrez le sélecteur de modèles Agent Panel et sélectionnez YOUR_MODEL_ID sous BetterToken.

Facultatif : déclarer le fournisseur et le modèle dans `settings.json`

Si vous avez besoin de déclarations de modèles gérées par fichier, exécutez zed: open settings file. Ne conservez dans le fichier que le fournisseur, api_url et les métadonnées du modèle :

{
  "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 exige max_tokens comme déclaration de fenêtre de contexte du modèle. Ajustez-la au modèle sélectionné. Saisissez l’API Key dans les Agent Settings afin que le trousseau système la stocke.

Vérifier la connexion

Sélectionnez BetterToken / YOUR_MODEL_ID dans l’Agent Panel.
Envoyez un court message de test.
Une réponse normale sans erreur d’authentification ou de modèle confirme la configuration.

Quittez complètement Zed et redémarrez-le après avoir modifié les paramètres du fournisseur ou du modèle.

Changer de modèle

Choisissez un autre modèle BetterToken dans le sélecteur de modèles Agent Panel. Pour ajouter un Model ID, copiez la valeur actuelle depuis le model plaza, puis mettez à jour les paramètres du fournisseur ou available_models.

Erreurs courantes

Erreur	Correction
`401` ou `Unauthorized`	Saisissez à nouveau la BetterToken API Key dans Agent Settings et supprimez les espaces autour.
`404`	Utilisez `https://bettertoken.ai/v1` comme API URL ; n’ajoutez pas `/chat/completions`.
`model not found`	Copiez à nouveau `YOUR_MODEL_ID` depuis le model plaza.
Les paramètres ne sont pas appliqués	Enregistrez le fournisseur, quittez complètement Zed et rouvrez-le.
Zed utilise une ancienne Key	Vérifiez la variable dérivée de votre ID de fournisseur : en snake case majuscule, suivi de `_API_KEY`, par exemple `BETTERTOKEN_API_KEY` pour `BetterToken`. Une valeur non vide est prioritaire sur le trousseau. Supprimez cette variable et redémarrez Zed pour utiliser la clé enregistrée. Consultez la priorité des clés dans Zed.

Détails techniques

Trousseau, fichier de paramètres et endpoint

Zed appelle BetterToken via un fournisseur compatible OpenAI. L’écran des paramètres stocke la Key dans le trousseau système ; settings.json contient uniquement le fournisseur, api_url et la déclaration du modèle. Avec les réglages Chat Completions par défaut de ce guide, utilisez https://bettertoken.ai/v1 comme Base URL et laissez Zed ajouter le chemin de l’endpoint.