Claude API ile Kilo Code — temel URL, modeller ve maliyet (Cline ve Roo Code da dahil)

Kilo Code, Cline ve Roo Code, VS Code içinde en çok kullanılan açık kaynak kodlama ajanlarıdır — üçü de özel bir OpenAI uyumlu uç noktayı kabul eder. Yani tek bir sk-kn- anahtarıyla Claude'u editörünüzün içinde çalıştırabilirsiniz; başlıca modellerde fiyat Anthropic'in resmî liste fiyatından 30% kadar daha düşüktür. Bu kılavuzda her araç için üç alanlı yapılandırma, görev türüne göre hangi Claude modelinin seçileceği, agentic kodlama oturumunun gerçek maliyeti ve Brezilya'dan uluslararası kart olmadan Pix ile ödeme anlatılır.

Bu araçlar neden API anahtarı istiyor?

Kilo Code, Cline ve Roo Code herhangi bir modeli bünyesinde barındırmaz: her eylem (dosya okuma, değişiklik ö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 karşılamaz — API'ye doğrudan erişim gerekir. Kunavo tam olarak bunun içindir: $10'dan başlayan yüklemeyle kullandıkça öde, Claude ve GPT için tek anahtar, hiç sona ermeyen bakiye ve Brezilya'dan Pix veya kartla ödeme (gecikme, LGPD ve fatura hakkındaki tüm bağlam Brezilya'da Claude API kılavuzunda). Agentic döngü her adımda bağlamı yeniden gönderdiğinden, token başına ücret bir oturumun maliyetindeki ilk kaldıraçtır.

Üç alan (üç araç için de geçerlidir)

Üç uzantı aynı sağlayıcı 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-...          # criada em kunavo.com/app/keys
Model ID       claude-sonnet-5        # ou claude-opus-5 / claude-haiku-4-5

kaydolup $10 yükleme yaptıktan sonra anahtarı kontrol panelinde oluşturun — anahtar yalnızca bir kez görünür, hemen kaydedin.

Kilo Code'u yapılandırma

1. VS Code marketplace üzerinden Kilo Code'u yükleyin ve kenar çubuğundaki paneli açın.
2. Uzantının ayarlarını (dişli simgesi) açın ve Providers bölümüne gidin.
3. API Provider değerini OpenAI Compatible olarak bırakın.
4. Base URL: https://api.kunavo.com/v1 · API anahtarı: kendi sk-kn-… anahtarınız · model: claude-sonnet-5.
5. Kaydedin ve aracın kodu düzenlemesine izin vermeden önce basit bir istekle (“bu dosyayı açıkla”) test edin.

Kilo Code, her mod için farklı bir modele izin verir (Architect / Code / Debug) — planlamayı daha güçlü, yürütmeyi ise daha ucuz bir modele göndermek için pratiktir.

Cline'ı yapılandırma

1. Cline'ı yükleyin ve panelini açın.
2. Ayarlar dişlisine tıklayın ve API Provider bölümünde OpenAI Compatible'ı seçin.
3. Aynı üç değeri doldurun: base URL https://api.kunavo.com/v1, kendi anahtarınız ve model ID 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. Roo Code'un mod sistemi (Code / Architect / Ask / Debug) de her mod için bir modeli kabul eder.

Üç araçta da özel temel URL seçeneğine sahip yerleşik bir Anthropic sağlayıcısı bulunur. Temel URL olarak https://api.kunavo.com kullanarak Anthropic'e özgü Messages API'sinden (/v1/messages) geçersiniz — bunun avantajı, cache_control alanının doğrudan iletilmesi ve önbelleğe alınmış girdinin girdi ücretinin %10'u üzerinden ücretlendirilmesidir (bkz. istem önbellekleme belgeleri). Her iki yol da çalışır; başlangıç için OpenAI uyumlu yol daha basittir.

Ancak istem önbellekleme, Anthropic'e özgü yola bağlı değildir. 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.

Brezilya'dan ödeme — uluslararası kart olmadan Pix

Brezilyalı geliştiricilerin çoğunu zorlayan nokta yapılandırma değil, ödemedir: Anthropic API'sini doğrudan ücretlendirmek, yurt dışı alışverişlerine açık uluslararası bir kredi kartı gerektirir. Kunavo'da ödeme Stripe üzerinden işlenir ve Brezilya'dan ödeme yapanlar için Pix bir ödeme yöntemi olarak görünür — tutar reallerle gösterilir, anında hesaba geçer; böylece uluslararası karta ihtiyaç duyulmaz. Uluslararası kartlar (Visa, Mastercard, American Express), Apple Pay, Google Pay ve Link de normal şekilde çalışır.

Token ücretleri USD cinsinden belirlenir: Pix'te (ve ödeme ekranı reallerle göründüğünde kartla) Stripe, onaylamadan önce dönüşümü reallerle gösterir; bu kura alıcının ödediği %2–4 döviz bozdurma maliyeti dahildir. Kartla dolar ödemeyi seçerseniz bu maliyet ortadan kalkar ve dönüşüm kartı veren kuruluşun kuruna göre yapılır (bankanızın uygulamasında IOF ve uluslararası işlem ücretini kontrol edin) — Pix ile yükleme adım adım API için Pix ile ödeme kılavuzunda açıklanır. Bu bir ön ödemeli cüzdandır: minimum yükleme $10'dır, aylık ücret yoktur ve bakiye hiçbir zaman sona ermez — bu nedenle kod yazmadan geçirilen bir ay, aboneliğin aksine hiçbir maliyet oluşturmaz.

Hangi Claude modelini seçmeliyim?

Model alanı aynı uç noktadaki yalnızca bir slug'dır: model değiştirmek tek bir kelimeyi değiştirmek demektir — yeni anahtar veya yeni sağlayıcı gerekmez. Tam ücretler Claude API fiyatlandırma kılavuzunda ve fiyatlandırma sayfasında yer alır.

Bir oturumun gerçek maliyeti

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

Başka bir deyişle, Pix ile yapılan $10'lık bir yükleme Sonnet 5'te yaklaşık 20 adımlık 11 agentic görevi karşılar. Kendi hesabınızı yapmak için:

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

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

# Um passo do agente: a ferramenta reenvia o contexto + os arquivos lidos.
print(custo_passo("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Uma tarefa realista de 20 passos (editar, rodar, corrigir, repetir):
print(20 * custo_passo("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Portekizce, aynı içerik için İngilizceden yaklaşık %10–20 daha fazla token tüketir — prompt ve kod yorumları Portekizce olduğunda bunu hesaba katmak gerekir.

Faturayı nasıl düşük tutarsınız?

1. Aynı görevi uzatmak yerine yeni görevler açın. Araç her adımda konuşmanın tamamını yeniden gönderir: sonu gelmeyen bir görev karesel biçimde maliyetlenir. Yeni görev = kısa bağlam.
2. Moda göre yönlendirin. Kilo Code ve Roo Code mod başına bir modeli kabul eder — Architect için claude-opus-5, Code için claude-sonnet-5, hızlı sorular için claude-haiku-4-5.
3. Önbelleğe alma için Anthropic'e özgü rotayı kullanın. Önbelleğe alınan girdi, ücretin %10'u üzerinden fiyatlandırılır — her adımda sabit bir ön eki yeniden gönderen bir döngüde bu, elde edilebilecek en büyük tasarruftur (nasıl çalışır).
4. Anahtar başına harcamayı izleyin. Editöre dashboard'da harcama limiti olan kendi anahtarını verin ve bir haftalık agentic kodlamanın gerçekte ne kadara mal olduğunu kullanım panelinde kontrol edin.

Sık sorulan sorular