Crie seu site com Claude Code
Isso é um processo, não um modelo. Ensina alguém a construir um site do qual ele se orgulhe — com seu próprio gosto, seu próprio conteúdo, na pilha que lhe convier — usando o Claude Code como construtor. Você fornece a estrutura e os movimentos; eles fornecem a visão.
Tudo se baseia em uma mudança: a pessoa é o diretor, o Claude é a equipe. Eles decidem como deve parecer e o que é bom o suficiente; Claude estrutura, escreve, estiliza, verifica e publica. Seu trabalho ao executar esta habilidade é extrair o gosto deles, transformá-lo em instruções que o Claude possa executar, colocar algo ao vivo rapidamente e depois iterar.
A única regra que rege tudo: coloque um site real e feio ao vivo primeiro, depois melhore-o em pequenos passos que você possa ver. Um site que está ao vivo no primeiro dia e iterado 50 vezes vence uma obra-prima que nunca é publicada.
A mentalidade (diga isso em voz alta logo no início)
- Você dirige, o Claude constrói. A pessoa nunca precisa escrever código — ou mesmo saber as palavras. Eles descrevem sensações ("mais quente", "isso parece apertado", "muito corporativo") e apontam; o Claude traduz em pixels.
- Ao vivo primeiro, bonito depois. Implante um shell vazio antes de estilizar qualquer coisa, para depurar o pipeline uma vez, enquanto não há nada para quebrar.
- Codifique o gosto em arquivos. Depois que gostarem de um visual, escreva-o como um sistema de design que tanto eles quanto o Claude leiam a cada sessão — é isso que impede o site de derivar.
- Pequenos passos visíveis. Uma mudança coerente de cada vez; olhe para ela; faça commit. Grandes mudanças invisíveis são onde os sites morrem.
- Feche o ciclo. Publique cedo, coloque na frente de pessoas reais, alimente o que elas dizem diretamente de volta ao Claude como a próxima lista de tarefas.
- Quando estiver travado, pergunte ao Claude. Cada passo abaixo — criar contas, corrigir um erro vermelho no terminal, uma tela de hospedagem confusa — é algo para delegar de volta ao Claude, não para resolver sozinho. "Nunca fiz isso, me guie" e "aqui está uma captura de tela do que vejo" são as duas coisas mais úteis que a pessoa pode dizer.
Como usar esta habilidade
Trabalhe as fases mais ou menos em ordem, mas elas não são um waterfall rígido — a Fase 4 (o ciclo de iteração) é o motor que roda continuamente por baixo das outras:
Fase 0 → 1 emoldure e coloque ao vivo · Fase 2 → 3 torne seu e preencha · Fase 5 → 6 torne memorável e ouça · Fase 4 roda o tempo todo.
Cada fase fornece o objetivo, os movimentos, um prompt copiável para a pessoa dar ao Claude e a uma armadilha que mais frequentemente a arruina. Material mais profundo está nos arquivos de referência — puxe-os quando uma fase ficar real.
Permissão para parar. Um site calmo de uma página — o nome deles, uma linha sobre eles, um link — é um site real e finalizado. Se eles terminaram após a Fase 4, terminaram. As Fases 5–6 são para quando querem mais, não uma barra que precisam superar.
Antes de começar (o Claude pode ajudar com tudo isso)
A pessoa precisa de quatro coisas gratuitas em vigor antes da Fase 1. Tudo isso pode ser configurado pedindo ao Claude para guiá-los — não presuma que eles fizeram algo disso:
- Claude Code, instalado e aberto em uma pasta para o projeto.
- Node.js + npm (para a maioria das pilhas modernas) — o Claude pode verificar com
node -ve instalá-lo. - Uma conta no GitHub (gratuita) — onde o código fica e o que o host monitora.
- Uma conta de hospedagem — Vercel, Netlify ou Cloudflare Pages (os planos gratuitos são generosos; alguns pedem um cartão mesmo no gratuito — sem cobrança para um site pessoal normal).
Se algo disso for desconhecido, o primeiro prompt deve ser:
Nunca configurei um projeto de programação antes. Verifique se Node, npm e git estão instalados na minha máquina e me guie — um passo de cada vez — instalando qualquer coisa que esteja faltando e criando contas gratuitas no GitHub e [Vercel/Netlify]. Diga-me exatamente no que clicar e espere por mim a cada passo.
Início rápido (um site ao vivo em uma tarde)
Se a pessoa quer ritmo agora:
- Extraia o briefing de gosto. Faça as cinco perguntas da Fase 0; escreva as respostas em um breve
BRIEF.md. (~15 min) - Estruture e implante um shell vazio. Escolha uma pilha + um host push-to-deploy (se não souber, diga Next.js + Vercel e siga em frente), gere o starter com seu CLI oficial, faça push para o GitHub, conecte o host e confirme que o site em branco está ao vivo em uma URL real. (~30 min, mais na primeira vez — inscrições em contas e conectar o GitHub ao host adicionam ~20–30 min)
- Adicione o arquivo de proteção. Crie
AGENTS.mddizendo ao Claude para ler a documentação do framework instalado antes de escrever código (Fase 1). (~2 min) - Construa apenas o hero. Uma tela: o nome deles, uma linha sobre eles, uma chamada para ação, cores do briefing. Olhe para ela no navegador. (~20 min)
- Ajuste e faça commit. "aumente o título", "fundo mais quente", commit, push — está ao vivo. (~15 min)
Eles agora têm um site real em uma URL real. Tudo depois é melhoria — a parte fácil. (Os tempos assumem que as contas acima já existem; a configuração inicial adiciona tempo, e isso é normal, não uma falha.)
Fase 0 — Emoldure: gosto e escopo
Objetivo: ser capaz de descrever, em palavras simples e imagens, como o site deve parecer e quais páginas ele precisa — antes que um único componente seja construído.
Movimentos
- Entreviste a pessoa. Não projete ainda; extraia. Faça estas cinco:
- Para quem é, e o que você quer que eles façam ou sintam? (contratar você, comprar isso, ler seus escritos, "me levar a sério", "ver que sou divertido")
- Nomeie a vibe em 2–3 palavras. ("quente e editorial", "limpo e técnico", "alto e brincalhão", "quieto e caro", "escuro e brutalista"). Pressione por sentimentos, não por recursos.
- Mostre-me o que você ama. URLs de 2–3 sites, e capturas de tela, moodboards ou qualquer imagem que capture a sensação — a maioria das pessoas tem gosto visual, não verbal, então deixe-os colar imagens. E um site que eles odeiam. Roube estrutura e clima, nunca conteúdo.
- Qual é a única coisa que este site deve acertar? (a escrita, os visuais, as amostras de trabalho, ser rápido)
- Quais páginas/seções você realmente precisa? Resista ao aumento de escopo — a maioria dos sites pessoais é Home + uma ou duas a mais.
- Escreva as respostas em um
BRIEF.mdna raiz do repositório — a estrela do norte que você e o Claude verificam. Se eles forneceram imagens, anote o que tirar de cada uma.
Prompt para dar ao Claude
Antes de construirmos qualquer coisa, me entreviste sobre o site que quero. Pergunte-me, um de cada vez: para quem é e o que quero que os visitantes sintam ou façam; a vibe em 2–3 palavras; sites que amo (vou colar links E capturas de tela/imagens de moodboard — reaja também às imagens) mais um que odeio; a única coisa que este site deve acertar; e quais páginas eu realmente preciso. Depois escreva minhas respostas em um BRIEF.md como minha estrela do norte. Ainda não escreva nenhum código do site.
A armadilha: começar a construir antes que alguém possa descrever a sensação. Se eles não conseguem nomear a vibe ou mostrar uma imagem dela, o Claude padrão é um template-SaaS genérico e cada correção posterior luta contra essa gravidade. Obtenha a sensação — em palavras ou imagens — primeiro.
Fase 1 — Fundação: coloque um site vazio ao vivo e proteja-o
Objetivo: um site em branco, mas real, já implantado em uma URL real com auto-implantação configurada — para que cada alteração posterior seja publicada gratuitamente — mais uma proteção que mantém o Claude na verdade fundamental.
Você não precisa saber como fazer nada disso. O Claude fornece os cliques e comandos exatos e espera enquanto você os executa. Quando uma tela o confundir, faça uma captura de tela e cole-a de volta — isso é todo o fluxo de trabalho, não uma falha.
Movimentos
- Escolha a pilha e o host com antecedência (tabela abaixo). Prefira um host da mesma empresa que o framework para que os padrões funcionem. Qualquer caminho é bom; a pior escolha é passar um dia escolhendo.
- Estruture com o CLI oficial do framework, não manualmente.
- Implante o template vazio primeiro. Faça push para o GitHub, conecte o host, confirme que o site em branco está ao vivo antes de mexer no código — para depurar o pipeline enquanto nada mais pode quebrar.
- Anexe um domínio personalizado cedo se eles tiverem um (é o endereço real; a URL gratuita
*.host.appé temporária). DNS — a configuração que aponta um nome de domínio para o site — pode levar algumas horas para fazer efeito, então comece cedo. Ainda sem domínio? A URL do host é um ótimo lugar para começar; compre um depois. - Adicione a proteção de verdade fundamental. Escreva um
AGENTS.md(e umCLAUDE.mdde uma linha que diga apenas@AGENTS.md) informando a qualquer agente de IA que o framework instalado pode ser mais novo que seus dados de treinamento e para ler a documentação real emnode_modules/<framework>/dist/docsantes de escrever código. Este único arquivo previne uma classe inteira de bugs de API alucinada. - Mantenha segredos fora do git desde o início. Um
.gitignoredeve excluir arquivos env e saída de build; nunca faça commit de chaves de API ou endereços privados — mantenha-os nas configurações de ambiente do host. Peça ao Claude para configurar isso com o repositório. - Escreva os fatos de implantação que o Claude não pode inferir: URL de produção, host, qual branch faz auto-implantação, o slug exato do repositório, quaisquer pegadinhas. Salve em um arquivo de notas/memória — o domínio ao vivo geralmente não é descoberto a partir do código.
- Configure pré-visualização local + uma verificação de integridade: uma configuração de execução (ou comando
devdocumentado + porta) e uma verificação de uma linha de que a URL local retorna HTTP 200, para que você possa olhar antes de enviar.
Tabela de decisão — escolha um caminho e siga em frente
| Se o site é… | Pilha padrão razoável | Host |
|---|---|---|
| Um portfólio / site pessoal / currículo | Next.js ou Astro | Vercel / Netlify |
| Principalmente escrita / um blog | Astro ou Next.js | Vercel / Netlify |
| Uma única landing / página de marketing | Astro ou Vite + React | Netlify / Cloudflare Pages |
| Algo que você quer editar manualmente como arquivos simples | HTML + CSS simples (sem etapa de build) | Netlify / CF / GitHub Pages |
| "Não sei, apenas faça funcionar" | Next.js + Vercel | Vercel |
(A última linha escolhe Next.js + Vercel apenas porque é o caminho mais documentado para o Claude se apoiar — cada caminho acima é igualmente legítimo.)
Prompt para dar ao Claude
Estruture um novo site [Next.js / Astro / HTML+CSS simples] com sua ferramenta oficial, mantenha o starter intocado, depois me guie: git init + primeiro commit (com um .gitignore que exclua env/segredos), criando um repositório no GitHub e conectando [Vercel / Netlify] para que cada push para main faça auto-implantação. Confirme que o site vazio está ao vivo em uma URL real antes de escrevermos qualquer código. Depois crie um AGENTS.md informando a qualquer agente de IA que o framework instalado pode ser mais novo que seus dados de treinamento e para LER a documentação em node_modules/[framework]/dist/docs antes de escrever código, mais um CLAUDE.md contendo apenas `@AGENTS.md`. Por fim, salve minha URL de produção, host, branch de implantação e repositório em um arquivo de notas. Dê-me cliques exatos e espere por mim a cada passo.
A armadilha: construir o site inteiro antes de implantar uma vez (então você está depurando código e pipeline ao mesmo tempo), ou confiar na memória do modelo de um framework em rápida mudança em vez de fixá-lo na documentação instalada.
→ Mídia, limites de tamanho, comandos de codificação, verificação de produção: referências/PLAYBOOK.md.
Fase 2 — Codifique sua linguagem de design
Objetivo: um sistema de design escrito e legível por máquina — cor, tipografia, espaçamento, movimento, voz — que tanto a pessoa quanto o Claude leiam a cada sessão, para que cada nova página permaneça na marca em vez de derivar para cinco visuais ligeiramente diferentes.
Faça isso depois de ter uma página de que realmente goste, não antes. Você extrai o sistema de algo bom; não o inventa no vácuo.
Movimentos
- Nomeie o clima em palavras primeiro, depois derive cada regra dele. Duas frases curtas; se dois climas estão em tensão, essa tensão se torna uma regra. (Em uma construção real, as frases eram "calma editorial quente + artesanato pixel lúdico" — mas um site "quieto e caro" ou "alto e brutalista" nomearia as suas e derivaria regras muito diferentes.)
- Use cor deliberadamente e consistentemente. Uma paleta contida — geralmente um único acento — mantém a hierarquia legível e é o padrão seguro. Mas se o gosto é maximalista, retrô ou brutalista, um sistema multicolorido é uma escolha legítima. A regra não é "exatamente um acento"; é que cada cor tem um papel definido e é usada da mesma forma em todos os lugares.
- Cor como tokens nomeados por papel, não hexadecimais espalhados na marcação. Expresse texto suave e bordas como uma cor de tinta com opacidade reduzida, em vez de inventar cinco cinzas quase idênticos.
- Combine tipos por papel, não por face (corpo/UI, títulos/"voz", mono, exibição). Referencie o papel para que a fonte real possa mudar depois sem reescrita.
- Fixe um ritmo de espaçamento e uma escada z-index, e escreva "não invente novos valores."
- Declare uma filosofia de movimento que se encaixe no clima: loops ambientes baratos em CSS, feedback interativo em uma biblioteca JS; bloqueie movimento não essencial atrás de
prefers-reduced-motion. - Defina uma linha de base acessível (é parte da qualidade, não um adicional): contraste de texto do corpo ≥ 4.5:1, ordem real de títulos, estados de foco visíveis, marcos semânticos, texto alternativo em imagens significativas. Uma paleta ousada/escura é exatamente onde o contraste falha silenciosamente.
- Escreva voz e tom como design — a cópia é parte do visual (minúsculas? lúdico? palavras simples? sem enchimento corporativo?).
- Codifique em dois arquivos com commit: um
DESIGN_SYSTEM.mdem prosa (princípios + receitas de componentes + uma lista de verificação de build) e um arquivotokens(os valores brutos). Marque-o como somente daqui para frente — extraído de páginas existentes, não um alvo de migração — para que o Claude não "ajudativamente" refatore código funcional. - Conecte-o ao contexto: refe…
[truncado para tradução]