Aider nasıl kullanılır? Adım adım rehber

Aider’ı kullanmak için onu aider-install ya da tek satırlık betikle kurarsın, cd ile bir git deposuna geçersin, aider --model sonnet --api-key anthropic=<key> (veya başka bir sağlayıcı) ile başlatırsın, değiştirmek istediğin dosyaları /add ile eklersin ve değişikliği düz bir dille anlatırsın. Aider dosyaları düzenler ve her değişikliği git’e commit eder; /undo ile geri alırsın.

Döngünün tamamı bu. Bu rehber Aider’ı keyifli kılan kısımları anlatıyor: API anahtarları ve modeller, hangi dosyaların ekleneceği, ask, code ve architect modları, düzenleme formatları, git davranışı, .aider.conf.yml, lint ve test entegrasyonu ve bir kurallar dosyası. Buradaki her komut ve bayrak, Ekim 2026 itibarıyla aider.chat’teki resmi Aider belgelerinden geliyor.

Aider nedir?

Aider, terminal için bir yapay zeka eşli programcısı. Neredeyse her LLM ile çalışan bir kodlama ajanı: Claude, GPT, Gemini, DeepSeek ya da yerel bir model. Onu çoğu CLI ajanından iki şey ayırır. Birincisi, git etrafında kurulmuştur: her düzenleme bir commit olur. İkincisi, bağlam konusunda açıktır: sohbette hangi dosyaların olacağına sen karar verirsin, bir depo haritası da modele geri kalanın özetini verir.

Onu başka terminal ajanlarıyla karşılaştırıyorsan opencode nasıl kullanılır ve GitHub Copilot CLI nasıl kullanılır yazıları aynı adım adım formatı izliyor.

1. Adım: Aider’ı kur

Aider belgeleri birkaç kurulum yolu sıralıyor. Birini seç.

aider-install, Aider’ı kendine ait bir Python ortamına kurar; böylece projenin paketleriyle çakışmaz. Düz pip ile kuruyorsan bunu bir sanal ortamın içinde yap. pip kurulumundan sonra aider komutu bulunamıyorsa python -m aider aynı şeyi çalıştırır.

2. Adım: API anahtarları ve modeller

Aider model sağlayıcılarıyla senin anahtarlarınla konuşur. En hızlı başlangıç, modeli ve anahtarı komut satırında vermek:

cd /to/your/project

# Anthropic
aider --model sonnet --api-key anthropic=<key>

# OpenAI
aider --model o3-mini --api-key openai=<key>

# DeepSeek
aider --model deepseek --api-key deepseek=<key>

Anahtarı her seferinde yazmak bir süre sonra yorar. Aider bilinen ortam değişkenlerini (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, DEEPSEEK_API_KEY vb.) ve projendeki bir .env dosyasını da okur. --api-key provider=<key> her sağlayıcı için çalışır: --api-key gemini=xxx, GEMINI_API_KEY değerini ayarlar.

sonnet gibi kısa adlar yerleşik takma adlardır. Ekim 2026 itibarıyla belgeler sonnet, opus ve haiku’yu güncel Claude modellerine, gemini ve flash’ı Gemini modellerine, deepseek ve r1’i DeepSeek chat ve reasoner’a, 4o’yu da GPT-4o’ya eşliyor. Kendi takma adını da tanımlayabilirsin:

aider --alias "fast:gpt-4o-mini" --model fast

Oturum içinde /model <name> ana modeli değiştirir, /models <search> kullanılabilir modelleri listeler, /reasoning-effort da destekleyen modellerde eforu ayarlar. Aider commit mesajları ve sohbet özetleri için daha ucuz bir “zayıf model” de kullanır; --weak-model onu değiştirir. Kendi donanımında çalıştırmak mı istiyorsun? Yerel modelle kodlama ajanı rehberi bu kurulumu anlatıyor.

3. Adım: sohbete dosya ekle

Aider yalnızca sohbette olan dosyaları düzenler. Onları başlatırken verebilirsin:

aider src/api/users.py tests/test_users.py

ya da sonradan ekleyebilirsin:

/add src/api/users.py tests/test_users.py

Aider belgeleri bir konuda net: yalnızca görev için düzenlenmesi gereken dosyaları ekle. Eklediğin her dosya token harcar, fazla dosya da modeli boğabilir. Aider tüm depo için bir depo haritası çıkarır; böylece model, sen eklemeden de ilgili fonksiyonların ve sınıfların nerede olduğunu bilir. Hiçbir şey eklemezsen Aider hangi dosyaların düzenlenmesi gerektiğini kendisi bulmaya çalışır.

Bağlamı yöneten komutlar:

• /add <files> Aider’ın düzenleyebileceği dosyaları ekler.
• /read-only <files> okuyabileceği ama değiştiremeyeceği referans dosyaları ekler (belgeler, örnek bir modül).
• /drop <files> bağlamı boşaltmak için dosyaları çıkarır; tek başına /drop hepsini temizler.
• /ls sohbetteki ve depodaki dosyaları listeler.
• /tokens mevcut bağlamın kaç token kullandığını gösterir.
• /map depo haritasını yazdırır, /map-refresh onu yeniden oluşturur.

Sonra değişikliği anlat:

list_users endpoint’ine sayfalama ekle: page ve page_size sorgu
parametrelerini kabul etsin, varsayılan sayfa başına 20 olsun, testleri de güncelle.

4. Adım: ask, code ve architect modları

Aider’ın sohbet modları var ve doğru olanı seçmek işin büyük kısmı.

/ask, /code ve /architect arkasından bir mesajla yazılırsa yalnızca o mesaj için geçerli olur. Tek başına yazılırsa sen yeniden değiştirene kadar modu değiştirir; /chat-mode <mode> da aynı işi yapar. --chat-mode <mode> modu açılışta seçer, --architect ise bunun kısayolu.

Belgelerin önerdiği iş akışı dönüşümlü çalışmak. Önce sor, planı netleştir, sonra kodlamasına izin ver:

/ask Diğer endpoint’lere dokunmadan login route’una hız sınırlaması
nasıl eklemeliyim? Henüz hiçbir şeyi değiştirme.

Plan doğru görünüyorsa /ok yaz. Bu, “/code Ok, please go ahead and make those changes.” (“Tamam, devam et ve bu değişiklikleri yap.”) mesajının kısaltması.

Architect modu işi iki model arasında böler. Ana model sorunun nasıl çözüleceğini anlatır, --editor-model ile ayarlanan bir editor modeli de bunu dosya düzenlemelerine çevirir. Sen seçmezsen Aider her ana model için mantıklı bir editor modeli seçer. Bu, planlamada iyi ama birebir düzenleme üretmede daha az güvenilir olan akıl yürütme modellerinde çoğu zaman işe yarar. Bedeli şu: architect modu her değişiklik için iki istek gönderir, yani daha yavaş ve daha pahalıdır.

5. Adım: düzenleme formatları

Düzenleme formatı, modelin Aider’a neyi değiştireceğini nasıl söylediğidir. Ona nadiren dokunman gerekir, çünkü Aider her model için en iyi formatı seçer; ama ne gördüğünü bilmek işe yarar:

--edit-format <format> ile değiştirebilir, editor modelinin formatını da --editor-edit-format ile ayarlayabilirsin. Bir model sürekli uygulanamayan düzenlemeler üretiyorsa küçük dosyalarda onu whole’a geçirmek mantıklı bir denemedir.

6. Adım: git, otomatik commit’ler ve /undo

Aider en iyi bir git deposunun içinde çalışır. Varsayılan olarak:

• Aider’ın yaptığı her düzenleme, zayıf modelin Conventional Commits tarzında yazdığı açıklayıcı bir mesajla commit edilir.
• Aider bir dosyayı düzenlemeden önce o dosyalarda commit edilmemiş değişikliklerin varsa önce onları commit eder; böylece senin işinle onunki ayrı commit’lerde kalır.
• Onun commit’lerinde git yazar ve committer adına “(aider)” eklenir.

Bu da güvenlik ağını basitleştirir:

• /diff son mesajından beri yapılan değişiklikleri gösterir.
• /undo son commit’i Aider attıysa onu geri alır.
• /commit kendi yaptığın, sohbet dışındaki düzenlemeleri commit eder.
• /git <command> sohbetten çıkmadan herhangi bir git komutu çalıştırır.

Bunun parçalarını kapatabilirsin: --no-auto-commits düzenlemeleri gözden geçirmen için commit edilmeden bırakır, --no-dirty-commits düzenleme öncesi commit’i atlar, --no-git ise git’i tamamen kapatır (belgeler bunu önermiyor). Aider varsayılan olarak --no-verify ile commit eder, yani pre-commit hook’ların çalışmaz; çalışmalarını istiyorsan --git-commit-verify ekle. Aider’ın değişikliklerini ana çalışma kopyandan uzak tutmak istersen onu ayrı bir git worktree içinde çalıştır.

7. Adım: .aider.conf.yml ayarla

Her seferinde kullandığın bayraklar bir YAML dosyasına gider. Aider .aider.conf.yml dosyasını önce ana klasöründen, sonra git deposunun kökünden, sonra da bulunduğun klasörden yükler; sonra gelen kazanır. --config <file> yalnızca o dosyayı yükler.

# .aider.conf.yml
model: sonnet
weak-model: haiku
auto-commits: true
dirty-commits: true
lint-cmd: "python: ruff check --fix"
test-cmd: pytest -q
auto-test: false
read: [CONVENTIONS.md]

Dosyadaki anahtarlar, uzun bayrak adlarının tiresiz hâli. API anahtarları da buraya yazılabilir (anthropic-api-key:, openai-api-key: ya da - gemini=xxx gibi bir api-key: listesi), ama bunu yaparsan dosyayı git’in dışında tut. Aider varsayılan olarak .gitignore’a .aider* ekler; böylece geçmiş dosyaları commit’lere girmez.

8. Adım: lint ve test entegrasyonu

Aider düzenlediği dosyaları her değişikliğin hemen ardından lint’ler; popüler dillerin çoğu için yerleşik linter’lar kullanır. Linter sorun bildirirse Aider onları düzeltmeye çalışır. Kendi linter’ını da kullanabilirsin:

aider --lint-cmd "python: ruff check --fix" --lint-cmd "javascript: npx eslint --fix"

Komut, sorun bulduğunda hataları yazdırmalı ve sıfır olmayan bir kodla çıkmalı. --no-auto-lint lint’i kapatır.

Testler de aynı şekilde çalışır, ama varsayılan olarak kapalıdır. --test-cmd ile bir komut belirle ve --auto-test’i aç; Aider her değişiklikten sonra testleri çalıştırır ve başarısız olanları (sıfır olmayan her çıkış kodu) düzeltmeye çalışır. Sohbette:

• /lint sohbetteki dosyaları, hiç dosya eklenmemişse değişmiş tüm dosyaları lint’ler ve düzeltir.
• /test <command> bir komut çalıştırır, başarısız olursa çıktıyı sohbete ekler.
• /run <command> (ya da !<command>) bir kabuk komutu çalıştırır ve çıktısını paylaşmanı sağlar.

9. Adım: bir kurallar dosyası

Aider’ın kendiliğinden yüklediği yerleşik bir proje talimat dosyası yok. Belgelerdeki yöntem, salt okunur yüklediğin düz bir Markdown dosyası:

# CONVENTIONS.md
- Prefer httpx over requests for making http requests.
- Use types everywhere possible.
- Every new endpoint needs a test in tests/api/.

aider --read CONVENTIONS.md

ya da oturum sırasında /read-only CONVENTIONS.md veya her seferinde yüklensin diye .aider.conf.yml içinde read: CONVENTIONS.md. Prompt önbelleği açıkken salt okunur dosyalar önbelleğe alınır, yani maliyet düşük kalır. Diğer ajanlar için zaten bir AGENTS.md tutuyorsan onun yerine onu yükleyebilirsin; ajanların gerçekten uyduğu kuralları yazmaya dair ipuçları CLAUDE.md nasıl yazılır yazısında.

Bilmeye değer iki özellik daha

Betik yazma. --message (ya da -m) tek bir talimat gönderir, düzenlemeleri uygular ve çıkar; bu da Aider’ı dosyalar üzerinde döngüde çalıştırmayı kolaylaştırır:

for FILE in *.py ; do
  aider --message "add descriptive docstrings to all the functions" $FILE
done

Onayları otomatik kabul etmek için --yes-always, talimatı bir dosyadan okumak için --message-file ekle.

İzleme modu. Aider’ı --watch-files ile başlat ve editöründe çalışmaya devam et. Sonu AI! ile biten bir yorum yaz, Aider değişikliği yapar; AI? ile bitirirsen soruyu yanıtlar. #, // ve -- yorumlarıyla çalışır.

Sık yapılan hatalar

• Tüm depoyu eklemek. Daha fazla dosya, daha yüksek maliyet ve daha kötü düzenleme demek. Değişeni ekle, referanslar için /read-only kullan, depo haritasına güven.
• Kirli commit davranışını unutmak. Aider bir dosyaya dokunmadan önce bekleyen düzenlemelerini commit eder. Bu seni şaşırtıyorsa önce commit at ya da stash’le, veya --no-dirty-commits kullan.
• Hook’ların çalışmasını beklemek. --git-commit-verify vermezsen commit’ler pre-commit hook’larını atlar.
• Her şey için architect modu. İstek sayısını ikiye katlar. Zor değişikliklerde kullan; küçük düzenlemeler için düz code modu yeterli.
• Commit edilmiş bir ayar dosyasında anahtarlar. .aider.conf.yml API anahtarı içeriyorsa onu ana klasöründe ya da git’in dışında tut.
• Uzun sohbetler. Eski mesajlar her istekte token harcar. /clear sohbet geçmişini siler, /reset dosyaları da çıkarır.

Aider’ı AgentVera’da çalıştırmak

AgentVera; macOS, Windows ve Linux için CLI ajanlarını gerçek terminallerde yan yana çalıştıran bir masaüstü uygulaması ve senin kendi kurulumlarını ve anahtarlarını kullanır. Aider desteklediği ajanlardan biri; ayrıntılar AgentVera’da Aider sayfasında:

• Senin anahtarların, senin ayarların. Aider sağlayıcı anahtarlarını her zamanki gibi ortam değişkenlerinden ya da .aider.conf.yml’dan okur. AgentVera’da seçtiğin model --model ile, düşük, orta veya yüksek efor da --reasoning-effort ile verilir.
• Ajan başına ayrı geçmiş. Her Aider ajanı kendi sohbet geçmişi dosyasını ~/.aider/agentvera/ altında tutar ve uygulama yeniden açılınca --restore-chat-history ile devam eder; böylece birden fazla Aider ajanının geçmişi asla karışmaz.
• Salt okunur dosya olarak roller. Aider sistem prompt’unun genişletilmesine izin vermediği için ajanın rolü, kurallar dosyasıyla aynı mekanizma olan --read ile verilir.
• Diğer ajanların yanında paneller. Aider’ı çalışma alanı ızgarasında Claude Code ya da Codex’in yanında çalıştır, Git panelinden ajanları kendi worktree’lerinde başlat.
• İnceleme ve akışlar. Aider ajanları bir tur bitince otomatik kod incelemesi alır; akışlarda (Pro ve Team), toplu mesajlarda ve zamanlanmış görevlerde de çalışırlar.

Bilmen gereken bir sınır var: AgentVera’da kurduğun MCP sunucuları Aider’a aktarılmaz. Izgara, worktree’ler ve kod incelemesi ücretsiz planda. Denemek için AgentVera’yı indir.

Toparlarsak

Aider’ı kur, cd ile bir git deposuna geç, bir model ve anahtarla başlat ve yalnızca değişikliğin ihtiyaç duyduğu dosyaları ekle. Planlamak için /ask, uygulamak için /ok ya da /code kullan, zor sorunlarda /architect’i dene; her düzenleme bir commit olduğu için /diff ve /undo’ya güven. Varsayılanlarını .aider.conf.yml’a, kurallarını CONVENTIONS.md’ye yaz, hataları senden önce --lint-cmd ve --test-cmd yakalasın. GitHub’ın ajanını da kullanıyorsan GitHub Copilot CLI nasıl kullanılır aynı rehberin o araç için olanı.