Claude Code para iniciantes: 10 passos para começar (2026)

por Jasmine, uma dev que usa o Claude Code todos os dias.

Escrevi isto para a pessoa exata que eu era há pouco mais de um ano: alguém que sentia um aperto de medo ao abrir um terminal, não fazia ideia do que digitar e temia que cada rodada de IA queimasse uma pilha de dinheiro em tokens. Boa notícia — o Claude Code é muito mais fácil de começar do que você imagina. Se quiser entender os fundamentos primeiro, dê uma passada de olhos em o que é o Claude Code (uma explicação de A a Z); se você só quer "seguir o passo a passo e funcionar", pule direto para os 10 passos abaixo.

Antes de começar: o que você precisa

Bastam algumas poucas coisas listadas abaixo. Não se preocupe se você ainda se atrapalha com a linha de comando — cada passo diz exatamente o que digitar.

Checklist de preparo (5 minutos):

• Um computador com Windows, macOS ou Linux — qualquer um funciona.
• Node.js (a versão LTS) — necessário para o método de instalação via npm. Confira com node -v; se der erro, baixe e instale o Node.js LTS primeiro.
• Uma conta Claude: o plano Pro a US$ 20/mês (a opção mais fácil e barata para iniciantes) ou uma chave de API cobrada por token.
• Uma pasta de projeto para experimentar — uma pasta totalmente vazia serve.
• Cerca de 30 minutos e a atitude de "vamos só testar".

Você não precisa mandar bem no terminal. Bastam dois comandos: cd para entrar numa pasta e claude para abri-la ali. Todo o resto você diz em linguagem simples.

Passo 1 - Instalar o Claude Code

A forma mais comum é instalar via npm. Abra um terminal (no Windows, use o PowerShell ou o Terminal) e digite:

npm install -g @anthropic-ai/claude-code

Isso instala o Claude Code globalmente, então você pode chamar o claude de qualquer pasta (conforme a documentação oficial). Quando terminar, confirme com:

claude --version

Observações por sistema:

• Windows: se digitar claude resultar em "comando não reconhecido", feche o terminal e abra de novo para recarregar o seu PATH. Usar o PowerShell é a aposta mais segura.
• macOS/Linux: se você topar com um erro de permissão na instalação global, evite o sudo — em vez disso, reconfigure o diretório global do npm ou use um gerenciador de versões do Node.

Deixei de propósito todos os casos de exceção fora desta seção para o artigo continuar leve de ler. Se você empacar, veja o guia detalhado de instalação do Claude Code para cada plataforma e como corrigir os erros mais comuns.

Passo 2 - Entrar na conta e autenticar

Na primeira vez que você abre, o Claude Code pede autenticação. Há dois caminhos:

Meu conselho para iniciantes: escolha o plano Pro a US$ 20/mês. Você não precisa acompanhar cada token, não vai gastar muito "sem querer" enquanto ainda está aprendendo, e o preço fixo é fácil de administrar. Passe para uma chave de API quando o trabalho crescer. É só digitar claude, escolher o método de login e seguir as instruções na tela — leva algumas dezenas de segundos.

Passo 3 - Abra seu primeiro projeto e rode /init

Entre na pasta do seu projeto e inicie o Claude:

cd path/to/your-project
claude

Quando a interface de chat aparecer no terminal, digite:

/init

O comando /init manda o Claude escanear o seu projeto e criar um arquivo CLAUDE.md com uma visão geral (estrutura de pastas, tecnologias usadas, convenções). Esse arquivo ajuda o Claude a "entender o contexto" em toda sessão seguinte — você vai afiná-lo no Passo 8.

Passo 4 - Entenda o ciclo básico

Antes de dar qualquer instrução, captar esse ciclo significa que você entende 80% de como o Claude Code funciona. Ele se repete assim:

1. Você dá um prompt — diga em linguagem simples o que você quer.
2. O Claude lê o repositório — abre os arquivos relevantes para entender o contexto.
3. O Claude propõe mudanças — mostra quais arquivos vai editar ou criar.
4. Você aprova (permissão) — o Claude pergunta antes de escrever um arquivo ou rodar um comando; você aceita ou recusa.
5. O Claude edita os arquivos e roda os testes — e depois informa o resultado.
6. Repita até bater com o que você queria.

Sobre as permissões: por padrão o Claude sempre pergunta primeiro antes de qualquer ação com impacto — esse é o "freio de segurança" para iniciantes. Leia com atenção e depois aprove. Não tenha pressa de ligar o "aceitar tudo automaticamente" antes de estar à vontade (é um dos 5 erros comuns no fim deste artigo). Mantenha o hábito: ler, entender e então aprovar.

Eis o que deixa muita gente iniciante tranquila: o Claude não apaga arquivos escondido nem roda comandos perigosos pelas suas costas. Toda vez que ele quer escrever um arquivo, rodar um teste ou chamar um comando de terminal, você vê exatamente o que ele está prestes a fazer e pode recusar. Em outras palavras, quem está sempre no volante é você — o Claude só propõe e então executa quando permitido. Quando você entende esse ciclo, todo passo restante é só uma variação dele.

Passo 5 - Escreva seu primeiro prompt do jeito certo

A qualidade do resultado depende diretamente de como você formula suas instruções. A regra de ouro para iniciantes: pequeno, específico, uma coisa de cada vez. Não peça ao Claude para "construir o site inteiro" em uma única frase — quebre em partes.

Um bom prompt sempre tem contexto (qual arquivo, qual linha), um objetivo claro e um limite de escopo. Quanto mais específica você for, menos o Claude adivinha e menos você tem que refazer.

Passo 6 - Use o Plan Mode antes de construir

Para qualquer coisa minimamente complexa, não deixe o Claude mergulhar direto no código. Peça a ele para planejar primeiro. Meu mantra: um minuto lendo o plano economiza dez minutos construindo na direção errada — e economiza tokens também, porque você não refaz o trabalho.

Passo 7 - Seu primeiro projeto de verdade (com resultado real)

Agora a parte divertida: construir algo que você realmente consegue ver. Escolhi um miniprojeto extremamente leve para qualquer pessoa conseguir acompanhar — criar uma landing page em HTML estático. Você pode aplicar o mesmo processo a "consertar um bug pequeno" se já tiver um projeto.

Como fazer: abra um terminal numa pasta vazia, digite claude e então dê um prompt específico (lembre da regra do Passo 5):

Create an index.html file: a static landing page for a coffee shop called "Sunny".
Include: a header with the shop name, one slogan, a "Menu" section listing 3 items with prices,
and a footer with the address. Use clean inline CSS with basic responsiveness.
No JavaScript needed yet.

O Claude vai propor criar o index.html, pedir permissão para escrever o arquivo, e você aprova. Assim que o arquivo estiver criado, abra-o no navegador (dê dois cliques no index.html ou arraste-o para uma aba do navegador) para ver o resultado renderizado de verdade.

Momento sincericídio: a primeira tentativa costuma acertar o esqueleto, mas pode não combinar com o seu gosto — cores pálidas demais, digamos, ou um espaçamento que não ficou bem. Não desanime: é só continuar conversando, "Deixe a seção Menu com fundo creme, arredonde os cantos de cada item e coloque mais espaço entre eles." Isso é exatamente o ciclo do Passo 4. No que o Claude é realmente bom é em montar a estrutura rápido e ajustar conforme pedidos curtos; onde você precisa se manter ativa é em colocar em palavras a sua estética e conferir o resultado no navegador. Depois de algumas rodadas, você tem uma página pronta sem escrever uma única linha de HTML à mão.

Passo 8 - Crie um CLAUDE.md para o seu projeto

O CLAUDE.md é um arquivo de texto na raiz do seu projeto que registra o que você quer que o Claude sempre lembre: o que é este projeto, quais tecnologias usa, como o código é estilizado e os comandos de teste/execução. A cada nova sessão, o Claude lê esse arquivo primeiro, então você não precisa se repetir do zero.

Iniciantes deveriam ter um CLAUDE.md cedo, porque ele reduz drasticamente o Claude "perder o contexto" e adivinhar errado. Um CLAUDE.md mínimo pode ser assim:

# Project: Sunny coffee shop landing page

## Tech
- Static HTML/CSS, no framework, no build step.

## Conventions
- Keep CSS inline in index.html for simplicity.
- Write display content in English.

## Common tasks
- Adjust layout, colors, menu content.

Você já tem um rascunho do /init lá no Passo 3 — agora é só abrir e editar para bater com a realidade. Para escrever um CLAUDE.md do jeito certo (estrutura, dicas, exemplos para projetos maiores), veja o guia para escrever um CLAUDE.md caprichado para o seu projeto.

Passo 9 - Aprenda os atalhos e comandos de barra essenciais

Você não precisa decorar todos. Conhecer uns 6 comandos centrais já basta para o dia a dia:

Dica rápida: use /clear sempre que começar uma tarefa sem relação com a anterior — é o hábito de economia de tokens mais eficaz para iniciantes. Para uma tabela mais completa, veja a folha de referência completa de atalhos e comandos do Claude Code. Quando estiver à vontade, você também pode adicionar skills e comandos de barra prontos para parar de redigitar os mesmos fluxos repetitivos — que é exatamente o assunto do Passo 10.

Passo 10 - Ganhe velocidade com skills e subagents prontos

Depois de alguns projetos rodando lisos, você vai notar que repete bastante coisa: o mesmo tipo de prompt de revisão de código, o mesmo processo de montar o esqueleto do back-end, o mesmo jeito de escrever testes. É aqui que skills e subagents brilham — são "fluxos de trabalho pré-embalados" para o Claude seguir, em vez de você descrevê-los de novo toda vez.

Iniciantes definitivamente não são obrigados a construir tudo sozinhos. Existem kits que reúnem uma gama inteira de skills e agentes tanto para programação quanto para marketing — por exemplo, o kit AgentKit para o Claude Code (resenha detalhada). Para iniciantes, eu encaro isso como um upgrade depois que você já está à vontade, não algo que você precise no primeiro dia: deixe firmes os 9 passos acima primeiro. Quando você perceber que está perdendo tempo redigitando o mesmo fluxo, experimente o AgentKit (20% de desconto pelo link) para ver quanto esforço um sistema pronto de skills/subagents pode poupar. Não corra para comprar antes de realmente precisar — essa é a regra honesta.

5 erros comuns de iniciante (e como evitá-los)

Estes são os erros que mais vejo em iniciantes. Só de evitá-los, você já ganha uma velocidade bem perceptível:

• 1. Passar uma tarefa grande demais. "Constrói o app inteiro pra mim" faz o Claude adivinhar e se perder. Como evitar: quebre em partes, uma coisa clara por prompt (veja o Passo 5).
• 2. Pular o Plan Mode. Mergulhar direto no código facilmente vai na direção errada e força um retrabalho, desperdiçando tempo e tokens. Como evitar: peça um plano primeiro em qualquer coisa que mexa em mais de um arquivo (Passo 6).
• 3. Aceitar tudo automaticamente sem ler. Ligar o aceite automático e deixar o Claude editar a esmo. Como evitar: mantenha o hábito de ler-entender-e-então-aprovar nas permissões, pelo menos até estar realmente à vontade.
• 4. Não usar /clear. Enfiar toda tarefa numa mesma sessão dilui o contexto, enfraquece as respostas e aumenta o uso de tokens. Como evitar: rode /clear sempre que trocar de tarefa.
• 5. Não ter CLAUDE.md. Sem esse arquivo, o Claude tem que readivinhar o seu projeto a cada sessão. Como evitar: crie um CLAUDE.md cedo e atualize com o tempo (Passo 8).

Perguntas frequentes (FAQ)

O Claude Code é gratuito?

Existe um nível de teste limitado, mas para uso constante você precisa de um plano Claude (o Pro a US$ 20/mês é a escolha popular para pessoas físicas) ou de pagamento por token via chave de API. Para iniciantes, o plano Pro é o mais fácil de manter os custos previsíveis, porque o preço é fixo.

Preciso saber programar antes?

Não é obrigatório para começar — você dá as instruções em linguagem simples e o Claude escreve o código. Mas conhecer o básico (ler código, entender o que o seu projeto contém) ajuda você a escrever prompts melhores e a conferir os resultados. Quanto mais você aprende, mais efetivamente usa o Claude Code.

Funciona no Windows?

Sim. O Claude Code roda em Windows, macOS e Linux. No Windows, use o PowerShell ou o Terminal; se digitar claude não for reconhecido, feche e reabra o terminal para recarregar o seu PATH.

Quanto custam os tokens/o dinheiro?

No plano Pro a US$ 20/mês o custo é fixo, então você não precisa se preocupar com tokens individuais enquanto aprende. Numa chave de API você paga pelo volume de tokens (por exemplo, o Sonnet 5 é mais ou menos US$ 2 de entrada e US$ 10 de saída por 1 milhão de tokens). Usar /clear ao trocar de tarefa e ligar o Plan Mode reduzem visivelmente o uso de tokens.

Qual a diferença para o ChatGPT ou o chat do Claude?

O chat comum só responde em texto, e você tem que copiar o código de um lado para o outro. O Claude Code roda direto no seu terminal, lê o seu projeto diretamente e edita arquivos e roda comandos (depois de pedir permissão). Em resumo: o chat é um assistente que responde, o Claude Code é um colega de equipe que opera na sua base de código de verdade.

Quanto tempo leva para aprender o Claude Code?

Colocar seu primeiro projeto para rodar leva só uns 30 minutos, como nos 10 passos acima. Ficar proficiente (bons prompts, gestão de contexto, uso de skills/subagents) costuma levar alguns dias de prática. É só construir projetos de verdade que você pega o jeito rápido.

Conclusão e próximos passos

Com esses 10 passos concluídos, você foi do zero a um primeiro projeto funcionando — instalar, autenticar, entender o ciclo, escrever bons prompts e evitar os erros comuns. Isso é uma base sólida para ir além. Meus próximos passos sugeridos: salve nos favoritos a folha de referência completa de comandos e atalhos para consultar rápido, leia sobre como escrever um CLAUDE.md caprichado e, se quiser entender os fundamentos a fundo, volte a o que é o Claude Code (uma explicação de A a Z).