Mistral Vibe CLI

.vibe/config.toml의 5줄 [[providers]] 블록 — api_base, api_key_env_var, api_style — 로 Vibe CLI를 Kunavo에 연결하며 키는 파일이 아닌 환경 변수에 저장됩니다

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

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. ~/.vibe/config.toml를 열거나, 설정을 적용할 저장소에 ./.vibe/config.toml를 만들고 위 블록을 붙여 넣으세요. 클릭해서 공급자를 추가하는 절차는 없습니다. Mistral은 이 파일을 직접 편집하도록 안내하며, /config와 /model는 이미 존재하는 사전 설정 사이에서만 전환합니다.
3. api_key_env_var에서 지정한 변수 export KUNAVO_API_KEY="sk-kn-..."를 내보내세요. Mistral의 인증 정보 페이지에서는 CLI가 시작할 때 인증 정보 파일 ~/.vibe/.env를 불러온다고 설명하며, Mistral의 타사 예시에서는 Mistral이 아닌 키에 셸 export를 사용합니다.
4. 사용하려는 각 ID에 대해 [[models]] 사전 설정을 하나씩 추가하고, 각각에 자체 alias를 지정한 다음 active_model를 별칭 중 하나로 설정하세요. 별칭은 로컬에서만 사용되며, /model에 표시되는 이름입니다. 실제로 엔드포인트에 전달되는 ID는 name입니다.
5. 신뢰할 수 있는 폴더에서 vibe를 실행하고 인사말이 아니라 파일을 다루는 작업을 맡기세요. 파일을 읽고 수정하는 첫 턴으로 도구 호출을 확인할 수 있으며, 공급자 설정 오류는 대개 이 과정에서 드러납니다.

Mistral Vibe Code CLI 구성 페이지에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 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-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모든 트래픽이 이 공급자로 전송되는 것은 아닙니다

구성 블록만으로는 알 수 없는 내용이며, Kunavo가 아니라 Vibe에 해당합니다. v2.25.5에서 CLI는 백그라운드 “유틸리티” 완료 요청(대화와 작업 트리의 이름을 지정하는 소규모 호출)을 Mistral 공급자를 사용할 수 있을 때마다 Mistral 자체의 mistral-vibe-cli-fast 모델로 전송합니다. 기본 제공 설정에는 항상 공급자가 지정되어 있으므로, 세션의 활성 모델이 사용자 지정 모델이어도 마찬가지입니다. 소스에는 우선순위와 대체 동작이 모두 명시되어 있습니다. 사용할 수 있는 Mistral 공급자가 없으면 유틸리티 호출은 세션의 활성 모델로 전송됩니다.

따라서 세션의 모든 요청을 설정한 공급자로 보내려면 다음 중 하나가 충족되어야 합니다.

• MISTRAL_API_KEY를 설정하지 않아 빠른 모델의 인증 정보를 확인할 수 없고, 유틸리티 호출이 대체 경로로 전송되거나
• allowed_models를 통해 빠른 모델의 별칭이 제외되어야 합니다. 이 경우 키 대신 허용 목록 설정으로 같은 효과를 냅니다.

Smart Approve 분류기는 더 나아갑니다. 버전 2.25.1 변경 로그에 따르면 세션의 활성 모델과 관계없이 빠른 Mistral 모델에서 실행됩니다. 따라서 Kunavo만 사용하는 세션에서는 현실적으로 Smart Approve보다 accept-edits 또는 plan를 사용하게 됩니다. 이 동작이 위 구성을 깨뜨리는 것은 아닙니다. 다만 공급자 블록은 모델 턴에 적용되며 바이너리가 전송하는 모든 요청에 적용되는 것은 아닙니다.

그 밖의 api_style 값

문서에는 api_style의 값 하나가 예시로 나와 있습니다. "openai"입니다. v2.25.5 소스에는 "anthropic", "openai-responses", "reasoning", "vertex-anthropic" 등 네 가지 값이 더 있지만, 유효성 검사 없이 일반 딕셔너리에 정의되어 있습니다. 따라서 오타는 파일을 불러올 때가 아니라 요청 시점에 드러납니다. 이 값들은 소스에서 확인했지만 문서화되지 않은 것으로 취급하세요. Anthropic 값을 사용하려는 경우 주의할 점이 있습니다. 해당 어댑터의 엔드포인트는 /v1/messages이므로, api_base는 위 블록과 반대로 접미사 /v1가 없는 기본 주소 https://api.kunavo.com여야 합니다. Kunavo는 ID가 claude-로 시작하는 경우 /v1/messages에도 응답합니다. 이 페이지에서는 Mistral 문서에 나온 openai 스타일을 사용합니다.