Documentação

Zed

O Zed declara um provedor compatível com OpenAI em settings.json e recebe a chave separadamente, pelo Agent Panel. O array models não é apenas uma conveniência — ele é a lista completa de modelos que o Zed reconhecerá.

Um bloco language_models.openai_compatible em settings.json declara o endpoint e seus modelos; a chave vai na interface Agent Panel, nunca no arquivo.

~/.config/zed/settings.json

{
  "language_models": {
    "openai_compatible": {
      "kunavo": {
        "api_url": "https://api.kunavo.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-5",
            "display_name": "Claude Sonnet 5",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": { "tools": true, "images": true }
          },
          {
            "name": "claude-haiku-4-5",
            "display_name": "Claude Haiku 4.5",
            "max_tokens": 200000
          }
        ]
      }
    }
  }
}

A chave de API não deve ser colocada neste arquivo. A documentação do Zed diz isso explicitamente: insira-a nas configurações do provedor no Agent Panel ou defina a variável de ambiente que o Zed gera para o nome do provedor. O settings.json é sincronizado e compartilhado; se houver uma chave nele, ela será compartilhada junto.

available_models é todo o catálogo do ponto de vista do Zed — não há uma chamada de descoberta para um provedor compatível com OpenAI, então um modelo que você não listou não aparece no seletor. Adicione uma entrada por ID que pretenda usar, com max_tokens definido para a janela de contexto real desse modelo.

Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Zed.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
Abra settings.json com zed: open settings na paleta de comandos e adicione o bloco acima.
Abra as configurações do Agent Panel, encontre o provedor pelo nome que você usou como chave (kunavo neste caso) e cole a chave de API ali.
Escolha o modelo no seletor de modelos do Agent Panel — ele exibe o display_name e envia o name.
Substitua apenas os capabilities que diferem dos padrões do Zed; por padrão, são tools: true, com imagens e chamadas paralelas de ferramentas desativadas.

Verificado em Documentação de acesso à API do Zed em 6 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Zed.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

ID do modelo	Entrada / saída da Kunavo	Onde se encaixa em Zed
`claude-sonnet-5`	$1.40 / $7.00	o padrão do agente — ferramentas e imagens ativadas
`claude-opus-5`	$3.50 / $17.50	refatorações maiores, em que o plano importa mais do que a velocidade
`claude-haiku-4-5`	$0.70 / $3.50	assistências em linha e edições rápidas
`gpt-5-6-terra`	$0.70 / $4.20	uma segunda família no mesmo cadastro de provedor

A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

Perguntas frequentes

Como adiciono um provedor compatível com OpenAI ao Zed?

Adicione um bloco language_models.openai_compatible a settings.json com o nome do provedor como chave, um api_url apontando para a raiz /v1 do endpoint e um array available_models com o ID de cada modelo que você quer usar. Em seguida, abra as configurações do provedor no Agent Panel e insira a chave de API ali. A documentação do Zed deixa explícito que as chaves não devem ficar em settings.json.

Por que um modelo não aparece no seletor de modelos do Zed?

Porque ele não está em available_models. O Zed não consulta o catálogo de um endpoint compatível com OpenAI, então o array em settings.json é a lista completa de modelos oferecidos pelo provedor. Adicione uma entrada com o ID do modelo como name, um display_name para o seletor e max_tokens definido para a janela de contexto real do modelo.

Onde o Zed armazena a chave de API de um provedor personalizado?

Na interface de configurações do provedor no Agent Panel ou na variável de ambiente que o Zed gera a partir do nome do provedor — não em settings.json. O Zed mantém as credenciais fora do arquivo de configurações de propósito, porque esse arquivo deve ser portátil e compartilhável, enquanto a chave não deve ser compartilhada.

O Zed pode usar modelos Claude por meio de um endpoint personalizado?

Sim. O provedor openai_compatible envia o nome do modelo diretamente para api_url; assim, o endpoint, e não o Zed, resolve um ID Claude. Defina capabilities.tools como true para modelos que aceitam chamadas de ferramentas — esse é o padrão do Zed para este tipo de provedor — e o agente funciona da mesma forma que com um provedor próprio.