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

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

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

export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_BASE=https://aiprimetech.io

aider --model anthropic/claude-sonnet-5

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

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.

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

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:

- 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:

{
  "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

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:

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

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

Para erros que vêm do modelo, e não do Aider, consulte guia de erros da API do Claude.

Perguntas frequentes

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.