Como usar o Claude Code: o primeiro projeto, passo a passo

Para usar o Claude Code no primeiro projeto, você cria uma pasta vazia, abre o terminal dentro dela, digita claude, pede um plano antes de qualquer arquivo e aprova uma mudança pequena de cada vez. Este guia mostra como usar o Claude Code nessa ordem, do primeiro pedido até desfazer um erro.

Para quem é este passo a passo

Este texto é para quem já instalou a ferramenta e travou na pergunta seguinte: e agora, o que eu peço? Se você ainda não instalou, comece pelo passo a passo para instalar o Claude Code no Mac e no Windows e volte aqui. Se ainda não sabe se a ferramenta é para você, leia antes o que é o Claude Code para quem não é programador.

O Claude Code nada mais é do que o Claude trabalhando direto nos arquivos do seu computador. No chat, você copia e cola a resposta. Aqui, ele mesmo cria, lê e altera os arquivos da pasta em que você abriu a sessão. Pense num funcionário novo sentado na sua mesa: ele mexe nos papéis, mas pergunta antes de rasgar alguma coisa.

O exemplo deste guia é pequeno de propósito: uma página simples que calcula o valor de um orçamento a partir de horas e valor da hora. Não precisa de servidor, abre no navegador e dá para conferir na hora.

O que você precisa antes de começar

• O Claude Code instalado. A documentação oficial pede para conferir com o comando claude --version, que deve mostrar um número de versão.
• Uma conta que dê acesso ao Claude Code. A página de início rápido da Anthropic lista as assinaturas do Claude e a conta do Claude Console. Quais planos incluem e quanto custa, confira na página oficial de preços, porque isso muda.
• Uma pasta para o projeto. Pode ser vazia. É o espaço de trabalho dele.

Como usar o Claude Code: o primeiro projeto em 6 etapas

Qual é o primeiro passo? Não é escrever o pedido. É separar o espaço de trabalho, porque o Claude Code enxerga a pasta onde você abriu a sessão.

Etapa 1: crie a pasta e abra a sessão dentro dela

Crie uma pasta com um nome claro, por exemplo orcamento. No terminal, entre nela e inicie a sessão:

cd caminho/da/pasta/orcamento
claude

Na primeira vez, ele pede login e abre o navegador para você entrar com a sua conta. Segundo a documentação, depois disso a credencial fica salva e você não precisa logar de novo. Quando a sessão abre, aparece a caixa para digitar, com a pasta atual indicada logo acima.

Um cuidado: não abra o Claude Code na sua pasta de usuário inteira ou na área de trabalho cheia de documentos. Uma pasta por projeto. Assim fica claro o que ele pode tocar.

Etapa 2: peça um plano antes de pedir o código

A documentação descreve o modo de planejamento (plan mode): o Claude lê, pesquisa e escreve um plano, mas não edita seus arquivos até você aprovar. Você entra nele apertando Shift+Tab ou começando o pedido com /plan.

Escreva o pedido com contexto, formato e critério de pronto. É o mesmo raciocínio do método C.L.A.R.O. para montar um prompt. Um exemplo para copiar:

/plan Sou dono de uma pequena empresa de serviços e quero uma página simples
para calcular orçamento. Contexto: vou abrir o arquivo direto no navegador,
sem servidor. Ação: crie uma página com três campos (nome do cliente, horas
estimadas e valor da hora) e um botão que mostra o total. Referência: visual
limpo, fundo claro, fonte legível no celular. Objetivo: eu abro o arquivo,
preencho os campos e vejo o total certo. Antes de criar qualquer arquivo,
me mostre o plano e me diga quais arquivos vai criar.

Ele devolve o plano e pergunta como seguir. Leia. Se ele quiser criar mais coisa do que você pediu, responda que não, que mantenha simples. Escopo pequeno é o que faz o primeiro projeto dar certo.

Etapa 3: aprove e acompanhe as permissões

Quando o plano estiver bom, você aprova. A documentação lista as opções nessa hora: aprovar e deixar ele seguir com menos interrupções, ou aprovar e revisar cada edição uma a uma. No primeiro projeto, eu escolheria revisar cada edição. Você aprende o que ele faz e onde.

Isso tem a ver com os modos de permissão. Em resumo, pela documentação: no modo manual, ele para e pergunta antes de editar arquivo ou rodar comando; no modo de aceitar edições, ele altera arquivos sem perguntar; no modo automático, um segundo modelo revisa as ações no seu lugar. Shift+Tab troca o modo a qualquer momento. Em novembro de 2026, a documentação diz que o modo automático é o ponto de partida nas versões mais recentes do terminal, então confira na tela em qual modo a sua sessão abriu.

Etapa 4: confira o resultado fora do Claude Code

Quando ele terminar, abra a página no navegador e teste. Preencha 10 horas e um valor qualquer, faça a conta de cabeça e compare. Teste também o caso chato: campo vazio, letra no lugar de número.

A documentação da Anthropic tem uma recomendação útil para quem não programa: dar ao Claude algo que ele consiga rodar e que responda passou ou não passou. No nosso caso, você pode pedir:

Crie uma lista de 5 testes para a calculadora, com entrada e resultado
esperado, rode cada um e me diga quais passaram e quais falharam.

Mesmo assim, a conferência final é sua. Se você não testou, a culpa do erro não é da IA.

Etapa 5: registre as regras do projeto com /init

Na próxima sessão, ele não lembra da conversa de hoje. Quem lembra é um arquivo chamado CLAUDE.md, que fica na pasta do projeto. Segundo a documentação, o comando /init analisa o projeto e cria um CLAUDE.md inicial; se o arquivo já existe, ele sugere melhorias em vez de apagar o que está lá.

Rode /init e depois abra o arquivo. Acrescente o que ele não tem como adivinhar: para quem é a página, o tom do texto, o que não pode mudar. Pense num manual de boas-vindas do funcionário novo. Curto e direto, porque a própria documentação recomenda manter esse arquivo enxuto.

Etapa 6: saiba desfazer antes de precisar

Três comandos resolvem a maior parte dos tropeços, todos descritos na documentação oficial:

• Esc para o que ele está fazendo e mantém o que já foi feito, para você corrigir a rota.
• /rewind (ou Esc duas vezes com a caixa de texto vazia) abre a lista dos seus pedidos e volta o código, a conversa ou os dois para um ponto anterior.
• /clear começa a conversa do zero. A própria documentação sugere: se você corrigiu a mesma coisa duas vezes e ainda está errado, limpe e escreva um pedido melhor, em vez de insistir na terceira correção.

A ressalva: o /rewind cobre os arquivos que o Claude editou com as ferramentas dele. Arquivo que só foi alterado por um comando de terminal não volta. Por isso a documentação diz que esse recurso trabalha junto com o Git, não no lugar dele. Se o projeto vai crescer, peça ao Claude Code para iniciar o controle de versão e salvar um ponto a cada etapa que funcionar.

Comandos para ter à mão

Comando	Onde digitar	O que faz
claude	Terminal	Abre a sessão na pasta atual
claude -c	Terminal	Continua a conversa mais recente daquela pasta
claude -r	Terminal	Escolhe uma conversa anterior para retomar
/plan	Dentro da sessão	Pede plano antes de editar
Shift+Tab	Dentro da sessão	Troca o modo de permissão
/init	Dentro da sessão	Cria ou melhora o CLAUDE.md
/rewind	Dentro da sessão	Volta código e conversa para um ponto anterior
/clear	Dentro da sessão	Começa a conversa do zero
/help	Dentro da sessão	Lista os comandos disponíveis

Fonte: página de início rápido, modos de permissão e checkpoints da documentação do Claude Code, acessadas em 10/11/2026.

Os erros mais comuns no primeiro projeto

• Pedir o sistema inteiro de uma vez. A IA que recebe tudo junto se perde no meio. A documentação sugere quebrar a tarefa em passos numerados. Faça a calculadora, confira, depois peça o PDF do orçamento.
• Aprovar sem ler. O plano existe para você cortar o que não pediu. Se ele propôs banco de dados para uma página de cálculo, diga não.
• Colocar dado de cliente cedo demais. Você não precisa saber configurar segurança. Precisa saber que o sistema tem que ter, e pedir isso antes de usar dado real.
• Corrigir em círculo. Duas tentativas sem sucesso: /clear e um pedido novo com o que você aprendeu.

Quando o básico estiver confortável, o passo seguinte é ensinar tarefas repetidas para ele. É aí que entram as skills no Claude Code, e você encontra skills do Claude prontas para pequenas empresas para começar a partir de um modelo.

Se você quer fazer esse caminho com aula, em ordem, a trilha Construindo com a IA da Academ.IA vai das telas rápidas ao terminal e até colocar no ar um sistema próprio com o Claude Code.

Perguntas frequentes

Preciso saber programar para usar o Claude Code?

Não para começar. Você descreve o que quer e ele escreve o código. Mas você precisa saber o que quer, conferir o resultado e entender o básico do terminal: entrar numa pasta e abrir a sessão. A documentação oficial tem um guia de terminal para quem nunca abriu um.

O Claude Code mexe em arquivos fora da pasta do projeto?

Ele trabalha na pasta em que você abriu a sessão, e os modos de permissão definem o que ele pode fazer sem perguntar. Por isso a regra prática é abrir sempre dentro da pasta do projeto, nunca na pasta de usuário inteira, e usar o modo manual enquanto você aprende.

Como continuar um projeto no dia seguinte?

Entre na mesma pasta e rode claude -c para continuar a conversa mais recente, ou claude -r para escolher uma anterior. O que precisa valer em toda sessão vai no CLAUDE.md, que ele lê sozinho.

Qual a diferença entre usar o Claude no chat e no Claude Code?

No chat, ele responde e você copia o resultado para algum lugar. No Claude Code, ele cria e altera os arquivos direto no seu computador, roda comandos e testa. Para texto e análise, o chat resolve. Para construir uma ferramenta, o Claude Code poupa o copia e cola.

Errei e ele estragou o que funcionava. Dá para voltar?

Na maioria dos casos, sim: /rewind volta os arquivos que ele editou para um ponto anterior. O que foi alterado só por comando de terminal não volta, e por isso vale salvar versões com Git a cada etapa que funcionar.

Próximo passo

O Claude Code não organiza o projeto por você. Ele executa rápido o que você definiu, inclusive o que você definiu mal. Escopo pequeno, plano antes, conferência depois: essa ordem vale mais do que qualquer comando da tabela. Se você quer aprender a construir assim, com aula e na sequência certa, a Academ.IA tem a trilha Construindo com a IA, que leva do chat ao sistema próprio no ar, e a primeira aula é grátis.