Zed com Claude e GPT: configurar uma API personalizada

O Zed é um editor de código rápido e de código aberto com um agente de IA embutido. O Zed Agent trabalha no Agent Panel: lê o projeto, edita arquivos, usa ferramentas e mostra cada alteração para você revisar ou desfazer. As mesmas configurações de modelo também alimentam o Inline Assistant, a geração de mensagens de commit do Git e os resumos de threads.

O Zed pode usar os próprios modelos hospedados, mas também aceita qualquer provedor com chave de API. É aí que a APIVAI entra: uma única chave dá acesso a modelos Claude e GPT, cobrados por token (abaixo dos preços oficiais na maioria dos modelos), a partir de um saldo que você recarrega quando precisar. A chave funciona no formato da OpenAI e no da Anthropic, então serve para os dois tipos de provedor personalizado do Zed.

O Zed tem dois tipos de endpoint personalizado que funcionam com a APIVAI:

Comece pelo OpenAI-compatible: um único provedor cobre Claude e GPT, e trocar de modelo é um clique no Agent Panel. Adicione também o Anthropic-compatible se você usa principalmente o Claude e quer que o Zed envie as requisições no formato nativo do Claude, incluindo cache de prompts. Os dois podem ficar configurados ao mesmo tempo com a mesma chave.

1. Cadastre-se em apivai.com com seu e-mail.
2. Recarregue o saldo a partir de $10 com cartão, cripto, Alipay ou WeChat Pay. Não há teste grátis: você paga só pelo que usar.
3. Abra o Dashboard, crie uma chave e copie. Você pode definir um limite de orçamento próprio para a chave, para que o agente nunca gaste mais do que o planejado.

O jeito mais rápido é pela interface de configurações:

1. Execute agent: open settings na paleta de comandos (ou vá em Settings → AI → LLM Providers).
2. Clique em Add Provider e preencha o nome do provedor, a API URL, o ID do modelo e a janela de contexto conforme a tabela.
3. Cole sua chave da APIVAI no campo de chave do provedor. O Zed guarda a chave no chaveiro do sistema, não no settings.json.

Se preferir editar o settings.json, o mesmo provedor com dois modelos fica assim:

Três detalhes importam. No Zed, max_tokens é a janela de contexto, não o tamanho da resposta; o limite da resposta é max_output_tokens. A api_url deve terminar em /v1 uma única vez, porque o Zed acrescenta /chat/completions. E a chave nunca vai no settings.json: informe na interface ou defina a variável de ambiente que o Zed deriva do ID do provedor (em maiúsculas mais _API_KEY, então apivai vira APIVAI_API_KEY) e reinicie o Zed.

Para ver quais IDs de modelo a sua chave pode usar, execute:

A lista de modelos muda com o tempo, então copie os IDs dessa resposta ou da página de preços, e não de tutoriais antigos.

Em Add Provider, escolha Anthropic e informe https://api.apivai.com como API URL, ou adicione isto ao lado do bloco acima:

Não adicione /v1 aqui. O cliente Anthropic do Zed acrescenta /v1/messages à API URL, então https://api.apivai.com/v1 viraria /v1/v1/messages e daria 404. Com prompt_caching, o Zed envia pontos de cache e o contexto repetido é cobrado pelo preço de leitura de cache ($0.12 por 1M no Claude Sonnet 4.6). Informe a chave na interface de configurações do provedor. Há mais detalhes sobre esse formato na página do proxy da API do Claude.

Abra o Agent Panel e clique no seletor de modelo no editor de mensagens. Seus modelos da APIVAI aparecem sob o nome de provedor que você escolheu; confira se selecionou a entrada da APIVAI e não um modelo com o mesmo nome de outro provedor. Para torná-lo o padrão, defina agent.default_model no settings.json com o nome do provedor e o ID do modelo.

O agente envia uma requisição a cada passo, então o preço por token importa. Preços por 1M de tokens de entrada / saída em 2026-10-10:

Um esquema prático: Claude Sonnet 4.6 ou Claude Sonnet 5.5 para o agente, Claude Opus 5.5 quando uma tarefa falha repetidamente, e Claude Haiku 4.5 para edições rápidas em linha. Os modelos GPT só funcionam pelo provedor compatível com OpenAI.

Cada passo do agente reenvia a thread e os arquivos já lidos, então os tokens de entrada são a maior parte do custo. Dois exemplos realistas com o Claude Sonnet 4.6:

• Uma tarefa média, como corrigir um bug que envolve alguns arquivos: cerca de 15 requisições de 25.000 tokens de entrada e 1.500 de saída cada. Custo: $0.56 com a APIVAI, $1.46 no preço oficial.
• Um mês de trabalho com duas tarefas dessas por dia durante 22 dias (660 requisições): $24.66 com a APIVAI, $64.35 no preço oficial.

O mesmo mês com o Claude Haiku 4.5 custaria $8.17. Essas estimativas não consideram o cache de prompts e incluem os tokens de raciocínio no número de saída, já que são cobrados como saída. O Dashboard lista cada requisição com tokens e custo, então em um dia você pode trocar essas suposições pelos seus próprios números. Para uma comparação mais ampla, veja os preços da API do Claude em 2026.

• 401 Unauthorized: a chave está ausente, incompleta, foi excluída ou esgotou o orçamento. Informe-a de novo nas configurações do provedor. Uma variável de ambiente não vazia tem prioridade sobre o chaveiro, então confira também APIVAI_API_KEY.
• 404 Not Found: quase sempre é o /v1. O OpenAI-compatible precisa de https://api.apivai.com/v1 (sem /chat/completions no final); o Anthropic-compatible precisa de https://api.apivai.com sem /v1.
• Modelo não encontrado: name deve ser um ID exato, como claude-sonnet-4-6, e não um nome de exibição. Confira com GET /v1/models.
• Respostas vazias ou cortadas: o raciocínio vem ativado por padrão e consome tokens de saída. Aumente max_output_tokens para 8192 ou mais (no mínimo 4096).
• 429 Too Many Requests: o limite padrão é de 60 requisições por minuto por chave. Tarefas longas do agente podem atingi-lo; espere um pouco ou peça ao suporte para aumentar o limite.

As regras gerais de cada formato estão na página de API compatível com OpenAI e na documentação.

Sim. Adicione um provedor compatível com OpenAI com os dois IDs de modelo em available_models e alterne entre eles no seletor de modelo.

https://api.apivai.com/v1 para um provedor compatível com OpenAI e https://api.apivai.com para um compatível com Anthropic, porque o próprio Zed acrescenta /v1/messages.

Não. O Edit Prediction tem configuração de provedor própria; os provedores deste guia alimentam o Zed Agent, o Inline Assistant, as mensagens de commit e os resumos de threads.

Não. O conteúdo das requisições e respostas não é registrado. Só ficam guardados dados de uso como modelo, tokens e custo, para a cobrança.

Sim. A mesma chave funciona no Cline, no Continue e em agentes de terminal como o OpenCode. Criar uma chave por ferramenta deixa o Dashboard mais fácil de ler.

Crie uma conta, recarregue a partir de $10 e cole sua chave no Zed.