Mistral Vibe CLI

.vibe/config.toml içindeki beş satırlık [[providers]] bloğu — api_base, api_key_env_var, api_style — Vibe CLI'yi Kunavo'ya yönlendirir; anahtar dosyada değil, ortam değişkeninde tutulur.

# ./.vibe/config.toml (project) or ~/.vibe/config.toml (user).
# "Project-level configuration takes precedence over user-level
# configuration", and the project file loads only in a trusted folder.
active_model = "sonnet-kunavo"

[[providers]]
name = "kunavo"
api_base = "https://api.kunavo.com/v1"
api_key_env_var = "KUNAVO_API_KEY"
api_style = "openai"
backend = "generic"

[[models]]
name = "claude-sonnet-5"
provider = "kunavo"
alias = "sonnet-kunavo"
# Optional, and documented on the api-keys-profiles page:
#   temperature   sampling temperature
#   input_price   indicative per-input cost, fed to --max-price
#   output_price  indicative per-output cost, fed to --max-price
# Take the two prices from the table further down this page if you want
# --max-price to mean anything.

# The key never goes in config.toml. api_key_env_var names the variable:
#   export KUNAVO_API_KEY="sk-kn-..."

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. ~/.vibe/config.toml dosyasını açın (veya bu ayarın uygulanmasını istediğiniz depoda ./.vibe/config.toml dosyasını oluşturun) ve yukarıdaki bloğu yapıştırın. Tıklayarak kullanılabilecek bir sağlayıcı ekleme adımı yoktur: Mistral bu dosyanın elle düzenlenmesini belgeliyor; /config ve /model ise yalnızca mevcut ön ayarlar arasında geçiş yapıyor.
3. api_key_env_var alanında belirttiğiniz değişkeni dışa aktarın: export KUNAVO_API_KEY="sk-kn-...". Mistral'in kimlik bilgileri sayfasında, CLI'nin başlangıçta kimlik bilgileri için yüklediği dosyanın ~/.vibe/.env olduğu belgelenir; Mistral dışı anahtar için kendi üçüncü taraf örneğinde kabukta export komutu kullanılır.
4. İstediğiniz her kimlik için ayrı bir [[models]] ön ayarı ekleyin; her birine kendi alias değerini verin ve ardından active_model alanını bu takma adlardan birine yönlendirin. Takma ad yereldir: /model komutunun listelediği değerdir; uç noktaya gerçekten gönderilen kimlik ise name alanındaki değerdir.
5. Güvenilir bir klasörde vibe komutunu çalıştırın ve selamlama yerine bir dosyayla işlem yapan bir görev verin. Dosyayı okuyup düzenleyen ilk tur, araç çağrısını sınar; sağlayıcı yanlış yapılandırılmışsa sorun genellikle bu aşamada ortaya çıkar.

Mistral'in Vibe Code CLI yapılandırma 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.

İ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 Mistral Vibe CLI 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ış.

Trafiğinizin tamamı bu sağlayıcıya gitmez

Yapılandırma bloğunun açıklayamayacağı ve Kunavo'dan ziyade Vibe'a özgü olan kısım budur. v2.25.5'te CLI, arka plandaki “yardımcı” tamamlamaları (konuşmaları ve çalışma ağaçlarını adlandıran küçük çağrılar) kullanılabilir bir Mistral sağlayıcısı olduğunda Mistral'in kendi mistral-vibe-cli-fast modeline yönlendirir; dağıtımla gelen varsayılanlar da her zaman bir Mistral sağlayıcısı yapılandırır; oturumun etkin modeli size ait olsa bile. Kaynak kodu hem tercihi hem de yedek davranışı açıkça belirtir: kullanılabilir bir Mistral sağlayıcısı yoksa yardımcı çağrı, oturumun etkin modeline gönderilir.

Dolayısıyla oturumdaki her isteğin yapılandırdığınız sağlayıcıya gitmesini istiyorsanız şu koşullardan biri sağlanmalıdır:

• MISTRAL_API_KEY ayarlanmamış olmalı; böylece hızlı modelin kimlik bilgileri çözümlenemez ve yardımcı çağrı yedek modele yönelir; veya
• hızlı modelin takma adı allowed_models aracılığıyla dışlanır; böylece anahtar üzerinden değil, izin verilenler listesi üzerinden aynı sonuç elde edilir.

Smart Approve sınıflandırıcısı daha da ileri gider: 2.25.1 değişiklik günlüğü girdisinde, oturumun etkin modelinden bağımsız olarak hızlı Mistral modelinde çalıştığı belirtilir. Bu nedenle yalnızca Kunavo kullanılan bir oturum, gerçekçi olarak Smart Approve yerine accept-edits veya plan modunda işler. Bunların hiçbiri yukarıdaki yapılandırmayı bozmaz; yalnızca sağlayıcı bloğunun model turlarınızla ilgili olduğunu, ikilinin gönderdiği her paketle ilgili olmadığını gösterir.

Diğer api_style değerleri

Belgelerde api_style için bir değer listelenir ve bu değer örnek olarak tanımlanır: "openai". v2.25.5 kaynak kodu, doğrulama yapılmayan basit bir sözlükte dört değer daha içerir: "anthropic", "openai-responses", "reasoning" ve "vertex-anthropic". Bu nedenle yazım hatası dosya yüklenirken değil, istek sırasında ortaya çıkar. Bunları kaynak koduyla doğrulanmış ancak belgelenmemiş değerler olarak değerlendirin. Anthropic değerini denemek isterseniz bir tuzağa dikkat edin: bağdaştırıcısının uç noktası /v1/messages olduğundan api_base için yalnızca yalın temel adres olan https://api.kunavo.com kullanılmalıdır; yukarıdaki bloğun tersine /v1 eklenmemelidir. Kunavo /v1/messages isteklerini, kimlikleri claude- ile başlayan modeller için yanıtlar. Bu sayfada openai tarzı gösterilmiştir; çünkü Mistral'in belgelediği değer budur.