Dokümantasyon

Aider

Aider, OPENAI_API_BASE ve OPENAI_API_KEY değerlerini okur. Bunları Kunavo'ya yönlendirin, model kimliğinin başına openai/ ekleyin; Claude ve GPT arasında geçiş yapmak için yalnızca --model bağımsız değişkenini değiştirmeniz yeterlidir.

İki ortam değişkeni ve bir önek. OPENAI_API_BASE değerini https://api.kunavo.com/v1 olarak, OPENAI_API_KEY değerini sk-kn-… anahtarınız olarak ayarlayın; ardından Aider'ı --model openai/<id> ile çalıştırın. Depoda veya Aider kurulumunda hiçbir şeyi değiştirmeniz gerekmez.

~/.zshrc

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

openai/ öneki zorunludur ve /v1 soneki temel URL'de bulunmalıdır. Öneki kaldırırsanız Aider kimliği kendi sağlayıcı tablosunda çözümlemeye çalışır ve “unknown model” hatası verir; /v1 öğesini kaldırırsanız istek doğru rotaya ulaşmaz.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Aider'ı başlattığınız kabukta OPENAI_API_BASE ve OPENAI_API_KEY değerlerini dışa aktarın ya da aşağıda gösterildiği gibi ~/.aider.conf.yml dosyasına ekleyin.
Deponuzda aider --model openai/claude-sonnet-5 ile Aider'ı başlatın.
Aider başlangıçta çözümlenen modeli yazdırır. Bu satırda istediğiniz kimlik görünüyorsa uç nokta bağlantısı hazırdır.

Bunun için Aider'ın kendi başvuru kaynağı olan OpenAI uyumlu API'ler sayfasına bakın.

Kabuk profilinizde tutmama

Aynı iki değer Aider'ın yapılandırma dosyasında da bulunabilir. Projeye göre farklı uç noktalar arasında geçiş yapıyorsanız bu dosya daha uygun yerdir.

~/.aider.conf.yml

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

Aider'da hata ayıklamadan önce doğrulayın

Tek bir istek, sorunun uç noktada mı, anahtarda mı yoksa Aider'ın model çözümlemesinde mi olduğunu belirler. Bu istek bir JSON model kimlikleri listesi döndürüyorsa Aider'da aynı temel URL ve anahtar çalışır — geriye kalan tek hata openai/ önekiyle ilgilidir.

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Hangi modelleri seçmeli?

Kunavo'daki her metin modeline openai/<id> olarak erişilebilir — tam liste modeller sayfasında bulunur ve güncel liste GET /v1/models üzerinden alınabilir. Ücretler 1 milyon token başına USD cinsindendir; girdi / çıktı.

Model kimliği	Kunavo giriş / çıkış	Kullanım alanı
`claude-haiku-4-5`	$0.70 / $3.50	En ucuz Claude modeli — Aider'ın depo haritası ve commit mesajı çağrıları için uygun
`claude-sonnet-5`	$1.40 / $7.00	Düzenleme için kalite ve fiyat arasında varsayılan denge
`claude-opus-5`	$3.50 / $17.50	En yüksek kaliteli Claude katmanı — mimari düzeyde değişiklikler
`gpt-5-6-terra`	$0.70 / $4.20	Aynı anahtar, farklı model ailesi — zorlu bir diff için ikinci görüş olarak kullanışlı

Aider her ileti alışverişinde depo haritasını ve düzenlenen dosyaları yeniden gönderir; bu nedenle token harcaması düzenlemenin büyüklüğünden çok bağlamın büyüklüğüne bağlıdır. Bu da istem önbelleğe almayı burada en etkili araç, --model ve --weak-model openai/claude-haiku-4-5 öğelerini ise en ucuz ikili hâline getirir: güçlü model düzenlemeleri yapar, zayıf model commit mesajlarını ve özetleri yazar. Faturalandırma, aylık ücret olmadan ön ödemeli bakiyeden token başına yapılır — ayrıntılar için faturalandırma sayfasına bakın.

Sık sorulan sorular

Aider'ı OpenAI uyumlu bir API ile nasıl kullanırım?

OPENAI_API_BASE değerini uç noktanın temel URL'sine, OPENAI_API_KEY değerini anahtarınıza ayarlayın; ardından model kimliğinin başına openai/ ekleyerek Aider'ı başlatın — örneğin `aider --model openai/claude-sonnet-5`. Kunavo için temel URL https://api.kunavo.com/v1'dir. Önek isteğe bağlı değildir: önek olmadan Aider, kimliği uç noktanıza göndermek yerine kendi sağlayıcı tablosunda çözümlemeye çalışır.

Aider, OpenAI uyumlu bir uç nokta üzerinden Claude modellerini kullanabilir mi?

Evet. Aider, OPENAI_API_BASE değerinin gösterdiği hizmetle OpenAI protokolü üzerinden konuşur; bu nedenle bu biçimde sunulan bir Claude modeline Anthropic kimlik bilgileri olmadan erişilebilir — model kimliği, /v1/models listesindeki diğer dizelerden biridir. Kunavo'da Claude ve GPT kimliklerinin tümü aynı anahtarın arkasındadır; bu yüzden aralarında geçiş yapmak için yapılandırmayı değiştirmek yerine --model bağımsız değişkenini değiştirmeniz yeterlidir.

Aider neden modelin bilinmediğini söylüyor?

Neredeyse her zaman openai/ önekinin eksik olmasından kaynaklanır. Aider, yalın bir kimliği tanıması gereken bir model olarak görür ve tanımadığında hata verir; `openai/<id>` ise kimliği doğrudan OPENAI_API_BASE adresine iletmesini söyler. İkinci en yaygın neden, /v1 soneki olmayan bir temel URL'dir; bu, bilinmeyen model hatası yerine bağlantı veya 404 hatasına yol açar.

Aider oturumun maliyetini gösterir mi?

Aider, kendi model meta verilerinden hesapladığı token sayılarını ve her ileti alışverişi için tahmini maliyeti yazdırır — özel bir uç noktada bu tahmin yanlış olabilir; çünkü Aider uç noktanızın ücretlerini bilmez. Token sayılarını güvenilir bilgi olarak kabul edin ve gerçek ücreti sağlayıcınızdan kontrol edin. Kunavo'da istek başına maliyet kullanım görünümünde yer alır; ön ödemeli bakiyeden düşülür ve aylık ücret alınmaz.