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

Primeiro Início do Vibe

Aula 3 de 16 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Primeiro Início do Vibe
  2. O Assistente de Configuração Inicial
  3. A Interface Interativa
  4. A Sua Primeira Troca
  5. Início com um Pedido Direto
  6. Regresso à Configuração
  7. Pontos-chave

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 -latest antes 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:

  1. 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.
  2. 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:

AtalhoEfeito
Ctrl+J ou Shift+EnterNova 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+GAbrir um editor externo para redigir uma mensagem longa
Ctrl+OMostrar ou ocultar a saída da ferramenta
Cmd+\ ou Alt+\Mostrar ou ocultar a lista de tarefas (todo)
Shift+TabAlternar 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 vibe dentro 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 /model para 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