Claude API ile Kilo Code — OpenAI uyumlu temel URL kurulumu ve mod başına yönlendirme

Kilo Code, VS Code için en çok kullanılan açık kaynaklı AI kodlama ajanlarından biridir ve Cline ailesindeki kardeşleri gibi kendi OpenAI uyumlu API uç noktanızı getirmenize olanak tanır. Bu, Claude'u editörünüzün içinde tek bir sk-kn- anahtarıyla, ana modellerde Anthropic'in liste fiyatının yaklaşık 30% altında çalıştırabileceğiniz anlamına gelir. Bu kılavuz üç alanlı kurulumu, göreve göre hangi Claude modelinin seçileceğini ve aracı tabanlı bir kodlama oturumunun gerçekte ne kadara mal olduğunu ele alır.

Kilo Code neden API anahtarına ihtiyaç duyar?

Kilo Code bir model içermez — her eylem (dosya okuma, düzenleme önerme, komut çalıştırma, sonucu kontrol etme) token başına ücretlendirilen bir API çağrısıdır. Claude Pro gibi bir sohbet aboneliği bunu kapsamaz; uzantının doğrudan API erişimine ihtiyacı vardır. Kunavo'nun sunduğu yapı tam olarak budur: $10'lık yüklemeden başlayan kullandıkça öde modeli, Claude ve GPT için tek anahtar ve hiçbir zaman sona ermeyen bakiye. Aracı tabanlı döngüler her adımda büyüyen görev bağlamını yeniden gönderdiğinden, token başına ücret bir oturumun maliyetindeki en büyük etkendir — claude-sonnet-5 üzerindeki yaklaşık 30% indiriminin hızla katlanmasının nedeni budur.

Üç alan

Kilo Code, sağlayıcıyı üç ayar alanı olarak sunar:

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

konsoldan kaydolup $10 yükleme yaptıktan sonra anahtarı alın — yalnızca bir kez gösterilir, bu nedenle hemen saklayın. Tam anahtar yönetimi Claude API anahtarı dokümanında ele alınır.

Kilo Code kurulumu

1. VS Code marketplace'ten Kilo Code'u yükleyin ve kenar çubuğundan açın.
2. Uzantı ayarlarını (dişli simgesi) açın ve Providers bölümüne gidin.
3. API Provider değerini OpenAI Compatible olarak ayarlayın.
4. Base URL: https://api.kunavo.com/v1 · API key: sk-kn-… anahtarınız · Model: claude-sonnet-5.
5. Kaydedin, ardından kodu düzenlemesine izin vermeden önce bağlantıyı doğrulamak için ona küçük bir şey sorun (“bu dosyayı açıkla”).

Kilo Code, mod başına model geçersiz kılmalarını destekler (Architect / Code / Debug) — planlamayı daha güçlü bir modele (claude-opus-5) ve yürütmeyi daha ucuz bir modele (claude-sonnet-5) yönlendirmek için iyi bir yerdir.

Cline ve Roo Code

Kilo Code ve Roo Code, Cline ailesinin çatallarıdır; bu nedenle yukarıdaki üç alanın tümü üç araçta da aynıdır — sağlayıcı OpenAI Compatible, temel URL https://api.kunavo.com/v1, anahtar, model kimliği. Farklı olan, her aracın modelleri yönlendirmek için sunduğu özelliktir ve maliyet tasarrufu burada ortaya çıkar; bu nedenle her birinin kendi kılavuzu vardır: Claude API ile Cline, Plan/Act ayrımını; Claude API ile Roo Code ise adlandırılmış yapılandırma profillerini ve mod başına model bağlamayı ele alır.

Üç araç da ayrıca özel temel URL seçeneğine sahip yerleşik bir Anthropic sağlayıcısıyla gelir. Bunu https://api.kunavo.com adresine yönlendirmek, bunun yerine Anthropic'e özgü Messages API'yi (/v1/messages) kullanır — cache_control dönüştürülmeden geçer ve önbelleğe alınan girdi, girdi ücretinin %10'u üzerinden faturalandırılır (bkz. istem önbelleğe alma dokümanı). Her iki yol da çalışır; başlangıç için en basit olan OpenAI uyumlu yoldur.

Ancak istem önbelleğe alma, Anthropic'e özgü yolu gerektirmez. Uzun bir istemde Kunavo, OpenAI uyumlu yolda önbellek kesme noktalarını kendisi ayarlar: 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 orada ayarladığı bir cache_control korunur. Anthropic'e özgü yolda istek, uzantının gönderdiği gibi iletilir ve hiçbir kesme noktası eklenmez; dolayısıyla neyin önbelleğe alınacağı, uzantının ayarladığı kesme noktalarına bağlıdır.

Hangi Claude modeli seçilmeli?

claude-opus-5 burada güçlü akıl yürütme tercihidir: Anthropic'in en yeni Opus modelidir ve önceki nesil claude-opus-4-7 ile aynı $3,50 / $17,50 ücretinden ($3,50 / $17,50) faturalandırılır; buna sabitlediyseniz kullanılmaya devam eder. Model alanı aynı uç noktadaki yalnızca bir slug olduğundan geçiş tek kelimelik bir değişikliktir — yeni anahtar veya yeni sağlayıcı yapılandırması gerekmez. Tüm modellerin tam ücretleri Claude API fiyatlandırma kılavuzunda ve fiyatlandırma sayfasında bulunur.

Bir oturumun gerçek maliyeti

Aracı tabanlı araçlar tasarım gereği token tüketir: her adım sistem istemini, görev geçmişini ve yeni dosya bağlamını yeniden gönderir. Kunavo ücretleriyle gerçekçi rakamlar:

Çalıştırılabilir hesap:

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

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

# One agentic step: the tool resends the task context + file reads.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Faturayı düşük tutmak

1. Bir görevi sonsuza kadar uzatmak yerine yeni görevler başlatın. Araç her adımda konuşmanın tamamını yeniden gönderir; bu nedenle uzun süren bir görev karesel olarak pahalıdır. Yeni görev = yeni, küçük bağlam.
2. Moda göre yönlendirin. Kilo Code mod başına bir modeli destekler — Architect için claude-opus-5, Code için claude-sonnet-5, hızlı sorular için claude-haiku-4-5. Planlama token'ların küçük bir bölümünü oluşturduğundan, daha güçlü modelin buradaki maliyeti düşüktür.
3. Önbelleğe alma için Anthropic'e özgü yolu kullanın. Önbelleğe alınan girdi, girdi ücretinin %10'u üzerinden faturalandırılır — her adımda sabit bir öneki yeniden gönderen bir döngüde bu, mevcut en büyük tasarruftur (nasıl çalıştığını öğrenin).
4. Anahtar başına harcamayı izleyin. Editöre konsolda bir harcama limiti olan kendi anahtarını verin ve bir haftalık aracı tabanlı kodlamanın size gerçekte ne kadara mal olduğunu görmek için kullanımı kontrol edin.

Sık sorulan sorular