Mistral Vibe CLI

Một khối [[providers]] năm dòng trong .vibe/config.toml — api_base, api_key_env_var, api_style — trỏ Vibe CLI tới Kunavo, với key nằm trong biến môi trường thay vì tệp.

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

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Mở ~/.vibe/config.toml (hoặc tạo ./.vibe/config.toml trong kho mã mà bạn muốn áp dụng cấu hình này) rồi dán khối ở trên. Không có quy trình thêm nhà cung cấp để nhấp qua: Mistral hướng dẫn chỉnh sửa trực tiếp tệp này, còn /config và /model chỉ chuyển đổi giữa các cấu hình sẵn có.
3. Export biến bạn đã khai báo trong api_key_env_var — export KUNAVO_API_KEY="sk-kn-...". Trang thông tin xác thực của Mistral ghi rõ CLI tải ~/.vibe/.env lúc khởi động để lấy thông tin xác thực, và ví dụ riêng của họ về nhà cung cấp bên thứ ba dùng lệnh shell export cho khóa không thuộc Mistral.
4. Thêm một cấu hình sẵn có [[models]] cho mỗi id bạn muốn dùng, mỗi cấu hình có alias riêng, rồi đặt active_model trỏ đến một trong các bí danh đó. Bí danh chỉ có hiệu lực cục bộ — đó là giá trị được liệt kê trong /model, còn name là id thực sự được gửi đến endpoint.
5. Chạy vibe trong một thư mục đáng tin cậy và giao cho Vibe một việc có thao tác với tệp, không phải lời chào. Lượt đầu tiên đọc và chỉnh sửa tệp sẽ kiểm tra tính năng gọi công cụ, vốn là nơi cấu hình nhà cung cấp sai thường bộc lộ.

Đã kiểm tra đối chiếu với trang cấu hình Vibe Code CLI của Mistral vào 21 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong 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-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Không phải mọi yêu cầu của bạn đều đi qua nhà cung cấp này

Đây là điều mà một khối cấu hình không thể cho bạn biết, và chỉ riêng Vibe mới có đặc điểm này, không liên quan đến Kunavo. Ở phiên bản v2.25.5, CLI định tuyến các yêu cầu hoàn tất tiện ích chạy nền — những lời gọi nhỏ dùng để đặt tên cho các cuộc trò chuyện và worktree — đến mô hình riêng mistral-vibe-cli-fast của Mistral bất cứ khi nào có thể sử dụng một nhà cung cấp Mistral. Các giá trị mặc định đi kèm luôn cấu hình một nhà cung cấp như vậy, ngay cả khi mô hình đang hoạt động trong phiên là của bạn. Mã nguồn nói rõ cả lựa chọn ưu tiên lẫn phương án dự phòng: khi không thể sử dụng nhà cung cấp Mistral nào, yêu cầu tiện ích sẽ được gửi đến mô hình đang hoạt động của phiên.

Vì vậy, nếu bạn muốn mọi yêu cầu trong phiên đều được gửi đến nhà cung cấp đã cấu hình, cần thỏa mãn một trong các điều kiện sau:

• MISTRAL_API_KEY chưa được đặt, nên thông tin xác thực của mô hình nhanh không được phân giải và yêu cầu tiện ích chuyển sang phương án dự phòng; hoặc
• bí danh của mô hình nhanh bị loại khỏi danh sách qua allowed_models, tạo ra cùng kết quả bằng danh sách cho phép thay vì bằng khóa.

Bộ phân loại Smart Approve còn đi xa hơn — mục trong changelog phiên bản 2.25.1 cho biết bộ phân loại này chạy trên mô hình Mistral nhanh bất kể mô hình đang hoạt động trong phiên là gì — vì vậy, một phiên chỉ dùng Kunavo trên thực tế sẽ ở accept-edits hoặc plan thay vì Smart Approve. Những điều này không làm cấu hình ở trên mất tác dụng; chúng chỉ có nghĩa là khối nhà cung cấp áp dụng cho các lượt mô hình của bạn, chứ không phải mọi gói tin mà chương trình gửi đi.

Các giá trị api_style khác

Tài liệu liệt kê một giá trị cho api_style và mô tả nó là ví dụ: "openai". Mã nguồn v2.25.5 có thêm bốn giá trị — "anthropic", "openai-responses", "reasoning" và "vertex-anthropic" — trong một từ điển thông thường không có bước xác thực, vì vậy lỗi chính tả chỉ xuất hiện lúc gửi yêu cầu chứ không phải lúc tải tệp. Hãy xem các giá trị này là đã được xác minh từ mã nguồn nhưng chưa được tài liệu hóa. Nếu thử giá trị Anthropic, hãy lưu ý một điểm dễ nhầm: endpoint của bộ chuyển đổi là /v1/messages, vì vậy api_base phải là origin gốc, https://api.kunavo.com, không có /v1 — trái ngược với khối cấu hình ở trên. Kunavo có phản hồi với /v1/messages cho các id bắt đầu bằng claude-. Trang này trình bày kiểu openai vì đó là kiểu được Mistral tài liệu hóa.