Dokümantasyon

Kilo Code

Kilo Code'un özel sağlayıcısı dört alandan oluşur. Bunları doldurduğunuzda eklenti, Claude ve GPT ile tek anahtar üzerinden konuşur — uç noktanın arkasındaki satıcının kim olduğunu hiçbir zaman öğrenmez.

Providers → Custom provider → OpenAI Compatible, /v1 içeren temel URL ve yazılmış Claude model kimliği — Kilo Code arkasındaki satıcının kim olduğunu asla öğrenmez.

Ayarlar → Sağlayıcılar → Özel sağlayıcı

Provider ID    kunavo
Display name   Kunavo
Provider API   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API key        sk-kn-...
Models         claude-sonnet-5
               claude-opus-5
               claude-haiku-4-5

Temel URL burada /v1 son ekini korur; Kilo Code yalnızca yolu ekler ve kendi belgelenmiş örneği de /v1 ile biter. Bu, yalın kök adres isteyen Anthropic tarzı istemcilerin tersidir.

Provider API bir satıcı seçicisi değil, protokol seçicisidir. OpenAI Compatible seçip ardından bir Claude model kimliği girmek amaçlanan birleşimdir: kimlik uzantıda değil, uç noktada çözümlenir.

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 Kilo 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.
Kilo Code ayarlarını (dişli simgesi) açın, Providers sekmesine gidin, en alta kaydırıp Custom provider seçeneğine tıklayın.
Provider ID, Display name, Provider API = OpenAI Compatible, Base URL ve API key alanlarını yukarıda gösterildiği gibi doldurun.
Models bölümünde kimlikleri elle ekleyin veya otomatik alınan listeden seçin; Kunavo GET /v1/models yanıtı verdiği için liste kendiliğinden dolar.
Sağlayıcıyı sohbet modu seçicisinde belirleyip bir mesaj gönderin. Sürekli çalışan modlara ucuz bir modeli, planlama yapan modlara ise pahalı bir modeli sabitleyin.

Kilo 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 Kilo 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 Kilo 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ış	Kilo Code içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	Code ve Architect modları — varsayılan çalışma modeli
`claude-opus-5`	$3.50 / $17.50	Hatalı bir planın maliyetli olduğu büyük yeniden düzenlemelerde Architect modu
`claude-haiku-4-5`	$0.70 / $3.50	Hacmin belirleyici olduğu Ask modu ve hızlı dosya incelemesi
`gpt-5-6-sol`	$2.00 / $12.00	aynı anahtarla, farklı bir aileden ikinci bir görüş

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

Kilo Code'a özel bir sağlayıcıyı nasıl eklerim?

Kilo Code ayarlarını dişli simgesiyle açın, Providers sekmesine gidin, listenin en altına kaydırıp "Custom provider" seçeneğine tıklayın. Bir Provider ID ve Display name girin, Provider API değerini "OpenAI Compatible" olarak ayarlayın, uç noktanın temel URL'sini ve API key değerini yapıştırın; ardından model kimliklerini elle veya otomatik alınan listeden ekleyin. Sağlayıcı daha sonra yerleşik sağlayıcılar gibi mod seçicisinde görünür.

Kilo Code, Anthropic hesabı olmadan Claude modellerini kullanabilir mi?

Evet. Kilo Code'un "OpenAI Compatible" Provider API seçeneği satıcıyı değil, iletişim protokolünü belirtir ve model kimliğini doğrudan yapılandırdığınız temel URL'ye iletir. Dolayısıyla Claude kimliği uzantıda değil, bu uç noktada çözümlenir; kullandığınız kimlik bilgileri Anthropic'e değil, uç noktaya aittir.

Kilo Code temel URL'sinin sonunda /v1 bulunmalı mı?

OpenAI uyumlu bir uç nokta için evet. Kilo Code yalnızca yolu ekler: /chat/completions, /models. Bu nedenle temel URL'nin /v1 kökü olması gerekir; örneğin https://api.kunavo.com/v1. Kendi belgelenmiş örneğinde de aynı son ek yer alır. /v1 eksikse kimlik doğrulama hatası yerine 404 alınır.

Sağlayıcı ekledikten sonra Kilo Code neden model göstermiyor?

Model listesi, girdiğiniz anahtarla uç noktanın /v1/models yolundan alınır. Bu nedenle listenin boş olması genellikle sağlayıcının model içermediği değil, anahtarın veya temel URL'nin yanlış olduğu anlamına gelir. Aynı ikiliyi /v1/models yoluna düz bir curl isteği göndererek sınayın: JSON yanıtı sorunun uzantı yapılandırmasında olduğunu, 401 anahtarın, 404 ise URL'nin sorunlu olduğunu gösterir. Modelleri her zaman elle de girebilirsiniz.