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

Configurar

1. Instale o Aider. O Aider 0.86 suporta Python 3.10 a 3.12, e o seu próprio instalador, aider-install, configura uma versão compatível do Python. Nós usámos pip install aider-chat num ambiente virtual com Python 3.12.

python -m pip install aider-install
aider-install

2. Aponte-o para a API com duas variáveis de ambiente e coloque o prefixo openai/ em todos os modelos, incluindo o Claude. O modelo fraco escreve mensagens de commit e resumos, por isso um modelo barato chega.

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. Dê a conhecer os modelos ao Aider. Estes dois ficheiros na sua pasta pessoal corrigem o aviso, o formato de edição e a apresentação do custo (secção seguinte). 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 arranque com ela. Contém a sua chave, por isso 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 interpreta mal nos modelos novos

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

• Mostra um aviso em cada arranque: Unknown context window size and costs, using sane defaults, e pergunta se quer abrir a documentação. Basta uma entrada max_input_tokens no ficheiro de metadados para o evitar.
• Usa o formato de edição de ficheiro completo, pelo que o modelo devolve na íntegra cada ficheiro que altera. Isso custa mais tokens de saída em ficheiros grandes e é mais lento. edit_format: diff faz com que envie apenas blocos de procurar e substituir; ambos os modelos os aplicaram sem problemas no nosso teste. Se as edições de um modelo continuarem a falhar, volte a whole para esse modelo.
• Não mostra o custo. Com os preços no ficheiro de metadados, a linha de custo do Aider coincidiu com a nossa fatura: indicou $0.0036 numa edição com o Claude que a Zurelay faturou em $0.00357.

Claude: openai/ ou anthropic/?

O Aider também consegue chegar ao 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 conhecia o modelo dessa forma. Mas com --cache-prompts pagou para escrever a cache de prompts nas nossas duas execuções e nunca leu dela, a cerca de $0.0035 por edição. Através de openai/, a segunda edição leu 2,863 dos seus 3,682 tokens de prompt da cache sem qualquer configuração, e custou $0.0025. Usaríamos openai/ para todos os modelos.

Quanto custou no nosso teste

Edições a um pequeno ficheiro Python num repositório git novo, cada uma com commit feito pelo Aider. Cada edição são dois pedidos: a alteração no modelo principal e uma mensagem de commit do DeepSeek V4.1 Flash. A Zurelay faturou:

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

O que deve saber

• A linha de custo do Aider não conta os acertos de cache nos modelos openai/: indicou $0.0045 na edição que nos foi faturada em $0.0025. A sua página de utilização da Zurelay mostra o valor real.
• No Windows, o chat do Aider precisa de uma consola a sério. No Git Bash apresentou Can't initialize prompt toolkit: Found xterm-256color; use o PowerShell, a Linha de Comandos ou o Windows Terminal. As execuções pontuais com --message funcionam em qualquer lado.
• 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 testámos a pasta pessoal.

Preços dos modelos que pode combinar

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 em Python 3.12, no Windows, com 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 definições de modelo.