Como criar um site com Claude Code: passo a passo para iniciantes
Aprenda a criar um site com o Claude Code do zero, mesmo sem saber programar: instalar, pedir o hero, ver o site rodando, ajustar com a sua cara e publicar de graça.
Por Integra Sites · · 8 min de leitura
Dá para criar um site bonito sem escrever uma linha de código à mão. O Claude Code é uma ferramenta de IA que roda no terminal do seu computador: você descreve o que quer em português, ele cria os arquivos, ajusta o visual e corrige os erros. O seu trabalho passa a ser escolher, pedir e revisar.
Este é o passo a passo para iniciantes, do computador vazio ao site no ar. No fim você tem um site de uma página (hero, seções e botões) rodando no seu computador e publicado com um endereço grátis. O caminho é o mesmo que ensinamos nas aulas do curso "Do prompt ao site no ar".
O que você vai precisar
- Um computador com Windows, Mac ou Linux e conexão com a internet.
- Node.js instalado (versão LTS), que é o que roda o site no seu computador. O instalador está em nodejs.org.
- Uma conta na Anthropic com acesso ao Claude Code (plano pago do Claude ou créditos de API). As condições mudam com o tempo, então confira a página oficial antes de assinar.
- Um editor de código, opcional, como o VS Code, para olhar os arquivos.
- Uma ideia: sobre o que é o site, para quem e qual ação você quer que a pessoa faça.
Passo 1: instale o Claude Code
Abra o terminal (no Windows, o PowerShell; no Mac, o aplicativo Terminal) e rode o comando de instalação:
npm install -g @anthropic-ai/claude-codeAo terminar, confira se funcionou digitando claude --version. Se aparecer um número, está instalado. As instruções oficiais ficam sempre atualizadas na documentação da Anthropic, e vale consultá-las se o comando mudar.
Passo 2: crie uma pasta para o site
O Claude Code trabalha dentro de uma pasta. Crie uma nova, entre nela e abra o assistente:
mkdir meu-site
cd meu-site
claudeNa primeira vez ele pede para você entrar na sua conta e autorizar o acesso à pasta. Faça isso apenas em pastas do seu projeto, e não em pastas com documentos pessoais.
Passo 3: peça a base do site
Agora é a conversa. Em vez de "crie um site", descreva o tipo de projeto e a tecnologia. Um bom início é pedir um projeto Next.js com Tailwind, que é o que a maioria dos componentes da biblioteca usa:
O Claude Code vai criar os arquivos, instalar o que for preciso e rodar o site. Normalmente ele avisa o endereço: algo como http://localhost:3000. Abra no navegador e você já vê a base funcionando.
Passo 4: escolha o hero e peça o resto da página
Essa é a parte que faz o site parecer profissional, e é onde a maioria trava: pedir "um hero bonito" produz um resultado genérico. O atalho é partir de um componente pronto.
- Abra a biblioteca e escolha um hero que combine com o seu negócio.
- Copie o código ou o prompt do componente.
- Cole na conversa com o Claude Code e peça para ele usar como a abertura da página.
Depois, peça o resto, sempre uma seção por vez, e não tudo junto:
Quer entender como pedir o hero direito? Leia como pedir um hero profissional para o Claude Code e veja os 12 exemplos de hero section.
Passo 5: deixe o site com a sua cara
Com a estrutura pronta, falta personalizar. Faça pedidos curtos e específicos, um de cada vez, e olhe o resultado no navegador a cada mudança:
- Textos: "troque os textos da seção de benefícios por estes: ..." (cole o seu texto).
- Cores: "use #1E40AF como cor principal e deixe os botões nessa cor".
- Logo: "coloque o logo que está na pasta public no topo da página".
- Fotos: "troque a imagem do hero pela foto que está em public/foto.jpg".
- Celular: "veja como a página fica em tela pequena e corrija o que estiver cortado".
Passo 6: corrija o que der errado
Vai aparecer erro, e tudo bem. É parte do processo. Quando o site quebrar:
- Leia a mensagem do terminal ou do navegador.
- Copie a mensagem inteira e cole na conversa com o Claude Code.
- Escreva: "apareceu este erro, corrija".
Na maioria das vezes ele resolve sozinho. Se o problema continuar, peça para ele explicar a causa em palavras simples e tente outro caminho.
Passo 7: publique o site de graça
Com o site pronto no seu computador, é hora de colocá-lo no ar. A forma mais simples para quem está começando é publicar na Vercel, que oferece um plano gratuito para projetos pessoais:
- Crie uma conta grátis em vercel.com.
- Envie a pasta do projeto, pelo painel ou pelo GitHub.
- Aguarde a publicação e receba o link do seu site.
Você também pode pedir ajuda ao próprio Claude Code: "me explique, passo a passo, como publicar este projeto na Vercel". Depois, se quiser, registre um domínio próprio e aponte para o site.
Passo 8: configure o básico para ser encontrado
Um site no ar ainda não é um site encontrado. Antes de divulgar, peça para a IA conferir o essencial:
O guia de SEO básico para quem criou o site com IA explica cada item e como cadastrar o site no Google Search Console.
Erros comuns de quem está começando
- Pedir tudo de uma vez: pedidos enormes geram resultados confusos. Vá por etapas.
- Não olhar o site entre os pedidos: ver o resultado a cada mudança evita surpresas no fim.
- Aceitar sem ler: comandos e alterações precisam fazer sentido para você.
- Usar imagens enormes: fotos de vários megabytes deixam o site lento. Comprima antes.
- Esquecer o celular: teste sempre numa tela pequena.
- Não guardar o projeto: use o Git ou o GitHub para guardar versões, assim você volta atrás se algo der errado.
Claude Code, Cursor ou Lovable: qual escolher?
Todos funcionam para criar sites. O Claude Code roda no terminal e dá muito controle, o Cursor é um editor com IA integrada e o Lovable gera o site direto no navegador, sem instalar nada. Se ainda não decidiu, a comparação completa está em Claude Code, Cursor ou Lovable. Os componentes da biblioteca funcionam nos três.
Checklist: do zero ao site no ar
- Node.js instalado
- Claude Code instalado e logado
- Pasta do projeto criada e site rodando em localhost
- Hero escolhido na biblioteca e colado no projeto
- Seções criadas e conferidas no celular
- Textos, cores e logo ajustados
- Site publicado e com link funcionando
- Título, descrição e sitemap configurados
Perguntas frequentes
Dá para criar um site com o Claude Code sem saber programar?
Dá. Você descreve o que quer em português e o Claude Code escreve e ajusta o código. O que ajuda é saber o que pedir, dividir o trabalho em etapas e conferir o resultado no navegador.
O Claude Code é grátis?
O Claude Code precisa de uma conta da Anthropic com plano pago do Claude ou créditos de API. Os valores e as regras mudam com o tempo, então confira a página oficial antes de assinar.
Quanto tempo leva para criar um site com IA?
Uma página simples pode ficar pronta em uma ou duas horas, incluindo a instalação. O tempo maior costuma ir para escolher o visual, escrever os textos e ajustar os detalhes. Veja o roteiro em como criar uma landing page com IA em 1 hora.
Preciso instalar algo além do Claude Code?
Sim, o Node.js, que roda o projeto no seu computador. Um editor como o VS Code é opcional, mas ajuda a olhar os arquivos.
Como publicar o site criado com o Claude Code?
Uma opção simples é a Vercel, que tem plano gratuito para projetos pessoais. Você cria a conta, envia o projeto e recebe um link. Depois pode apontar um domínio próprio.
Meu site vai aparecer no Google?
Só aparece se você configurar o básico de SEO e deixar o Google encontrar as páginas: títulos, descrições, sitemap e cadastro no Search Console. Leva alguns dias ou semanas até as primeiras visitas.
Próximo passo
Escolha um hero na biblioteca, abra o Claude Code numa pasta nova e peça a primeira página. O primeiro site é o mais difícil de sair do papel; o segundo você faz em metade do tempo.
- Claude Code
- passo a passo
- iniciantes
- criar site
Componentes citados neste post
Leia também
- Criar site com IA: o que é vibe coding e por onde começarDá para criar um site completo descrevendo o que você quer em português. Entenda como funciona, o que a IA faz bem, onde ela erra e o caminho mais seguro para o primeiro projeto.
- Como escrever prompts melhores para criar sites com IAO que separa um pedido que dá certo de um que gera retrabalho. Aprenda a estrutura de um bom prompt, como refinar o resultado e o que fazer quando a IA erra.
- Claude Code, Cursor ou Lovable: qual usar para criar o seu site?Três ferramentas populares para criar sites com IA, cada uma para um perfil. Veja as diferenças, para quem cada uma serve e um fluxo que combina duas delas.