Cursor Türkiye API Rehberi: AI Kod Asistanlarını (Cursor, Cline, Continue.dev, aider) Tek Anahtarla Kullanmak

OpenAI-uyumlu özel base_url destekleyen tüm AI kod asistanları — Cursor, Cline, Continue.dev ve aider — Onysoft AI Gateway ile çalışır: araç ayarlarında base_url alanına https://api.onysoft.com/v1, anahtar alanına sk-ony- anahtarınızı yazmanız yeterlidir. Claude Code ise Anthropic-native protokol gerektirdiğinden doğrudan bağlanamaz; aynı Claude modellerine Cursor veya Cline üzerinden erişebilirsiniz.

Kod asistanları API tüketiminin en hızlı büyüyen kalemi haline geldi: her sohbet, her düzenleme ve her agent adımı arka planda bir API isteğidir. Türkiye'den çalışan geliştirici için sorun iki katmanlı — hem araçların abonelik/API ödemeleri yabancı kart ister, hem de hangi isteğin kaça mal olduğunu görmek zordur.

Bu rehberde dört aracın kurulumunu adım adım veriyor, Claude Code sorusuna dürüst cevap veriyor ve bu sorguda başka yerde bulamayacağınız veriyi paylaşıyoruz: gerçekçi bir geliştirici senaryosunun model model TL maliyeti, her yanıtta dönen cost alanı ve son 14 günün 6.959 istekten ölçülmüş gecikme verileri.

Hangi AI Kod Asistanları Onysoft ile Çalışır?

Özel API anahtarı ve base_url değişikliğini destekleyen her araç çalışır; belirleyici tek soru, aracın isteklerini OpenAI chat/completions şemasıyla atıp atmadığıdır. Onysoft bu şemayı birebir sunduğu için "OpenAI Compatible" ya da "Override Base URL" seçeneği olan her araç, katalogdaki 739+ modelin tamamına tek sk-ony- anahtarıyla erişir. Durum tablosu:

Araç	Özel base_url	Ayar yeri	Onysoft ile durum
Cursor	Var ("Override OpenAI Base URL")	Settings → Models → API Keys	Çalışır (Tab tamamlama hariç, aşağıda)
Cline (VS Code)	Var ("OpenAI Compatible" sağlayıcı)	Eklenti ayarları	Çalışır
Continue.dev	Var (apiBase)	config.yaml	Çalışır
aider (terminal)	Var (OPENAI_API_BASE)	Ortam değişkeni / bayrak	Çalışır
Claude Code	Yok (Anthropic-native protokol)	—	Doğrudan çalışmaz (dürüst bölüm aşağıda)

Kod asistanlarının vazgeçilmezi olan streaming de kapsamdadır: yanıtlar SSE ile akışlı gelir, ilk token editörünüzde erken belirir. Genel base_url geçiş mantığı için OpenAI SDK geçiş rehberi temel referanstır.

Araç Araç Kurulum: Cursor, Cline, Continue.dev ve aider

Dört araçta da kurulum aynı üç bilgiye iner: base_url (https://api.onysoft.com/v1), sk-ony- anahtarınız ve katalogdaki model adı. Araç araç adımlar:

Cursor: Cursor Settings → Models → API Keys bölümüne gidin. OpenAI API Key alanına sk-ony- anahtarınızı yapıştırın, hemen altındaki Override OpenAI Base URL seçeneğini açıp https://api.onysoft.com/v1 yazın ve Verify'a tıklayın. Model listesine + Add model ile katalogdaki adı (örneğin anthropic/claude-sonnet-5) ekleyin. Dürüst not: Cursor'ın kendi özel modellerine dayanan özellikleri — başta Tab tamamlama — özel anahtarla çalışmaz; özel anahtar sohbet ve Composer tarafında geçerlidir.

Cline: VS Code'da eklenti ayarlarını açın, API Provider olarak OpenAI Compatible seçin. Base URL: https://api.onysoft.com/v1, API Key: sk-ony- anahtarınız, Model ID: katalogdaki ad. Cline'ın agent modu da aynı uç üzerinden akar; maliyet tarafına aşağıda ayrıca değineceğiz.

Continue.dev: config.yaml dosyanıza bir model bloğu eklemeniz yeterli:

models:
  - name: Claude Sonnet 5 (Onysoft)
    provider: openai
    model: anthropic/claude-sonnet-5
    apiBase: https://api.onysoft.com/v1
    apiKey: sk-ony-ANAHTARINIZ

aider: Terminal tabanlı bu ajan, OpenAI-uyumlu uçları ortam değişkeniyle tanır:

export OPENAI_API_BASE=https://api.onysoft.com/v1
export OPENAI_API_KEY=sk-ony-ANAHTARINIZ
aider --model openai/anthropic/claude-sonnet-5

Buradaki openai/ öneki aider'a "bu modeli OpenAI-uyumlu uca gönder" der; önekten sonrası Onysoft katalogundaki model adıdır. Aynı önekle katalogdaki herhangi bir modeli — openai/deepseek/deepseek-v4-flash gibi — kullanabilirsiniz.

Claude Code için Dürüst Cevap: Doğrudan Çalışmaz

Claude Code, Anthropic'in kendi native protokolünü (/v1/messages) konuşur ve OpenAI-şemalı gateway'lerle — Onysoft dahil — doğrudan çalışmaz. Onysoft ucu OpenAI chat/completions şemasını sunar; Anthropic-native protokol ise farklı istek ve yanıt gövdesi kullanır. Bu yüzden Claude Code'da base_url değiştirmek yeterli olmaz ve bunu size "çalışıyor gibi" pazarlamayacağız.

Mimari olarak iki dürüst yol var:

• Aynı modeller, farklı arayüz: Claude Code'un kullandığı modellerin kendisi — anthropic/claude-sonnet-5 ve anthropic/claude-opus-5 — Onysoft katalogunda mevcut. Cursor, Cline veya Continue.dev üzerinden aynı modellerle, TL bakiyeyle ve istek bazlı maliyet dökümüyle çalışabilirsiniz. Terminal ajanı arıyorsanız aider en yakın ikamedir.
• Hibrit kullanım: Claude Code'u kendi aboneliğiyle sürdürün; üretim API'nizi, otomasyonlarınızı ve diğer araçlarınızı Onysoft'tan yürütün. İki katman birbirini dışlamaz.

Claude modellerinin Türkiye'den API ile kullanımına dair genel çerçeve için Claude API Türkiye rehberine bakın.

Onysoft'ta Nasıl Çalışıyor: Tek Anahtar, Araç Bazlı Limit ve Her Yanıtta cost Alanı

Kurulumun doğrulaması ve maliyet takibi, araca girmeden önce iki curl komutuyla görülebilir. Önce anahtar ve ucu test edin — /v1/models katalogdaki tüm modelleri listeler:

curl https://api.onysoft.com/v1/models \
  -H "Authorization: Bearer sk-ony-ANAHTARINIZ"

Araç bağlandıktan sonra attığı her istek, standart usage bloğuna ek olarak Onysoft'a özgü cost alanıyla döner:

{
  "model": "anthropic/claude-sonnet-5",
  "choices": [ ... ],
  "usage": { "prompt_tokens": 4000, "completion_tokens": 1000 },
  "cost": 0.027
}

Buradaki 0,027 $ tahmin değil, bakiyenizden düşülen gerçek tutardır: 4.000 girdi tokeni × 3 $/1M + 1.000 çıktı tokeni × 15 $/1M. Cline gibi araçların kendi maliyet tahminleri yaklaşıktır; cost alanı gateway'in kestiği kesin rakamı verir.

Çok araçlı kullanımda iki koruma katmanı daha var:

• Anahtar bazlı limitler: Her araca ayrı anahtar üretin (biri Cursor'a, biri Cline'a) ve anahtara harcama limiti tanımlayın. Panelde hangi aracın ne yaktığı ayrı ayrı görünür.
• Maliyet ön-kontrolü: Her istek işlenmeden önce tahmini maliyet 1,2 güvenlik katsayısıyla bakiyenize karşı kontrol edilir; bakiye yetmiyorsa istek 402 ile reddedilir. Bir agent döngüsü bakiyenizi sessizce eksiye süremez.

Kod Asistanı Ayda Kaç TL Tutar? Gerçekçi Senaryo Hesabı

Günlük aktif bir geliştirici için gerçekçi taban senaryo — günde 50 istek, istek başına yaklaşık 4.000 girdi + 1.000 çıktı tokeni, ayda 22 iş günü — Claude Sonnet 5 ile ayda 29,70 $, yani yaklaşık 1.412 TL eder. Girdinin yüksekliği tesadüf değil: kod asistanı isteği kısa bir soru değildir; sistem istemi, açık dosya içeriği ve diff bağlamı birlikte girer. Senaryonun aylık toplamı 4,4M girdi + 1,1M çıktı tokenidir; model model hesap:

Model	Girdi maliyeti ($/ay)	Çıktı maliyeti ($/ay)	Toplam ($/ay)	Toplam (TL/ay)
anthropic/claude-opus-5	$33.00	$41.25	$74.25	3.530,96 TL
anthropic/claude-sonnet-5	$13.20	$16.50	$29.70	1.412,38 TL
google/gemini-3.6-flash	$9.90	$12.38	$22.28	1.059,29 TL
openai/gpt-5.6-terra	$6.60	$9.90	$16.50	784,66 TL
openai/gpt-5.6-luna	$0.66	$0.99	$1.65	78,47 TL
deepseek/deepseek-v4-flash	$0.92	$0.46	$1.39	65,91 TL

Ölçüm: 5 Ağustos 2026 — api.onysoft.com canlı katalog satış fiyatları. Senaryo: 22 iş günü × 50 istek × (4.000 girdi + 1.000 çıktı token) = 4,4M girdi + 1,1M çıktı. TL karşılıkları 5 Ağustos 2026 TCMB kuru (1 USD = 47,555 TL) ile hesaplanmıştır.

İki uyarı: birincisi, agent modları (Cline'ın otonom döngüsü, aider'ın çok adımlı düzenlemeleri) tek görev için birden çok istek attığından tüketim bu tabanın katlarına çıkabilir — tam da bu yüzden cost alanıyla izleyip anahtar limitiyle sınırlamak gerekir. İkincisi, tablodaki yaklaşık 54 kat fark (65,91 TL ile 3.530,96 TL arası) model seçiminin faturayı belirleyen asıl karar olduğunu gösterir: rutin düzenlemeler için ekonomik sınıf, zor refactor için amiral. Seçimi gateway'e bırakmak isterseniz model alanına onysoft/auto yazın — OnyRouter isteği analiz edip uygun sınıfa yönlendirir, yönlendirme ücretsizdir. Kendi senaryonuzu maliyet hesaplayıcıda kurabilirsiniz.

Hız Ne Durumda? Gerçek Gecikme Verisi ve Pratik Öneriler

Son 14 günde gateway üzerinden geçen 6.959 başarılı istekte uçtan uca ortalama yanıt süresi 3,8 saniye, en hızlı yanıt 0,3 saniye ölçüldü — kod asistanı deneyiminde belirleyici olan gateway katmanı değil, seçtiğiniz modelin üretim hızıdır. 0,3 saniyelik taban hafif modellerle katmanın ne kadar inceldiğini gösterir; 3,8 saniyelik ortalamayı yukarı çeken, uzun üretim yapan amiral ve muhakeme istekleridir. Streaming sayesinde ilk token her durumda çok daha erken gelir.

Pratik öneriler:

• Hızlı düzenleme ve kısa sorular: openai/gpt-5.6-luna veya deepseek/deepseek-v4-flash — saniye altı sınıf, ayda 100 TL altı maliyet.
• Günlük ana model: anthropic/claude-sonnet-5 veya openai/gpt-5.6-terra — kalite/maliyet dengesi.
• Zor refactor ve mimari kararlar: anthropic/claude-opus-5 — az ama kritik istekte.
• Karar yorgunluğu istemeyenler: onysoft/auto.

Başlamak için ücretsiz hesap açın, anahtarınızı üretin ve aracınıza bağlamadan önce Playground'da aynı kod istemini birkaç modelle yan yana deneyin. Genel çerçeve için Yapay Zeka API rehberi iyi bir sonraki durak.

Son güncelleme: 5 Ağustos 2026 · Veriler: api.onysoft.com canlı katalog