Aider z darmowym API LLM
Aider to programista w parze o otwartym kodzie źródłowym, działający w terminalu. Edytuje pliki w repozytorium git i tworzy commity. Ten poradnik łączy Aider z darmowymi modelami przez FreeLLMAPI. Pokazuje też ustawienia Aidera, które są ważne dla darmowych modeli: format edycji, słaby model i rozmiar mapy repozytorium.
Kod, nazwy modeli i etykiety z katalogu na żywo są podane po angielsku.
Krok 1: Zainstaluj FreeLLMAPI
FreeLLMAPI to brama o otwartym kodzie źródłowym. Działa na Twoim komputerze w Dockerze. Łączy darmowe poziomy 45 dostawców za jednym kluczem zgodnym z OpenAI.
Instalacja na macOS lub Linux
curl -fsSL https://freellmapi.co/install.sh | bashOtwórz http://localhost:3001. Dodaj co najmniej dwa darmowe klucze dostawców na stronie Keys. Skopiuj swój ujednolicony klucz z tej samej strony.
Krok 2: Połącz Aider
Polecenie konfiguracji zapisuje ~/.aider.conf.yml. Najpierw tworzy kopię zapasową istniejącego pliku.
Jedno polecenie
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>
aiderPlik zapisany przez polecenie wygląda tak:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"Prefiks openai/ jest wymagany. Mówi Aiderowi, żeby wysłał nazwę modelu do API zgodnego z OpenAI. Aby użyć zmiennych środowiskowych bez pliku, zrób tak:
Tylko zmienne środowiskowe
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider szuka .aider.conf.yml w katalogu domowym, potem w katalogu głównym repozytorium git, a na końcu w bieżącym katalogu. Plik wczytany ostatni ma pierwszeństwo. Plik projektu może więc zmienić model dla jednego repozytorium.
Krok 3: Wybierz modele
Aider wysyła Twoje pliki i mapę repozytorium w każdym żądaniu. Do swojej głównej pętli edycji nie potrzebuje wywoływania narzędzi, bo odczytuje edycje z tekstu modelu. Ważniejsze są duże okno kontekstu i dobre wykonywanie instrukcji. Tabela pokazuje darmowe modele z co najmniej 128K kontekstu na dziś.
| Model | Za darmo w | Kontekst | Darmowe limity (najlepsza oferta) | Narzędzia | Wizja |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 żądań/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Tak | Nie |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 więcej | 1M | 40 żądań/min 40 RPM | Tak | Tak |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 żądań/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Tak | Tak |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Tak | Nie |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Tak | Tak |
| Deepseek V4.1 Flash | APINex | 1M | 5 żądań/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Nie | Nie |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Tak | Tak |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 żądań/min 50 żądań/dzień 50 req/day account-wide (1,000 after a $10 purchase) | Tak | Tak |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 żądań/min 50 żądań/dzień Shared rate limit | Tak | Nie |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Nie | Nie |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 więcej | 262K | 30 żądań/min 250 żądań/dzień 70,000 tokenów/min ~6M | Tak | Tak |
Pokazano 12 z 184 pasujących darmowych modeli. Zobacz wszystkie modele.
Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.
Użyj openai/auto, aby router wybrał model. Użyj openai/auto:smart, aby preferować modele o najwyższej inteligencji. Aby przypiąć jeden model, użyj openai/ i identyfikatora z katalogu z GET /v1/models.
Modele dla jednej sesji możesz ustawić też w linii poleceń. Ten przykład używa najmocniejszych modeli do edycji. Do komunikatów commitów i streszczeń historii czatu używa szybkich modeli:
Modele dla jednej sesji
aider --model openai/auto:smart --weak-model openai/auto:fastDla zaplanowanego profilu utwórz łańcuch zapasowy w panelu FreeLLMAPI, na przykład łańcuch o nazwie coding. Następnie użyj --model openai/auto:coding. Nieznana nazwa profilu zwraca błąd 400, więc żądanie nie trafi bez ostrzeżenia do innego łańcucha.
Ustawienia Aidera dla darmowych modeli
Aider zna ustawienia znanych modeli. Model bramy, taki jak auto, nie jest znany, więc te wartości ustawiasz sam.
| Ustawienie | Co robi | Zalecana wartość dla darmowych modeli |
|---|---|---|
edit-format | Format, którego model używa do wysyłania edycji: whole, diff, diff-fenced albo udiff | diff dla mocnych modeli. whole dla słabych modeli, bo jest prostszy, ale wysyła więcej tokenów. |
weak-model | Model do komunikatów commitów i streszczeń historii czatu | openai/auto:fast, aby małe zadania nie zużywały limitu mocnego modelu |
map-tokens | Liczba tokenów dla mapy repozytorium. 0 wyłącza ją. | 1024 lub mniej na małych darmowych poziomach |
architect | Jeden model planuje zmianę, a model edytora pisze edycje | Opcjonalnie. Podwaja liczbę żądań. |
~/.aider.conf.yml z ustawieniami dla darmowych modeli
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: 1024Aby podać Aiderowi okno kontekstu modelu bramy, dodaj plik .aider.model.metadata.json. Kluczem jest pełna nazwa modelu. Aider szuka tego pliku w tych samych miejscach co pliku konfiguracji.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Limity szybkości i przełączanie awaryjne
Darmowe poziomy mają limity na minutę i na dzień. FreeLLMAPI liczy użycie każdego klucza. Gdy dostawca zwróci błąd 429, router wysyła żądanie do następnego modelu w łańcuchu. Aider nie widzi błędu i działa dalej.
- Dodaj klucze od czterech lub więcej dostawców. Więcej dostawców daje więcej żądań dziennie.
- Dodawaj tylko te pliki, które chcesz zmienić, przez
/add. Każdy plik jest w każdym żądaniu. - Używaj
/clearmiędzy zadaniami, aby wysyłać krótszą historię czatu. Krótka historia obniża też tokeny na minutę. - Użyj
/drop, aby usunąć pliki, które nie są już potrzebne.
Rozwiązywanie problemów
| Problem | Przyczyna | Rozwiązanie |
|---|---|---|
| Komunikat "Model openai/auto: Unknown context window size and costs, using sane defaults." | Aider nie zna modelu bramy | To ostrzeżenie zwykle jest nieszkodliwe. Aby je usunąć, dodaj .aider.model.metadata.json. |
| Edycja nie została zastosowana | Model nie trzymał się formatu edycji | Użyj --edit-format whole albo mocniejszego modelu |
401 "Invalid API key" | Aider wysyła inny klucz, na przykład z innego pliku konfiguracji | Sprawdź pliki konfiguracji w katalogu domowym, w katalogu głównym git i w bieżącym katalogu |
| Aider wywołuje api.openai.com | Użyto prefiksu openai/, ale base URL nie jest ustawiony | Ustaw openai-api-base albo OPENAI_API_BASE |
| Komunikat "All models rate-limited after N attempts" | Wszystkie klucze są na limicie | Dodaj klucze od kolejnych dostawców albo zmniejsz map-tokens |
Najczęstsze pytania
Czy mogę używać Aidera za darmo?
Tak. Aider ma otwarty kod źródłowy. Skieruj go na FreeLLMAPI przez openai-api-base i prefiks modelu openai/. Brama używa darmowych poziomów dostawców, więc wnioskowanie kosztuje 0 USD.
Jak używać Aidera z API zgodnym z OpenAI?
Ustaw OPENAI_API_BASE i OPENAI_API_KEY, a potem uruchom aider --model openai/
Którego formatu edycji używać z darmowymi modelami?
Używaj diff dla mocnych modeli, bo wysyła mniej tokenów. Jeśli edycje się nie stosują, użyj whole. Jest prostszy dla słabych modeli, ale za każdym razem wysyła cały plik.
Co oznacza 'Unknown context window size and costs, using sane defaults'?
Aider nie zna nazwy modelu, więc używa wartości domyślnych. Ostrzeżenie zwykle jest nieszkodliwe. Aby je usunąć, dodaj .aider.model.metadata.json z oknem kontekstu.
Który darmowy model jest najlepszy dla Aidera?
Użyj modelu z dużym oknem kontekstu i dobrym wykonywaniem instrukcji. Tabela na tej stronie pokazuje dziś najmocniejsze darmowe modele z kontekstem 128K lub większym.
Powiązane poradniki
- Używaj OpenCode z darmowym API LLM
- Codex CLI z darmowymi modelami
- Najlepsze darmowe API modeli do kodowania
- Darmowe bazowe URL-e API zgodne z OpenAI
- Darmowe API LLM z kontekstem 1 miliona tokenów
Źródła
- Aider docs: OpenAI-compatible APIs (sprawdzono 20 November 2026)
- Aider docs: YAML config file (sprawdzono 20 November 2026)
- Aider docs: options reference (sprawdzono 20 November 2026)
- Aider docs: edit formats (sprawdzono 20 November 2026)
- Aider docs: model warnings (sprawdzono 20 November 2026)
- Aider docs: advanced model settings (sprawdzono 20 November 2026)
- FreeLLMAPI CLI generators (sprawdzono 20 November 2026)