Dokümantasyon

Roo Code

Roo Code'un OpenAI Compatible sağlayıcısı üç alandan ve bir model yetenekleri bloğundan oluşur. Yetenekler bloğu isteğe bağlı bir süs değildir; Roo Code'un bağlam bütçesini hesaplamasını sağlar.

OpenAI Compatible sağlayıcısını seçin, temel URL'yi ve anahtarı yapıştırın; Roo Code'un kendi bütçelemesinin doğru olması için modelin bağlam penceresini ve maksimum çıktısını ayarlayın.

Roo Code ayarları paneli

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on

Roo Code, geri dönüş seçeneği olmaksızın modele yerleşik araç çağrısını kullanır. Bu nedenle seçtiğiniz model OpenAI uyumlu araç çağrılarını desteklemelidir. Aşağıdaki tablodaki tüm id'ler bunu destekler; burada yapılandırılan yalnızca metin veya medya modelleri, kurulum sırasında değil, ajan ilk aracı kullanmaya çalıştığında hata verir.

Varsayılanları olduğu gibi bırakmak yerine Context Window ve Max Output Tokens alanlarını doldurun. Roo Code, konuşmanın ne zaman özetleneceğine bu sayılara göre karar verir. Bu nedenle bağlam penceresini çok düşük ayarlamak, gereksiz yere geçmişi kesmesine; çok yüksek ayarlamak ise düzgün bir özetleme yerine üst akıştan 400 hataları almasına yol açar.

Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Roo Code kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Roo Code ayarları panelini açın ve API Provider değerini OpenAI Compatible olarak ayarlayın.
Base URL alanına https://api.kunavo.com/v1 adresini ve anahtarınızı girin. /v1 soneki temel URL'de bulunmalıdır; Roo Code yalnızca yolu ekler.
Model id'sini seçin veya yazın, ardından Model Configuration bölümünü açıp bağlam penceresini, maksimum çıktı belirteci sayısını, görüntü desteğini ve girdi/çıktı fiyatlarını aşağıdaki tablodaki değerlere göre ayarlayın.
Code modunda bir mesaj gönderin. Buraya girilen fiyatlar, Roo Code'un görev başına maliyet göstergesinin kullandığı değerlerdir; bu yüzden doğru girmek önemlidir.

Roo Code'un OpenAI Compatible sağlayıcı sayfası ile 6 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber Roo Code + Claude adım adım kılavuzu içindedir.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Roo Code içinde çalışır.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliği	Kunavo giriş / çıkış	Roo Code içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	Code modu — varsayılan mod ve maliyet göstergesinin temel aldığı mod
`claude-opus-5`	$3.50 / $17.50	Architect modu; burada yanlış bir planın maliyeti belirteçlerden fazladır
`claude-haiku-4-5`	$0.70 / $3.50	Ask modu ve yinelenen dosya okumaları
`gpt-5-6-terra`	$0.70 / $4.20	büyük bir depoda uzun bağlamlı taramalar

Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Sık sorulan sorular

Roo Code'u özel bir OpenAI uyumlu uç noktaya nasıl yönlendiririm?

Roo Code ayarları panelinde API Provider değerini "OpenAI Compatible" olarak ayarlayın; ardından bu uç noktanın Base URL ve API Key değerlerini girip bir model seçin. Roo Code yalnızca yolu eklediği için temel URL, hizmetin /v1 köküdür. Roo Code'un kendi belgeleri Base URL alanının kritik olduğunu belirtir; çünkü her isteğin nereye gideceğini bu alan belirler.

Roo Code'da özel bir uç nokta üzerinden hangi modeller çalışır?

OpenAI uyumlu yerleşik araç çağrısını destekleyen ve uç noktanın sunduğu tüm modeller. Roo Code yalnızca modele yerleşik araç çağrılarını kullanır ve geri dönüş modu yoktur. Bu nedenle araç desteği olmayan bir model bağlanır ancak ajan dosyayı okumaya veya yazmaya çalıştığı anda hata verir. Claude ve GPT metin modellerinin tümü uygundur; görüntü, video ve ses modelleri uygun değildir.

Roo Code'un Context Window ve Max Output Tokens alanlarına ne girmeliyim?

Varsayılan değerleri değil, seçtiğiniz modelin gerçek sınırlarını girin. Roo Code bu iki sayıyı konuşmayı ne zaman özetleyeceğine karar vermek için kullanır. Bu nedenle modelin gerçek bağlam sınırının altındaki bir değer, geçmişi gereksiz yere silmesine; bu sınırı aşan bir değer ise düzgün bir özetleme yerine üst akıştan 400 hataları almasına yol açar. Model başına değerler uç noktanın model kataloğunda bulunur.

Roo Code bir görev için neden yanlış maliyet bildiriyor?

Çünkü Model Configuration bölümündeki Input Price ve Output Price elle girilir ve varsayılan olarak sıfır ya da başka bir sağlayıcının ücretleri kullanılır. Roo Code görev başına maliyet göstergesini tamamen bu iki alana göre hesaplar; uç noktadan fiyatları almaz. Bu nedenle gösterilen değer, yalnızca girilen değerler kadar doğrudur. Ücretleri sağlayıcının kendi kataloğundan kopyalayın.