Claude API ile Roo Code — sağlayıcı kurulumu ve mod başına model

Roo Code, VS Code için açık kaynaklı otonom bir kodlama ajanıdır — Cline ailesinde bir çataldır ve mod sistemi ile mod başına model yönlendirmesiyle ayrılır. Kendi modelini sunmaz; bu nedenle bir API anahtarına ihtiyaç duyar. Bu kılavuz, Claude'u Roo Code'da tek bir sk-kn- anahtarıyla, ana modellerde Anthropic liste fiyatının yaklaşık 30% altında çalıştırmanın tam kurulumunu; güçlü model maliyetini yalnızca karşılığını verdiği yerde harcamak için yapılandırma profillerinin nasıl kullanılacağını, bir oturumun maliyetini ve Anthropic'i doğrudan çağırmaya kıyasla ödünleşmenin dürüst bir değerlendirmesini açıklar.

Roo Code neden API anahtarına ihtiyaç duyar?

Roo Code'un gerçekleştirdiği her adım — dosya okuma, fark yazma, komut çalıştırma, sonucu okuma — token başına ücretlendirilen bir model çağrısıdır. claude.ai Pro veya Max aboneliği bunu karşılamaz: sohbet planlarıyla API erişimi ayrı ürünlerdir ve Roo Code API ile iletişim kurar. Ajan döngüsü büyüyen görev bağlamını her adımda yeniden gönderdiğinden token başına ücret, oturum maliyetindeki en büyük kaldıraçtır — ağ geçidi için de durum böyledir: 10 $ yüklemeyle kullandıkça öde, GPT'ye de ulaşan tek anahtar ve hiçbir zaman süresi dolmayan bakiye.

Kurulum — üç alan

Ayarlar → Sağlayıcılar bölümünü açı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 hesabınıza bakiye yükledikten sonra anahtarı panelden oluşturun — yalnızca bir kez gösterilir, bu nedenle hemen kaydedin; Claude API anahtarı dokümanında anahtar yenileme ve harcama limitleri açıklanır. Roo Code bağlam penceresi veya çıktı sınırı gibi model meta verileri isterse değerleri model sayfasından alın — gereğinden düşük bir bağlam penceresi, modelin olması gerekenden erken kesilmesine neden olur.

Kodu düzenlemesine izin vermeden önce küçük bir şeyle test edin. Buradaki 401 neredeyse her zaman anahtardan kaynaklanır; 404 ise neredeyse her zaman temel URL'den veya mevcut olmayan model slug'ından kaynaklanır — Kunavo slug'ları tam olarak eşleştirir ve tarih son ekli adlar için takma ad kullanmaz; bu nedenle claude-sonnet-4-5-20250929 404 döndürürken claude-sonnet-4-6 çözümlenir.

Modlar ve yapılandırma profilleri — maliyet kolu

Roo Code'da yerleşik olarak birkaç mod bulunur — Kod, Mimar, Sor ve Hata Ayıkla — ayrıca kendiniz tanımladığınız özel modlar da vardır. Maliyet açısından önemli nokta, Roo Code'un adlandırılmış API yapılandırma profillerini saklaması ve her modda en son hangi profili kullandığınızı hatırlamasıdır. Böylece modeli değiştirmeniz gerektiğinde hatırlamanız gereken bir ayar olmaktan çıkar; modun bir özelliği hâline gelir:

# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.

Profile "strong"         model claude-opus-5        -> bind to Architect and Debug
Profile "code-default"   model claude-sonnet-5      -> bind to Code mode
Profile "ask-cheap"      model claude-haiku-4-5     -> bind to Ask mode

Bunun işe yaramasının nedeni, modların token profillerinin birbirinden çok farklı olmasıdır. Mimar, model kalitesinin sonraki yirmi adımın verimli olup olmayacağını belirlediği, akıl yürütme ağırlıklı birkaç turdan oluşur — toplam token'ların küçük bir bölümüdür; bu nedenle güçlü bir model mutlak olarak az maliyet getirir. Kod, her biri bağlamı yeniden gönderen çok sayıda mekanik adımdan oluşur; token başına ücretin katlandığı yer burasıdır. Sor genellikle tek seferliktir ve hiçbir şekilde en üst düzey bir model gerektirmez.

Aşağıda hesaplanan rakamlar yer alıyor: Opus 5 ile üç Mimar adımı ve Sonnet 5 ile on yedi Kod adımı, tümüyle Sonnet çalıştırmanın 0,87 dolarına karşı yaklaşık $1,06 tutar — planlama kalitesi belirgin ölçüde daha iyi olduğu hâlde yaklaşık 23% daha fazla ve her şeyi Opus'ta çalıştırmaktan çok daha ucuz.

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

Roo Code ayrıca özel bir temel URL alanına sahip yerleşik bir Anthropic sağlayıcısı sunar. Bu sağlayıcıyı https://api.kunavo.com adresine yönlendirmek — istemci /v1/messages öğesini kendisi eklediği için /v1 içermeyen yalnızca origin adresini kullanarak — istekleri Anthropic'e özgü Messages API üzerinden yönlendirir. Buraya /v1 biçimini yapıştırmak, model bulunamıyormuş izlenimi veren bir 404 hatasına yol açar.

Bu rotanın sağladığı şey istem önbelleğe almadır: cache_control olduğu gibi iletilir ve önbelleğe alınan girdiler, giriş ücretinin %10'u üzerinden ücretlendirilir (nasıl çalışır). Her adımda sabit bir ön eki yeniden gönderen bir döngüde bu, elde edilebilecek en büyük tasarruftur — model değişikliğinden bile daha büyük. Her iki rota da çalışır; başlangıç için OpenAI Compatible daha basittir ve aralarında geçiş yapmak bir ayar değişikliğinden ibarettir.

Ancak istem önbelleğe alma, Anthropic'e özgü rotayı gerektirmez. Uzun bir istemde Kunavo, OpenAI Compatible rotasında ö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. Roo Code'un orada ayarladığı bir cache_control korunur. Anthropic'e özgü rotada istek, Roo Code'un gönderdiği gibi iletilir ve hiçbir kesme noktası eklenmez; dolayısıyla neyin önbelleğe alınacağı, Roo Code'un ayarladığı kesme noktalarına bağlıdır.

Hangi Claude modelini hangi moda bağlamalı?

Bunların hepsi aynı anahtarı ve aynı uç noktayı kullanır — yalnızca model slug'ı değişir; dolayısıyla profil tek kelimelik bir değişikliktir. Anthropic'in resmî listesine göre model başına tüm ücretler Anthropic Claude API fiyat listesinde, güncel katalog ise fiyatlandırma sayfasında yer alır.

Kunavo üzerinde Roo Code ve doğrudan Anthropic çağrısı

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ı gerçek ödünleşimi açıkça ortaya koyar. Garantili bir kotaya, sözleşmeye bağlı bir SLA'ya veya model sağlayıcısıyla bir tedarik ilişkisine ihtiyacınız varsa doğrudan gidin — fiyat farkının satın aldığı şey budur. Roo Code çalıştıran bireysel bir geliştirici veya küçük bir ekip için denge genellikle ters yöndedir.

Bir Roo Code 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 Code-mode step: Roo 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 on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
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. Roo Code her adımda konuşmanın tamamını yeniden gönderir; bu nedenle uzun süren tek bir görevin maliyeti karesel olarak büyür. Yeni bir görev, taze ve küçük bir bağlam demektir — buradaki en yüksek etkili alışkanlık budur.
2. Her moda bir profil bağlayın. Yukarıda ele alındı: model yönlendirmesini, görevin ortasında hatırlamanız gereken bir şey olmaktan çıkarıp yapılandırmaya dönüştürü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 kendi harcama limitli anahtarını verin. Panelde ayrı bir anahtar oluşturun ve gerçek bir haftadan sonra kullanımı kontrol edin — bunun size maliyetini dürüstçe tahmin etmenin tek yolu budur.

Sık sorulan sorular