Aider Kurulumu: Terminal Kod Asistanı Rehberi

Aider, geliştiricinin kendi terminalinde çalışan, dosyaları doğrudan düzenleyen ve değişiklikleri git geçmişine işleyen açık kaynak bir yapay zekâ çiftli programlama asistanıdır. ChatGPT benzeri arayüzlerden farkı, konuşmanın doğrudan gerçek proje dosyalarına dönüşmesidir: Aider’a istenen değişiklik yazılır, araç ilgili dosyaları düzenler, lint çalıştırır ve her adımı anlamlı bir commit mesajıyla kaydeder. Bu rehber kurulumu, model bağlantılarını, git işleyişini ve verimli kullanım desenlerini ele alır.

Aider Nedir

Aider, tek bir geliştiriciyle model arasında sürekli bir düzenleme akışı kurar. En ayırt edici yeteneği depo haritasıdır: araç, projenin tamamını sembolik olarak analiz eder ve her istekte hangi dosyaların bağlama eklenmesi gerektiğini kendisi seçer. Bu sayede çok büyük depolarda bile ilgili işlevlerin bulunması otomatikleşir. Aider iki düzenleme kipi sunar: kod kipinde dosyalar anında değişir, mimarlık (architect) kipinde önce tasarım önerilir, onaylanınca uygulanır. Her düzenlemede diff görünür ve değişiklikler otomatik veya istemle commit edilir.

Ön Koşullar

Kurulum öncesi gerekli bileşenler şunlardır: Python 3.9 veya üzeri, bir model sağlayıcısının API anahtarı (OpenAI, Anthropic, DeepSeek gibi) veya yerel Ollama kurulumu ve tercihen git. Windows’ta PowerShell veya Windows Terminal, macOS ve Linux’ta standart terminal yeterlidir. Aider komut satırı dışında hiçbir arayüz gerektirmez; zaten kurulu bir geliştirme ortamına ek olarak çalışır.

Kurulum Adımları

Önerilen Yöntem: aider-install

1. Resmî kurulum betiği, Aider’ı kendi bağımsız Python ortamına kurar ve sistem yolu ekler.

python -m pip install aider-install
aider-install

2. Kurulum bitince terminal yeniden başlatılır veya PATH güncellenir.
3. Kurulum doğrulanır.

aider --version

uv ile Kurulum

uv kullanan geliştiriciler için araç kurulumu pratik bir alternatiftir:

uv tool install --force --python python3.12 aider-chat

Bu yöntem, Aider’ı izole bir ortama yerleştirir ve sistem Python’undan bağımsız tutar.

pip ile Kurulum

Sanal ortam tercih edenler için klasik pip yöntemi de kullanılabilir:

python -m venv .venv
source .venv/bin/activate
python -m pip install aider-chat

Sanal ortam yönteminde Aider’ın etkinleştirilmiş ortamı kullanması gerekir; ortam değişkeni çakışmaları yaşanırsa uv yöntemi daha sorunsuzdur.

API Anahtarı Tanımlama

Aider model sağlayıcısına göre farklı ortam değişkenleri okur. OpenAI için OPENAI_API_KEY, Anthropic için ANTHROPIC_API_KEY, DeepSeek için DEEPSEEK_API_KEY tanımlanır. En sürdürülebilir yol, proje kökünde .env dosyası oluşturmaktır:

OPENAI_API_KEY=sk-...

.env dosyasının git tarafından izlenmemesi için .gitignore’a eklenmesi şarttır; aksi hâlde anahtar depoya sızabilir. Model seçimi başlangıçta —model parametresiyle veya oturum içinde /model komutuyla yapılır. Yerel model kullanımı da desteklenir; Ollama çalışıyorsa model OpenAI uyumlu uç nokta üzerinden tanımlanır ve tamamen çevrimdışı çalışılabilir.

Git Entegrasyonu

Aider’ın iş akışı git üzerine kuruludur. Git deposunda başlatıldığında her düzenleme turu için otomatik commit oluşturur; mesajlar yapılan değişikliği özetler. Bu düzen üç avantaj sağlar: her yapay zekâ müdahalesi geriye dönük incelenebilir, beğenilmeyen değişiklik tek komutla geri alınabilir ve kod inceleme süreci doğal biçimde işler. Otomatik commit davranışı ayarlarla değiştirilebilir; değişiklikler commit edilmeden biriktirilebilir de. Git olmayan klasörlerde Aider uyarı verir ve değişiklikleri yine yapar ancak güvenlik ağı ortadan kalkar.

Temel Kullanım ve Desenler

1. Proje klasöründe Aider başlatılır.

cd proje-klasoru
aider

2. Düzenlenecek dosyalar oturuma eklenir; /add dosya yolu ile manuel eklenebilir veya Aider depo haritasından kendisi seçebilir.
3. İstenen değişiklik doğal dille yazılır; Aider planını özetler, dosyaları düzenler ve diff gösterir.
4. Değişiklikler onaylanır; /undo ile son tur geri alınabilir.

Verimli desenlerden biri, istekleri küçük ve net tutmaktır; tek istekte bir işlevin tamamı istenmek yerine önce arayüz, sonra mantık istenirse başarı oranı artar. Test odaklı çalışma güçlü bir desendir: önce testler yazdırılıp geçirilmesi istenir, Aider test çıktısını okuyup kendi hatalarını düzeltir. Mimarlık kipi büyük değişikliklerde önce plan üretir; plan onaylanınca uygulama yapılır. /diff ile değişiklikler özetlenir, /clear ile bağlam temizlenir, /run komutu ile araç çıktısı modele gösterilir.

Depo Haritası Derinlemesine

Aider’ın depo haritası, aracın en ayırt edici teknolojidir ve ne yaptığını bilmek, aracı verimli kullanmanın anahtarlarından biridir. Harita, projenin dosyalarını ve içindeki önemli sembolleri (sınıflar, işlevler, tanımlar) özetleyen hiyerarşik bir taslaktır; Aider bunu dil sunucuları benzeri ayrıştırıcılarla üretir. Her istekte model, tüm depoyu değil bu haritayı görür ve harita üzerinden hangi dosyaların düzenlenmesi gerektiğini önerir. Bu yaklaşım, yüzlerce dosyalı depolarda bile bağlam penceresinin doldurulmadan çalışılabilmesini sağlar.

Haritanın boyutu ayarlanabilir; çok büyük depolarda harita otomatik olarak kırpılır ve en ilgili bölümler önceliklendirilir. Kullanıcı, /add ve /drop komutlarıyla haritaya ek olarak dosyaları düzenleme kümesine elle alıp çıkarabilir; düzenleme kümesindeki dosyaların tam içeriği modele gönderilirken, yalnızca haritada görünen dosyalardan yalnızca iskelet bilgisi iletilir. Bu iki katmanlı bağlam düzeni, doğruluk ile maliyet dengesini kurar. Haritada beklenmeyen eksiklikler görülürse dile özgü ayrıştırıcının destek durumunu kontrol etmek gerekir; desteklenmeyen dosya türleri haritadan düşer ve düzenleme kalitesi etkilenebilir.

Test ve Sürekli Doğrulama Döngüsü

Aider’ın güçlü kullanım desenlerinden biri, test güdümlü akıştır. Ayarlarda test komutu tanımlandığında Aider, her düzenleme turundan sonra testleri çalıştırır; başarısız test varsa hata çıktısını okuyup kendini düzeltmeye devam eder. Bu döngü, yapay zekâ düzenlemelerinin en tehlikeli sakıncası olan “kompilasyonu geçen ama işlevi bozuk” kod riskini belirgin biçimde azaltır. Benzer biçimde lint entegrasyonu, düzenlenen dosyalarda biçim ihlallerini otomatik giderir ve değişikliklerin proje standartlarıyla uyumlu kalmasını sağlar.

Döngünün verimli çalışması için test paketinin hızlı olması gerekir; dakikalar süren test paketleri her turda tekrar çalıştırıldığında akış yavaşlar ve API maliyeti büyür. Büyük depolarda yalnızca etkilenen modüllerin testlerinin çalıştırılması, hız ve kapsam dengesini kurar. Test güdümlü çalışma, Aider’a verilen görevlerin doğasında değişiklik yaratır: “şu işlevi düzelt” istemi, “şu davranışı testle ve geçene dek düzelt” biçimine dönüşür. Sonuç, her turda ölçülebilir bir ilerleme kaydıdır; başarısız testler doğal bir iş listesi gibi davranır.

Maliyet Yönetimi ve Model Seçimi

Bulut modelleriyle çalışan kullanıcılar için Aider oturumlarında token tüketimi, doğrudan maliyete dönüşür. Araç, her istekle gönderilen bağlamın boyutunu gösterir; bu göstergenin düzenli takibi, gereksiz dosya birikimini önler. Oturum içinde /clear ile bağlam temizlenmesi, uzun çalışmalarda maliyeti düşürür; /undo ile geri alınan turlar harcanan tokenları geri getirmez, bu yüzden büyük ve riskli istekler küçük adımlara bölünmek maliyet açısından da doğru olur.

Model seçimi maliyet-kalite dengesinin merkezidir. Kod düzenleme kalitesi modelin yetenekleriyle doğrusal değil, basamaklı ilerler: güçlü modeller tüm dosyayı doğru biçimde değiştirirken zayıf modeller parça düzenlemelerde hata yapar ve aracın beklentisi olan diff biçimini bozabilir. Aider, model uyumluluğu hakkında uyarı üretir ve desteklediği düzenleme biçimlerini model bazında belgeler. Bütçe kısıtlıysa karma düzen mantıklıdır: planlama ve karmaşık mimari kararlar güçlü modele, mekanik düzenlemeler ve basit görevler ekonomik modele verilir. Oturum içinde /model komutuyla geçiş anında yapılabilir; bu esneklik, tek araçla çok modelli çalışmayı pratikleştirir.

Yaygın Hatalar ve İpuçları

En sık görülen sorun, geçersiz veya eksik API anahtarıdır; hata mesajı sağlayıcıyı işaret eder ve .env dosyasının doğru klasörde olup olmadığı kontrol edilir. Sanal ortam kurulumlarında Aider’ın beklenen ortamı bulamaması yaşanabilir; uv kurulumu bu karışıklığı ortadan kaldırır. Bağlam aşırı yüklenmesi, çok sayıda dosyanın aynı anda eklenmesinden doğar; /drop ile gereksiz dosyalar çıkarılır. Büyük depolarda depo haritasının ilk analizi zaman alabilir; bu tek seferlik maliyet sonraki adımlarda verimlilik olarak geri döner.

Performans ve kalite ipuçları arasında, güncel ve güçlü bir modelin seçilmesi, düzenleme öncesi temiz bir git durumu (depolu değişikliklerin commit’lenmesi) ve lint/test entegrasyonunun açık tutulması sayılabilir. Aider’ın ürettiği commit’lerin düzenli gözden geçirilmesi, hem kod kalitesini hem de istem alışkanlıklarının gelişmesini sağlar. Son olarak ~/.aider.conf.yml dosyasına yazılan varsayılan model ve ayarlar, her proje için tekrarlanan yapılandırmayı ortadan kaldırır.