Preços do Zed AI: tarifas hospedadas, custos BYOK e escolha do modelo

Para as próprias superfícies de IA do Zed, a melhor API é uma que você mesmo configure, porque o nível gratuito do Zed já pode acessar um endpoint compatível com OpenAI ou Anthropic e você nem precisa de uma conta Zed para fazer isso. A lista de recursos do plano Personal diz “Unlimited use with your API keys or external agents like Claude Agent, Codex CLI, and more”, e o FAQ da mesma página responde “I don't want to pay for Zed, can I use my own keys?” citando Anthropic, Google AI, OpenAI, OpenRouter, Ollama e outros (zed.dev/pricing, verificado em 19 de setembro de 2026); a documentação de autenticação do Zed diz “Signing in to Zed is not required” e que “To use AI without signing in, you can bring and configure your own API keys”. O que um plano pago realmente compra é conclusão por Tab ilimitada e inferência hospedada pelo Zed — duas coisas que um gateway não pode substituir da mesma maneira, e essa diferença é toda a decisão.

Primeiro, duas armadilhas de nomenclatura, porque os resultados de busca misturam as duas. ZED também é uma linha de câmeras estéreo da Stereolabs, com seus próprios preços de hardware; nada disso é este produto. E “Zed AI” não é um único produto na documentação atual, que divide a superfície em Zed Agent (nativo, conduzido pelos seus provedores configurados), External Agents pelo Agent Client Protocol e Terminal Threads. Um texto que trate “Zed AI” como um único serviço hospedado está descrevendo uma forma que a documentação atual não usa.

Três coisas separadas pelas quais o Zed pode cobrar

O erro de orçamento mais comum aqui é tratar “Zed” como uma única linha. São três, e cada uma tem um mecanismo de preços diferente.

A documentação de agentes externos do Zed afirma que “Zed does not charge for External Agents” e que “Billing, legal terms, retention, and data handling are between you and the agent provider”. Sua lista selecionada inclui Claude, Codex, OpenCode, Copilot, Cursor, Gemini CLI, Pi Coding Agent e Poolside. Se você já executa um desses com uma chave, a maior parte da questão sobre preços do Zed já está respondida — consulte a comparação de provedores do OpenCode e a do Codex para conhecer as opções próprias deles.

Preços do Zed AI: os planos e os limites que realmente impedem a cobrança

Três mecanismos importam mais do que os números anunciados. Primeiro, a página de planos e uso do Zed diz que “The default value for Pro users is $10, for a total monthly spend with Zed of $20” e que isso “can be set to $0 to limit your spend with Zed to exactly $10/month”; quando atingido, “we'll stop any further usage until your token spend limit resets”. Portanto, uma conta Pro sem alterações tem um teto de $20, não um medidor aberto. Segundo, a página de cobrança do Zed diz que o limite de gastos de IA para toda a organização no Business “starts at $0, so it must be increased before members can use any hosted models” — um assento Business, sozinho, compra zero de inferência. Terceiro, a mesma página descreve a cobrança por limite: as cobranças pelo gasto incremental de tokens começam em $10 antes dos impostos e o Zed “may automatically raise your pre-tax invoicing threshold in $10 increments, up to $100”, e “Once raised, the invoicing threshold is not automatically lowered during the same subscription”.

Um conflito a ser resolvido na sua própria conta, e não a partir de qualquer resumo. A página educacional da Zed diz que "O plano Zed Student não inclui os modelos Claude Fable, Claude Opus ou GPT Pro", enquanto a página de planos e uso descreve o mesmo plano como "todos os modelos de IA hospedados, exceto Claude Opus". São listas de exclusão diferentes. Confirme qual delas sua conta aplica antes de planejar em torno de um modelo específico. A elegibilidade na página educacional exige matrícula atual em uma universidade credenciada e ter pelo menos 18 anos; após 12 meses, o plano "será automaticamente rebaixado para um plano Free". A Zed também não publica nenhum preço anual em sua página de preços — o que não equivale a provar que não existe uma opção anual disponível no checkout. O Business não tem teste gratuito, não exige um número mínimo de assentos e oferece contratos por formulário de pedido para 25 ou mais assentos; SSO, SAML e SCIM são descritos como "planejados, mas não disponíveis atualmente".

A tabela de preços hospedados e a única coluna que não corresponde

A Zed publica uma tabela por modelo com os cabeçalhos "Preço do provedor por 1 milhão de tokens" e "Preço da Zed por 1 milhão de tokens", e afirma: "Qualquer uso de um modelo hospedado pela Zed será cobrado pelo Preço da Zed (coluna mais à direita acima)". A página de preços da Zed estabelece a regra do Pro como a tarifa da lista da API mais dez por cento, e em todas as linhas abaixo essa aritmética é exata. A questão interessante é com o que a coluna do provedor é comparada.

Fontes, todas consultadas em 19 de setembro de 2026: as colunas da Zed em zed.dev/docs/ai/models.md, as tarifas da Anthropic em claude.com/pricing, as tarifas da OpenAI em developers.openai.com e as da Kunavo no catálogo ao vivo. As linhas da Anthropic correspondem às de seus fornecedores. As duas linhas do GPT-5.6 não correspondem, no dia em que ambas as páginas foram consultadas. Esta página publica os dois números e para por aí: não afirma por que eles diferem e não está alegando que a Zed esteja cobrando além de sua política declarada. Um fato publicado que vale conhecer antes de fazer suposições: a própria página da OpenAI informa que o preço promocional do GPT-5.6 Sol está disponível pelo menos até 21 de novembro de 2026, portanto pelo menos uma dessas linhas está sujeita a uma promoção com data de término. Consulte novamente ambas as páginas antes de fazer o orçamento de uma carga de trabalho GPT-5.6 pelo caminho hospedado.

Uma observação estrutural sobre a tabela hospedada. A linha do Sonnet 5 da Zed ainda traz uma nota chamando a tarifa de introdutória "até 31 de agosto de 2026", embora liste essa mesma tarifa em setembro; a tarifa publicada pela Anthropic não mudou, portanto leia a nota de rodapé como desatualizada, e não o preço. A Zed também restringe seus modelos principais: "Claude Fable 5, modelos Claude Opus, GPT-5.5 pro e GPT-5.4 pro estão disponíveis apenas no Zed Pro e no Zed Business", e mantém uma lista de descontinuações que vale consultar antes de confiar em qualquer texto antigo: as entradas do Grok foram retiradas em 15 de maio de 2026, o Gemini 3 Pro em 26 de março de 2026 e o Claude Sonnet 3.7 em 19 de fevereiro de 2026.

Três limites que nenhuma página da Zed declara em conjunto

Esta é a parte que uma tabela de tarifas não consegue informar, e cada item pode custar uma tarde ou gerar uma cobrança inesperada.

1. Os dois tipos de provedor assumem api_url formas diferentes. A documentação de acesso à API da Zed mostra openai_compatible com uma api_url que termina em /v1 (https://example.com/v1) e anthropic_compatible com uma origem simples (https://api.someprovider.com). Essa documentação não explica a diferença nem traz um aviso sobre as consequências de errar; portanto, o motivo vem da convenção do cliente, e não de algo declarado pela Zed: os SDKs da Anthropic acrescentam /v1/messages à URL base por conta própria, e é por isso que a referência da URL base diz que incluir /v1 ali produz solicitações para /v1/v1/messages. Copie as duas formas mostradas pela Zed. A Kunavo oferece ambas — https://api.kunavo.com/v1 e https://api.kunavo.com.

{
  "language_models": {
    "openai_compatible": {
      "kunavo": {
        "api_url": "https://api.kunavo.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-5",
            "display_name": "Claude Sonnet 5 (Kunavo)",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": { "tools": true, "images": true }
          }
        ]
      }
    },
    "anthropic_compatible": {
      "Kunavo": {
        "api_url": "https://api.kunavo.com",
        "available_models": [
          {
            "name": "claude-sonnet-5",
            "display_name": "Claude Sonnet 5 (Kunavo, Messages)",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": { "tools": true, "images": true, "prompt_caching": false }
          }
        ]
      }
    }
  }
}

A chave não deve ser colocada nesse arquivo. A documentação da Zed diz: "Não coloque chaves de API em settings.json" para os dois tipos de provedor, e acrescenta que as chaves salvas pela Zed são "armazenadas no chaveiro do sistema, não em settings.json" e que "Variáveis de ambiente não vazias têm precedência sobre os valores do chaveiro". A regra de nomenclatura publicada é específica do tipo compatível com OpenAI — a variável é o ID do provedor configurado em maiúsculas com sublinhados, seguido de _API_KEY, portanto o bloco kunavo acima seria KUNAVO_API_KEY. Nenhuma regra equivalente é declarada para o tipo compatível com Anthropic; portanto, consulte a própria tabela de variáveis de ambiente da Zed para esse caso, em vez de presumir o mesmo padrão. Também não há descoberta de modelos em nenhum dos dois caminhos personalizados: available_models é o catálogo, e um modelo que você não declarou não aparece no seletor. Se um modelo funcionar apenas pela Responses API, a documentação da Zed diz para definir capabilities.chat_completions como false, e ela usará o endpoint Responses em vez disso.

2. prompt_caching tem false como valor padrão no caminho compatível com a Anthropic. Os valores padrão documentados pelo Zed para esse tipo de provedor são tools: true, images: false, prompt_caching: false. A redação do Zed é "Ative prompt_caching para enviar pontos de interrupção explícitos de cache_control para o cache de prompts; deixe-o desativado se o provedor rejeitar solicitações que os contenham". Com o sinalizador desativado, o Zed não envia pontos de interrupção nesse caminho, e o protocolo da Anthropic cobra um prefixo sem cache como entrada comum — portanto, uma conversa longa com um agente tem toda a sua entrada cobrada novamente a cada turno. Essa afirmação se refere apenas ao caminho compatível com a Anthropic; o caminho compatível com a OpenAI tem seu próprio sinalizador prompt_cache_key e seu próprio comportamento de cache, que esta página não descreve. Nenhum valor de economia com cache é publicado aqui, porque essa combinação nunca foi testada com o Kunavo, e um número que ninguém mediu seria pior do que nenhum número. Leia como o cache é cobrado e como o cache de prompts afeta a cobrança e, em seguida, verifique com uma pequena solicitação sua antes de presumir o desconto.

3. Trazer sua própria chave não alcança a conclusão por Tab. A previsão de edição é configurada em edit_predictions, não em language_models, e seus provedores que não são Zeta são copilot, mercury, codestral, ollama e open_ai_compatible_api. Este último não é a API de chat: a documentação de previsão de edição da Zed diz que seu servidor "deve implementar o endpoint OpenAI /v1/completions" e envia um corpo fill-in-the-middle com model, prompt, max_tokens, temperature e stop. A Kunavo não expõe nenhuma rota /v1/completions, portanto a Kunavo não pode fornecer a previsão de edição da Zed. Um modelo local por meio do Ollama ou um servidor FIM pode fazer isso, que é a única tarefa desta página em que o ambiente local realmente vence.

Dois limites menores, declarados porque fazer suposições sobre eles custa dinheiro. Uma entrada de provedor configurada para o Zed Agent não faz nada pelo External Agent: a documentação da Zed afirma que "Uma chave de API da Anthropic configurada para o Zed Agent não configura automaticamente o Claude Agent", e o mesmo vale para uma chave da OpenAI e o Codex. Ela não diz se as Terminal Threads herdam essa separação, portanto trate isso como não estabelecido, e não como resolvido. E os controles administrativos do Zed Business são descritos para modelos hospedados, previsões de edição e compartilhamento de dados; nada na documentação descreve visibilidade administrativa sobre provedores personalizados configurados por membros, portanto não está estabelecido aqui se um administrador do Business pode ver ou limitar esse gasto.

Uma estimativa de custo calculada com três cargas de trabalho declaradas

Estes são cálculos ilustrativos de tokens, não custos de tarefas medidos nem um teto de cobrança. Três formas, todas com suposições: A, um auxílio inline com 20,000 tokens de entrada não armazenados em cache e 1,500 tokens de saída; B, uma thread de agente em um recurso com 400,000 tokens de entrada e 25,000 de saída; C, um mês intenso de agente com 8,000,000 tokens de entrada e 500,000 de saída. Sem cache, sem cobranças de ferramentas, um único modelo durante todo o período e sem sobretaxa de contexto longo — os modelos GPT-5.6 cobram um prompt único suficientemente grande em uma faixa mais alta, o que estes cálculos não modelam. As tarifas vêm do catálogo da Kunavo ao vivo.

Agora compare a carga de trabalho C com as tarifas hospedadas da Zed para três desses modelos, usando os valores publicados acima. Claude Opus 5: $57.75 hospedado contra $36.75 nas tarifas do catálogo. GPT-5.6 Terra: $30.25 contra $7.70. Claude Sonnet 5: $23.10 contra $14.70 — uma diferença pequena, porque a Kunavo precifica esse modelo em paridade com a tarifa publicada pela Anthropic, enquanto a Zed acrescenta sua margem. A diferença não é uniforme em toda a prateleira, e uma página que dissesse o contrário estaria vendendo uma versão conveniente — observe que o catálogo atualmente lista Claude Opus 5 e Claude Sonnet 5 com a mesma tarifa, portanto essas duas linhas diferem apenas no que a Zed cobra por cada uma.

A leitura mais importante diz respeito ao limite, não à tarifa. Um mês hospedado de $57.75 é mais do que o dobro do teto total padrão de $20 de uma conta Pro, portanto essa carga de trabalho não custa apenas mais no caminho hospedado — ela é interrompida no meio até que você aumente o limite de gastos, e a página de cobrança da Zed diz que o limite de faturamento aumentado em resposta não é reduzido novamente durante a mesma assinatura. Dimensione tudo isso de acordo com suas próprias sessões antes de tratá-lo como orçamento. O valor do catálogo da Kunavo é um piso de cobrança, não um teto: quando o upstream informa sua cobrança, a fatura é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável, como explica o guia de cobrança. O recarregamento mínimo é de $10 em crédito pré-pago — um mínimo de financiamento, não uma tarifa de tarefa nem uma assinatura.

Qual rota vence e quando

Uma observação de solução de problemas que pertence à rota de gateway. A Zed 1.20.2, lançada em 17 de setembro de 2026, registra uma correção para "erros de pagamento de provedores de modelos que não são da Zed solicitando incorretamente que os usuários atualizassem para o Zed Pro em vez de exibir a mensagem de erro original do provedor" (zed.dev/releases). Se você estiver em uma versão anterior e um provedor personalizado retornar um erro de pagamento ou saldo, a Zed pode ter mostrado uma oferta do Zed Pro em vez da mensagem real. Atualize antes de concluir que sua chave está funcionando. A referência de erros da Kunavo explica o que o endpoint realmente retorna.

Escolhendo um modelo para o agente da Zed

A Zed lê um conjunto específico de flags de capacidade para provedores personalizados, e configurá-las incorretamente parece um problema do modelo quando na verdade é um problema de configuração. No caminho compatível com Anthropic, os padrões são tools: true, images: false, prompt_caching: false, além de extra_beta_headers opcional, um mode para raciocínio com um orçamento de tokens e default_temperature. No caminho compatível com OpenAI, eles são tools: true, images: false, parallel_tool_calls: false, prompt_cache_key: false, chat_completions: true, interleaved_reasoning: false, max_tokens_parameter: false, com reasoning_effort aceitando none, minimal, low, medium, high, xhigh ou max. Um modelo de agente precisa de tools ativado; qualquer modelo que você espere que leia uma captura de tela precisa ter images ativado explicitamente.

Em max_tokens, que a Zed usa como janela de contexto e exige: prefira um valor conservador, como 200000, em vez do máximo anunciado pelo modelo. As janelas de contexto publicadas pela Kunavo são valores dos fornecedores, e não medições por rota; portanto, um arquivo de configurações que declare uma janela de um milhão de tokens está afirmando algo que ninguém testou. Aumente esse valor depois de enviar uma solicitação grande com sucesso, não antes.

E o limite honesto para o "melhor modelo": nenhuma medição de taxa de conclusão foi realizada para esta página, e nem a Zed nem a Kunavo publicam um benchmark específico da Zed. O preço unitário classifica orçamentos, não resultados — um modelo mais barato que precisa de três tentativas para uma refatoração pode custar mais do que um que a conclui de primeira. Use a tabela acima para criar uma lista preliminar por custo por carga de trabalho, depois avalie em seu próprio repositório. A comparação de modelos de programação e otimização de custos explicam esse método com mais profundidade.

Configurando

A Kunavo publica uma referência de configuração preenchida para este cliente. Isso é uma verificação de documentação, não um teste de compatibilidade: nenhuma solicitação de uma Zed em execução para a Kunavo foi registrada, e todo comportamento descrito acima foi lido na própria documentação da Zed em 19 de setembro de 2026. Mantenha uma rota funcional disponível, execute uma tarefa limitada e depois leia a cobrança registrada pela sua conta — especialmente se você ativar prompt_caching. Comece pelo guia de integração da Zed e crie uma conta da Kunavo quando estiver pronto para financiar uma chave.

Ainda comparando editores em vez de provedores? Zed vs Cursor coloca os dois modelos de compra lado a lado, e o diretório de APIs de agentes mostra quais outros clientes aceitam um endpoint personalizado.

Perguntas frequentes

Cada valor da Zed, Anthropic, OpenAI e Google nesta página foi consultado na página indicada ao lado em 19 de setembro de 2026; as afirmações sobre o comportamento da Zed vêm da documentação e das notas de versão da Zed, não de um teste em tempo de execução da Kunavo dentro da Zed, que não foi realizado. As tarifas da Kunavo vêm do catálogo ao vivo, e todos os totais em dólares mostrados são cálculos ilustrativos de tokens baseados nas suposições declaradas.