Dokümantasyon

Kimi Code

Kimi Code sağlayıcılarını bir TOML dosyasında tutar; üçüncü taraf bir uç nokta için bu dosyada üç anahtar bulunur: type, base_url, api_key. Birini Kunavo'ya yönlendirin; CLI, zaten konuştuğu protokol üzerinden Claude ve GPT kimlikleriyle iletişim kurar.

Kimi Code, sağlayıcıları ~/.kimi-code/config.toml içinde tutar — providers.<name>.base_url değerini type = "openai" ile https://api.kunavo.com/v1 olarak ayarlayın; CLI, Claude ve GPT kimliklerini tek anahtarla çalıştırır.

~/.kimi-code/config.toml

default_model = "kunavo/claude-sonnet-5"

[providers.kunavo]
type = "openai"
base_url = "https://api.kunavo.com/v1"
api_key = "sk-kn-..."

[models."kunavo/claude-sonnet-5"]
provider = "kunavo"
model = "claude-sonnet-5"
max_context_size = 200000

base_url /v1 son ekini korur. Sağlayıcılar sayfası çıkarım yapmaya gerek bırakmaz: type = "openai" için belgelenen varsayılan https://api.openai.com/v1, üçüncü taraf uç nokta için ortam değişkenleri sayfasında verilen örnek ise KIMI_MODEL_BASE_URL="https://api.example.com/v1". Kimi Code yalnızca yolu eklediğinden, burada yalın bir kök adres kullanılması kimlik doğrulama hatası yerine 404'e yol açar. https://api.kunavo.com isteyen Anthropic protokolü istemcilerinde ise bunun tersi geçerlidir.

Bir kabuk değişkenini dışa aktarmak sağlayıcıya anahtar vermez. Kimi Code'un kendi yapılandırma dosyaları sayfası bu konuda açıktır: terminalde export KIMI_API_KEY çalıştırmak hiçbir sağlayıcıya anahtarını vermez. Belgelenen öncelik sırası api_key veya api_key_env şeklindedir; tam olarak birini ayarlayın, çünkü birbirlerini dışlarlar. İkisi de yoksa [providers.kunavo.env] alt tablosundaki anahtar kullanılır; üçünün de bulunmaması durumunda başlatma hata vererek başarısız olur. Anahtarı dosyaya yazmamak için api_key yerine api_key_env = "KUNAVO_API_KEY" yazın; ayarlanmamış veya boş bir değişken, değişkenin adını belirten bir hatayla isteğin başarısız olmasına neden olur.

Kunavo bu istemciyi kendi uç noktasında çalıştırmadı. Yukarıdaki blok bir oturumdan değil, Kimi Code'un güncel belgelerinden alınmıştır: burada Kimi Code ile akışlı yanıt veya araç çağrısı çalıştırıldığı kaydedilmedi; bu nedenle ilk gerçek isteği doğrulama değil, sınama olarak değerlendirin. Yayımlanan sayfa kurulum talimatıdır, kabul testi değildir.

type satıcıyı değil, protokolü belirtir. Belgelenen seçenekler kimi, anthropic, openai, openai_responses, google-genai ve vertexai şeklindedir; mevcut tabloda eski OpenAI varyantı yoktur. Dolayısıyla bunu ayarlamanızı söyleyen bir yazı, mevcut tablodan daha eskidir. openai seçip ardından bir Claude model kimliği yazmak amaçlanan birleşimdir: kimlik CLI'da değil, temel URL'de çö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 Kimi 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.
İlk çalıştırmada oluşturulan ~/.kimi-code/config.toml dosyasını açın. KIMI_CODE_HOME ile veri dizinini değiştirdiyseniz dosya $KIMI_CODE_HOME/config.toml konumundadır; dosya adı her zaman config.toml olur.
Yukarıdaki [providers.kunavo] tablosunu ekleyin. Belgelerin bu tür için gösterdiği üç anahtar, sırasıyla type, base_url ve api_key şeklindedir.
[models."..."] altında provider, model ve max_context_size değerlerini içeren bir model takma adı tanımlayın; üçünün de bulunması gerekir. Takma ad, -m ve default_model komutlarına ilettiğiniz addır; model değeri ise iletişim protokolü üzerinden gönderilen kimliktir. Nokta içeren takma adları tırnak içine alın.
İlk denemede capabilities alanını eklemeyin. Sağlayıcılar sayfası, özelliklerin model adı önekine göre otomatik eşleştirildiğini; modeller tablosu ise dizinin yalnızca genişletilebildiğini, hiçbir zaman öğe çıkarılmadığını belirtiyor. Bu nedenle yanlış bir etiket daha sonra yapılandırmayı düzenleyerek kaldırılamaz.
kimi komutunu çalıştırın veya tek bir oturum için takma adı seçmek üzere kimi -m kunavo/claude-sonnet-5 komutunu kullanın. Yapılandırmaya hiç dokunmadan uç noktayı denemek için KIMI_MODEL_NAME, KIMI_MODEL_API_KEY, KIMI_MODEL_PROVIDER_TYPE=openai ve KIMI_MODEL_BASE_URL değerlerini ayarlayın; CLI bellekte bir sağlayıcı oluşturur ve yapılandırmaya hiçbir şey yazmaz.

Kimi Code'un sağlayıcılar ve modeller sayfası ile 21 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 Kimi Code ve Claude Code karşılaştırması — hangi istemci, hangi model, hangi hesap 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 Kimi 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ış	Kimi Code içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	varsayılan takma ad — düzenleme ve çalıştırma döngüleri için kullanılan model
`claude-opus-5`	$3.50 / $17.50	Hatalı bir planın maliyetli olduğu planlama aşamaları için ikinci takma ad
`claude-haiku-4-5`	$0.70 / $3.50	alt ajanlar için [secondary_model] altında atanacak ucuz takma ad
`gpt-5-6-sol`	$2.00 / $12.00	aynı anahtar ve sağlayıcı tablosuyla, 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

Kimi Code'u özel bir API uç noktasına nasıl yönlendiririm?

~/.kimi-code/config.toml içine type = "openai" olan bir sağlayıcı tablosu ekleyin, base_url değerini uç noktanıza, api_key değerini de anahtarınıza ayarlayın. Ardından [models."<alias>"] altında provider, model ve max_context_size değerlerini içeren bir model takma adı tanımlayın. Kimi Code'un sağlayıcılar sayfasında type = "openai" türünün, OpenAI Chat Completions protokolü ve bu protokolle uyumlu tüm üçüncü taraf hizmetler için olduğu belgelenmiştir; gerektiğinde base_url değerini değiştirebilirsiniz. TUI'de /provider komutuyla sağlayıcı yöneticisini de açabilirsiniz. Ancak bilinen sağlayıcılar yolu models.dev kataloğundan içe aktarma yapar; bu katalogda bulunmayan bir uç noktayı elle eklemek daha hızlıdır.

Kimi Code base_url değerinin sonunda /v1 bulunmalı mı?

OpenAI uyumlu bir uç nokta için evet. Kimi Code yalnızca yolu eklediğinden base_url, /v1 kökü olmalıdır; örneğin https://api.kunavo.com/v1. Belgeler çıkarım gerektirmeden bunu açıklıyor: type = "openai" için varsayılan base_url https://api.openai.com/v1, ortam değişkenleri sayfasındaki üçüncü taraf örneği ise https://api.example.com/v1. /v1 eksikse 401 değil, 404 alınır.

Değişken dışa aktarılmış olmasına rağmen Kimi Code neden API anahtarımın eksik olduğunu söylüyor?

Çünkü hangi değişkeni okuyacağını belirtmediğiniz sürece kimlik bilgileri için kabuk ortam değişkenlerini okumaz. Yapılandırma dosyaları sayfasında, export KIMI_API_KEY komutunu çalıştırmanın hiçbir sağlayıcıya anahtar vermediği açıkça belirtilir. Ya api_key değerini doğrudan config.toml dosyasına yazın ya da api_key_env değerini değişkenin adı olarak ayarlayın; bu ikisi birbirini dışlar, bu yüzden yalnızca birini ayarlayın. [providers.<name>.env] alt tablosuna yalnızca ikisi de yoksa bakılır; üçünün de bulunmaması durumunda başlatma bir hatayla başarısız olur.

Kimi Code, Claude modellerini üçüncü taraf bir sağlayıcı üzerinden çalıştırabilir mi?

Sağlayıcı türü satıcıyı değil protokolü belirtir ve model değeri yapılandırdığınız base_url adresine iletilir; dolayısıyla openai türündeki bir sağlayıcıya ayarlanan Claude kimliği CLI'da değil, bu uç noktada çözümlenir. Kimi Code'da Anthropic Messages protokolü için ayrı bir type = "anthropic" sağlayıcısı da bulunur; bunun temel URL'si /v1 son eki olmayan yalın kök adrestir. Kunavo, Kimi Code oturumunu kendi uç noktasında iki protokolle de çalıştırmadı. Bu nedenle yukarıdaki curl komutuyla doğrulayın ve ilk oturumunuzu sınama olarak değerlendirin.