Aider Kurulumu ve OmniProxy Yapılandırması

Aider, terminalde kod değişiklikleri yapmanıza yardımcı olan bir araçtır. Modelin daha büyük projeleri anlayabilmesi için tüm kod deposunun bir haritasını oluşturur. Git ise kod değişikliklerini kaydeden, farkları incelemek ve değişiklikleri geri almak için kullanılabilen bir sürüm kontrol aracıdır. Aider’a bir görev verdiğinizde görevi adım adım işler ve commit açıklamaları yazar. Yapılan değişiklikleri beğenmezseniz /undo ile geri alabilirsiniz.

Kurulum öncesi hazırlık

Yaygın olarak kullanılan iki kurulum yöntemi vardır:

• Bilgisayarınızda Python 3.8 ile 3.13 arasında bir sürüm zaten varsa önce aider-install paketini kurun. Python, Aider’ın çalışması için gereken programlama ortamıdır.
• Uygun bir Python sürümü yoksa tek satırlık kurulum komutunu kullanın. Gerektiğinde Python 3.12 de hazırlanır.

Mac ve Linux

install.sh

• curl sonrasında sh ile çalıştırın
• Gerekirse Python kurulur
• curl yoksa wget kullanılabilir

Windows

install.ps1

• PowerShell ile çalıştırın
• Kurulumdan sonra terminali yeniden açın
• Ortam değişkenleri için setx kullanın

Python zaten varsa

aider-install

• Önce bu paketi pip ile kurun
• Ardından aider-install çalıştırın
• Kendi ortamını oluşturur

Çalışır durumda bir OmniProxy hazırlayın. Kurulum tamamlandıktan sonra önce değiştireceğiniz projenin dizinine girin, ardından Aider’ı başlatın.

Kurulum ve ilk çalıştırma

Python 3.8 ile 3.13 arasında bir sürüm zaten varsa

Aşağıdaki komutları sırayla çalıştırın:

python -m pip install aider-install
aider-install

aider-install, bilgisayarınızdaki diğer Python projeleriyle karışmasını önlemek için Aider’ı ayrı bir Python ortamına kurar. Gerektiğinde Aider’ın kullanacağı Python 3.12’yi de kurar.

Tek satırlık kurulum

Mac ve Linux’ta çalıştırın:

curl -LsSf https://aider.chat/install.sh | sh

Bilgisayarınızda curl yoksa bunun yerine şunu kullanabilirsiniz:

wget -qO- https://aider.chat/install.sh | sh

Windows PowerShell’de çalıştırın:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Bu tek satırlık komutlar uv tabanlıdır. uv, Python araçlarını ve ortamlarını kurup yönetmek için kullanılan bir programdır. Aşağıdaki komutu da kullanabilirsiniz:

uv tool install --force --python python3.12 --with pip aider-chat@latest

Bunun dışında pipx de kullanılabilir. python -m pip install aider-chat ile doğrudan kurulumda desteklenen Python sürümleri 3.9 ile 3.12 arasındadır; ancak bu alternatif bir kurulum yöntemidir ve öncelikle yukarıdaki yöntemler tercih edilmelidir. Sistem paket yöneticilerindeki Aider paketlerinde bağımlılık uyuşmazlıkları yaşanabileceğinden, kurulum için bunlara öncelik vermeyin.

2026-10-09 tarihinde tek satırlık kurulum komutuyla Aider v0.86.2 kuruldu. Kurulum sırasında önbelleğin ve hedefin aynı diskte olmadığı, bu nedenle dosyaların kopyalanacağı belirtilse bile kurulum tamamlanır.

Kurulum bittikten sonra proje dizinine girin. Uyumlu API, diğer model hizmetleriyle OpenAI biçimini kullanarak iletişim kuran bir arayüzdür. Başlatma biçimi şöyledir:

aider --model openai/<model-name>

Buradaki <model-name> değerini bir sonraki bölümde OmniProxy’den kopyalayacağınız tam model ID’siyle değiştirin. Model ID’si, modeli kesin olarak belirtmek için kullanılan addır.

Bağlantı değerlerini OmniProxy’den alma

Aşağıdaki iki ortam değişkenini ayarlamanız gerekir. Ortam değişkenleri, terminal programlarının okuduğu bağlantı ayarları grubu olarak düşünülebilir:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE API adresidir ve mutlaka /v1 ile bitmelidir. OPENAI_API_KEY, API’ye erişirken kullanılan anahtardır.

Windows’ta değişkenleri kaydetmek için setx kullanın. Komutları çalıştırdıktan sonra terminali yeniden açmanız gerekir:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

Model adını OmniProxy’nin güncel listesinden eksiksiz olarak kopyalayın ve model ID’sindeki eğik çizgileri koruyun. Aider’ı başlatırken tam ID’nin başına ayrıca openai/ ekleyin.

2026-10-09 tarihinde sağlayıcı belgelerindeki iki karşılaştırma ID’si gemini-3.8-flash ve grok-4.7 idi. Bu adlar güncel listede yoksa doğrudan kopyalamayın; listede gerçekten bulunan tam ID’yi kullanın.

Adres

OPENAI_API_BASE

• OmniProxy'yi göstermeli
• /v1 ile bitmeli
• Depoya yazmayın

Anahtar

OPENAI_API_KEY

• Ağ geçidinin verdiği anahtarı kullanın
• Windows'ta değiştirdikten sonra yeniden açın
• Sağlayıcı anahtarını ağ geçidinde tutun

Başlatma

openai/model

• Proje dizinine cd ile geçin
• Model adının başına openai/ ekleyin
• Ad için ağ geçidi listesini esas alın

Araç yapılandırmasını girme

Burada ayrıca bir yapılandırma dosyası oluşturmanız gerekmez. Önce proje dizinine girin, ardından Aider’ı başlatın ve model ID’sini OmniProxy’nin güncel listesinde gerçekten bulunan adla değiştirin:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

Diğer örnek modele geçmek için şunu çalıştırın:

aider --model openai/grok-4.7

Aider’ın tanımadığı bir model kullanıldığında arayüzde bir uyarı gösterilir. Bu uyarı tek başına adresin yanlış olduğu anlamına gelmez. İsteğin ulaşıp ulaşmadığını OmniProxy’nin çağrı kayıtlarından kontrol etmeniz gerekir.

Aider, yalnızca Git tarafından zaten izlenen dosyaları bağlama ekler. Bağlam, modelin mevcut görev sırasında okuyabildiği kod ve bilgilerden oluşur. Geçerli dizin henüz bir Git deposu değilse Aider kendisi bir depo oluşturur; ancak Git tarafından izlenmeyen dosyaları yine okuyamaz. Aider’ı başlatmadan önce dosyaları git add ile ekleyip commit oluşturun.

Aider yine de dosyaları değiştirebilir. --no-auto-commits yalnızca otomatik commit oluşturmayı kapatır; dosyaların değiştirilmesini engellemez. İlk kullanımda önemli olmayan bir depo seçmeniz ve görev tamamlandıktan sonra gerçek değişiklikleri görmek için git diff çalıştırmanız önerilir.

Gerçek anahtarları proje dosyalarına veya herkese açık sayfalara yazmayın. Sağlayıcı anahtarlarını yalnızca OmniProxy’de tutun. Ağ geçidi anahtarı doğrulamıyorsa OPENAI_API_KEY için yalnızca yerel bilgisayarınızda kullanılan bir yer tutucu dize girebilirsiniz.

Gerçek bir görevle doğrulama

Önce okunacak dosyanın Git’e commit edildiğinden emin olun, ardından proje dizininde aşağıdaki komutu çalıştırın. Model ID’sini OmniProxy’nin güncel listesindeki tam ID ile değiştirmeniz gerekir:

aider --model openai/gemini-3.8-flash --message "Bu dosyanın ilk satırı nedir? Dosyayı değiştirme." --no-auto-commits

--message, Aider’a doğrudan tek bir görev vermek için kullanılır. --no-auto-commits, bu çalıştırma sırasında otomatik olarak Git commit’i oluşturulmaması anlamına gelir.

2026-10-09 tarihinde Aider v0.86.2 kullanılarak izlenen bir dosyanın ilk satırı okundu. Dosya henüz Git tarafından izlenmiyorsa Aider içeriği göremediğini söyler; bu durum API adresinin yanlış olduğu anlamına gelmez. Soru tamamlandıktan sonra isteğin kaynağını ve model ID’sini OmniProxy’nin çağrı kayıtlarından doğrulayın.

Başlatma

aider açılabiliyor

• Komut bulunabiliyor
• Ortam değişkenleri etkin
• Proje dizinindesiniz

Görev

Dosyayı inceledi

• Belirli bir dosyayı sorun
• Açıklamasını inceleyin
• Tanımadığı modeller için uyarı verir

Kayıtlar

Ağ geçidinde görünüyor

• Kaynak Aider
• Model ID eşleşiyor
• Anahtar sayfaya girilmedi

Yaygın hatalar

• aider bulunamıyor: Önce terminali yeniden açın. Doğrudan pip ile kurulum yaptıysanız python -m aider komutunu deneyebilirsiniz.
• Windows’ta değişkenleri değiştirdiğiniz hâlde hâlâ eski adrese bağlanıyor: setx komutunu çalıştırdıktan sonra terminali yeniden açmanız gerekir. Güncellenen değişkenleri yalnızca yeni pencere okur.
• Model adının başında openai/ yok: Uyumlu API için adın openai/<model-name> biçiminde yazılması gerekir.
• Tanınmayan model uyarısı gösteriliyor: Bu normal bir uyarıdır ve bağlantının başarısız olduğu anlamına gelmez. Ardından OmniProxy’nin isteği alıp almadığını kontrol edin.
• Model ID’si geçersiz: Tam ID’yi OmniProxy’nin güncel listesinden yeniden kopyalayın. openai/ ön ekini ve ID’de bulunan özgün eğik çizgileri koruyun.
• Dosya içeriğinin bulunmadığını söylüyor: Önce dosyanın Git tarafından izlendiğinden emin olun. Boş depolar veya izlenmeyen dosyalar bağlama eklenmez.

Resmî kaynaklar

Kurulum adımları için Aider installation sayfasına bakın. Ortam değişkenleri ve model ön eki için OpenAI compatible APIs sayfasına bakın. Örneklerde kullanılan model ID’lerini Gemini model listesi ve xAI model sayfası üzerinden inceleyebilirsiniz.

Tüm yer tutucuları kendi OmniProxy yapılandırmanızdaki değerlerle değiştirin. Gerçek bir anahtar asla paylaşmayın.

Kaydedilmiş bir sonuç veya yalnızca HTTP 200, tam Aracı uyumluluğunu kanıtlamaz. OmniProxy'nin çağrı kaydındaki kaynağı ve modeli kontrol edin.

Resmi kaynaklar · Aider ↗