Como usar o Claude Code: tutorial para iniciantes (2026)

Para usar o Claude Code, você o inicia em uma pasta de projeto, descreve com as suas palavras o resultado que quer, deixa que ele planeje, aprova ou revisa o que ele muda e confere o resultado você mesmo antes de seguir. Este tutorial mostra esse ciclo em um projeto pequeno e real que você termina em um fim de semana: um site de uma página para um negócio local. Você vai ver exatamente o que digitar, como funcionam as permissões e o plan mode e como desfazer um passo que deu errado.

O negócio do exemplo é inventado: Muddy Paws Banho e Tosa, um pet shop de banho e tosa para cachorros. Troque pelo seu negócio, ou pelo de um amigo, e você termina o fim de semana com algo realmente útil.

O que você precisa antes de começar

• Claude Code instalado e com o login feito. Se ainda não fez isso, siga primeiro o guia de instalação para Mac e Windows.
• Um plano pago do Claude, já que o plano gratuito não inclui o Claude Code.
• Os dados do negócio: nome, o que vende, três serviços com preços, horário de funcionamento, região, telefone, um link de agendamento se houver e duas ou três avaliações reais de clientes.
• Algumas sessões focadas: uma no sábado para construir e uma no domingo para dar o acabamento.

Abaixo eu uso a versão do terminal. A aba Code do app para desktop tem os mesmos controles, com o seletor de modo de permissão ao lado do botão de enviar.

Sábado de manhã: monte o projeto

Passo 1: crie uma pasta e inicie uma sessão

Cada projeto ganha a sua própria pasta. O Claude Code consegue ler tudo dentro da pasta em que você o inicia, então uma pasta limpa mantém o foco e deixa os seus outros arquivos fora de alcance.

No Mac:

$ mkdir -p ~/claude-projects/muddy-paws
$ cd ~/claude-projects/muddy-paws
$ claude
$ 

No Windows, no PowerShell:

PS> mkdir -Force "$HOME\claude-projects\muddy-paws"
PS> cd "$HOME\claude-projects\muddy-paws"
PS> claude
PS> 

No app para desktop, abra a aba Code, escolha Local, clique em Select folder e crie a mesma pasta por ali.

Passo 2: escolha quanto controle você quer

O Claude Code tem modos de permissão: configurações que decidem quais ações ele pode fazer sem perguntar a você. Você alterna entre eles com Shift+Tab, a linha embaixo do prompt mostra o modo atual, e as versões atuais começam as novas sessões do terminal no modo automático.

Quando o Claude Code pede permissão, Yes aprova só aquela ação, Yes, and don't ask again salva uma regra para que aquele comando rode sem perguntar neste projeto dali em diante, e No recusa (o Esc faz o mesmo). Com Yes ou No selecionado, aperte Tab para anexar uma observação, como "No: use as fotos da pasta images no lugar dessas", e o Claude se ajusta.

Passo 3: escreva o briefing no plan mode

Aperte Shift+Tab até a linha de status mostrar ⏸ plan mode on, ou digite /plan no começo da sua mensagem. Depois cole um briefing como este, com os seus dados preenchidos:

Quero um site de uma página para o Muddy Paws Banho e Tosa, um pet shop de banho e tosa em [CIDADE].

Público: donos de cachorro ocupados que moram perto e agendam quase sempre pelo celular.
Objetivo: fazer com que toquem em "Agendar banho" ([LINK DE AGENDAMENTO]) ou liguem para [TELEFONE].

Seções, nesta ordem:
1. Título dizendo o que fazemos e onde, com o botão de agendamento
2. Três serviços com preços: [SERVIÇO E PREÇO] x3
3. Horário de funcionamento e endereço
4. Duas avaliações de clientes: [COLE AVALIAÇÕES REAIS]
5. Contato: telefone, e-mail e um link para o mapa

Estilo: simpático e limpo, bastante espaço em branco, letras grandes, fácil de usar no celular.
Restrições: um arquivo index.html e um arquivo styles.css. Nada de frameworks. Nenhuma foto que eu não tenha aprovado.
Pronto quer dizer: eu abro o index.html no navegador, tudo o que está acima aparece e dá para ler no celular.

Antes de escrever qualquer coisa, me faça até cinco perguntas sobre o que está faltando e depois proponha um plano.

O Claude lê a pasta vazia, faz as perguntas dele (às vezes em múltipla escolha) e depois apresenta um plano: quais arquivos vai criar, o que vai em cada seção e o que ainda precisa de você. Para mudar o plano diretamente, aperte Ctrl+G e ele abre no seu editor de texto.

Sábado à tarde: construa, olhe, reaja

Passo 4: aprove a construção passo a passo

Agora o Claude cria o index.html e depois o styles.css, e antes de cada arquivo ele mostra o que vai escrever e espera a sua resposta. Aprove quando bater com o plano e olhe com mais atenção qualquer comando que apague arquivos ou saia da pasta.

Quando ele terminar, abra a página com um clique duplo no index.html no Finder ou no Explorador de Arquivos, ou, no Mac, digite ! open index.html no Claude Code. O ! no começo roda um comando por sua conta, sem passar pelo Claude.

Passo 5: dê feedback como um cliente

É daqui que vem a maior parte do valor. Reaja como um cliente exigente reagiria: curto, específico, uma coisa de cada vez.

Digitar @ seguido do nome de um arquivo, como @brand.txt, aponta o Claude para aquele arquivo exato, para que ele leia antes de agir. Para mostrar um problema em vez de descrever, tire um print da tela e cole no Claude Code com Ctrl+V na maioria dos terminais, Cmd+V no iTerm2 ou Alt+V no Windows.

Você não precisa esperar em silêncio enquanto ele trabalha. Digite uma correção e aperte Enter, e o Claude lê assim que terminar o passo atual, ou aperte Esc para pará-lo na hora.

Passo 6: desfaça uma mudança de que você não gostou

Cedo ou tarde, uma mudança vai piorar as coisas. Você tem três caminhos de volta:

1. Peça. "Desfaça essa última mudança" funciona nos casos simples.
2. Use o rewind. Aperte Esc duas vezes com o prompt vazio, ou digite /rewind, escolha a mensagem de antes de as coisas darem errado e depois escolha Restore code and conversation (restaura o código e a conversa), Restore code (mantém o chat e reverte os arquivos) ou Restore conversation (mantém os arquivos e volta o chat).
3. Volte para uma versão salva, se você usa o git, uma ferramenta gratuita que guarda versões nomeadas de um projeto.

Para ter uma rede de segurança de verdade, peça uma. A maioria dos Macs já vem com o git; no Windows, instale antes o Git for Windows.

Transforme esta pasta em um repositório git e salve a versão atual com uma descrição clara do que está funcionando.

Domingo: deixe tudo redondo

Passo 7: anote o que vocês combinaram

A essa altura você já tomou decisões sobre cores, tom e "sempre conferir na largura de celular". Salve essas decisões para nunca mais precisar repetir:

Crie um arquivo CLAUDE.md para este projeto com os dados do negócio, as regras de estilo que definimos e uma regra para conferir a página na largura de celular antes de dizer que terminou.

O CLAUDE.md é um arquivo de texto simples que o Claude Code lê no começo de toda sessão nesta pasta, e as edições que você faz no meio de uma sessão passam a valer depois de um /clear ou na sessão seguinte. O guia do arquivo CLAUDE.md mostra o que colocar nele, com modelos.

Passo 8: peça uma revisão com evidências

Revise a página como um cliente exigente. Confira se todas as seções do meu briefing estão lá, se todos os links e o telefone funcionam, se dá para ler o texto na largura de celular, se as imagens têm texto alternativo e se nenhum nome, preço ou horário está diferente do briefing. Corrija o que puder e depois liste o que você mudou e o que ainda precisa de mim.

Depois confira você mesmo: clique em todos os links, estreite a janela do navegador até a largura de um celular e leia cada preço em voz alta comparando com a sua tabela de preços. Se você configurou o git no Passo 6, o /diff mostra o que mudou desde a última versão salva.

Passo 9: decida onde o site vai ao ar

Publicar é um trabalho à parte: um domínio, uma hospedagem gratuita e algumas configurações para que os buscadores encontrem a página. O guia de como criar um site com IA mostra como publicar com o Claude Code e a Vercel, e o passo a passo de vibe coding acrescenta um checklist de lançamento para a landing page de um negócio.

10 dicas para usar bem o Claude Code

1. Um resultado por mensagem. "Deixe o botão de agendamento com a largura toda no celular" funciona melhor do que um parágrafo com cinco desejos.
2. Aponte, não descreva. @styles.css faz o Claude ler o arquivo certo em vez de sair procurando.
3. Deixe que ele entreviste você. Para qualquer coisa maior que um ajuste, termine com "me faça perguntas até ter o que você precisa".
4. Planeje quando não der para dizer em uma frase. Pule o planejamento em correções pequenas, em que ele só acrescenta etapas.
5. Pare cedo. Aperte Esc assim que ele for para o lado errado, porque esperar só aumenta a faxina depois.
6. Errou duas vezes, comece do zero. Se você corrigiu a mesma coisa duas vezes, rode /clear e escreva um primeiro prompt melhor com o que aprendeu.
7. Uma tarefa por sessão. Use /clear entre trabalhos sem relação, e rode /rename antes se quiser achar a conversa antiga depois com /resume.
8. Peça evidências, não garantias. "Liste os arquivos que você mudou" ou "me mostre de onde vem esse número" é melhor do que "terminou?".
9. Deixe as perguntas paralelas de lado. O /btw responde uma pergunta rápida sem adicioná-la à conversa principal.
10. Deixe a ferramenta ensinar você. O /powerup roda aulas interativas curtas, a referência do modo interativo lista todos os atalhos, e o nosso guia rápido de comandos do Claude Code junta os mais úteis em uma página.

O que fazer agora

Escolha um segundo projeto pequeno para o próximo fim de semana, de preferência algo pelo qual você pagaria ou que vive adiando, e repita o mesmo ciclo: briefing no plan mode, construção no modo Manual, revisão com evidências e o que você aprendeu salvo no CLAUDE.md. A nossa lista de ideias de projetos com Claude Code tem opções que vão de uma hora a um fim de semana. Se você prefere ser guiado pela jornada inteira, o curso de Claude Code vai da instalação até uma landing page publicada, um vídeo com IA e um agente de notas fiscais.