Mistral Vibe CLI

Um bloco [[providers]] de cinco linhas em .vibe/config.toml — api_base, api_key_env_var, api_style — aponta o Vibe CLI para a Kunavo, com a chave em uma variável de ambiente em vez do arquivo.

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

Passo a passo

1. Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
2. Abra ~/.vibe/config.toml (ou crie ./.vibe/config.toml no repositório em que deseja aplicar a configuração) e cole o bloco acima. Não há um fluxo de configuração de provedor para percorrer: a Mistral documenta esse arquivo como editável manualmente, e /config e /model apenas alternam entre configurações predefinidas já existentes.
3. Exporte a variável definida em api_key_env_var — export KUNAVO_API_KEY="sk-kn-...". A página de credenciais da Mistral identifica ~/.vibe/.env como o arquivo carregado pela CLI na inicialização para obter credenciais, e o exemplo da própria Mistral com um provedor de terceiros usa o comando de shell export para a chave que não é da Mistral.
4. Adicione uma configuração predefinida [[models]] para cada ID desejado, cada uma com seu próprio alias, e depois defina active_model como um desses aliases. O alias é local: é o que aparece em /model, enquanto name é o ID enviado ao endpoint.
5. Execute vibe em uma pasta confiável e dê ao agente algo que altere um arquivo, não uma saudação. Um primeiro turno que lê e edita um arquivo exercita as chamadas de ferramentas, onde um provedor mal configurado costuma revelar o problema.

Verificado em página de configuração do Mistral Vibe Code CLI em 21 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em 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-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

Nem todo o seu tráfego passa por este provedor

Esta é uma particularidade que um bloco de configuração não revela, e que diz respeito ao Vibe, não ao Kunavo. Na versão v2.25.5, a CLI encaminha conclusões de “utilitários” em segundo plano — chamadas pequenas que dão nomes a conversas e worktrees — para o modelo próprio da Mistral mistral-vibe-cli-fast sempre que um provedor Mistral está disponível. Os valores padrão distribuídos sempre configuram um, mesmo quando o modelo ativo da sessão é o seu. O código-fonte deixa explícitos tanto essa preferência quanto o fallback: quando nenhum provedor Mistral está disponível, a chamada de utilitário usa o modelo ativo da sessão.

Portanto, para que todas as solicitações da sessão usem o provedor configurado, uma destas condições precisa ser atendida:

• MISTRAL_API_KEY não está definido, então as credenciais do modelo rápido não são resolvidas e a chamada de utilitário usa o fallback; ou
• o alias do modelo rápido é excluído por meio de allowed_models, o que produz o mesmo efeito pela lista de permissões, em vez de pela chave.

O classificador Smart Approve vai além: a entrada correspondente no changelog da versão 2.25.1 informa que ele usa o modelo rápido da Mistral independentemente do modelo ativo da sessão. Portanto, na prática, uma sessão que use apenas o Kunavo precisa funcionar no modo accept-edits ou plan, e não no Smart Approve. Nada disso impede a configuração acima; significa apenas que o bloco do provedor diz respeito aos turnos do seu modelo, não a cada solicitação enviada pelo binário.

Os outros valores de api_style

A documentação apresenta um valor para api_style e o descreve como exemplo: "openai". O código-fonte da versão v2.25.5 inclui outros quatro — "anthropic", "openai-responses", "reasoning" e "vertex-anthropic" — em um dicionário simples, sem validação. Por isso, um erro de digitação só aparece no momento da solicitação, não quando o arquivo é carregado. Considere esses valores verificados no código-fonte, mas não documentados. Se experimentar o valor Anthropic, atente para uma particularidade: o endpoint do adaptador é /v1/messages. Portanto, api_base deve ser apenas a origem, https://api.kunavo.com, sem /v1 — o oposto do bloco acima. O Kunavo responde a /v1/messages para IDs que começam com claude-. Esta página usa o estilo openai porque é o documentado pela Mistral.