Zed con un provider LLM personalizzato

macOS e 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
            }
          }
        ]
      }
    }
  }
}

404 sul provider Claude

L’api_url termina con /v1. Sul provider compatibile con Anthropic è https://aigrow.gg.

404 su un modello GPT

capabilities.chat_completions è false, il che manda il modello alla Responses API. Impostalo su true.

Il mio strumento mostra un errore 401 o di autenticazione

La chiave manca o è stata digitata in modo errato. Copiala di nuovo da Accesso API nella dashboard e assicurati che venga inviata come chiave, non come nome di un modello. Una chiave revocata dà lo stesso errore: creane una nuova e sostituiscila.

Ricevo un errore 402 o un messaggio sul credito

Il tuo saldo è esaurito. Apri Accesso API nella dashboard, riscatta un codice o acquista un altro pacchetto e la richiesta successiva andrà a buon fine. Non serve cambiare nient’altro.

Compare 404 o Unknown model

Il modello deve essere uno di quelli serviti dall’endpoint, per esempio claude-opus-5.5. Funzionano anche le grafie originali del provider (claude-opus-5-5, anthropic/claude-opus-5.5), ma un id con data o qualsiasi modello fuori dal catalogo viene rifiutato prima che la richiesta sia inoltrata, e non viene addebitato nulla. Con la tua chiave richiedi GET /v1/models per l’elenco aggiornato, oppure leggi gli id nel listino.

Le richieste vengono rifiutate con errore 429

La capacità dell’endpoint è condivisa da tutti i clienti: circa 20 richieste al minuto e 4 contemporaneamente. Ogni risposta 429 include un header retry-after, e gli SDK di OpenAI e Anthropic attendono quel tempo e riprovano da soli. In un ciclo scritto da te, attendi i secondi indicati oppure riduci la concorrenza.

Il modello al momento non è disponibile

Un 404 che indica che il modello non è al momento disponibile significa che è temporaneamente fuori servizio presso il provider a monte, non che c'è un problema con la tua chiave o il tuo saldo. Riprova tra qualche istante oppure invia la richiesta a un altro modello.

Ricevo un errore 502 o 503

Un problema temporaneo a monte o di configurazione, che non viene addebitato sul tuo saldo. Riprova la richiesta; se continua a fallire, scrivici tramite lo store e ce ne occuperemo.

Uno sviluppatore al lavoro tutto il giorno, con la maggior parte di ogni richiesta letta dalla cache del prompt, al prezzo di listino e tramite credito. Cambia il modello per confrontare.

Compatibile con Anthropic o con OpenAI in Zed?

Vanno bene entrambi. Quello compatibile con Anthropic, con api_url https://aigrow.gg, è adatto ai modelli Claude e al prompt caching. Quello compatibile con OpenAI, con api_url https://aigrow.gg/v1, esegue GPT e Grok.

Dove conserva la chiave Zed?

Nel portachiavi di sistema, se la incolli nelle impostazioni del provider, oppure in una variabile d’ambiente con il nome del provider, come AIGROW_API_KEY. La documentazione di Zed raccomanda di non inserirla mai in settings.json.

Devo attivare il prompt caching?

Sì, per i modelli Claude sul provider compatibile con Anthropic. Zed contrassegna così le parti del prompt da mettere in cache, e le letture dalla cache costano meno di un nuovo input.

Fonti: Zed Use API access · Zed LLM providers · Zed Configuring Zed. Consultato il 21 ottobre 2026.