Bloga dön

Araçlar ve entegrasyonlarKılavuz

Kendi API anahtarınız için Aider yapılandırma dosyası: .aider.conf.yml ve Windows setx

Kendi API anahtarınızı ve temel URL'nizi .aider.conf.yml içinde tutun, yüklenme sırasını doğru yapın ve Windows setx tuzağından kaçının, bir oturum maliyet tahminiyle birlikte.

Yazan: CheapTokens TeamYayınlanma tarihi: 3 dk okuma

Aider'ı OpenAI uyumlu bir API'ye bağlayan komutlarla terminal
Bu sayfada
  1. Windows: setx ve yeni bir terminal
  2. Hangi düzenleme için hangi model
  3. İlk düzenlemeyi çalıştırın
  4. Yeniden yazmayı bırakın: .aider.conf.yml
  5. Bir oturumun maliyeti
  6. Çalışmazsa

İki değişken, OPENAI_API_BASE ve OPENAI_API_KEY, ve openai/<model id> gibi bir model argümanı Aider'ı CheapTokens'e yönlendirmek için yeterlidir. Adım adım temel bilgiler (kurulum, ilk istek, 401/404/400/402) Aider'ı CheapTokens'e nasıl bağlarsınız sayfasında; bu sayfa o kılavuzun atladıklarını kapsar: Windows setx, yapılandırma dosyası ve yüklenme sırası ve bir oturum maliyet tahmini.

Kaynak: Aider'ın OpenAI uyumlu API'ler için dokümantasyonu (sayfa 26 Ekim 2026'da kontrol edildi; dokümantasyonda tarih veya sürüm belirtilmiyor ve o gün PyPI'daki en son aider-chat 0.86.2'ydi).

Windows: setx ve yeni bir terminal#

Mac ve Linux'ta iki değişkeni export. Windows'ta (PowerShell veya cmd) setx kullanın:

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

Windows'ta bir püf noktası var. setx değişkenleri gelecek oturumlar için yazar, şu anda yazdığınız oturum için değil, bu yüzden Aider'ı başlatmadan önce terminali kapatıp yeni bir tane açın. Değişkenleri ayarlayıp Aider hâlâ anahtar istiyorsa, genellikle sebep budur.

Hangi düzenleme için hangi model#

Model argümanı openai/ artı tam kimliktir, yani CheapTokens için iki eğik çizgi vardır:

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7 180K bağlama sahiptir ve 8.192 token'a kadar yanıt verir; yanıtların kısa kaldığı küçük ve orta düzenlemeler için uygundur. Düzenlemeleriniz uzun diff'ler olarak dönerse, denemeye değer diğer model DeepSeek-V4-Flash'tir: yanıt başına 32.768 token'a kadar, 380K bağlam ve günün her saatinde tek fiyat.

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

Tam kimliği CheapTokens dokümantasyonundan veya fiyatlandırma sayfasındaki model listesinden kopyalayın.

İlk düzenlemeyi çalıştırın#

Aider bir git deposu içinde çalışır, bu yüzden bir tanesinde başlayın. Bir dosya ekleyin ve küçük bir şey isteyin:

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

Aider dosyaya bir düzenleme ile yanıt verdiğinde, anahtar, temel URL ve model kimliği doğrudur.

Çalışan tam kimliğin yanında yanlış model kimliği, ardından ilk düzenleme
Yanlış kimlik ile tam kimlik ve ilk istek

Yeniden yazmayı bırakın: .aider.conf.yml#

Aider .aider.conf.yml dosyasını önce ana dizininizden, sonra git deposu kökünden, sonra geçerli dizinden okur ve sonraki dosyalar kazanır. Yani global bir dosya anahtarı ve temel URL'yi tutabilir, bir depo dosyası da modeli seçebilir. Yalnızca belirli bir dosyayı ve başka hiçbir şeyi istiyorsanız, aider --config <file> yalnızca onu yükler.

Ana dizin dosyası (örnek, kendi anahtarınızı koyun):

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

Artık aider tek başına doğru uç nokta ve modelle başlar. Dosyayı bir depoya işlerseniz, anahtarı dışarıda bırakın ve ortam değişkeninde veya bir .env dosyasında tutun; anahtar satırları kendi ana dizininiz içindir.

Aider'ın bilmediği bir model için dokümantasyon, ayarlarını belirleyebileceğiniz bir model-settings-file (.aider.model.settings.yml) tanımlar.

Bir oturumun maliyeti#

Aider eklediğiniz dosyaları ve sohbet geçmişini her mesajla yeniden gönderir, bu yüzden girdi token'ları çıktıdan daha hızlı büyür. Diyelim ki yaklaşık 20 mesajlık bir çalışma oturumu 400.000 girdi token'ı gönderiyor ve 40.000 çıktı token'ı alıyor (örnek için bir varsayım; kendi sayılarınızı koyun). MiniMax-M2.7'de bu $0.026 eder ve girdi ile çıktı birlikte sayıldığında toplamda OpenRouter'dan daha ucuzdur. Aşağıdaki tablo aynı oturumu modellerimiz genelinde çalıştırır:

Model Maliyet OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

Toplamda 400.000 giriş ve 40.000 çıkış token'ı. 1M token başına fiyatlar günceldir ve tarifelerimizle birlikte değişir; OpenRouter sütunu aynı iş yükü için referans fiyatları gösterir.

Girdi tarafını nasıl küçük tutacağınız (salt okunur dosyalar, /drop, depo haritası boyutu) Aider ne kadar maliyetli sayfasında ele alınmıştır. Güncel fiyatlar her zaman fiyatlandırma sayfasındadır.

Çalışmazsa#

  • Aider bir API anahtarı istiyor veya yanlış hizmetle konuşuyor. Değişkenler süreç tarafından görülmüyor. Windows'ta setx sonrasında terminali yeniden başlatın; Mac ve Linux'ta aynı kabukta echo $OPENAI_API_BASE çalıştırın.
  • Yapılandırmanız yok sayılıyor gibi görünüyor. Sırayı hatırlayın: ana dizin, depo kökü, geçerli dizin. Size daha yakın bir dosya global olanı geçersiz kılar.
  • Model bulunamadı, 404 veya bir kimlik doğrulama hatası. Bunlar Aider'ı CheapTokens'e nasıl bağlarsınız sayfasında ele alınmıştır.

Aynı OpenAI uyumlu adres diğer araçlarda da çalışır; bir editör ajanı da kullanıyorsanız, OpenCode'u bağlama veya kendi API anahtarınızı nereye takacağınız genel bakışına bakın.

Etiketler: