Zed avec un fournisseur LLM personnalisé

macOS et Linux

~/.config/zed/settings.json

{
  "language_models": {
    "anthropic_compatible": {
      "aigrow": {
        "api_url": "https://aigrow.gg",
        "available_models": [
          {
            "name": "claude-opus-5.5",
            "display_name": "Claude Opus 5.5",
            "max_tokens": 1000000,
            "capabilities": {
              "tools": true,
              "images": false,
              "prompt_caching": true
            }
          },
          {
            "name": "claude-sonnet-5.5",
            "display_name": "Claude Sonnet 5.5",
            "max_tokens": 1000000,
            "capabilities": {
              "tools": true,
              "images": false,
              "prompt_caching": true
            }
          }
        ]
      }
    },
    "openai_compatible": {
      "aigrow-openai": {
        "api_url": "https://aigrow.gg/v1",
        "available_models": [
          {
            "name": "gpt-6-astra",
            "display_name": "GPT-6 Astra",
            "max_tokens": 1050000,
            "capabilities": {
              "tools": true,
              "images": false,
              "chat_completions": true
            }
          },
          {
            "name": "grok-4.7",
            "display_name": "Grok 4.7",
            "max_tokens": 500000,
            "capabilities": {
              "tools": true,
              "images": false,
              "chat_completions": true
            }
          }
        ]
      }
    }
  }
}

Erreur 404 sur le fournisseur Claude

L’api_url se termine par /v1. Sur le fournisseur compatible Anthropic, elle doit être https://aigrow.gg.

Erreur 404 sur un modèle GPT

capabilities.chat_completions est à false, ce qui envoie le modèle vers l’API Responses. Définissez-le sur true.

Mon outil affiche une erreur 401 ou d’authentification

La clé est absente ou mal saisie. Copiez-la de nouveau depuis Accès API sur le tableau de bord, et vérifiez qu’elle est bien transmise comme clé, et non comme nom de modèle. Une clé révoquée provoque la même erreur : créez-en une nouvelle et remplacez-la.

J’obtiens une erreur 402 ou un message sur le crédit

Votre solde est vide. Ouvrez Accès API sur le tableau de bord, activez un code ou achetez un autre pack, et la requête suivante passera. Rien d’autre à modifier.

J’obtiens une erreur 404 ou « Unknown model »

Le modèle doit être l’un de ceux que l’endpoint propose, par exemple claude-opus-5.5. Les écritures propres aux fournisseurs fonctionnent aussi (claude-opus-5-5, anthropic/claude-opus-5.5), mais un identifiant daté ou tout modèle hors du catalogue est rejeté avant que la requête soit transmise, et rien n’est facturé. Envoyez GET /v1/models avec votre clé pour obtenir la liste à jour, ou consultez les identifiants dans la grille tarifaire.

Les requêtes sont rejetées avec l’erreur 429

La capacité de l’endpoint est partagée entre tous les clients : environ 20 requêtes par minute et 4 simultanément. Chaque erreur 429 contient un en-tête retry-after, et les SDK OpenAI et Anthropic attendent ce délai puis réessaient automatiquement. Dans votre propre boucle, attendez le nombre de secondes indiqué ou réduisez le nombre de requêtes simultanées.

Le modèle est indisponible pour le moment

Une erreur 404 indiquant que le modèle n’est pas disponible pour le moment signifie qu’il est brièvement hors service chez le fournisseur en amont. Ce n’est pas un problème lié à votre clé ou à votre solde. Réessayez dans un instant ou envoyez la requête à un autre modèle.

J’obtiens une erreur 502 ou 503

Un incident passager en amont ou de configuration, sans débit sur votre solde. Réessayez la requête ; si l’échec persiste, contactez-nous via la boutique et nous examinerons le problème.

Un développeur qui travaille toute la journée, avec la majeure partie de chaque requête relue depuis le cache du prompt, au tarif public et avec du crédit. Changez de modèle pour comparer.

Compatible Anthropic ou compatible OpenAI dans Zed ?

Les deux fonctionnent. Le mode compatible Anthropic, avec api_url https://aigrow.gg, convient aux modèles Claude et à la mise en cache des prompts. Le mode compatible OpenAI, avec api_url https://aigrow.gg/v1, fait tourner GPT et Grok.

Où Zed conserve-t-il la clé ?

Dans le trousseau du système quand vous la collez dans les paramètres du fournisseur, ou dans une variable d’environnement portant le nom du fournisseur, comme AIGROW_API_KEY. La documentation de Zed recommande de ne jamais la mettre dans settings.json.

Dois-je activer la mise en cache des prompts ?

Oui, pour les modèles Claude sur le fournisseur compatible Anthropic. Zed marque alors les parties du prompt à mettre en cache, et les lectures du cache coûtent moins cher qu’une nouvelle entrée.

Sources : Zed Use API access · Zed LLM providers · Zed Configuring Zed. Consulté le 21 octobre 2026.