Aider'ı ücretsiz LLM API ile kullanın
Aider, terminal için açık kaynaklı bir eşli programlama aracıdır. Git deposundaki dosyaları düzenler ve commit'ler oluşturur. Bu kılavuz Aider'ı FreeLLMAPI üzerinden ücretsiz modellere bağlar. Ayrıca ücretsiz modeller için önemli Aider ayarlarını gösterir: düzenleme biçimi, zayıf model ve depo haritası boyutu.
Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.
Adım 1: FreeLLMAPI'yi kurun
FreeLLMAPI, açık kaynaklı bir ağ geçididir. Bilgisayarınızda Docker içinde çalışır. Tek bir OpenAI uyumlu anahtarın arkasında 45 sağlayıcının ücretsiz katmanlarını birleştirir.
macOS veya Linux'a kurun
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001 adresini açın. Keys sayfasına en az iki ücretsiz sağlayıcı anahtarı ekleyin. Birleşik anahtarınızı aynı sayfadan kopyalayın.
Adım 2: Aider'ı bağlayın
Kurulum komutu ~/.aider.conf.yml dosyasını yazar. Önce mevcut dosyanın bir yedeğini alır.
Tek komut
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>
aiderKomutun yazdığı dosya şöyle görünür:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"openai/ ön eki gereklidir. Aider'a model adını OpenAI uyumlu bir API'ye göndermesini söyler. Ortam değişkenlerini ve dosya kullanmadan yapmak için şunu yapın:
Yalnızca ortam değişkenleri
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider, .aider.conf.yml dosyasını önce ana dizininizde, sonra git deposunun kök dizininde, son olarak geçerli dizinde arar. Son yüklenen dosyanın önceliği vardır. Bu yüzden bir proje dosyası, tek bir depo için modeli değiştirebilir.
Adım 3: Modelleri seçin
Aider, her istekte dosyalarınızı ve bir depo haritasını gönderir. Ana düzenleme döngüsü için araç çağrısına ihtiyaç duymaz, çünkü düzenlemeleri modelin metninden okur. Geniş bağlam penceresi ve iyi talimat takibi daha önemlidir. Tablo, bugün en az 128K bağlamı olan ücretsiz modelleri gösterir.
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 istek/dk 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Evet | Hayır |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 tane daha | 1M | 40 istek/dk 40 RPM | Evet | Evet |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 istek/dk 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Evet | Evet |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Evet | Hayır |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Deepseek V4.1 Flash | APINex | 1M | 5 istek/dk 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Hayır | Hayır |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 istek/dk 50 istek/gün 50 req/day account-wide (1,000 after a $10 purchase) | Evet | Evet |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 istek/dk 50 istek/gün Shared rate limit | Evet | Hayır |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Hayır | Hayır |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 tane daha | 262K | 30 istek/dk 250 istek/gün 70,000 jeton/dk ~6M | Evet | Evet |
184 eşleşen ücretsiz modelden 12 tanesi gösteriliyor. Tüm modelleri gör.
Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.
Yönlendiricinin bir model seçmesi için openai/auto kullanın. En yüksek zekâya sahip modelleri tercih etmek için openai/auto:smart kullanın. Tek bir modeli sabitlemek için openai/ ve GET /v1/models üzerinden bir katalog kimliği kullanın.
Bir oturum için modelleri komut satırında da ayarlayabilirsiniz. Bu örnek düzenlemeler için en güçlü modelleri kullanır. Commit mesajları ve sohbet geçmişi özetleri için hızlı modelleri kullanır:
Bir oturum için modeller
aider --model openai/auto:smart --weak-model openai/auto:fastPlanlı bir profil için FreeLLMAPI panosunda bir yedek zinciri oluşturun, örneğin coding adlı bir zincir. Sonra --model openai/auto:coding kullanın. Bilinmeyen bir profil adı 400 hatası döndürür, bu yüzden istek haber verilmeden başka bir zincire gitmez.
Ücretsiz modeller için Aider ayarları
Aider, bilinen modellerin ayarlarını bilir. auto gibi bir ağ geçidi modeli bilinmez, bu yüzden bu değerleri kendiniz ayarlayın.
| Ayar | Ne yapar | Ücretsiz modeller için önerilen değer |
|---|---|---|
edit-format | Modelin düzenlemeleri göndermek için kullandığı biçim: whole, diff, diff-fenced veya udiff | Güçlü modeller için diff. Zayıf modeller için whole, çünkü daha basittir ama daha fazla token gönderir. |
weak-model | Commit mesajları ve sohbet geçmişi özetleri için model | openai/auto:fast, böylece küçük görevler güçlü modelin kotasını kullanmaz |
map-tokens | Depo haritası için token sayısı. 0 onu kapatır. | Küçük ücretsiz katmanlarda 1024 veya daha az |
architect | Bir model değişikliği planlar ve bir editör modeli düzenlemeleri yazar | İsteğe bağlı. İstek sayısını iki katına çıkarır. |
Ücretsiz modeller için ayarlı ~/.aider.conf.yml
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: 1024Aider'a bir ağ geçidi modelinin bağlam penceresini vermek için bir .aider.model.metadata.json dosyası ekleyin. Anahtar, tam model adıdır. Aider bu dosyayı yapılandırma dosyasıyla aynı yerlerde arar.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Hız limitleri ve yedekleme
Ücretsiz katmanların dakika ve gün başına limitleri vardır. FreeLLMAPI her anahtarın kullanımını sayar. Bir sağlayıcı 429 hatası gönderdiğinde yönlendirici isteği zincirdeki sonraki modele iletir. Aider hatayı görmez ve devam eder.
- Dört veya daha fazla sağlayıcıdan anahtar ekleyin. Daha fazla sağlayıcı, günde daha fazla istek verir.
- Yalnızca değiştirmek istediğiniz dosyaları
/addile ekleyin. Her dosya her istekte bulunur. - Görevler arasında daha kısa bir sohbet geçmişi göndermek için
/clearkullanın. Kısa bir geçmiş, dakikadaki token sayısını da düşürür. - Artık ihtiyaç duymadığınız dosyaları kaldırmak için
/dropkullanın.
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
| "Model openai/auto: Bilinmeyen bağlam penceresi boyutu ve maliyetler, makul varsayılanlar kullanılıyor." | Aider, ağ geçidi modelini bilmiyor | Bu uyarı genellikle zararsızdır. Kaldırmak için .aider.model.metadata.json ekleyin. |
| Düzenleme uygulanmadı | Model düzenleme biçimini izlemedi | --edit-format whole kullanın veya daha güçlü bir model seçin |
401 "Geçersiz API anahtarı" | Aider farklı bir anahtar gönderiyor, örneğin başka bir yapılandırma dosyasından | Ana dizindeki, git kökündeki ve geçerli dizindeki yapılandırma dosyalarını kontrol edin |
| Aider api.openai.com adresini çağırıyor | openai/ ön eki kullanılıyor, ama temel URL ayarlı değil | openai-api-base veya OPENAI_API_BASE ayarlayın |
| "Tüm modeller, N denemeden sonra hız sınırına takıldı" | Tüm anahtarlar limitinde | Daha fazla sağlayıcıdan anahtar ekleyin veya map-tokens değerini düşürün |
Sık sorulan sorular
Aider'ı ücretsiz kullanabilir miyim?
Evet. Aider açık kaynaklıdır. openai-api-base ve openai/ model ön eki ile onu FreeLLMAPI'ye yönlendirin. Ağ geçidi ücretsiz sağlayıcı katmanlarını kullanır, bu yüzden çıkarım maliyeti 0 $ olur.
Aider'ı OpenAI uyumlu bir API ile nasıl kullanırım?
OPENAI_API_BASE ve OPENAI_API_KEY değerlerini ayarlayın, sonra aider --model openai/
Ücretsiz modellerle hangi düzenleme biçimini kullanmalıyım?
Güçlü modeller için diff kullanın, çünkü daha az token gönderir. Düzenlemeler uygulanmazsa whole kullanın. Zayıf modeller için daha basittir, ama her seferinde tüm dosyayı gönderir.
'Bilinmeyen bağlam penceresi boyutu ve maliyetler, makul varsayılanlar kullanılıyor' ne anlama geliyor?
Aider model adını bilmediği için varsayılan değerleri kullanır. Uyarı genellikle zararsızdır. Bunu kaldırmak için bağlam penceresini içeren bir .aider.model.metadata.json ekleyin.
Aider için en iyi ücretsiz model hangisi?
Geniş bir bağlam penceresi ve iyi talimat takibi olan bir model kullanın. Bu sayfadaki tablo, bugün 128K veya daha fazla bağlamı olan en güçlü ücretsiz modelleri gösterir.
İlgili rehberler
- OpenCode'u ücretsiz LLM API ile kullanın
- Codex CLI'ı ücretsiz modellerle kullanın
- En iyi ücretsiz kodlama model API'leri
- Ücretsiz OpenAI uyumlu API base URL'leri
- 1 milyon token bağlamlı ücretsiz LLM API
Kaynaklar
- Aider docs: OpenAI-compatible APIs (20 November 2026 tarihinde kontrol edildi)
- Aider docs: YAML config file (20 November 2026 tarihinde kontrol edildi)
- Aider docs: options reference (20 November 2026 tarihinde kontrol edildi)
- Aider docs: edit formats (20 November 2026 tarihinde kontrol edildi)
- Aider docs: model warnings (20 November 2026 tarihinde kontrol edildi)
- Aider docs: advanced model settings (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI CLI generators (20 November 2026 tarihinde kontrol edildi)