Use o Aider com uma API gratuita de LLM
O Aider é um programador em par de código aberto para o terminal. Ele edita arquivos no seu repositório git e faz commits. Este guia conecta o Aider a modelos gratuitos por meio do FreeLLMAPI. Ele também mostra as configurações do Aider que são importantes para modelos gratuitos: formato de edição, modelo fraco e tamanho do mapa do repositório.
O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.
Passo 1: instale o FreeLLMAPI
O FreeLLMAPI é um gateway de código aberto. Ele roda no seu computador em Docker. Ele reúne as camadas gratuitas de 45 provedores atrás de uma chave compatível com OpenAI.
Instale no macOS ou no Linux
curl -fsSL https://freellmapi.co/install.sh | bashAbra http://localhost:3001. Adicione pelo menos duas chaves gratuitas de provedores na página Keys. Copie a sua chave unificada na mesma página.
Passo 2: conecte o Aider
O comando de configuração grava ~/.aider.conf.yml. Antes, ele faz um backup do arquivo existente.
Um comando
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aiderO arquivo que o comando grava tem esta forma:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"O prefixo openai/ é obrigatório. Ele diz ao Aider para enviar o nome do modelo a uma API compatível com OpenAI. Para usar variáveis de ambiente e nenhum arquivo, faça o seguinte:
Somente variáveis de ambiente
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoO Aider procura .aider.conf.yml no seu diretório pessoal, depois na raiz do repositório git e, por fim, no diretório atual. O arquivo carregado por último tem prioridade. Assim, um arquivo de projeto pode mudar o modelo de um repositório.
Passo 3: escolha os modelos
O Aider envia os seus arquivos e um mapa do repositório em cada requisição. Ele não precisa de chamada de ferramentas para o seu loop principal de edição, porque lê as edições do texto do modelo. Uma janela de contexto grande e boa obediência às instruções são mais importantes. A tabela mostra os modelos gratuitos com pelo menos 128K de contexto hoje.
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Sim | Não |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 a mais | 1M | 40 req/min 40 RPM | Sim | Sim |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Sim | Sim |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Sim | Não |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Deepseek V4.1 Flash | APINex | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Não | Não |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/dia 50 req/day account-wide (1,000 after a $10 purchase) | Sim | Sim |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/dia Shared rate limit | Sim | Não |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Não | Não |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 a mais | 262K | 30 req/min 250 req/dia 70,000 tokens/min ~6M | Sim | Sim |
Mostrando 12 de 184 modelos gratuitos correspondentes. Ver todos os modelos.
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
Use openai/auto para deixar o roteador selecionar um modelo. Use openai/auto:smart para preferir os modelos com maior inteligência. Para fixar um modelo, use openai/ e um ID do catálogo de GET /v1/models.
Você também pode definir os modelos de uma sessão na linha de comando. Este exemplo usa os modelos mais fortes para edições. Ele usa modelos rápidos para mensagens de commit e resumos do histórico do chat:
Modelos para uma sessão
aider --model openai/auto:smart --weak-model openai/auto:fastPara um perfil planejado, crie uma cadeia de fallback no painel do FreeLLMAPI, por exemplo uma cadeia chamada coding. Depois, use --model openai/auto:coding. Um nome de perfil desconhecido retorna um erro 400, então a requisição não vai para outra cadeia sem aviso.
Configurações do Aider para modelos gratuitos
O Aider conhece as configurações de modelos bem conhecidos. Um modelo de gateway, como auto, não é conhecido, então defina esses valores por conta própria.
| Configuração | O que faz | Valor recomendado para modelos gratuitos |
|---|---|---|
edit-format | O formato que o modelo usa para enviar edições: whole, diff, diff-fenced ou udiff | diff para modelos fortes. whole para modelos fracos, porque é mais simples, mas envia mais tokens. |
weak-model | O modelo para mensagens de commit e resumos do histórico do chat | openai/auto:fast, para que tarefas pequenas não usem a cota do seu modelo forte |
map-tokens | O número de tokens do mapa do repositório. 0 o desativa. | 1024 ou menos em camadas gratuitas pequenas |
architect | Um modelo planeja a mudança e um modelo editor escreve as edições | Opcional. Ele dobra o número de requisições. |
~/.aider.conf.yml com configurações para modelos gratuitos
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024Para informar ao Aider a janela de contexto de um modelo de gateway, adicione um arquivo .aider.model.metadata.json. A chave é o nome completo do modelo. O Aider procura este arquivo nos mesmos lugares do arquivo de configuração.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Limites de taxa e failover
As camadas gratuitas têm limites por minuto e por dia. O FreeLLMAPI conta o uso de cada chave. Quando um provedor envia um erro 429, o roteador envia a requisição para o próximo modelo da sua cadeia. O Aider não vê o erro e continua.
- Adicione chaves de quatro ou mais provedores. Mais provedores dão mais requisições por dia.
- Adicione apenas os arquivos que você quer alterar, com
/add. Cada arquivo entra em cada requisição. - Use
/clearentre tarefas para enviar um histórico de chat mais curto. Um histórico curto também reduz os tokens por minuto. - Use
/droppara remover arquivos que você não precisa mais.
Solução de problemas
| Problema | Causa | Solução |
|---|---|---|
| "Modelo openai/auto: tamanho de janela de contexto e custos desconhecidos, usando padrões seguros." | O Aider não conhece o modelo do gateway | Este aviso geralmente é inofensivo. Para removê-lo, adicione .aider.model.metadata.json. |
| A edição não foi aplicada | O modelo não seguiu o formato de edição | Use --edit-format whole, ou um modelo mais forte |
401 "Invalid API key" | O Aider envia outra chave, por exemplo de outro arquivo de configuração | Confira os arquivos de configuração do diretório pessoal, da raiz do git e do diretório atual |
| O Aider chama api.openai.com | O prefixo openai/ é usado, mas a base URL não está definida | Defina openai-api-base ou OPENAI_API_BASE |
| "Todos os modelos com limite de taxa após N tentativas" | Todas as chaves atingiram o limite | Adicione chaves de mais provedores, ou reduza map-tokens |
Perguntas frequentes
Posso usar o Aider de graça?
Sim. O Aider é de código aberto. Aponte-o para o FreeLLMAPI com openai-api-base e o prefixo de modelo openai/. O gateway usa camadas gratuitas de provedores, então a inferência custa US$ 0.
Como uso o Aider com uma API compatível com OpenAI?
Defina OPENAI_API_BASE e OPENAI_API_KEY e, depois, execute aider --model openai/
Qual formato de edição devo usar com modelos gratuitos?
Use diff para modelos fortes, porque ele envia menos tokens. Se as edições falharem ao ser aplicadas, use whole. Ele é mais simples para modelos fracos, mas envia o arquivo inteiro a cada vez.
O que significa 'Unknown context window size and costs, using sane defaults'?
O Aider não conhece o nome do modelo, então usa valores padrão. O aviso geralmente é inofensivo. Adicione .aider.model.metadata.json com a janela de contexto para removê-lo.
Qual modelo gratuito é o melhor para o Aider?
Use um modelo com janela de contexto grande e boa obediência às instruções. A tabela desta página mostra os modelos gratuitos mais fortes com 128K ou mais de contexto hoje.
Guias relacionados
- Use o OpenCode com uma API LLM gratuita
- Use o Codex CLI com modelos gratuitos
- Melhores APIs gratuitas de modelos para código
- URLs base de APIs gratuitas compatíveis com OpenAI
- API LLM gratuita com contexto de 1 milhão de tokens
Fontes
- Aider docs: OpenAI-compatible APIs (verificado em 20 November 2026)
- Aider docs: YAML config file (verificado em 20 November 2026)
- Aider docs: options reference (verificado em 20 November 2026)
- Aider docs: edit formats (verificado em 20 November 2026)
- Aider docs: model warnings (verificado em 20 November 2026)
- Aider docs: advanced model settings (verificado em 20 November 2026)
- FreeLLMAPI CLI generators (verificado em 20 November 2026)