# Aider nasıl kullanılır? Adım adım rehber Adres: https://agentvera.dev/blog/aider-nasil-kullanilir/ · Yayın: 2026-10-27 Aider nasıl kullanılır: kurulum, API anahtarları, model seçimi, sohbete dosya ekleme, ask, code ve architect modları, commit geri alma ve .aider.conf.yml ayarı. **Kısaca:** - Aider’ı aider-install, tek satırlık betik, uv ya da pipx ile kur, sonra bir git deposunun içinde aider --model sonnet --api-key anthropic= çalıştır. - Değişikliğin ihtiyaç duyduğu dosyaları /add ile ekle, referans dosyaları salt okunur tut ve işe göre /ask, /code ve /architect arasında geçiş yap. - Aider her düzenlemeyi git’e commit eder, bu yüzden /undo son commit’ini geri alır; varsayılanlarını .aider.conf.yml, --lint-cmd, --test-cmd ve bir CONVENTIONS.md belirler. 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=` (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ı](/sozluk/kodlama-ajani/ "Kodlama ajanı nedir"): 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](/blog/opencode-nasil-kullanilir/ "opencode nasıl kullanılır") ve [GitHub Copilot CLI nasıl kullanılır](/blog/copilot-cli-nasil-kullanilir/ "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ç. | Yöntem | Komut | | --- | --- | | aider-install (önerilen) | `python -m pip install aider-install`, ardından `aider-install` | | Tek satır, macOS ve Linux | `curl -LsSf https://aider.chat/install.sh \| sh` | | Tek satır, Windows | `powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 \| iex"` | | uv | `uv tool install --force --python python3.12 --with pip aider-chat@latest` | | pipx | `pipx install aider-chat` | `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: ```bash cd /to/your/project # Anthropic aider --model sonnet --api-key anthropic= # OpenAI aider --model o3-mini --api-key openai= # DeepSeek aider --model deepseek --api-key deepseek= ``` 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=` 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: ```bash aider --alias "fast:gpt-4o-mini" --model fast ``` Oturum içinde `/model ` ana modeli değiştirir, `/models ` 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ı](/blog/yerel-model-kodlama-ajani/ "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: ```bash aider src/api/users.py tests/test_users.py ``` ya da sonradan ekleyebilirsin: ```text /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 ` Aider’ın düzenleyebileceği dosyaları ekler. - `/read-only ` okuyabileceği ama değiştiremeyeceği referans dosyaları ekler (belgeler, örnek bir modül). - `/drop ` 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: ```text 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ı. | Mod | Ne yapar | İstem | | --- | --- | --- | | code | Varsayılan. Aider değişikliği yapmak için dosyaları düzenler. | `>` | | ask | Kodu tartışır, soruları yanıtlar. Hiç düzenleme yapmaz. | `ask>` | | architect | Bir model değişikliği önerir, bir editor modeli düzenlemeleri yazar. | `architect>` | | help | Aider’ın kendisiyle ilgili soruları yanıtlar. | `help>` | `/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 ` da aynı işi yapar. `--chat-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: ```text /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: | Format | Düzenlemeler nasıl gönderilir | | --- | --- | | whole | Model güncellenmiş dosyanın tamamını döndürür. Basit, ama büyük dosyalarda pahalı. | | diff | Arama/değiştirme blokları: eski satırlar ve yerlerine gelecekler. | | diff-fenced | diff gibi, ama dosya yolu kod bloğunun içinde. Daha çok Gemini modelleri için. | | udiff | Sadeleştirilmiş bir unified diff. | | editor-diff, editor-whole | Architect modunda editor modelinin kullandığı sadeleştirilmiş sürümler. | `--edit-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 ` 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](/blog/git-worktree-paralel-gelistirme/ "Git worktree ile paralel geliştirme") 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 ` yalnızca o dosyayı yükler. ```yaml # .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: ```bash 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 ` bir komut çalıştırır, başarısız olursa çıktıyı sohbete ekler. - `/run ` (ya da `!`) 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ı: ```markdown # CONVENTIONS.md - Prefer httpx over requests for making http requests. - Use types everywhere possible. - Every new endpoint needs a test in tests/api/. ``` ```bash 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](/blog/claude-md-nasil-yazilir/ "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: ```bash 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](/ajanlar/aider/ "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ı](/ozellikler/calisma-alani/ "Çalışma alanı") ızgarasında Claude Code ya da Codex’in yanında çalıştır, [Git panelinden](/ozellikler/git-ve-github/ "Git ve GitHub") ajanları kendi worktree’lerinde başlat. - **İnceleme ve akışlar.** Aider ajanları bir tur bitince [otomatik kod incelemesi](/ozellikler/kod-incelemesi/ "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](/indir/ "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](/blog/copilot-cli-nasil-kullanilir/ "GitHub Copilot CLI nasıl kullanılır") aynı rehberin o araç için olanı. ## Sık sorulanlar **Aider ücretsiz mi?** Aider’ı kurmak ücretsiz. Kendi API anahtarınla kullandığın token’lar için model sağlayıcısına ödersin; Aider’ı yerel bir modele bağlarsan hiçbir şey ödemezsin. Maliyet, modele ve sohbete kaç dosya eklediğine bağlı. **Aider ile hangi modeli kullanmalıyım?** Aider’ın desteklediği her model çalışır. Belgeler hızlı başlangıçta sonnet, deepseek ve o3-mini kullanıyor; opus, gemini ve flash gibi takma adlar da var. Güçlü modeller düzenleme formatlarına daha güvenilir uyar; güçlü bir architect modelini daha ucuz bir editor modeliyle eşleştirebilirsin. **Aider’ın yaptığı bir değişikliği nasıl geri alırım?** /undo yaz. Aider her düzenlemeyi açıklayıcı bir mesajla git’e commit eder; son commit’i Aider attıysa /undo onu geri alır. /diff son mesajından beri neyin değiştiğini gösterir; her değişiklik normal bir commit olduğu için düz git komutları da işe yarar. **Aider git olmadan çalışır mı?** Evet, --no-git ile, ama otomatik commit’leri, /undo’yu ve /diff’i kaybedersin. Aider belgeleri git’i açık tutmayı öneriyor. Her düzenlemeden sonra commit istemiyorsan --no-auto-commits kullan ve commit’i kendin at. **Aider’ın kod stilime uymasını nasıl sağlarım?** Kuralları kısa bir CONVENTIONS.md dosyasına yaz ve aider --read CONVENTIONS.md ile yükle ya da her seferinde yüklensin diye .aider.conf.yml dosyasına read: CONVENTIONS.md ekle. Dosya salt okunur olduğu için Aider onu yol gösterici olarak kullanır, hiç düzenlemez. --- **AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz planda sınırsız ajan vardır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/