Aider com uma API compatível com OpenAI mais barata (UberLLM)
Defina OPENAI_API_BASE=https://api.uberllm.dev/v1 e OPENAI_API_KEY para sua chave UberLLM, depois execute aider --model openai/<UberLLM model id>. Adicione um .aider.model.settings.yml para que o Aider edite com diffs e use seu repo map.
Passos
- Crie uma chave na sua página de chaves e adicione crédito.
- Defina duas variáveis:
export OPENAI_API_BASE=https://api.uberllm.dev/v1
export OPENAI_API_KEY=ull_your_key
Windows: setx OPENAI_API_BASE https://api.uberllm.dev/v1 e setx OPENAI_API_KEY ull_your_key, depois abra um novo terminal.
- Execute o Aider com
openai/na frente do ID do UberLLM:
aider --model openai/moonshotai/kimi-k3 --weak-model openai/deepseek/deepseek-v4.1-flash
openai/ informa ao Aider para usar a rota compatível com OpenAI. Apenas essa primeira parte é removida, então o ID que chega ao UberLLM é moonshotai/kimi-k3.
Faça as edições funcionarem corretamente (importante)
Aider escolhe as configurações de edição pelo nome do modelo. Para um modelo que não conhece, ele volta a reescrever arquivos inteiros e desativa o mapa do repositório: mais lento, mais tokens, resultados piores. Informe as configurações corretas em .aider.model.settings.yml (na sua pasta inicial ou na raiz do repositório):
- name: openai/moonshotai/kimi-k3
edit_format: diff
use_repo_map: true
name deve ser exatamente o que você passa para --model.
Silenciar o aviso de "janela de contexto desconhecida"
Aider avisa que não sabe o tamanho e o preço do modelo. Dê a ele os números em .aider.model.metadata.json, usando a página do modelo em uberllm.dev/models:
{
"openai/moonshotai/kimi-k3": {
"max_input_tokens": 200000,
"max_output_tokens": 32000,
"input_cost_per_token": 0.000001,
"output_cost_per_token": 0.000004,
"litellm_provider": "openai",
"mode": "chat"
}
}
Os números são um exemplo: copie o comprimento de contexto real e divida os preços por-1M na tabela abaixo por 1,000,000. Aider então mostra um custo próximo ao que você paga. Ou apenas desligue o aviso com show-model-warnings: false.
Mantenha-o em um arquivo de configuração
.aider.conf.yml na sua pasta home ou repositório:
openai-api-base: https://api.uberllm.dev/v1
openai-api-key: ull_your_key
model: openai/moonshotai/kimi-k3
weak-model: openai/deepseek/deepseek-v4.1-flash
Não faça commit de um arquivo que contenha sua chave.
Solução de Problemas
- "Tamanho da janela de contexto e custos desconhecidos": inofensivo; adicione o arquivo de metadados acima.
- Aider reescreve arquivos inteiros: o arquivo de configurações está faltando ou seu
namenão corresponde a--model. - Modelo 404 não encontrado: o prefixo
openai/está faltando, ou o ID depois dele está errado. - Variáveis ignoradas no Windows:
setxse aplica apenas a novos terminais. - 402 créditos insuficientes: adicione crédito na página de créditos.