Primeiro Início do Vibe
Nesta página
Lição atualizada em 2 de novembro de 2026 com base na documentação do Vibe Code: o login baseado no navegador é agora o padrão, as chaves são guardadas no chaveiro do sistema e o modelo integrado é o Mistral Medium 3.5 (o Devstral 2 foi removido da API em 31 de julho de 2026). Fontes: Instalação e configuração · Configuração · Agentes.
Atualização de 2 de novembro de 2026 — Devstral. O Devstral 2 (
devstral-2512) atingiu a data de fim de vida útil em 31 de julho de 2026, e o Devstral Small 2 em 31 de março de 2026: as chamadas a estes modelos já não estão garantidas. A tabela oficial redireciona-os para o Mistral Medium 3.5, que está, por sua vez, preterido em favor do Mistral Large 4. O Codestral (codestral-2508) mantém-se geralmente disponível para conclusão de código. Consulte a tabela de modelos para verificar para onde apontam os aliases-latestantes de reutilizar estes exemplos.
Primeiro Início do Vibe
O Vibe funciona sempre no contexto de um diretório. Navegue para um projeto existente, não para a sua pasta pessoal, antes de o iniciar:
cd /path/to/your/project
vibe
No primeiro início, o Vibe executa vários passos automáticos de inicialização. Não entre em pânico se o processo demorar alguns segundos: a ferramenta está a criar o seu diretório de configuração e a preparar o assistente de configuração.
O Assistente de Configuração Inicial
Na primeira vez que executar o Vibe, um assistente interativo guia-o através da configuração. Começa com o tema visual da interface do terminal: estão disponíveis várias paletas de cores. Escolha a que for mais legível no seu terminal. Nada está definido em pedra; pode alterar isto a qualquer momento.
Segue-se o passo crucial: o acesso aos modelos. O assistente oferece dois caminhos:
- Iniciar navegador: autentica-se com a sua conta Mistral no navegador e o Vibe utiliza o seu plano Mistral (o Vibe Code está incluído, com limites de utilização dependentes do seu plano e das definições de pagamento por uso). Este é o caminho padrão, não exigindo gestão de chaves.
- Utilizar uma chave de API: gera uma chave em Code › Vibe CLI, ou utiliza uma chave de outro fornecedor compatível, e cola-a no Vibe.
O Vibe guarda a chave no chaveiro do seu sistema operativo (Chaveiro do macOS, Gestor de Credenciais do Windows…) ou, na falta deste, em ~/.vibe/.env, que é legível apenas por si. Pode relançar este assistente a qualquer momento com vibe --setup.
Não lhe será pedido para selecionar um modelo: o Vibe vem com um modelo integrado, o Mistral Medium 3.5 (alias mistral-medium-3.5), que a sua documentação recomenda para raciocínio e programação. O comando /model permitir-lhe-á escolher um diferente mais tarde, entre os que configurou.
A Interface Interativa
Assim que a configuração estiver concluída, encontra-se no modo interativo. O ecrã está organizado de forma simples: uma área de entrada na parte inferior para escrever mensagens, o histórico da conversa acima e indicadores que mostram o modelo em uso e o estado da sessão. Não há mais nada para aprender para começar a trabalhar.
No entanto, alguns atalhos de teclado farão uma enorme diferença na velocidade do seu fluxo de trabalho. Memorize-os agora em vez de os procurar daqui a um mês:
| Atalho | Efeito |
|---|---|
| Ctrl+J ou Shift+Enter | Nova linha na sua mensagem (para entrada multilinha) |
| @ | Preenchimento automático de ficheiros (ex.: @src/main.py) |
| ! | Prefixo para executar um comando de shell diretamente |
| Ctrl+G | Abrir um editor externo para redigir uma mensagem longa |
| Ctrl+O | Mostrar ou ocultar a saída da ferramenta |
| Cmd+\ ou Alt+\ | Mostrar ou ocultar a lista de tarefas (todo) |
| Shift+Tab | Alternar entre modos de aprovação |
O atalho mais útil para o trabalho diário é, sem dúvida, o @: em vez de descrever onde um ficheiro está localizado, referencia-o diretamente e o agente lê-o.
A Sua Primeira Troca
Teste com um pedido simples. Num projeto Python, por exemplo, escreva:
Explain the structure of this project
Observe o que acontece, pois é aqui que a diferença em relação a um chatbot padrão se torna visível. O Vibe analisa a árvore do projeto — ficheiros, pastas, configuração —, lê o estado do Git para identificar a ramificação, as confirmações recentes e os ficheiros modificados, analisa ficheiros-chave como o README, package.json ou pyproject.toml e, em seguida, fornece-lhe um resumo estruturado da arquitetura.
Por outras palavras, não se limita a responder; vai buscar a informação de que precisa. Faça a mesma pergunta num repositório vazio e a resposta será escassa — não há nada para ler.
Início com um Pedido Direto
O modo interativo não é obrigatório. Para um único pedido, passe a sua consulta diretamente como argumento:
vibe "Refactor the main function to use async/await"
Para o modo programático — o tipo que utilizaria num script ou num pipeline de integração contínua —, a opção --prompt combinada com um formato de saída utilizável funciona melhor:
vibe --prompt "Analyze test coverage" --output json
Duas salvaguardas são particularmente úteis neste contexto, pois um agente não supervisionado pode entrar em loop ou tornar-se dispendioso. --max-turns limita o número de idas e voltas e --max-price define um teto para as despesas:
vibe --prompt "Fix bugs" --max-turns 10 --max-price 0.50
Regresso à Configuração
Mais cedo ou mais tarde, quererá alterar o tema ou reconfigurar a sua chave de API. O assistente de configuração pode ser relançado a pedido:
vibe --setup
Durante uma sessão, os comandos de barra assumem o controlo: escreva / para os ver aparecer. /help ou /h apresenta a ajuda completa, /config abre a configuração, /theme altera o tema, /model muda o modelo sem sair da sessão e /clear apaga o histórico da conversa quando muda para um tópico completamente diferente.
Pontos-chave
- Inicie o Vibe com
vibedentro do diretório do seu projeto - No primeiro início, o assistente configura o tema e a chave de API
- A chave de API é guardada em
~/.vibe/.env - O Mistral Medium 3.5 é o modelo integrado; utilize
/modelpara mudar de modelo - Os atalhos de teclado (@, !, Ctrl+J, Shift+Tab) são essenciais para o uso diário
- Utilize
vibe "a sua pergunta"para uma troca rápida sem o modo interativo