Mistral Vibe CLI

Blok [[providers]] lima baris di .vibe/config.toml — api_base, api_key_env_var, api_style — mengarahkan Vibe CLI ke Kunavo, dengan key disimpan dalam variabel lingkungan, bukan file.

# ./.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-..."

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Buka ~/.vibe/config.toml (atau buat ./.vibe/config.toml di repositori tempat Anda ingin konfigurasi ini berlaku), lalu tempel blok di atas. Tidak ada alur penyedia baru yang perlu diklik: Mistral menyatakan bahwa berkas ini diedit secara manual, sementara /config dan /model hanya beralih di antara preset yang sudah ada.
3. Ekspor variabel yang Anda beri nama di api_key_env_var — export KUNAVO_API_KEY="sk-kn-...". Halaman kredensial Mistral menyebut ~/.vibe/.env sebagai berkas yang dimuat CLI saat mulai untuk mengambil kredensial, dan contoh pihak ketiga mereka sendiri menggunakan export shell untuk kunci non-Mistral.
4. Tambahkan satu preset [[models]] untuk setiap ID yang diinginkan, masing-masing dengan alias tersendiri, lalu arahkan active_model ke salah satu alias tersebut. Alias ini hanya berlaku secara lokal — alias inilah yang ditampilkan oleh /model, sementara name adalah ID yang benar-benar dikirim ke endpoint.
5. Jalankan vibe di folder tepercaya dan berikan tugas yang menyentuh berkas, bukan sekadar sapaan. Giliran pertama yang membaca dan mengedit berkas akan menguji pemanggilan alat, yang biasanya menjadi tempat terlihatnya kesalahan konfigurasi penyedia.

Diperiksa terhadap halaman konfigurasi Mistral Vibe Code CLI pada 21 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Mistral Vibe CLI.

# 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-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

Tidak semua lalu lintas Anda menuju penyedia ini

Inilah hal yang tidak dapat Anda ketahui dari blok konfigurasi, dan ini khusus untuk Vibe, bukan Kunavo. Pada v2.25.5, CLI mengarahkan penyelesaian “utilitas” latar belakang — panggilan kecil untuk memberi nama pada percakapan dan worktree — ke model mistral-vibe-cli-fast milik Mistral setiap kali penyedia Mistral dapat digunakan. Setelan bawaan yang disertakan selalu mengonfigurasi salah satunya, bahkan saat model aktif dalam sesi adalah milik Anda. Kode sumber menjelaskan preferensi dan pilihan alternatif ini secara eksplisit: jika tidak ada penyedia Mistral yang dapat digunakan, panggilan utilitas akan menggunakan model aktif sesi.

Jadi, jika Anda ingin setiap permintaan dalam sesi diarahkan ke penyedia yang Anda konfigurasi, salah satu kondisi berikut harus terpenuhi:

• MISTRAL_API_KEY tidak ditetapkan, sehingga kredensial model cepat tidak dapat diresolusikan dan panggilan utilitas beralih ke model alternatif; atau
• alias model cepat dikecualikan melalui allowed_models, sehingga hasilnya sama melalui daftar yang diizinkan, bukan melalui kuncinya.

Pengklasifikasi Smart Approve bertindak lebih jauh — entri changelog 2.25.1 menyatakan bahwa pengklasifikasi tersebut berjalan pada model cepat Mistral terlepas dari model aktif sesi — jadi sesi yang hanya menggunakan Kunavo secara realistis akan memakai accept-edits atau plan, bukan Smart Approve. Hal ini tidak merusak konfigurasi di atas; artinya, blok penyedia Anda mengatur giliran model, bukan setiap paket yang dikirim oleh biner.

Nilai api_style lainnya

Dokumentasi mencantumkan satu nilai untuk api_style dan menjelaskannya sebagai contoh: "openai". Kode sumber v2.25.5 memuat empat nilai lainnya — "anthropic", "openai-responses", "reasoning" dan "vertex-anthropic" — dalam kamus sederhana tanpa validasi. Karena itu, kesalahan pengetikan baru terlihat saat permintaan dikirim, bukan ketika berkas dimuat. Anggap nilai-nilai ini telah diverifikasi dari kode sumber, tetapi tidak didokumentasikan. Perhatikan satu jebakan jika Anda mencoba nilai Anthropic: endpoint adaptornya adalah /v1/messages, jadi api_base harus berupa origin dasar, https://api.kunavo.com, tanpa /v1 — kebalikan dari blok di atas. Kunavo memang menjawab /v1/messages untuk ID yang diawali claude-. Halaman ini menggunakan gaya openai karena itulah yang didokumentasikan Mistral.