Source: https://aiprimetech.io/pt/learn/use-claude-api-with-aider/ [Início](/pt/) / [Aprenda](/pt/learn/) / Aider com Claude por meio de um gateway: ANTHROPIC_API_BASE, arquivos de configuração, modo arquiteto e correções # Aider com Claude por meio de um gateway: ANTHROPIC_API_BASE, arquivos de configuração, modo arquiteto e correções O Aider envia todas as chamadas de modelo por meio do LiteLLM, portanto apontá-lo para um gateway é uma configuração do LiteLLM, e não do Aider. Para o Claude, isso significa ANTHROPIC_API_BASE definido como a raiz do host do gateway e um nome de modelo com o prefixo anthropic/ . Duas configurações menos óbvias são igualmente importantes: IDs mais recentes do Claude precisam de uma entrada de configurações do modelo, ou o Aider passa a usar edições de arquivos inteiros sem um mapa do repositório. ## Instalar o Aider macOS / LinuxCopiar ``` python -m pip install aider-install aider-install # or the one-line installer (installs Python 3.12 if needed) curl -LsSf https://aider.chat/install.sh | sh ``` WindowsCopiar ``` powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex" ``` Se o comando aider não for encontrado depois, o que é comum no Windows, python -m aider executa o mesmo programa. ## Conectar ao Claude por meio do gateway terminalCopiar ``` export ANTHROPIC_API_KEY=your_gateway_key export ANTHROPIC_API_BASE=https://aiprimetech.io aider --model anthropic/claude-sonnet-5 ``` WindowsCopiar ``` setx ANTHROPIC_API_KEY your_gateway_key setx ANTHROPIC_API_BASE https://aiprimetech.io # open a new terminal, then: aider --model anthropic/claude-sonnet-5 ``` Use a raiz do host: sem /v1 e sem barra no final. O LiteLLM acrescenta /v1/messages automaticamente, portanto https://aiprimetech.io/v1 torna-se /v1/v1/messages e retorna 404, e uma barra no final produz uma barra dupla no caminho. A documentação do próprio Aider não aborda uma URL base personalizada da Anthropic. A variável é lida pelo LiteLLM, que verifica ANTHROPIC_API_BASE primeiro e depois ANTHROPIC_BASE_URL, a variável usada pelo Claude Code. Ambas funcionam; se as duas estiverem definidas, ANTHROPIC_API_BASE tem prioridade. Mantenha o prefixo anthropic/ no nome do modelo. Sem um prefixo de provedor, o LiteLLM não sabe para onde enviar um nome desconhecido e falha com LLM Provider NOT provided. ## Colocar as configurações em arquivos de configuração O Aider lê .aider.conf.yml e .env do seu diretório pessoal, da raiz do repositório git e do diretório atual, nessa ordem, dando prioridade aos arquivos lidos por último. Um arquivo no diretório pessoal vale para todos os projetos. ~/.aider.conf.ymlCopiar ``` model: anthropic/claude-sonnet-5 weak-model: anthropic/claude-haiku-4-5 set-env: - ANTHROPIC_API_BASE=https://aiprimetech.io model-settings-file: ~/.aider.model.settings.yml model-metadata-file: ~/.aider.model.metadata.json ``` ~/.envCopiar ``` ANTHROPIC_API_KEY=your_gateway_key ``` weak-model cuida das mensagens de commit e dos resumos do histórico de chat, portanto usar um modelo barato nessa função economiza dinheiro em cada sessão. set-env copia a variável para o ambiente antes de qualquer chamada de modelo, o que mantém a URL base fora do seu perfil de shell. ## Manter as edições por diff e o mapa do repositório nos modelos mais recentes O Aider escolhe seu formato de edição pelo nome do modelo. Os nomes que ele reconhece, incluindo os que contêm sonnet-4-, opus-4- ou haiku-4-, recebem edições diff e o mapa do repositório. Um nome que ele não reconhece, como claude-sonnet-5, faz com que ele passe a reescrever arquivos inteiros e deixe de usar o mapa do repositório. Isso torna as edições mais lentas e mais caras. Uma entrada de configurações restaura o comportamento correto: ~/.aider.model.settings.ymlCopiar ``` - name: anthropic/claude-sonnet-5 edit_format: diff use_repo_map: true weak_model_name: anthropic/claude-haiku-4-5 - name: anthropic/claude-opus-5-5 edit_format: diff use_repo_map: true weak_model_name: anthropic/claude-haiku-4-5 editor_model_name: anthropic/claude-sonnet-5 editor_edit_format: editor-diff ``` Modelos desconhecidos também geram um aviso: Unknown context window size and costs, using sane defaults. Ele é inofensivo, mas o Aider então presume uma janela ilimitada e um preço zero. O arquivo de metadados fornece os valores reais: ~/.aider.model.metadata.jsonCopiar ``` { "anthropic/claude-sonnet-5": { "max_tokens": 64000, "max_input_tokens": 200000, "max_output_tokens": 64000, "input_cost_per_token": 0.000002, "output_cost_per_token": 0.00001, "litellm_provider": "anthropic", "mode": "chat" }, "anthropic/claude-opus-5-5": { "max_tokens": 64000, "max_input_tokens": 200000, "max_output_tokens": 64000, "input_cost_per_token": 0.000004, "output_cost_per_token": 0.00002, "litellm_provider": "anthropic", "mode": "chat" } } ``` Os preços são os preços de tabela da Anthropic por token, portanto o indicador de custo do Aider mostra o custo de tabela; o gateway cobra menos do que isso. Um limite de entrada de 200K é um teto de trabalho seguro, mesmo quando um modelo aceita mais. ## Modo arquiteto: planeje com um modelo, edite com outro terminalCopiar ``` aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5 ``` No modo arquiteto, o modelo principal propõe a alteração e o modelo editor a transforma em edições nos arquivos. Usar um modelo mais potente para planejar e outro mais barato para editar geralmente custa menos do que usar o modelo potente para ambas as tarefas. Dentro de uma sessão, /architect alterna para ele por uma mensagem e /chat-mode architect alterna para ele pelo restante da sessão. ## A rota compatível com OpenAI O gateway também aceita o formato Chat Completions da OpenAI, que é a rota para modelos GPT na mesma conta. Nessa rota, a URL base inclui /v1, e o nome do modelo recebe o openai/ prefixo: terminalCopiar ``` export OPENAI_API_KEY=your_gateway_key export OPENAI_API_BASE=https://aiprimetech.io/v1 aider --model openai/claude-sonnet-5 ``` Para Claude, prefira a rota nativa acima: os metadados do modelo e o cache de prompts ficam alinhados com o formato da Anthropic. Se uma variável OPENAI_BASE_URL estiver definida indevidamente no seu ambiente, o LiteLLM a usará de preferência a OPENAI_API_BASE. ## Modelos | ID do modelo | Use para | claude-sonnet-5 | Padrão para programação e trabalho com agentes: rápido, eficiente e de preço intermediário. | claude-opus-5-5 | Raciocínio mais complexo, grandes refatorações e execuções longas de agentes. | claude-fable-5-1 | O mais capaz e mais caro; reserve-o para as tarefas mais difíceis. | claude-haiku-4-5 | Barato e rápido: títulos, resumos, classificação e pequenas etapas. Os aliases curtos do Aider (sonnet, opus, haiku) apontam para IDs de modelos mais antigos, portanto informe o nome do modelo explicitamente. IDs antigos com data, como claude-3-5-sonnet-20241022 não são disponibilizados. ## Solução de problemas | O que você vê | Causa | Correção | 404 / NotFoundError | /v1 em ANTHROPIC_API_BASE, portanto o caminho se torna /v1/v1/messages | Defina a raiz do host, https://aiprimetech.io, sem barra no final | LLM Provider NOT provided | Nome do modelo sem um prefixo de provedor | Use anthropic/claude-sonnet-5 | AuthenticationError: não foi possível autenticar você | Chave ausente no shell em que o Aider é executado, ou uma chave de outro endpoint | echo $ANTHROPIC_API_KEY; no Windows, abra um novo terminal após setx | Reescritas de arquivos inteiros, sem mapa do repositório | O Aider não reconhece o nome do modelo | Adicione a .aider.model.settings.yml entrada acima | Unknown context window size and costs | Sem metadados para o modelo | Adicione o arquivo de metadados ou ignore o aviso | Erros de limite de tokens | Arquivos demais ou muito grandes no chat | /tokens para ver o uso, /drop arquivos, /clear histórico | RateLimitError | Limite de simultaneidade ou de requisições atingido | O Aider tenta novamente com intervalos progressivos; evite executar várias sessões com a mesma chave | Modelo não compatível | Um ID de modelo antigo ou digitado incorretamente | Use um ID da tabela acima Para erros que vêm do modelo, e não do Aider, consulte [guia de erros da API do Claude](/pt/learn/claude-api-errors-troubleshooting/). ## Perguntas frequentes Como uso o Aider com uma URL base personalizada da Anthropic? Defina ANTHROPIC_API_BASE como a raiz do host do gateway, por exemplo, https://aiprimetech.io, sem /v1 e sem barra no final, defina ANTHROPIC_API_KEY e execute aider --model anthropic/claude-sonnet-5. O LiteLLM acrescenta /v1/messages. O Aider lê ANTHROPIC_BASE_URL? Sim, por meio do LiteLLM, como alternativa. O LiteLLM verifica ANTHROPIC_API_BASE primeiro e depois ANTHROPIC_BASE_URL. Por que o Aider reescreve arquivos inteiros com um novo modelo Claude? O Aider não reconhece o nome do modelo e recorre ao formato de edição whole, sem mapa do repositório. Adicione uma entrada com edit_format: diff e use_repo_map: true ao arquivo .aider.model.settings.yml. O Aider pode usar um endpoint compatível com OpenAI? Sim: defina OPENAI_API_BASE como o endpoint incluindo /v1 e defina OPENAI_API_KEY, depois use o prefixo openai/, por exemplo, aider --model openai/claude-sonnet-5. 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/)[Use Claude com o SDK da OpenAI: endpoint compatível com OpenAI, streaming, ferramentas e limites](/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/)[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/)[Hermes Agent com Claude por meio de um gateway: configuração de provedor personalizado, controles de custos e correções](/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/)[Codex CLI com um provedor personalizado: config.toml, modelos GPT e Claude, extensão para IDE e correções](/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/)[GitHub Copilot Chat com Claude por meio de um gateway: configuração de Custom Endpoint, modo agente e correções](/pt/learn/use-claude-api-with-github-copilot/)[Conecte o Zed ao Claude por meio do gateway](/pt/learn/use-claude-api-with-zed/)[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/)