Chave de API e Variáveis de Ambiente
Nesta página
Lição atualizada em 2 de novembro de 2026 com base em Chaves de API e perfis: a chave inserida durante a instalação vai para o chaveiro do sistema (o ficheiro
~/.vibe/.envserve apenas de fallback), o login via navegador é oferecido por predefinição e/statusou/whoamiindicam a fonte utilizada. Fonte: API keys and profiles.
Obter a Sua Chave de API Mistral
Para utilizar o Vibe, precisa de uma chave de API Mistral. Esta chave autentica os seus pedidos e permite ao Vibe comunicar com os modelos da Mistral. Sem ela, a ferramenta instala-se e inicia, mas nenhuma geração é possível. Crie a chave na Consola da Mistral em seis passos:
- Aceda a console.mistral.ai
- Crie uma conta ou inicie sessão
- Navegue até à secção API Keys
- Clique em Create new key
- Atribua-lhe um nome descritivo (ex: “vibe-cli-dev”)
- Copie a chave imediatamente — não voltará a ser mostrada
Este último ponto não é mera formalidade: a chave só é visível uma vez. Se fechar o separador demasiado cedo, terá de gerar uma nova. A chave segue o formato sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx e deve permanecer confidencial. Quem a tiver pode utilizar a sua quota de API — e, consequentemente, gastar o seu orçamento.
Três Métodos de Configuração
O Vibe aceita três formas de fornecer esta chave. A sua escolha depende inteiramente do seu contexto de trabalho.
Método 1: Configuração Interativa
Este é o método predefinido no primeiro arranque e o mais simples para uma estação de trabalho pessoal. O Vibe pede-lhe a chave diretamente e guarda-a:
vibe
# → "Please enter your Mistral API key:"
# Cole a sua chave, prima Enter
A chave é armazenada no seu chaveiro do sistema (macOS Keychain, Windows Credential Manager…). Se não houver chaveiro disponível, recorre ao ficheiro ~/.vibe/.env, que só é legível por si. Note que, no primeiro arranque, iniciar sessão no navegador com a sua conta Mistral elimina frequentemente a necessidade de uma chave. Para ver qual a fonte que o Vibe está realmente a usar, digite /status ou /whoami durante uma sessão.
# Se a chave estiver no ficheiro .env (sem chaveiro disponível)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
Método 2: Variável de Ambiente
Assim que sair do ambiente de estação de trabalho pessoal — como num pipeline de CI/CD, num script automatizado ou num servidor partilhado —, uma variável de ambiente torna-se preferível, pois não escreve nada no disco:
export MISTRAL_API_KEY="sk-your-key-here"
Para a tornar persistente na sua máquina, adicione esta linha ao ficheiro de configuração da sua shell:
# Em ~/.bashrc, ~/.zshrc ou ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
A variável de ambiente tem prioridade sobre o ficheiro .env. Isto permite um padrão de utilização muito prático: alternar temporariamente entre chaves sem fazer alterações permanentes. Pode trabalhar com a sua chave de desenvolvimento e depois prefixar um único comando com uma chave diferente para uma operação sensível:
# Chave de desenvolvimento
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Chave de produção (temporária)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
Método 3: Ficheiro config.toml
Por fim, pode referenciar a variável de ambiente no ficheiro de configuração TOML do Vibe:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Note que este parâmetro não contém a chave em si, apenas o nome da variável a ler. Esta indireção faz sentido quando trabalha com vários fornecedores, cada um com a sua própria variável: api_key_env_var diz ao Vibe qual utilizar para a chave predefinida.
Ordem de Prioridade
Quando vários métodos estão configurados simultaneamente, o Vibe aplica esta ordem:
- Variável de ambiente
MISTRAL_API_KEY(se definida na shell) - Ficheiro
.envem~/.vibe/.env - Chaveiro do sistema, onde o assistente de configuração guarda a chave
Para um fornecedor personalizado, api_key_env_var no config.toml designa simplesmente a variável a ler, seguindo a mesma ordem.
Lembre-se da primeira linha acima: se um pedido falhar a autenticação mesmo que o seu .env contenha uma chave válida, verifique primeiro se alguma variável antiga não estará residual na sua shell a sobrepor-se.
Segurança da Chave de API
A primeira regra é nunca fazer commit da sua chave num repositório Git. Adicione .env ao seu .gitignore antes mesmo de criar o ficheiro. Um segredo enviado para um repositório público considera-se comprometido, mesmo que apague o commit mais tarde. Pela mesma lógica, não partilhe a sua chave em texto simples numa mensagem ou documento. Se suspeitar de uma fuga, regenere-a imediatamente.
Organizacionalmente, utilize chaves separadas para desenvolvimento e produção. Se uma fugir, pode revogá-la sem interromper a outra. Por fim, defina limites de gastos na Consola da Mistral. Esta é a rede de segurança mais eficaz contra um script em loop ou uma chave exposta: a faturação para automaticamente.
Verificar se a Chave Funciona
Após a configuração, não assuma nada. Teste com um pedido mínimo:
vibe "Say hello"
Se a chave for válida, o Vibe responde normalmente. Se for inválida ou expirada, receberá um erro de autenticação claro, poupando-lhe a caça à causa na instalação.
Se configurar fornecedores adicionais como o OpenRouter, cada um precisa da sua própria variável. Os dois coexistem sem problemas:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Abordaremos a configuração de fornecedores de terceiros em detalhe na lição dedicada.
Pontos-chave
- Obtenha a sua chave de API Mistral em console.mistral.ai
- Três métodos de configuração: configuração interativa, variável de ambiente, config.toml
- A variável de ambiente tem prioridade sobre o ficheiro .env
- Nunca faça commit da sua chave no Git
- Defina limites de gastos na Consola da Mistral