Início / Guias / Use o Aider com uma API gratuita de LLM

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

Abra 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>
aider

O 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/auto

O 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.

Modelos gratuitos para o Aider: contexto de 128K+, por inteligência
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3APINex, UnoRouter1M5 req/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
SimNão
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 a mais1M40 req/min
40 RPM
SimSim
Gemini 3.8 FlashAPINex, Google AI Studio1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
SimSim
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceSimNão
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSimSim
Deepseek V4.1 FlashAPINex1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NãoNão
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSimSim
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimSim
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/dia
Shared rate limit
SimNão
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetNãoNão
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 a mais262K30 req/min
250 req/dia
70,000 tokens/min
~6M
SimSim

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

Para 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çãoO que fazValor recomendado para modelos gratuitos
edit-formatO formato que o modelo usa para enviar edições: whole, diff, diff-fenced ou udiffdiff para modelos fortes. whole para modelos fracos, porque é mais simples, mas envia mais tokens.
weak-modelO modelo para mensagens de commit e resumos do histórico do chatopenai/auto:fast, para que tarefas pequenas não usem a cota do seu modelo forte
map-tokensO número de tokens do mapa do repositório. 0 o desativa.1024 ou menos em camadas gratuitas pequenas
architectUm modelo planeja a mudança e um modelo editor escreve as ediçõesOpcional. 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: 1024

Para 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 /clear entre tarefas para enviar um histórico de chat mais curto. Um histórico curto também reduz os tokens por minuto.
  • Use /drop para remover arquivos que você não precisa mais.

Solução de problemas

ProblemaCausaSolução
"Modelo openai/auto: tamanho de janela de contexto e custos desconhecidos, usando padrões seguros."O Aider não conhece o modelo do gatewayEste aviso geralmente é inofensivo. Para removê-lo, adicione .aider.model.metadata.json.
A edição não foi aplicadaO modelo não seguiu o formato de ediçãoUse --edit-format whole, ou um modelo mais forte
401 "Invalid API key"O Aider envia outra chave, por exemplo de outro arquivo de configuraçãoConfira os arquivos de configuração do diretório pessoal, da raiz do git e do diretório atual
O Aider chama api.openai.comO prefixo openai/ é usado, mas a base URL não está definidaDefina openai-api-base ou OPENAI_API_BASE
"Todos os modelos com limite de taxa após N tentativas"Todas as chaves atingiram o limiteAdicione chaves de mais provedores, ou reduza map-tokens
Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produção.

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/. O prefixo openai/ é obrigatório. Você pode colocar os mesmos valores em .aider.conf.yml.

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

Fontes

Todos os guias · Ver todos os modelos gratuitos