Zed com um fornecedor de LLM personalizado

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 no fornecedor Claude

O api_url termina em /v1. No fornecedor compatível com Anthropic é https://aigrow.gg.

404 num modelo GPT

capabilities.chat_completions está como false, o que envia o modelo para a Responses API. Defina-o como true.

A minha ferramenta indica 401 ou erro de autenticação

A chave está em falta ou foi escrita incorretamente. Copie-a de novo em Acesso à API no painel e certifique-se de que é enviada como chave, e não como nome de modelo. Uma chave revogada falha da mesma forma: crie uma nova e substitua-a.

Recebo 402 ou uma mensagem sobre crédito

O seu saldo está vazio. Abra Acesso à API no painel, resgate um código ou compre outro pacote e o pedido seguinte será processado. Não é preciso mudar mais nada.

Aparece 404 ou Unknown model

O modelo tem de ser um dos que o endpoint disponibiliza, por exemplo claude-opus-5.5. A grafia própria do fornecedor também funciona (claude-opus-5-5, anthropic/claude-opus-5.5), mas um id com data ou qualquer modelo fora do catálogo é rejeitado antes de o pedido ser encaminhado e nada é cobrado. Peça GET /v1/models com a sua chave para obter a lista atual, ou consulte os ids na lista de preços.

Os pedidos são rejeitados com 429

A capacidade do endpoint é partilhada por todos os clientes: cerca de 20 pedidos por minuto e 4 em simultâneo. Cada resposta 429 inclui um cabeçalho retry-after, e os SDKs da OpenAI e da Anthropic esperam esse tempo e voltam a tentar por conta própria. Num ciclo seu, aguarde os segundos indicados ou reduza a concorrência.

O modelo está indisponível neste momento

Um 404 que indica que o modelo não está disponível neste momento significa que ele está brevemente em baixo no fornecedor de origem, e não um problema com a sua chave ou saldo. Tente novamente daqui a pouco ou envie o pedido para outro modelo.

Recebo um 502 ou 503

Uma falha transitória na origem ou na configuração, sem qualquer cobrança no seu saldo. Repita o pedido; se continuar a falhar, contacte-nos através da loja e vamos analisar.

Um programador a trabalhar o dia todo, com a maior parte de cada pedido lida da cache de prompts, ao preço de tabela e através de crédito. Mude o modelo para comparar.

Compatível com Anthropic ou compatível com OpenAI no Zed?

Ambos funcionam. O compatível com Anthropic, com api_url https://aigrow.gg, serve os modelos Claude e a cache de prompts. O compatível com OpenAI, com api_url https://aigrow.gg/v1, executa GPT e Grok.

Onde é que o Zed guarda a chave?

No porta-chaves do sistema, quando a cola nas definições do fornecedor, ou numa variável de ambiente com o nome do fornecedor, como AIGROW_API_KEY. A documentação do Zed diz para nunca a colocar no settings.json.

Devo ativar a cache de prompts?

Sim, para modelos Claude no fornecedor compatível com Anthropic. O Zed passa então a marcar as partes do prompt a guardar em cache, e as leituras da cache custam menos do que a entrada nova.

Fontes: Zed Use API access · Zed LLM providers · Zed Configuring Zed. Consultado em 21 de outubro de 2026.