Você não precisa saber programar. Precisa saber o que mandar a máquina fazer. Esse é o caminho inteiro, do computador vazio até o seu app rodando na internet pra qualquer um acessar.
Antes de instalar qualquer coisa, entende a jogada. Se você pegar isso aqui, o resto vira só seguir a receita.
Essa coisa é o Claude Code, que roda dentro do terminal do seu computador. Ele é quem programa. Seu trabalho não é digitar código, é dar a ordem certa. Você conversa em português, ele executa. O guia inteiro é só isso: criar 3 contas, instalar o Claude, e ir mandando ele trabalhar.
Você monta isso uma vez só. Serve pra esse app e pra todos os próximos. Repara numa coisa: das ferramentas da máquina, você instala só o Claude Code na mão. Node e Git quem instala é ele.
O cofre do código. Guarda tudo que o Claude escreve, versão por versão.
Onde o app fica no ar. Puxa direto do GitHub e publica sozinho.
Banco de dados, login de usuário e armazenamento de arquivos.
Só se você quiser um domínio próprio no lugar do endereço grátis.
O cérebro. Escreve o código e instala o resto. A única coisa que vai na mão.
A base que faz um app moderno rodar. Você não toca nisso.
O que conversa com o GitHub pra guardar as versões do código.
Já vem no Windows. É o PowerShell. É por ali que tudo começa.
Começa pelas contas porque o Claude vai precisar delas na frente. Faz nessa ordem. Leva uns 5 minutos.
Entra em github.com e cria a conta com seu email. Esse vai ser seu login mestre. Guarda bem o usuário e a senha.
Em vercel.com, na hora de criar a conta, clica em continuar com GitHub. Não cria senha nova. Isso já deixa as duas conversando, que é o que a gente quer.
Mesma coisa em supabase.com: entra com o GitHub. Não precisa criar o projeto ainda. Só ter a conta. A gente cria o banco lá no passo 07.
Porque assim você tem uma senha só e as ferramentas já se reconhecem. Menos coisa pra esquecer, menos atrito na hora de publicar.
Esse é o único programa que você instala na mão. Depois dele, é tudo por conversa.
Aperta Windows + X e clica em Terminal. Vai abrir o PowerShell. Cola o comando abaixo e dá Enter. Ele baixa e instala o Claude Code sem precisar de mais nada.
PS> irm https://claude.ai/install.ps1 | iexFecha o terminal e abre um novo. Isso é importante pro computador enxergar o programa recém instalado. Depois cola o teste abaixo. Se aparecer um número de versão, deu certo.
PS> claude --versionDigita claude e dá Enter. Na primeira vez ele abre o navegador pra você entrar com sua conta Claude. Faz o login, volta pro terminal, e pronto: você está conversando com quem vai construir o app.
PS> claude"Por que instalar o Claude primeiro?" Porque ele não consegue se instalar sozinho, mas instala tudo o resto. Por isso ele é a única coisa que vai na sua mão. Do passo 04 em diante, quem trabalha é ele.
Aqui começa a mágica. Você não vai baixar Node nem Git de site nenhum. Você pede, e ele instala.
Com o Claude aberto no terminal, cola o texto abaixo e dá Enter. Ele vai pedir sua permissão pra rodar cada comando. Você aprova. Em poucos minutos Node e Git estão instalados.
Depois de instalar Node e Git, sai do Claude digitando /exit, fecha o terminal e abre um novo antes de seguir. Isso garante que o computador reconheça os programas novos. Aí você roda claude de novo e continua.
Todo app mora numa pasta. Você cria ela, entra dentro, e abre o Claude ali. Assim ele trabalha no lugar certo.
No terminal, cola as três linhas abaixo, uma de cada vez. Troca meu-app pelo nome que você quiser. Sem espaço e sem acento no nome.
PS> mkdir meu-app # cria a pasta
PS> cd meu-app # entra nela
PS> claude # abre o Claude aqui dentroAgora sim. Com o Claude aberto dentro da pasta, você descreve o que quer e ele monta a estrutura inteira.
Esse prompt monta um app com a base que quase todo mundo usa hoje. Depois é só ir pedindo as telas e funções que você imaginou.
Depois desse, você continua conversando. Por exemplo: "cria uma tela de login e uma tela inicial com a lista dos meus produtos". Ele vai construindo em cima.
Se o seu app guarda qualquer coisa (usuários, pedidos, mensagens), ele precisa de um banco. É pra isso que serve o Supabase. São duas partes: pegar as chaves lá, e mandar o Claude conectar.
Entra no supabase.com, clica em New project e dá um nome. Espera uns minutos ele criar. Depois vai em Settings e depois API. Copia dois valores: a Project URL e a chave anon public. São esses dois que o Claude precisa.
Cola o prompt trocando os dois campos em laranja pelo que você copiou. Ele instala a conexão e guarda as chaves num arquivo protegido.
A chave anon public é a única que pode ir pro app. Se o Supabase te mostrar uma chave chamada service_role ou secret, não usa essa aqui. Ela é o mestre do banco e nunca sai do servidor.
Antes de botar no mundo, você testa no seu computador. É o famoso "rodar local". Ninguém vê ainda, é só pra você conferir.
Ele vai te dar um endereço tipo localhost:3000. Abre isso no navegador e o app aparece. Se algo estiver errado, ele mesmo resolve e roda de novo.
Agora você sobe o código pro cofre. Isso protege seu trabalho e, mais importante, é daqui que a Vercel vai puxar pra publicar.
Esse prompt cria o repositório e, antes de subir, confere que suas chaves ficaram de fora. Na primeira vez ele pode pedir pra você autorizar a conexão com o GitHub. É só seguir o que ele mostra.
O momento em que o app sai do seu computador e vira um link que qualquer pessoa acessa. Você tem dois caminhos. Escolhe um.
Entra na vercel.com, clica em Add New e depois Project. Ela mostra seus repositórios do GitHub. Escolhe o que você acabou de subir e clica em Import. Antes de finalizar, abre Environment Variables e cola ali as mesmas chaves do seu arquivo .env.local (a URL e a chave anon do Supabase). Clica em Deploy. Em um ou dois minutos seu app tem um link no ar.
Se preferir não sair do terminal, manda ele publicar. Na primeira vez ele te guia pra conectar sua conta da Vercel.
Depois de conectada, toda vez que o Claude subir uma mudança pro GitHub, a Vercel republica sozinha. Você mexe no app, ele salva, e o site atualiza sem você fazer mais nada.
Seu app já nasce com um endereço grátis tipo meu-app.vercel.app. Isso funciona perfeitamente. Só faz esse passo se você quiser um nome próprio, tipo meuapp.com.br.
Compra o domínio (na própria Vercel, na Cloudflare ou onde preferir). Na Vercel, dentro do projeto, vai em Settings e depois Domains, e adiciona o seu nome. Ela te mostra o que configurar no DNS. Se o domínio estiver na Cloudflare, você cola essa configuração lá. Em alguns minutos seu nome próprio está apontando pro app.
O app está no ar. Mas ele nunca fica pronto de verdade. A diferença agora é que mudar virou fácil.
Quer mudar uma cor, adicionar uma tela, corrigir um erro que um cliente achou? Abre o terminal na pasta do projeto, roda claude, e fala em português o que precisa. Ele muda, testa e sobe. Exemplo real de pedido: "muda a cor do botão principal pra laranja e aumenta o título da primeira tela". É assim que o app cresce.
Todos os prompts do guia, na ordem, num lugar só. Salva essa parte. Quando for fazer o próximo app, é só descer aqui e ir colando.
Os tropeços mais comuns e o que fazer. Quase tudo se resolve fechando e abrindo o terminal. Se não, é só colar o erro pro Claude e pedir pra resolver.
| O que aparece | Por quê | Como resolve |
|---|---|---|
| claude não é reconhecido | Você abriu o terminal antes de instalar. | Fecha e abre um terminal novo. O computador só enxerga o programa depois disso. |
| node não é reconhecido | Node ainda não entrou no caminho do sistema. | Sai do Claude com /exit, fecha o terminal, abre de novo e roda claude. |
| winget não é reconhecido | Windows sem o instalador de apps. | Instala o App Installer pela Microsoft Store e tenta o prompt de novo. |
| irm dá erro | Você está no Prompt de Comando antigo, não no PowerShell. | Abre pelo Windows + X e escolhe Terminal, que já é o PowerShell. |
| Qualquer erro dentro do app | Faz parte. Acontece com todo mundo. | Copia a mensagem inteira e cola pro Claude pedindo pra resolver. É pra isso que ele existe. |
A ferramenta faz o código. Você faz a jogada. Instala o Claude, cria as 3 contas, e vai mandando ele trabalhar.
Quer ver uma dessas máquinas já pronta e rodando de verdade? Entra e testa a minha, de graça.