Claude API ile Cline — temel URL kurulumu, Plan/Act model yönlendirmesi, gerçek maliyetler

Cline, VS Code için açık kaynaklı otonom bir kodlama aracısıdır ve bir model içermez — genellikle kendi API anahtarınızla onu bir modele bağlarsınız. Bu kılavuz, Claude'u Cline'da ana model gruplarında Anthropic'in liste fiyatından yaklaşık 30% daha düşük oranla tek bir sk-kn- anahtarı üzerinden çalıştırmak için gereken ayarları; her iki sağlayıcı rotasını, faturayı azaltmak için Plan/Act modundan yararlanmayı, gerçek bir oturumun maliyetini ve Anthropic'i doğrudan çağırmaya kıyasla nelerden vazgeçtiğinize dair dürüst bir değerlendirmeyi içerir.

Cline neden API anahtarına ihtiyaç duyar?

Cline'ın gerçekleştirdiği her eylem — dosya okuma, fark önerme, terminal komutu çalıştırma, çıktıyı okuma ve yeniden deneme — bir model çağrısıdır. Cline bu çağrıları Claude Pro veya Max aboneliği üzerinden Claude Code sağlayıcısıyla çalıştırabilir; bu sağlayıcı Claude CLI'yi kullanır ve API faturalandırması yerine abonelik sınırlarınızdan yararlanır — Eylül 2026 itibarıyla Cline belgelerinde listelenen ödünleşimlerle: yanıtlar token token akmayabilir, görüntü yüklemeleri ve istem önbelleğe alma bu modda sınırlıdır. Bu kılavuzun kurduğu OpenAI Compatible ve Anthropic sağlayıcıları dahil diğer tüm rotalar, API anahtarı üzerinden token başına faturalandırılır. Bu rotalarda soru token başına ödeme yapıp yapmamak değil, hangi oranda ödeme yapacağınızdır; aracı döngüsü büyüyen görev bağlamını her adımda yeniden gönderdiğinden token başına oran, bir oturumun maliyetindeki en büyük etkendir. Buradaki ağ geçidinin tüm gerekçesi budur: 10 $'lık yüklemeyle kullandıkça öde, GPT'ye de ulaşan tek anahtar ve hiç süresi dolmayan bakiye.

Kurulum — üç alan

Cline panelini açın, ayarlar dişlisine tıklayın ve API sağlayıcısını OpenAI Compatible olarak ayarlayın. Üç değer:

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

Kaydolup bakiyenize para ekledikten sonra anahtarı kontrol panelinde oluşturun — yalnızca bir kez gösterildiği için hemen kaydedin. Anahtar yönetimi, anahtar rotasyonu ve harcama limitleri Claude API anahtarı dokümanında ele alınmaktadır. Cline, bağlam penceresi veya çıktı sınırı gibi model meta verilerini isterse sayıları tahmin etmek yerine model sayfasından alın — bağlam penceresini olduğundan küçük belirtmek, Cline'ın içeriği gerekenden daha erken kesmesine neden olur.

Herhangi bir şeyi düzenlemesine izin vermeden önce küçük bir şey — “bu dosyayı açıkla” — isteyerek bağlantıyı doğrulayın. Bu noktadaki 401 hatası neredeyse her zaman anahtardır; 404 ise neredeyse her zaman temel URL veya mevcut olmayan bir model slug'ıdır — Kunavo slug'ları tam olarak eşleştirir ve tarih ekli adlara takma ad vermez; bu nedenle claude-sonnet-4-5-20250929 bir 404 iken claude-sonnet-4-6 çözümlenir.

Plan modu ve Act modu — en ucuz ayrım

Cline'ın ayırt edici özelliği, Plan modunu (kod tabanını okuma, sorular sorma, yaklaşım önerme) Act modundan (düzenlemeleri yapma, komutları çalıştırma) ayırması ve her biri için farklı bir model yapılandırmanıza izin vermesidir. Bu, maliyetle neredeyse kusursuz biçimde örtüşür; çünkü iki modun token profilleri çok farklıdır:

• Plan kısadır ve yoğun akıl yürütme gerektirir. Model kalitesinin sonraki yirmi adımın verimli mi yoksa boşa mı gideceğini belirlediği birkaç tur. claude-opus-5 buraya koyun — token'ların küçük bir bölümünü oluşturur, bu nedenle daha güçlü model mutlak olarak çok az maliyetlidir.
• Act uzundur ve mekaniktir. Her biri bağlamı yeniden gönderen çok sayıda adım. Token başına ücretin katlandığı yer burasıdır; bu nedenle daha ucuz Sonnet burada kullanılmalıdır — bugün Kunavo'da claude-sonnet-5.

Hesaplanmış rakamlar aşağıdaki maliyet bölümünde yer alıyor: Opus 5 ile üç adımı planlayıp Sonnet 5 ile on yedi adımı yürütmek, tüm çalışmayı Sonnet ile yürütmek için gereken 0,87 ABD dolarına karşılık yaklaşık 1,06 ABD dolarına mal olur — önemli ölçüde daha iyi planlama için kabaca 23% daha fazla, ancak tüm görevi Opus üzerinde çalıştırmaktan çok daha az.

Anthropic'e özgü rota (ve neden bunu isteyebileceğiniz)

Cline ayrıca özel bir temel URL alanına sahip yerleşik bir Anthropic sağlayıcısı sunar. Bunu Kunavo'ya yönlendirmek, OpenAI uyumlu uç nokta yerine Anthropic'e özgü Messages API'yi (/v1/messages) kullanır:

API Provider   Anthropic
Base URL       https://api.kunavo.com   # origin only — the client appends /v1/messages
API Key        sk-kn-...
Model ID       claude-sonnet-5

İki rota arasındaki temel URL'nin farklı olduğuna dikkat edin. OpenAI uyumlu sağlayıcı https://api.kunavo.com/v1 adresini ister; Anthropic sağlayıcısı ise yalnızca kök adres olan https://api.kunavo.com adresini ister, çünkü bu istemci /v1/messages yolunu kendisi ekler. /v1 biçimini Anthropic sağlayıcısına yapıştırmak, eksik model gibi görünen bir 404 hatası üretir.

Anthropic'e özgü rotanın sunduğu şey istem önbelleğe alma özelliğidir: cache_control çevrilmeden iletilir ve önbelleğe alınan girdi, girdi ücretinin %10'u üzerinden faturalandırılır (istem önbelleğe alma belgelerine bakın). Her adımda sabit bir öneki yeniden gönderen bir döngüde bu, kullanılabilecek en büyük tasarruftur — herhangi bir model değişiminden daha büyük. Her iki rota da çalışır; OpenAI uyumlu olanla başlamak daha kolaydır ve daha sonra geçiş yapmak ayarlarda yapılacak bir değişikliktir.

Ancak istem önbelleğe alma kendi başına Anthropic'in kendi Messages API'sini kullanan rotayı gerektirmez. Uzun bir istemde Kunavo, OpenAI uyumlu rotada ö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. Cline'ın orada ayarladığı bir cache_control korunur. Anthropic'in kendi Messages API'sini kullanan rotada istek, Cline'ın gönderdiği gibi iletilir ve hiçbir kesme noktası eklenmez; dolayısıyla neyin önbelleğe alınacağı, Cline'ın ayarladığı kesme noktalarına bağlıdır.

Hangi Claude modelini ayarlamalıyım

Geçiş, model alanında tek kelimelik bir değişikliktir — aynı anahtar, aynı sağlayıcı yapılandırması, aynı uç nokta. Anthropic'in resmi listesindeki model başına tam ücretler Anthropic Claude API fiyat listesinde, güncel katalog ise fiyatlandırma sayfasındadır.

Kunavo üzerinde Cline ve doğrudan Anthropic çağrısı karşılaştırması

Doğrudan gitmenin daha iyi seçenek olduğu durumlar da dâhil olmak üzere dürüst karşılaştırma:

Kapasite satırını yazıldığı şekilde okuyun. Ekibinizin garantili bir kotaya, sözleşmeye bağlı bir SLA'ya veya model sağlayıcısıyla bir tedarik ilişkisine ihtiyacı varsa doğrudan gidin — aradaki fark için ödeme yaptığınız şey budur. Cline çalıştıran bireysel bir geliştirici veya küçük bir ekip için tercih genellikle ters yöndedir.

Bir Cline oturumunun 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),
    "claude-opus-5":     (3.50, 17.50),
}

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 Act-mode step: Cline resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, read the error, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# The same task planned on Opus 5, executed on Sonnet 5:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

Faturayı düşük tutmak

1. Bir görevi sonsuza kadar uzatmak yerine yeni görevler başlatın. Cline her adımda tüm konuşmayı yeniden gönderir; bu nedenle uzun süren bir görevin maliyeti karesel olarak artar. Yeni bir görev, yeni ve küçük bir bağlamdır — listedeki en yüksek etkili alışkanlık budur.
2. Plan ve Act modlarını modeller arasında bölüştürün. Yukarıda ele alındı: bu bir disiplin sorunu değil, bir ayar alanıdır.
3. Önbelleğe alma için Anthropic'e özgü rotayı kullanın. Giriş ücretinin %10'u üzerinden ücretlendirilen önbellekli giriş, sabit bir ön eki yeniden gönderen bir döngüdeki en büyük yapısal tasarruftur.
4. Editöre harcama sınırı olan kendi anahtarını verin. Kontrol panelinde ayrı bir anahtar oluşturun, buna aylık harcama limiti belirleyin ve kullanımı izleyin — bunun size maliyetini dürüstçe tahmin etmenin tek yolu, gerçek aracılı kodlamayla geçen bir haftadır. Limit her isteğin öncesinde kontrol edilir ve takvim ayıyla birlikte sıfırlanır; anahtar da bağımsız olarak iptal edilebilir. Böylece editörü durdurmak, her şeyi döndürmek yerine tek bir işlem olur.
5. İki araç arasında hâlâ seçim yapıyor musunuz? Cline ve Claude Code karşılaştırması, özellik listeleri yerine faturalandırma biçimlerini karşılaştırır — ayrıca her ikisi de aynı uç noktaya karşı çalışır, bu nedenle seçim geri döndürülebilir kalır.

Sık sorulan sorular