# Vibe coding do zero: do primeiro prompt ao seu primeiro app

> Vibe coding do zero se resume a um ciclo: descrever o que você quer para um agente de IA em linguagem natural, deixar ele construir numa cópia separada do projeto, olhar o resultado e ficar só com o que você revisou. Você precisa de um computador, do Git, de uma conta de agente e de uma ideia pequena. Este guia gratuito leva você do zero ao primeiro app.

- Canonical: https://runtallos.com/pt/aprenda/vibe-coding-do-zero
- English: https://runtallos.com/learn/vibe-coding-from-scratch.md
- Autor: [Roberto Rocha](https://www.instagram.com/robertorochamkt/)
- Atualizado em: 2026-09-30
- Section: Aprenda

## Em resumo

- Não precisa ser dev profissional para começar
- Basta uma conta de agente, com assinatura ou chave de API
- Por padrão, os agentes pedem antes de rodar comandos
- Toda mudança fica numa cópia separada que você pode descartar
- Comece de uma pasta vazia: o Tallos cria o projeto Git

## O que é vibe coding, e dá para começar do zero?

**Vibe coding** é criar software descrevendo o que você quer para um agente de IA em linguagem natural e deixando ele escrever o código. Sim, dá para começar do zero. O agente lê arquivos, escreve código e roda comandos; o seu trabalho vira explicar o objetivo, conferir o resultado e decidir o que fica.

O que falta para quem está começando raramente é velocidade de digitação; é critério para julgar o que o agente mudou. Este guia cria esse hábito desde o primeiro dia. Para o conceito e onde ele quebra, leia [o que é vibe coding](https://runtallos.com/pt/vibe-coding).

## O que você precisa para começar com vibe coding?

Você precisa de quatro coisas, e nenhuma delas é diploma de computação.

- **Um computador** com macOS 13 ou mais recente (Apple Silicon ou Intel) ou Windows 10 ou mais recente.
- **Git.** Ele guarda cada versão do projeto e sustenta as cópias separadas onde os agentes trabalham. O Tallos precisa dele para criar projetos e workspaces.
- **Uma conta de agente de IA**: assinatura ou chave de API de um fornecedor como Anthropic (Claude Code), OpenAI (Codex) ou Google (Gemini CLI).
- **Uma primeira ideia pequena.** Uma lista de tarefas, uma página com os livros que você está lendo, um controle de gastos. Algo que você confere em um minuto.

O Tallos é o ambiente em volta do agente, um [ambiente de desenvolvimento agêntico](https://runtallos.com/pt/o-que-e-um-ade). Ele instala e conecta os agentes, dá a cada tarefa uma cópia própria do projeto e mostra cada mudança antes de você manter.

## Qual agente de IA escolher para começar?

Escolha o agente em que você já tem conta ou consegue criar uma hoje; dá para adicionar outros depois. Agentes de programação são programas de linha de comando (CLIs) de fornecedores diferentes; o Tallos roda todos estes.

| Agente | Quem faz | Como você entra |
| --- | --- | --- |
| Claude Code | Anthropic | Login da conta ou chave de API da Anthropic |
| Codex | OpenAI | Login da conta ou chave de API da OpenAI |
| Gemini CLI | Google (código aberto) | Login do Google ou chave de API do Gemini |
| GitHub Copilot CLI | GitHub | Sua conta do GitHub, como o GitHub explica |
| OpenCode | Código aberto, vários provedores de modelos | Os logins de provedor que você configura no OpenCode |
| Grok CLI | xAI | Login do Grok ou chave de API da xAI |
| Qwen Code | Equipe Qwen da Alibaba (código aberto) | `/auth` dentro do Qwen Code |
| MiMo Code | Xiaomi | `mimo auth login` |

_Preços e uso gratuito mudam com frequência; confira a página de cada fornecedor antes de escolher._

Todos, menos o Copilot CLI, têm um card em Configurações → Conexões que instala o agente e abre o login. Veja [como conectar seus agentes](https://runtallos.com/pt/aprenda/conectar-seus-agentes).

## Como fazer vibe coding do seu primeiro app, passo a passo?

Faça estes nove passos uma vez com uma ideia pequena. Depois, toda funcionalidade nova segue o mesmo ciclo.

1. **Instale o Tallos** — Baixe o Tallos para macOS ou Windows e abra. Na tela de boas-vindas, escolha o idioma e o seu agente em **Qual agente de IA você usa?** Deixe **Deixar os agentes executarem comandos sem perguntar** desligado: o agente vai pedir antes de rodar qualquer coisa.
2. **Conecte seu agente** — Abra Configurações → Conexões. No card do agente, instale, depois faça login ou salve uma chave de API. Uma chave salva ali vai só para aquele agente.
3. **Crie um projeto** — Começando do nada? Abra **Adicionar um projeto** e escolha **Criar novo projeto**. Dê um nome, e o Tallos cria uma pasta que já é um repositório Git. Já tem código? Use **Escolher uma pasta** ou **Clonar de uma URL**.
4. **Abra a tarefa num workspace próprio** — Clique em **Novo workspace**, escolha o projeto e o agente, e deixe o nome em branco se quiser. O Tallos trabalha numa cópia separada do projeto, então o original fica seguro.
5. **Descreva a primeira versão** — Escreva o que é o app, quem usa e a única coisa que ele precisa fazer. Peça a versão mais simples que funcione, e peça ao agente para explicar como rodar.
6. **Responda o agente** — O agente pode fazer uma pergunta ou pedir permissão para rodar um comando, como instalar um pacote. Leia o que ele quer rodar. Permita se bate com a tarefa; se não, recuse e explique.
7. **Olhe o resultado** — Rode o app do jeito que o agente explicou e abra o endereço no navegador integrado do workspace. Clique por tudo. Anote o que está errado ou faltando.
8. **Itere em passos pequenos** — Peça uma mudança por vez: “aumente o botão Adicionar”, “salve a lista quando eu fechar a página”. Quando faltar palavra, clique num elemento no navegador e mande para o agente.
9. **Revise antes de manter** — Clique em **Revisar mudanças** para ver cada arquivo que o agente mexeu. Deixe notas nas linhas que você não entende e devolva. Quando estiver certo, faça o commit. Se a tentativa deu errado, apague o workspace e comece de novo.

[Sua primeira tarefa no Tallos](https://runtallos.com/pt/aprenda/primeira-tarefa) percorre o mesmo ciclo em mais detalhe, com solução de problemas.

> Teste o ciclo com a sua ideia. O Tallos roda no macOS e no Windows com o agente que você já usa. → https://runtallos.com/signup

## Como descrever o que você quer para um agente de IA?

Descreva o resultado, o contexto e como você vai conferir. Agentes vão bem com pedidos concretos e mal com ambições vagas.

**Prompt vago**
- “Cria um app de finanças pra mim.”
- “Deixa mais bonito.”
- “Arruma o bug.”

**Prompt claro**
- “Um app de uma página onde eu digito um gasto e uma categoria e vejo o total do mês. Guarde os dados no navegador, sem login.”
- “Deixe o total maior e em negrito, e coloque o formulário acima da lista.”
- “Quando digito 3,50 como valor, o total mostra NaN. Corrija e adicione um teste.”

- Diga **para quem** é e **a primeira coisa** que ele precisa fazer.
- Diga o que não mexer: “não mude o layout”.
- Peça o plano antes de uma mudança grande.
- Termine com como você vai conferir: “o total deve atualizar quando eu adicionar um item”.

## Como iterar sem quebrar o que já funciona?

Itere em passos pequenos e separados, e salve cada versão que funciona. O jeito mais rápido de perder um app que funciona é pedir cinco coisas de uma vez.

- **Uma mudança por mensagem.** Mudança pequena é fácil de conferir e fácil de desfazer.
- **Faça commit do que funciona.** Um commit é um ponto de salvamento. Continue iterando no mesmo workspace e faça commit de cada versão que funciona; a branch dele guarda seu app até você mesclar, por exemplo com um pull request.
- **Peça testes.** Diga ao agente para adicionar um teste do que ele mudou, para ele conferir o próprio trabalho.
- **Recomece quando enrolar.** Se o agente entrou em looping, pare de discutir. Apague o workspace e abra outro com um prompt mais claro.

## Como revisar código gerado por IA se você não lê código bem?

Você revisa conferindo o escopo, o comportamento e tudo o que você não entende. Não precisa ler cada linha com fluência para pegar a maioria dos problemas.

- **Escopo:** quais arquivos mudaram? Uma “correção pequena” que mexe em muitos arquivos é sinal de alerta.
- **Comportamento:** o app faz o que você pediu, e os testes passam?
- **Perguntas:** deixe uma nota em qualquer linha que você não entende, como “o que isso faz?”, e mande as notas para o agente. As respostas ensinam o código para você.
- **Segredos:** nenhuma senha ou chave de API escrita no código.

Quando quiser uma revisão mais rigorosa, use o checklist de [como revisar código gerado por IA](https://runtallos.com/pt/aprenda/revisar-codigo-gerado-por-ia).

## Quais são os erros mais comuns de quem está começando?

| Erro | O que acontece | Faça assim |
| --- | --- | --- |
| Pedir o app inteiro de uma vez | Uma mudança enorme que você não consegue conferir | Construa a versão mínima e adicione uma funcionalidade por vez |
| Manter mudanças sem olhar | Bugs se acumulam sem ninguém ver | Abra **Revisar mudanças** toda vez |
| Desligar as confirmações no primeiro dia | O agente pode editar ou apagar arquivos sem falar com você | Fique no modo manual até confiar na tarefa |
| Colar senhas ou chaves no prompt | Segredos vão parar no código ou no histórico | Guarde em arquivos de ambiente ignorados pelo Git |
| Discutir com um agente travado | Sessões longas que andam em círculo | Descarte o workspace e recomece com um prompt mais claro |
| Nunca fazer commit | Nenhum ponto de salvamento para voltar | Faça commit de cada versão que funciona |

_Erros de iniciante e como evitar cada um_

## Como fazer vibe coding com segurança?

Três padrões protegem quem está começando no Tallos: os agentes pedem antes de agir, cada tarefa roda numa cópia separada e o Git guarda cada versão.

- **Permissões manuais por padrão.** O Tallos começa com os agentes no modo manual, então eles pedem antes de rodar comandos. O modo autônomo é opcional, em Avançado na tela de boas-vindas ou em Configurações → Agentes → Permissões do agente.
- **Workspaces isolados.** Cada tarefa é um git worktree com branch própria. O agente edita essa cópia, nunca o original, e apagar o workspace remove a pasta e a branch.
- **Histórico do Git.** Cada commit é um ponto de salvamento. Você sempre consegue voltar à última versão que funcionava.
- **Cada chave com seu agente.** Uma chave de API adicionada em Configurações → Conexões chega só àquele agente.

> **Workspace não é sandbox** — O workspace separa suas tarefas umas das outras; ele não impede o agente de mexer no resto do computador. É para isso que servem os pedidos de permissão: leia antes de permitir.

## O que fazer depois do primeiro app?

Quando o ciclo ficar natural, rode mais de um agente. Agentes em paralelo e squads são o mesmo ciclo, multiplicado.

- **Dois agentes, uma tarefa.** Clique em **Tentar outro agente** para dar a mesma tarefa a um segundo agente numa cópia própria, e fique com o melhor resultado.
- **Tarefas diferentes ao mesmo tempo.** Um agente no layout da página, outro em salvar os dados, cada um no seu workspace. Veja [como rodar agentes de IA em paralelo](https://runtallos.com/pt/rodar-agentes-de-ia-em-paralelo).
- **Uma squad.** Um agente líder divide o objetivo entre agentes membros, confere o trabalho, só pergunta a você quando trava e para no fim para você aceitar ou descartar. Comece pelo template **Construir + revisar**: um agente constrói, outro revisa. Siga [sua primeira squad](https://runtallos.com/pt/aprenda/seu-primeiro-squad).

> Baixe o Tallos e comece com um agente e uma ideia pequena. → https://runtallos.com/signup

## Perguntas frequentes

### Dá para fazer vibe coding sem saber programar?

Dá. Você consegue criar apps pequenos descrevendo o que quer para um agente de IA. Mas ainda precisa conferir: rodar o app, ver quais arquivos mudaram e pedir ao agente para explicar o que não ficou claro antes de manter.

### Como fazer vibe coding de um app do zero?

Crie um projeto novo, abra uma tarefa num workspace próprio, descreva a menor versão útil do app, rode e peça uma mudança por vez. Revise e faça commit de cada versão que funciona.

### Qual o melhor agente de IA para iniciantes em vibe coding?

Não existe um único melhor. Comece pelo agente em que você já tem conta, como Claude Code, Codex ou Gemini CLI. O Tallos roda todos, então dá para comparar depois na mesma tarefa.

### Preciso de uma assinatura de IA nova para usar o Tallos?

Não. O Tallos usa as assinaturas ou chaves de API que você já tem e não revende acesso a modelos. Confira a página de cada fornecedor para os preços dele.

### Vibe coding é seguro?

É, com três hábitos: os agentes pedem antes de rodar comandos, você trabalha numa cópia separada e revisa as mudanças antes de manter. No Tallos, os três são o padrão.

### Qual deve ser meu primeiro projeto de vibe coding?

Algo pequeno que você confere em um minuto: uma lista de tarefas, um controle de gastos, uma página com seus livros. Faça a menor versão primeiro e depois adicione uma funcionalidade por tarefa.

## Fontes

1. [“There's a new kind of coding I call vibe coding” (Feb 2, 2025)](https://x.com/karpathy/status/1886192184808149383) — Andrej Karpathy on X
2. [Best practices for Claude Code](https://code.claude.com/docs/en/best-practices) — Anthropic
3. [Claude Code overview](https://code.claude.com/docs/en/overview) — Anthropic

---

**Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem.

https://runtallos.com/signup (macOS 13+ · Windows 10+)