Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Chave de API e Variáveis de Ambiente

Aula 5 de 16 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Obter a Sua Chave de API Mistral
  2. Três Métodos de Configuração
  3. Ordem de Prioridade
  4. Segurança da Chave de API
  5. Verificar se a Chave Funciona
  6. Pontos-chave

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/.env serve apenas de fallback), o login via navegador é oferecido por predefinição e /status ou /whoami indicam 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:

  1. Aceda a console.mistral.ai
  2. Crie uma conta ou inicie sessão
  3. Navegue até à secção API Keys
  4. Clique em Create new key
  5. Atribua-lhe um nome descritivo (ex: “vibe-cli-dev”)
  6. 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:

  1. Variável de ambiente MISTRAL_API_KEY (se definida na shell)
  2. Ficheiro .env em ~/.vibe/.env
  3. 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