Aider'ı Codex4Less'e Bağlama: OpenAI Uyumlu API Kurulumu

Aider, terminalde çalışan bir yapay zekâ programlama eşidir: doğal dil talimatlarıyla yerel git deponuzdaki dosyaları düzenler ve arka planda OpenAI uyumlu bir API kullanır. Bu rehber Aider'ı Codex4Less'e yönlendirir ve kurulumu gerçek bir düzenlemeyle kanıtlar — aşağıdaki komutlar canlı API üzerinde aider 0.86.2 ile birebir çalıştırılmıştır.

Aider, OpenAI uyumlu uç noktalarla standart OPENAI_API_BASE / OPENAI_API_KEY ortam değişkenleri ve --model içindeki openai/<model> öneki üzerinden konuşur. Codex4Less aynı arayüzü sunduğu için özel bir entegrasyona gerek yoktur.

Ön Koşullar

  • Python 3.10+ (Aider'ın resmî kurucusu ortamı sizin için hazırlar).
  • git — Aider en iyi bir git deposu içinde çalışır (düzenlemeleri izlemek için git kullanır; commit'ler isteğe bağlıdır).
  • Codex4Less hesabı ve API anahtarı: codex4less.com/register.
  • Bir terminal. Bu rehberdeki kurulum Linux'ta test edilmiştir; Windows komutları verilmiştir ancak test sırasında çalıştırılmamıştır (aşağıda işaretli).

Adım 1 — API Anahtarınızı Oluşturun

  1. Giriş yapın ve API Anahtarları sayfasını açın: codex4less.com/dashboard/api-keys
  2. Yeni API Anahtarı Oluştur'a tıklayın ve sk-... değerini kopyalayın — yalnızca bir kez gösterilir.
Güvenlik: Anahtarı bir ortam değişkeninde tutun (Adım 3), işlediğiniz (commit ettiğiniz) bir dosyanın içine asla koymayın. Aşağıdaki örneklerdeki sk-... bir yer tutucudur — gerçek anahtarınızı yalnızca kendi terminalinizde yazın.

Adım 2 — Aider'ı Kurun

Resmî yöntem:

bash
python -m pip install aider-install
aider-install

pip'in bulunmadığı ya da işletim sistemi tarafından yönetildiği sistemlerde uv aynı işi görür (bu rehberi destekleyen testler bu yöntemle kurulmuştur):

bash
uv tool install aider-chat
aider --version

Bu komut, yazıldığı sırada aider 0.86.2 sürümünü kurar.

Adım 3 — Ortam Değişkenlerini Yapılandırın

Aider uç noktayı OPENAI_API_BASE'den, anahtarı OPENAI_API_KEY'den okur.

macOS / Linux:

bash
export OPENAI_API_BASE="https://api.codex4less.com/v1"
export OPENAI_API_KEY="sk-..."

Kalıcı olması için aynı satırları ~/.bashrc veya ~/.zshrc dosyanıza ekleyin ve yeni bir terminal açın.

Windows (PowerShell):

powershell
$env:OPENAI_API_BASE = "https://api.codex4less.com/v1"
$env:OPENAI_API_KEY = "sk-..."

Kalıcılık için bunları PowerShell profilinize ekleyin ya da setx OPENAI_API_BASE "https://api.codex4less.com/v1" ve setx OPENAI_API_KEY "sk-..." çalıştırıp yeni bir terminal açın. (Windows adımları standart PowerShell söz dizimini izler ancak bu rehber hazırlanırken çalıştırılmamıştır.)

Adım 4 — Aider'ı Codex4Less Modeliyle Başlatın

Projenize gidin ve model adının önüne openai/ ekleyin:

bash
cd /path/to/your/project
aider --model openai/gpt-6.1-sol

Etkileşimli oturumda yapmak istediğiniz değişikliği anlatın. Betikler veya hızlı kontroller için tek mesaj da gönderebilirsiniz:

bash
aider --model openai/gpt-6.1-sol --yes --message "Fix the bug in calc.py so add(a, b) returns a + b." calc.py

--yes onay istemlerini atlar (otomasyon için kullanışlıdır); normal etkileşimli kullanımda kaldırın.

Model seçimi: Yetkili liste codex4less.com/pricing ve GET https://api.codex4less.com/v1/models adresindedir. Bu rehberde doğrulanan model gpt-6.1-sol'dir; gpt-5.6-sol de aynı API testlerine yanıt vermiştir. Aider, tanımadığı adlar için bir "model warnings" notu yazdırır — resmî uyarılar sayfasına bakın; çalışma yine de sürer.

Adım 5 — İlk İsteği Doğrulayın

Bu, rehber için birebir yapılan testtir: hatalı bir calc.py içeren yeni bir git deposunda:

python
def add(a, b):
    return a - b  # BUG: should be +
bash
aider --model openai/gpt-6.1-sol --yes --no-auto-commits \
  --message "Fix the bug in calc.py so add(a,b) returns a + b. Only change that one line." calc.py

Gözlemlenen sonuç: Aider isteği Codex4Less'e gönderdi, düzeltmeyi uyguladı ve bir özet yazdırdı:

text
Applied edit to calc.py
Tokens: 683 sent, 28 received. Cost: $0.0016 message, $0.0016 session.

Dosya artık return a + b içeriyor. İsteğin Codex4Less üzerinden geçtiğini teyit etmek için Panel → Kullanım'ı açın: codex4less.com/dashboard/usage — istek; model, token ve maliyetle birlikte görünür.

Not: Betik çalıştırmalarında Aider Warning: Input is not a terminal (fd=0). yazdırabilir — bu zararsızdır; Aider'ın etkileşimsiz çalıştığını bildirir.

Adım 6 — İsteğe Bağlı Yapılandırma Dosyası

Değişkenleri her oturumda dışa aktarmak yerine proje kökündeki bir .env dosyasında saklayabilirsiniz (Aider .env dokümanı):

text
OPENAI_API_BASE=https://api.codex4less.com/v1
OPENAI_API_KEY=sk-...

.env dosyasının .gitignore içinde olduğundan emin olun. Varsayılan seçenekler (ör. tercih ettiğiniz model) ~/.aider.conf.yml içinde durabilir:

yaml
model: openai/gpt-6.1-sol

Temel çalışan kurulumu (Adım 3–4) başlangıç noktanız yapın; ekstraları ancak akış çalıştıktan sonra ekleyin.

Sorun Giderme

Kimlik doğrulama hataları (401 / invalid API key)

  • OPENAI_API_KEY tam sk-... anahtarını içermelidir. echo $OPENAI_API_KEY ile kontrol edin (ortak ekranlarda tam değeri yazdırmayın).
  • Ortam değişkenleri terminale özeldir; Windows'ta setx sonrası yeni bir terminal açın.

404 veya uç nokta hataları

  • OPENAI_API_BASE tam olarak https://api.codex4less.com/v1 olmalıdır. /chat/completions ekini Aider kendisi ekler — base'e uç nokta yolu eklemek 404 üretir.
  • Uç noktayı hızlıca doğrulayın: curl https://api.codex4less.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY".

Model uyarıları / “unknown model”

Aider, kendi iç listesinde tanımadığı model adları için uyarı verir. İstek yine de OpenAI uyumlu yol üzerinden çalışır. Tekrarlayan düzenleme biçimi hataları görürseniz --edit-format whole deneyin (bu rehberdeki başarılı testte kullanılan biçim budur) ve görevi küçük tutun.

Git kimlik uyarısı

Git'te user.name/user.email tanımlı değilse Aider uyarı yazdırır. Ya git'i yapılandırın (git config user.name "...") ya da burada test edilen mod olan --no-auto-commits ile devam edin.

Düzenlemeler uygulanmıyor

  • Aider'ın hedef dosyaları sohbette görmesi gerekir: komut satırında verin (calc.py) veya etkileşimli olarak ekleyin.
  • Bir model düzenleme biçimini sürekli başaramıyorsa gpt-6.1-sol'e geçin ve daha küçük bir talimatla yeniden deneyin.

SSS

Aider ile özel bir OpenAI uyumlu uç nokta kullanabilir miyim? Evet — OPENAI_API_BASE tam bunun içindir. Resmî OpenAI compatible APIs sayfasına bakın.

API anahtarımı nerede saklamalıyım? OPENAI_API_KEY içinde (kabuk ortamı ya da git'e girmeyen bir .env). Asla commit etmeyin.

Aider Codex4Less'e karşı hangi API biçimini kullanır? OpenAI chat completions arayüzünü: POST https://api.codex4less.com/v1/chat/completions. Bu rehberde doğrulanan akış tam olarak bu yolu kullandı. Codex4Less tüm API'yi dokümantasyonda belgeler.

Aider function calling / tool kullanır mı? Hayır — Aider düzenlemeleri, modelin yapılandırılmış düzenleme blokları (whole-file veya diff biçimleri) üretmesi ve bunların yerelde ayrıştırılıp uygulanmasıyla yapar. Bu akış yukarıda uçtan uca doğrulanmıştır.

Model kimliğim çalışmayı bırakırsa ne yapmalıyım? Güncel kimliği codex4less.com/pricing veya GET /v1/models adresinden kopyalayın ve --model değerini güncelleyin.

Sonuç ve Çağrı

Aider, Codex4Less'e tek bir ortam değişkeni uzağındadır: OPENAI_API_BASE değerini https://api.codex4less.com/v1 yapın, anahtarınızı ekleyin ve --model openai/gpt-6.1-sol kullanın. Yukarıdaki düzenle-ve-doğrula akışı canlı çalıştırıldı; başlangıç noktası olarak kopyalayabilirsiniz.

Başlamaya hazır mısınız?

Codex4Less hesabınızı oluşturun, bir API anahtarı üretin ve ilk Aider düzenlemenizi bir Codex4Less modeliyle çalıştırın.

Hesabınızı oluşturun →

İlgili yazılar: Cline + Codex4Less kurulumu · Codex CLI'ı Codex4Less ile Kullanma · API dokümantasyonu