Aider gebruiken met een gratis LLM-API
Aider is een open-source pair programmer voor de terminal. Het bewerkt bestanden in je git-repository en maakt commits. Deze gids verbindt Aider met gratis modellen via FreeLLMAPI. Het toont ook de Aider-instellingen die belangrijk zijn voor gratis modellen: bewerkingsformaat, zwak model en grootte van de repomap.
Code, modelnamen en labels uit de live catalogus worden in het Engels getoond.
Stap 1: FreeLLMAPI installeren
FreeLLMAPI is een open-source gateway. Het draait op je computer in Docker. Het bundelt de gratis tiers van 45 providers achter één OpenAI-compatibele sleutel.
Installeren op macOS of Linux
curl -fsSL https://freellmapi.co/install.sh | bashOpen http://localhost:3001. Voeg op de pagina Keys minstens twee gratis providersleutels toe. Kopieer daarna je uniforme sleutel van dezelfde pagina.
Stap 2: Aider verbinden
Het setupcommando schrijft ~/.aider.conf.yml. Het maakt eerst een back-up van het bestaande bestand.
Één commando
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>
aiderHet bestand dat het commando schrijft, ziet er zo uit:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"Het voorvoegsel openai/ is verplicht. Het vertelt Aider dat de modelnaam naar een OpenAI-compatibele API moet worden gestuurd. Om omgevingsvariabelen te gebruiken en geen bestand, doe je dit:
Alleen omgevingsvariabelen
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider zoekt .aider.conf.yml in je thuismap, daarna in de hoofdmap van je git-repository, en daarna in de huidige map. Het bestand dat als laatste wordt geladen, heeft voorrang. Een projectbestand kan dus het model voor één repository wijzigen.
Stap 3: modellen kiezen
Aider stuurt je bestanden en een repomap in elk verzoek. Het heeft geen toolaanroepen nodig voor zijn belangrijkste bewerkingslus, omdat het bewerkingen uit de tekst van het model leest. Een groot contextvenster en goed opvolgen van instructies zijn belangrijker. De tabel toont gratis modellen met minstens 128K context van vandaag.
| Model | Gratis op | Context | Gratis limieten (beste aanbod) | Tools | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 aanvragen/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Ja | Nee |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 meer | 1M | 40 aanvragen/min 40 RPM | Ja | Ja |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 aanvragen/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Ja | Ja |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Ja | Nee |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Deepseek V4.1 Flash | APINex | 1M | 5 aanvragen/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Nee | Nee |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 aanvragen/min 50 aanvragen/dag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Ja |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 aanvragen/min 50 aanvragen/dag Shared rate limit | Ja | Nee |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Nee | Nee |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 meer | 262K | 30 aanvragen/min 250 aanvragen/dag 70,000 tokens/min ~6M | Ja | Ja |
Toont 12 van 184 overeenkomende gratis modellen. Bekijk alle modellen.
Actuele gegevens uit de FreeLLMAPI-catalogus (versie 2026.11.19, gecontroleerd 2026-11-19). Gratis limieten veranderen vaak. De catalogus wordt elke dag gecontroleerd.
Gebruik openai/auto om de router een model te laten kiezen. Gebruik openai/auto:smart om de modellen met de hoogste intelligentie te kiezen. Om één model vast te zetten, gebruik je openai/ en een catalogus-id uit GET /v1/models.
Je kunt de modellen voor één sessie ook op de opdrachtregel instellen. Dit voorbeeld gebruikt de sterkste modellen voor bewerkingen. Het gebruikt snelle modellen voor commitberichten en samenvattingen van de chatgeschiedenis:
Modellen voor één sessie
aider --model openai/auto:smart --weak-model openai/auto:fastVoor een vast profiel maak je een fallbackketen op het FreeLLMAPI-dashboard, bijvoorbeeld een keten met de naam coding. Gebruik daarna --model openai/auto:coding. Een onbekende profielnaam geeft een fout 400, zodat het verzoek niet zonder melding naar een andere keten gaat.
Aider-instellingen voor gratis modellen
Aider kent de instellingen van bekende modellen. Een gatewaymodel zoals auto is niet bekend, dus stel deze waarden zelf in.
| Instelling | Wat het doet | Aanbevolen waarde voor gratis modellen |
|---|---|---|
edit-format | Het formaat dat het model gebruikt om bewerkingen te sturen: whole, diff, diff-fenced of udiff | diff voor sterke modellen. whole voor zwakke modellen, omdat het eenvoudiger is maar meer tokens stuurt. |
weak-model | Het model voor commitberichten en samenvattingen van de chatgeschiedenis | openai/auto:fast, zodat kleine taken niet het quotum van je sterke model gebruiken |
map-tokens | Het aantal tokens voor de repomap. 0 zet het uit. | 1024 of minder op kleine gratis tiers |
architect | Een model plant de wijziging en een bewerkingsmodel schrijft de bewerkingen | Optioneel. Het verdubbelt het aantal verzoeken. |
~/.aider.conf.yml met instellingen voor gratis modellen
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: 1024Om Aider het contextvenster van een gatewaymodel te geven, voeg je een bestand .aider.model.metadata.json toe. De sleutel is de volledige modelnaam. Aider zoekt dit bestand op dezelfde plaatsen als het configuratiebestand.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Ratelimieten en failover
Gratis tiers hebben limieten per minuut en per dag. FreeLLMAPI telt het gebruik van elke sleutel. Wanneer een provider een fout 429 stuurt, stuurt de router het verzoek naar het volgende model in je keten. Aider ziet de fout niet en gaat door.
- Voeg sleutels toe van vier of meer providers. Meer providers geven meer verzoeken per dag.
- Voeg alleen de bestanden toe die je wilt wijzigen, met
/add. Elk bestand zit in elk verzoek. - Gebruik
/cleartussen taken om een kortere chatgeschiedenis te sturen. Een korte geschiedenis verlaagt ook de tokens per minuut. - Gebruik
/dropom bestanden te verwijderen die je niet meer nodig hebt.
Problemen oplossen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
| "Model openai/auto: Onbekende grootte van contextvenster en kosten, standaardwaarden worden gebruikt." | Aider kent het gatewaymodel niet | Deze waarschuwing is meestal onschadelijk. Om hem te verwijderen, voeg je .aider.model.metadata.json toe. |
| De bewerking is niet toegepast | Het model volgde het bewerkingsformaat niet | Gebruik --edit-format whole, of een sterker model |
401 "Invalid API key" | Aider stuurt een andere sleutel, bijvoorbeeld uit een ander configuratiebestand | Controleer de configuratiebestanden in de thuismap, de git-root en de huidige map |
| Aider roept api.openai.com aan | Het voorvoegsel openai/ wordt gebruikt, maar de base URL is niet ingesteld | Stel openai-api-base of OPENAI_API_BASE in |
| "Alle modellen zijn beperkt na N pogingen" | Alle sleutels hebben hun limiet bereikt | Voeg sleutels van meer providers toe, of verlaag map-tokens |
Veelgestelde vragen
Kan ik Aider gratis gebruiken?
Ja. Aider is open source. Richt het op FreeLLMAPI met openai-api-base en het modelvoorvoegsel openai/. De gateway gebruikt gratis providertiers, dus de kosten voor inferentie zijn $0.
Hoe gebruik ik Aider met een OpenAI-compatibele API?
Stel OPENAI_API_BASE en OPENAI_API_KEY in en voer daarna aider --model openai/
Welk bewerkingsformaat moet ik gebruiken met gratis modellen?
Gebruik diff voor sterke modellen, omdat het minder tokens stuurt. Als bewerkingen niet worden toegepast, gebruik je whole. Het is eenvoudiger voor zwakke modellen, maar het stuurt elke keer het volledige bestand.
Wat betekent 'Unknown context window size and costs, using sane defaults'?
Aider kent de modelnaam niet, dus het gebruikt standaardwaarden. De waarschuwing is meestal onschadelijk. Voeg .aider.model.metadata.json met het contextvenster toe om hem te verwijderen.
Welk gratis model is het beste voor Aider?
Gebruik een model met een groot contextvenster en goed opvolgen van instructies. De tabel op deze pagina toont de sterkste gratis modellen met 128K of meer context van vandaag.
Gerelateerde gidsen
- OpenCode gebruiken met een gratis LLM API
- Codex CLI gebruiken met gratis modellen
- Beste gratis API's voor codemodellen
- Gratis OpenAI-compatibele API-basis-URL's
- Gratis LLM API met context van 1 miljoen tokens
Bronnen
- Aider docs: OpenAI-compatible APIs (gecontroleerd 20 November 2026)
- Aider docs: YAML config file (gecontroleerd 20 November 2026)
- Aider docs: options reference (gecontroleerd 20 November 2026)
- Aider docs: edit formats (gecontroleerd 20 November 2026)
- Aider docs: model warnings (gecontroleerd 20 November 2026)
- Aider docs: advanced model settings (gecontroleerd 20 November 2026)
- FreeLLMAPI CLI generators (gecontroleerd 20 November 2026)