Claude API ile Kilo Code — temel URL yapılandırması (Cline ve Roo Code da dahil)

Kilo Code, Cline ve Roo Code, VS Code'da en çok kullanılan açık kaynaklı yapay zekâ kodlama aracılarıdır — üçü de özel bir OpenAI uyumlu uç noktayı kabul eder. Böylece Claude'u düzenleyicinizde ana modellerde Anthropic'in resmî ücretinin yaklaşık 30% altında, tek bir sk-kn- anahtarıyla çalıştırabilirsiniz. Bu kılavuz, her araç için üç alanlı yapılandırmayı, göreve göre seçilecek Claude modelini ve aracı tabanlı bir kodlama oturumunun gerçek maliyetini açıklar.

Bu araçlar neden API anahtarı ister

Kilo Code, Cline ve Roo Code yerleşik bir model içermez: her işlem (dosya okuma, değişiklik önerme, komut çalıştırma, sonucu kontrol etme) token üzerinden ücretlendirilen bir API çağrısıdır. Claude Pro gibi bir sohbet aboneliği bunu kapsamaz — doğrudan API erişimi gerekir. Kunavo tam olarak bunun içindir: $10'dan başlayan kullandıkça öde sistemi, Claude ve GPT için tek anahtar, süresi hiç dolmayan bakiye ve Fransa'dan kredi kartıyla ödeme (Fransa'da Claude API rehberinde KDV ve GDPR ayrıntıları yer alır). Ajan döngüsü her adımda bağlamı yeniden gönderdiği için token başına fiyat, oturum maliyetinin ilk ve en önemli belirleyicisidir.

Üç alan (tüm araçlar)

Üç uzantı aynı provider modelini paylaşır — Kilo Code ve Roo Code, Cline ailesinin fork'larıdır — bu nedenle yapılandırma aynıdır:

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # à créer sur kunavo.com/app/keys
Model ID       claude-sonnet-5        # ou claude-opus-4-7 / claude-haiku-4-5

dashboard'da kaydolduktan ve $10 yükledikten sonra anahtarı oluşturun — yalnızca bir kez görüntülenir, hemen güvenli biçimde saklayın.

Kilo Code'u yapılandırma

1. VS Code marketplace'inden Kilo Code'u yükleyin ve kenar çubuğunda açın.
2. Uzantının ayarlarını (dişli simgesi) açın ve Providers bölümüne gidin.
3. API Provider seçeneğini OpenAI Compatible olarak ayarlayın.
4. Base URL: https://api.kunavo.com/v1 · API anahtarı: kendi sk-kn-… · model: claude-sonnet-5.
5. Kaydedin, ardından kodu değiştirmesine izin vermeden önce basit bir istekle («bu dosyayı açıkla») test edin.

Kilo Code, her mod için farklı bir model kullanmanıza izin verir (Architect / Code / Debug) — planlamayı daha güçlü bir modele, çalıştırmayı ise daha ucuz bir modele yönlendirmek için kullanışlıdır.

Cline'ı yapılandırma

1. Cline'ı yükleyin ve panelini açın.
2. Ayarlar dişlisine tıklayın ve API Provider altında OpenAI Compatible'ı seçin.
3. Aynı üç değeri girin: base URL https://api.kunavo.com/v1, anahtarınız ve model ID'si claude-sonnet-5.
4. Cline model meta verilerini (bağlam penceresi, output sınırı) isterse model sayfasındaki sayıları kullanın.

Roo Code'u yapılandırma

Diğer ikisiyle aynıdır: Settings → Providers → API Provider → OpenAI Compatible, ardından base URL https://api.kunavo.com/v1, anahtar ve model ID'si. Roo Code'un mod sistemi (Code / Architect / Ask / Debug) de mod başına bir modeli destekler.

Üç araçta ayrıca özel bir temel URL seçeneğine sahip yerleşik bir Anthropic sağlayıcısı bulunur. Bunu https://api.kunavo.com adresine yönlendirerek Anthropic'e özgü Messages API'sini (/v1/messages) kullanırsınız — bu ilgi çekicidir çünkü cache_control olduğu gibi aktarılır ve önbelleğe alınan giriş, giriş ücretinin %10'u olarak ücretlendirilir (istem önbellekleme belgelerine bakın). Her iki yol da çalışır; OpenAI uyumlu yol başlangıç için daha basittir.

Bununla birlikte, istem önbellekleme Anthropic'e özgü yola bağlı değildir. Uzun bir istemde Kunavo, OpenAI uyumlu yolda önbellek kesme noktalarını kendisi yerleştirir: sistem isteminde, araç tanımlarında ve konuşma bir asistan turu içerdiğinde son mesajda; bir ajan döngüsünde bu, ilk adımdan sonraki her adımdır. Uzantının oraya yerleştirdiği bir cache_control korunur. Anthropic'e özgü yolda istek, uzantının gönderdiği gibi iletilir ve hiçbir kesme noktası eklenmez: neyin önbelleğe alınacağı, uzantının yerleştirdiği kesme noktalarına bağlıdır.

Hangi Claude modelini seçmelisiniz?

Model alanı aynı endpoint üzerindeki yalnızca bir slug'dır: model değiştirmek tek kelimelik bir değişikliktir — yeni anahtar veya yeni provider gerekmez. Tüm fiyatlar Claude API fiyatlandırma rehberinde ve fiyatlandırma sayfasında yer alır.

Bir oturumun gerçek maliyeti

Agentik araçlar tasarım gereği çok sayıda token tüketir: her adım sistem prompt'unu, görev geçmişini ve dosya bağlamını yeniden gönderir. Kunavo fiyatlarıyla gerçekçi rakamlar:

Hesaplama, çalıştırılabilir biçimde:

# Tarifs Claude sur Kunavo (USD par 1M de tokens) : (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
}

def cout_etape(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# Une étape agentique : l'outil renvoie le contexte + les fichiers lus.
print(cout_etape("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Une tâche réaliste de 20 étapes (éditer, lancer, corriger, répéter) :
print(20 * cout_etape("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Faturayı düşük tutma

1. Aynı görevi uzatmak yerine yeni görevler açın. Araç her adımda tüm konuşmayı yeniden gönderir: bitmeyen bir görev karesel olarak pahalıya mal olur. Yeni görev = kısa bağlam.
2. Moda göre yönlendirin. Kilo Code ve Roo Code mod başına model kabul eder — Architect için claude-opus-4-7, Code için claude-sonnet-5, hızlı sorular için claude-haiku-4-5.
3. Önbellekleme için Anthropic'e özgü yolu kullanın. Önbelleğe alınan girdi, ücretin %10'u üzerinden ücretlendirilir — her adımda sabit bir öneki yeniden gönderen döngüde bu, mevcut en büyük tasarruftur (nasıl çalıştığı).
4. Anahtar başına harcamayı izleyin. Editöre dashboard'da harcama sınırı olan kendi anahtarını verin ve kullanım bölümünden bir haftalık agentik kodlamanın gerçekte ne kadara mal olduğunu kontrol edin.

Sık sorulan sorular