Source: https://aiprimetech.io/pt/learn/use-claude-api-with-zed/

[Início](/pt/) / [Aprenda](/pt/learn/) / Conecte Zed ao Claude pelo gateway 

# Conecte o Zed ao Claude por meio do gateway 

Zed é rápido e seu assistente é realmente útil, mas a forma de configurar um endpoint personalizado do Claude não está onde a maioria das pessoas procura primeiro. O provedor nativo da Anthropic não permite substituir a URL base, então o caminho mais direto para o gateway passa pelo bloco openai_compatible do Zed. 

## Por que não usar o provedor Anthropic 

Zed inclui um provedor nativo da Anthropic, e o impulso natural é apontá-lo para o gateway. O problema é que esse provedor não tem uma configuração api_url, portanto não há um campo compatível que permita redirecioná-lo para fora do host padrão da Anthropic. 

Essa única limitação explica por que tantas pessoas ficam sem conseguir avançar. Em vez de tentar contorná-la à força, encaminhe o Claude pelo mecanismo genérico openai_compatible, que disponibiliza a URL base e foi criado justamente para endpoints de terceiros. 

Ajuda pensar no provedor nativo como fixo em um único destino e no provedor openai_compatible como a opção configurável. Para um gateway multimodelo, o caminho configurável já é o mais adequado, pois o mesmo bloco pode dar acesso ao Claude e a qualquer outro modelo disponibilizado pelo gateway por meio de uma única api_url. Isso mantém toda a configuração de modelos do editor em um só lugar, em vez de dividi-la entre dois mecanismos de provedor com regras diferentes. Essa decisão orienta o restante da configuração, então vale a pena entendê-la antes de editar qualquer coisa. Depois que você entende que o bloco openai_compatible é o caminho compatível, basta preencher os campos. 

## Adicione um bloco openai_compatible 

Em settings.json, dentro de language_models.openai_compatible, adicione um provedor com nome. Defina sua api_url como o endereço do gateway com /v1 no final; Zed usa /chat/completions abaixo desse caminho, de modo que a interface compatível com OpenAI do gateway responde às solicitações. 

O nome escolhido é livre e se torna o rótulo no menu de modelos do Zed. Um único bloco pode disponibilizar vários modelos Claude, cada um declarado na próxima etapa. 

O sufixo /v1 é essencial aqui: Zed monta o caminho de chat completions diretamente abaixo do valor fornecido em api_url, então a ausência de /v1 envia as solicitações para o lugar errado, e uma barra no final pode duplicar o caminho. Defina exatamente o host seguido de /v1 para que o roteamento funcione corretamente. Recarregar rapidamente as configurações após a edição confirma que Zed interpretou o bloco sem erros. Se o provedor não aparecer, a primeira coisa a verificar é um erro de sintaxe JSON no bloco. 

## Declare available_models 

Zed não descobre modelos automaticamente em um endpoint personalizado, então liste-os manualmente em available_models. Cada entrada precisa de um name que corresponda ao ID do gateway, um display_name para o menu e um valor max_tokens adequado ao modelo. 

Use claude-sonnet-4-5 para assistência de rotina e adicione claude-opus-4-8 como segunda entrada para as tarefas mais difíceis. Como você os lista explicitamente, o menu mostra exatamente o conjunto desejado, sem outros modelos. 

O campo name deve corresponder ao ID do gateway caractere por caractere, enquanto display_name é apenas visual e pode ter o texto que você preferir no menu. Um name incorreto costuma ser a causa de um modelo que aparece, mas retorna um erro ao ser usado, então copie o ID diretamente do gateway em vez de digitá-lo de memória. Listar apenas os modelos que você realmente usa mantém o menu curto e torna a escolha óbvia no trabalho diário. Adicionar um modelo depois exige editar apenas uma linha, portanto não é necessário declarar tudo de antemão. 

## Onde a chave fica 

A chave de API não fica em settings.json. Zed a armazena no gerenciador de credenciais do sistema operacional ou a lê de uma variável de ambiente cujo nome corresponde ao provedor, como AIPRIME_API_KEY, mantendo o segredo fora da configuração sincronizada. 

Depois de salvar, abra o assistente, escolha seu provedor no menu e informe a chave quando solicitado. A partir daí, Zed usa o gerenciador de credenciais para autenticação, e seu arquivo de configurações permanece sem credenciais. 

Essa separação é realmente útil se você sincroniza as configurações do Zed entre máquinas ou as versiona em um repositório de dotfiles: a configuração pode circular livremente porque não contém nenhum segredo, e cada máquina fornece sua própria chave pelo gerenciador de credenciais ou pelo ambiente. É uma abordagem mais organizada do que a de ferramentas que incorporam a chave ao arquivo de configuração. É também por isso que compartilhar uma configuração do Zed com um colega é seguro — ele usa a própria chave, e a sua nunca é compartilhada. O mesmo vale para incluir as configurações em um repositório de dotfiles. 

## O caminho nativo via ACP 

Se você quer especificamente o comportamento nativo da Anthropic em vez da interface compatível com OpenAI, Zed oferece suporte ao Agent Client Protocol com Claude Code. Você executa Claude Code como agente, e Zed se comunica com ele por ACP. 

Nessa configuração, Claude Code usa seu próprio ANTHROPIC_BASE_URL apontado para o gateway, então Zed nunca precisa de uma api_url da Anthropic própria. É a forma mais direta de obter o verdadeiro comportamento nativo de Messages dentro do editor. 

A contrapartida é que ACP oferece o ciclo completo de agente do Claude Code em vez do assistente integrado mais leve do Zed, proporcionando mais recursos, mas também uma experiência mais pesada. Escolha o caminho openai_compatible para ajuda rápida diretamente no código e o caminho ACP quando quiser um agente completo conduzindo edições em várias etapas de dentro do editor. A maioria das pessoas começa pelo caminho mais leve e só adota ACP quando quer um agente completo no editor. Você pode manter ambos disponíveis e usar o que a tarefa exigir. 

Copiar

```
// Zed settings.json
{
  "language_models": {
    "openai_compatible": {
      "aiprime": {
        "api_url": "https://aiprimetech.io/v1",
        "available_models": [
          { "name": "claude-sonnet-4-5",
            "display_name": "Claude Sonnet",
            "max_tokens": 200000 }
        ]
      }
    }
  }
}
// Key goes in the keychain / AIPRIME_API_KEY env var, NOT this file.
```

## Perguntas frequentes 

 Por que não consigo definir uma URL base do Claude no Zed?

O provedor nativo da Anthropic no Zed não tem um campo api_url. Use o bloco openai_compatible, que disponibiliza api_url, e aponte-o para https://aiprimetech.io/v1. Onde coloco api_url?

Em language_models.openai_compatible.<name>.api_url, com /v1 no final. Zed usa /chat/completions abaixo desse caminho. Onde fica a chave de API?

Ela não fica em settings.json — Zed a mantém no gerenciador de credenciais do sistema operacional ou em uma variável de ambiente cujo nome corresponde ao provedor, como AIPRIME_API_KEY. Como obtenho o comportamento nativo da Anthropic?

Use ACP com Claude Code como agente; Claude Code usa ANTHROPIC_BASE_URL para acessar o gateway, então Zed não precisa de uma api_url da Anthropic.  

Comece a usar o Claude em minutos

Obtenha uma chave de API — sem precisar de conta na Anthropic nem de lista de espera.[Obtenha sua chave de API](/register) 

AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários.    

## Mais guias da API do Claude

[Como obter uma chave de API do Claude](/pt/learn/how-to-get-a-claude-api-key/)[Preços da API Claude explicados](/pt/learn/claude-api-pricing-explained/)[A maneira mais barata de usar a API do Claude](/pt/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado com a API do Claude](/learn/use-claude-api-with-cursor/)[Acesso ilimitado ao Claude Code](/pt/learn/use-claude-api-with-claude-code/)[Gateway da API do Claude vs. acesso direto à Anthropic](/pt/learn/claude-api-vs-anthropic-direct/)[Como usar Claude por meio de uma API compatível com OpenAI](/pt/learn/openai-compatible-claude-api/)[Modelos Claude explicados: uma comparação entre Claude Opus, Sonnet, Haiku e Fable — todos os modelos da API Claude, nomes e preços dos modelos Anthropic (2026)](/pt/learn/claude-api-models-compared/)[Pagamento da API do Claude com criptomoedas](/pt/learn/claude-api-with-crypto-payment/)[Acesso à API do Claude sem lista de espera](/pt/learn/claude-api-without-waitlist/)[Como reduzir o uso de tokens do Claude](/pt/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado com a API do Claude](/pt/learn/use-claude-api-with-cline/)[Roo Code ilimitado com a API do Claude](/pt/learn/use-claude-api-with-roo-code/)[Claude ilimitado nas IDEs da JetBrains](/pt/learn/use-claude-api-with-jetbrains/)[Aider ilimitado com a API do Claude](/pt/learn/use-claude-api-with-aider/)[Claude ilimitado no VS Code](/pt/learn/use-claude-api-with-vscode/)[Configuração do OpenCode para Claude: configuração do opencode.json, modelos e erros comuns](/pt/learn/use-claude-api-with-opencode/)[Como executar um agente Hermes ilimitado no Claude](/pt/learn/run-hermes-agent-with-claude-api/)[Executando OpenClaw ilimitado com Claude](/pt/learn/run-openclaw-with-claude-api/)[O que significa uma API compatível com a Anthropic](/pt/learn/anthropic-compatible-api/)[Chave de API do Claude Code — ANTHROPIC_API_KEY: como obtê-la, configurá-la e quando usar claude setup-token em seu lugar](/pt/learn/claude-code-api-key-setup/)[Custos da API do Claude Code — Preços e como reduzi-los](/pt/learn/claude-code-api-costs/)[Erros da API Claude explicados: erro de servidor 500, sobrecarga 529, limite de requisições 429, requisição inválida 400 — e a correção para cada um](/pt/learn/claude-api-errors-troubleshooting/)[Como comprar créditos da API do Claude — e por que um crédito do Claude é melhor do que qualquer oferta de "comprar conta do Claude"](/pt/learn/buy-claude-api-credits/)[API Claude gratuita: existe uma chave de API Claude gratuita e o que realmente é gratuito em 2026?](/pt/learn/claude-api-free-trial/)[API do Claude vs assinatura Claude Pro/Max — Qual escolher](/pt/learn/claude-api-vs-subscription/)[Como executar a CLI do Codex no Claude](/pt/learn/use-claude-api-with-codex/)[Conectando Claude ao n8n](/pt/learn/use-claude-api-with-n8n/)[Roteando LiteLLM para Claude](/pt/learn/use-claude-api-with-litellm/)[Usando Claude no Kilo Code](/pt/learn/use-claude-api-with-kilo-code/)[Integre Claude ao GitHub Copilot](/pt/learn/use-claude-api-with-github-copilot/)[Conecte o Cherry Studio ao Claude](/pt/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic no LangChain: importação, base_url, streaming, ferramentas e erros](/pt/learn/use-claude-api-with-langchain/)[SDK de Python da Anthropic: instale, defina base_url, use streaming e trate erros](/pt/learn/anthropic-python-sdk/)[Claude com o Vercel AI SDK: baseURL de createAnthropic, streaming e correções](/pt/learn/use-claude-api-with-vercel-ai-sdk/)[Execute o Factory Droid com o Claude](/pt/learn/use-claude-api-with-factory-droid/)[A API do Claude Code, explicada](/pt/learn/claude-code-api/)[Como integrar a API do Claude à sua aplicação](/pt/learn/claude-api-integration/)[Como obter uso ilimitado do Claude — e por que não existe "Claude Code crackeado"](/pt/learn/get-unlimited-claude-usage/)