Aider com DeepSeek, Claude ou qualquer modelo compatível com OpenAI

Como configurar

1. Instale o Aider. O Aider 0.86 é compatível com Python 3.10 a 3.12, e o instalador próprio dele, aider-install, configura uma versão compatível do Python para você. Nós usamos pip install aider-chat em um ambiente virtual com Python 3.12.

python -m pip install aider-install
aider-install

2. Aponte para a API com duas variáveis de ambiente e coloque o prefixo openai/ em todos os modelos, inclusive no Claude. O modelo fraco escreve mensagens de commit e resumos, então um modelo barato basta.

export OPENAI_API_BASE="https://api.zurelay.com/v1"
export OPENAI_API_KEY="zr_live_..."
aider --model openai/claude-sonnet-5-5 --weak-model openai/deepseek-v4.1-flash
# or all on DeepSeek
aider --model openai/deepseek-v4.1-flash --weak-model openai/deepseek-v4.1-flash

3. Conte ao Aider sobre os modelos. Estes dois arquivos na sua pasta pessoal corrigem o aviso, o formato de edição e a exibição de custo (próxima seção). Os preços são os atuais da Zurelay, por token.

{
  "openai/deepseek-v4.1-flash": {
    "max_input_tokens": 1000000,
    "input_cost_per_token": 0.00000003,
    "output_cost_per_token": 0.00000012,
    "cache_read_input_token_cost": 0.00000000074,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "openai/claude-sonnet-5-5": {
    "max_input_tokens": 1000000,
    "input_cost_per_token": 0.00000079,
    "output_cost_per_token": 0.00000395,
    "cache_read_input_token_cost": 0.000000079,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

- name: openai/deepseek-v4.1-flash
  edit_format: diff
  use_repo_map: true
- name: openai/claude-sonnet-5-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: openai/deepseek-v4.1-flash

4. Guarde a configuração em ~/.aider.conf.yml, para que um aider simples já comece com ela. O arquivo contém sua chave, então mantenha-o fora do git.

model: openai/claude-sonnet-5-5
weak-model: openai/deepseek-v4.1-flash
openai-api-base: https://api.zurelay.com/v1
openai-api-key: zr_live_...

O que o Aider erra com modelos novos

O Aider procura um modelo pelo nome completo e, na versão 0.86.2, não reconhecia nem openai/claude-sonnet-5-5 nem openai/deepseek-v4.1-flash. Sem os arquivos acima:

• Ele avisa a cada inicialização: Unknown context window size and costs, using sane defaults, e depois pergunta se você quer abrir a documentação. Uma entrada max_input_tokens no arquivo de metadados basta para acabar com isso.
• Ele usa o formato de edição de arquivo inteiro, então o modelo devolve na íntegra cada arquivo que altera. Isso custa mais tokens de saída em arquivos grandes e é mais lento. edit_format: diff faz com que ele envie só blocos de busca e substituição; os dois modelos aplicaram esses blocos sem problemas no nosso teste. Se as edições de um modelo continuarem falhando, volte para whole nesse modelo.
• Ele não mostra o custo. Com os preços no arquivo de metadados, a linha de custo do Aider bateu com a nossa fatura: ela indicou $0.0036 para uma edição com Claude que a Zurelay cobrou como $0.00357.

Claude: openai/ ou anthropic/?

O Aider também consegue acessar o Claude pelo formato da Anthropic: --model anthropic/claude-sonnet-5-5 com ANTHROPIC_API_BASE=https://api.zurelay.com (sem /v1) e ANTHROPIC_API_KEY definido com a mesma chave. Funcionou, e o Aider reconheceu o modelo dessa forma. Mas com --cache-prompts ele pagou para gravar o cache de prompt nas duas execuções e nunca leu dele, a cerca de $0.0035 por edição. Com openai/, a segunda edição leu 2,863 dos 3,682 tokens do prompt do cache, sem nenhuma configuração, e custou $0.0025. Nós usaríamos openai/ para todos os modelos.

Quanto custou no nosso teste

Edições em um pequeno arquivo Python em um repositório git novo, cada uma com commit feito pelo Aider. Cada edição são duas requisições: a mudança no modelo principal e uma mensagem de commit do DeepSeek V4.1 Flash. A Zurelay cobrou:

O prompt do próprio Aider é pequeno, de cerca de 2,800 a 3,700 tokens com o mapa do repositório, então um dia de edições com DeepSeek custa centavos. As duas edições feitas com anthropic/ não estão na tabela.

O que você precisa saber

• A linha de custo do Aider não conta os acertos de cache nos modelos openai/: ela indicou $0.0045 para a edição que nos foi cobrada a $0.0025. A página de uso da Zurelay mostra o valor real.
• No Windows, o chat do Aider precisa de um console de verdade. No Git Bash ele exibiu Can't initialize prompt toolkit: Found xterm-256color; use PowerShell, Prompt de Comando ou Windows Terminal. Execuções únicas com --message funcionam em qualquer lugar.
• O Aider lê .aider.conf.yml, .aider.model.settings.yml e .aider.model.metadata.json da sua pasta pessoal, da raiz do seu repositório git e da pasta atual. Nós testamos a pasta pessoal.

Preços dos modelos que você usaria em conjunto

Por 1M tokens, o preço de tabela do laboratório e o da Zurelay:

Testado em 3 de novembro de 2026 com o Aider 0.86.2 no Python 3.12, no Windows, usando a API da Zurelay. A configuração resumida está em Aider na documentação. Documentação do próprio Aider: APIs compatíveis com OpenAI e configurações de modelo.