Aider'ı OpenAI uyumlu bir API base'ine yönlendirin.

Hızlı yanıt: iki ortam değişkeni ve bir model ön eki.

Aider'ın belgelenmiş OpenAI uyumlu yolu tam olarak budur: endpoint'inizle OPENAI_API_BASE'i, ona ait anahtarla OPENAI_API_KEY'i dışa aktarın ve model adının önüne openai/ ekleyerek Aider'ın o base'e chat-completions protokolüyle konuşmasını sağlayın. Ön ekten sonraki dize endpoint'e olduğu gibi iletilir, bu yüzden gateway'in sunduğu her id oyuna dahildir, Claude ve DeepSeek id'leri de buna dahil. Bağlantının tamamı budur. Mac ve Linux'ta export kullanın; Windows'ta setx kullanın ve yeni bir shell açın, çünkü setx mevcut oturumu etkilemez. Aynı değerler, shell durumu yerine proje başına yapılandırmayı tercih ederseniz Aider'ın yapılandırma dosyasında veya bir .env dosyasında da yaşayabilir.

export OPENAI_API_BASE=https://api.apisrouter.com/v1
export OPENAI_API_KEY=sk-APIsRouter-...

aider --model openai/claude-sonnet-4-6

Aider modelleri ve sağlayıcıları nasıl çözer.

Aider (GitHub'da Aider-AI, kabaca 47K yıldız), orijinal terminal pair programmer'dır: git deponuzu haritalar, sohbette değişiklik isteklerini alır, dosyaları doğrudan düzenler ve sonucu commit'ler. Perde arkasında model çağrılarını litellm üzerinden yönlendirir; openai/ ön ekinin önemli olmasının nedeni de budur: litellm, bir sağlayıcı protokolü seçmek için ön eki okur ve openai/, "OPENAI_API_BASE'in söylediği her neyse ona karşı chat-completions" anlamına gelir. Ön eksiz bir model adı, bunun yerine yazılışından sağlayıcı çıkarımı yapılır; bu da bir Claude id'sini APIsRouter anahtarınız yerine Anthropic'in yerel API'sine ve ANTHROPIC_API_KEY'inize yönlendirir. İlk oturumunuzdan önce bilmeye değer, Aider'a özgü bir davranış var: kendi model yetenekleri kaydını tutar ve tanımadığı bir model "Unknown context window size and costs, using sane defaults" uyarısını tetikler; bundan sonra Aider sınırsız bir bağlam penceresi ve sıfır maliyet varsayar. Oturum yine de çalışır, ama iki yararlı alt sistem bozulur: token bütçelemesi, gerçek bağlam sınırını aşmadan önce sizi uyaramaz ve oturum içi maliyet göstergesi sıfır okur. Düzeltme, aşağıda ele alınan küçük bir metadata dosyasıdır ve iki dakikaya değer. Aider ayrıca oturum başına birden fazla model çalıştırır. Main model kodlamayı yapar; weak model commit mesajlarını ve sohbet özetlemesini ele alır; ve architect modunda, ayrı bir editor model planı uygular. Her biri aynı openai/ ön ekini kabul eder, bu yüzden üçü de tek bir anahtar üzerinden gateway'den geçebilir.

Tam kurulum: bağlantı artı model metadata'sı.

Bağlantı yukarıdaki iki değişkendir. İncelik, Aider'ın gateway modellerini bilinen büyüklükler olarak değerlendirmesi için metadata kaydetmektir. Ev dizininizde, git deposu kökünde veya çalışma dizininde (veya --model-metadata-file geçirerek) .aider.model.metadata.json oluşturun; openai/ ön eki dahil tam nitelikli adla anahtarlanmış olarak; litellm_provider alanı o ön ekle eşleşmelidir. max_input_tokens kaydedildiğinde, Aider'ın bağlam bütçelemesi sınırsız varsaymak yerine modelin gerçek penceresine karşı çalışır. İkinci, isteğe bağlı bir dosya olan .aider.model.settings.yml, model başına davranışı ayarlar: edit_format, Aider'ın kod değişikliklerini nasıl istediğini kontrol eder (bunları ele alan modeller için diff varyantları, ele almayanlar için whole-file) ve use_repo_map, repo-bağlamı dahil edilmesini kontrol eder. Aider, tanımadığı bir model için en iyi düzenleme formatını çıkaramaz, bu yüzden bunu bildirmek, bir modelin vasat görünmesi ile kendi seviyesinde performans göstermesi arasındaki farktır.

{
  "openai/claude-sonnet-4-6": {
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "openai/deepseek-v4-pro": {
    "max_input_tokens": 128000,
    "max_output_tokens": 16000,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Main, weak ve editor modellerini seçmek.

Aider oturumları uzun ve yinelemelidir, bu da model karşılaştırmasını burada alışılmadık derecede dürüst kılar: aynı özellik dalını iki main modelle farklı günlerde çalıştırın ve fark, ne sıklıkla /undo yazdığınızda ortaya çıkar. Tek bir endpoint her adayı bir bayrak değişikliği yapar ve anahtar başına kullanım her deneyi fiyatlandırır.

• Main model her düzenlemeyi taşır. Repo haritasını okur, dosyalarınız üzerinde akıl yürütür ve diff'ler üretir, bu yüzden claude-sonnet-4-6 veya gpt-5.5'in yeri burasıdır; diff sözdizimini beceremeyen bir model, her değişiklikte size inceleme zamanı kaybettirir.
• Weak model (--weak-model) commit mesajları yazar ve sohbet geçmişini özetler. Sürekli ateşlenir ve koda hiç dokunmaz, bu yüzden başka bir yere varsayılan olarak bırakmak yerine onu aynı gateway üzerinden hızlı, düşük fiyatlı bir id'ye yönlendirin.
• Architect modu planlamayı düzenlemeden ayırır: main model planlar, editor model (--editor-model) uygular. Güçlü bir muhakemecinin planlayıp kimi-k2.7-code gibi kodlamaya ayarlı bir id'nin uygulaması, tek satıcı anahtarlarının ifade edemeyeceği bir eşleşmedir.
• deepseek-v4-pro ve gpt-5.4, refactor ağırlıklı işlerde günlük sürücü main model olarak benchmark'lanmaya değer; burada oturum başına token hacmi fiyat farkını katlar.

Kullandıkça öde · resmi fiyatların altında

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Aider'a özgü hata modları.

"Sane defaults"a güvenmek. Bilinmeyen-model geri dönüşü sınırsız bağlam ve sıfır maliyet varsayar. Pratikte bu, gateway isteği reddedene veya model sessizce erken bağlamı kaybedene kadar Aider'ın uzun bir oturumun modelin gerçek penceresini aşarak büyümesine izin vereceği anlamına gelir ve maliyet takipçisi tüm süre boyunca hiçbir şey göstermez. Metadata'yı kaydedin; her iki sorun da ortadan kalkar. openai/ ön ekini düşürmek. Onsuz litellm sağlayıcıyı model adından çıkarır. Claude id'leri Anthropic'in API'sine yönelir ve eksik bir ANTHROPIC_API_KEY üzerinde başarısız olur; bu, bir ön ek sorunuyken bir anahtar sorunu gibi okunur. Eşleşmeyen metadata. .aider.model.metadata.json'daki girdiler, ön ek dahil tam nitelikli adla anahtarlanır ve litellm_provider o ön ekle uyuşmalıdır. Çıplak bir id anahtarı veya uyuşmayan bir sağlayıcı alanı sessizce uygulanmaz ve bunu söyleyen bir hata olmadan varsayılanlara geri dönmüş olursunuz. Windows shell durumu. setx değişkeni yalnızca gelecekteki shell'ler için yazar. aider'ı az önce setx çalıştırdığınız terminalde çalıştırmak eski ortamı kullanır ve ortaya çıkan 401, bir kimlik bilgisi sorunu değil bir shell yaşam döngüsü sorunudur. Yanlış düzenleme formatı. Kaydedilmemiş bir model, en iyi ele aldığı format olmayabilecek varsayılan bir düzenleme formatı alır. Güçlü bir model Aider'ın reddettiği düzenlemeler üretmeye devam ederse, modelin kod yazamadığı sonucuna varmadan önce .aider.model.settings.yml'de edit_format'ı açıkça ayarlayın.

Aider'ı bir gateway üzerinden kim yönlendirir.

• Claude, GPT ve DeepSeek'i --model ile oturum başına değiştirilebilir isteyen, her model ailesi için bir satıcı hesabı sürdürmeden günlük Aider kullanıcıları.
• Bir sınır model ana modeli ile commit mesajları için hızlı bir weak model eşleştiren, ikisi de tek bir anahtara oturum başına görünürlükle faturalandırılan geliştiriciler.
• Aynı oturumda farklı satıcılardan bir planlama modeli ve bir düzenleme modelini karıştıran architect-modu kullanıcıları.
• Bir satıcı-anahtarı kontrol listesi yerine tek bir sırla mühendisleri işe alan, harcama raporu olarak anahtar başına kullanımı olan ekipler.
• Belirli bir satıcının faturalandırmasına erişimi olmayan geliştiriciler. Kart gerektirmeyen yükleme tabanlı erişim, sağlayıcı başına kayıt bağımlılığını ortadan kaldırır.

Endpoint'i doğrulayın ve ilk oturumu hata ayıklayın.

Başlamadan önce gateway'in modellerini listeleyin; openai/'den sonraki id, sürüm sonekleri dahil, sunulan bir id ile tam olarak eşleşmelidir. İlk oturum başarısızlıkları hızla sıralanır. 401, OPENAI_API_KEY'in aider'ı başlatan shell'e görünür olmadığı anlamına gelir (Windows'ta setx sonrası yalnızca yeni shell'ler; aynı terminalde echo ile kontrol edin). Gateway'den bir model-not-found hatası bir id yazım hatasıdır. Farklı bir satıcının anahtarından bahseden bir hata, ön eksiz bir model adının yerel olarak yönlendirildiği anlamına gelir. Ve başlangıçtaki bilinmeyen-model uyarısı bir hata değildir, ama gerçek bağlam sınırına çarpandan sonra değil, uzun bir oturumdan önce metadata dosyasını eklemeniz için bir işarettir. Oturum içinde, metadata kaydedildikten sonra Aider'ın kendi token ve maliyet okuması doğru hale gelir ve APIsRouter konsolu aynı oturumları endpoint tarafından gösterir: istek başına model, token sayıları ve harcama. Gün boyu bir pair programmer için, bu anahtar başına görünüm, bir haftalık Aider'ın gerçekte neye mal olduğunun dürüst yanıtıdır.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | head -50

Sık sorulan sorular