Você ouviu falar de Claude Code e quer saber como começar na prática? Você está no lugar certo. Este tutorial te leva pela mão desde a instalação até seu primeiro projeto funcionando de verdade, sem presumir nenhum conhecimento técnico prévio.

Ao final deste guia, você terá instalado Claude Code, iniciado sua primeira sessão, entendido os comandos essenciais e criado um pequeno projeto que pode mostrar para alguém. Tudo em português, passo a passo.

O que é Claude Code?

Claude Code é uma ferramenta de assistência ao desenvolvimento criada pela Anthropic, a empresa por trás da IA Claude. Diferente de um simples chatbot, ele pode realmente mexer nos seus arquivos: criar código, modificar, executar comandos, testar e até fazer deploy.

Na prática, você abre Claude Code em uma pasta, explica o que quer (em português, em frases normais) e ele coloca a mão na massa. Você vê os arquivos aparecendo, valida, pede ajustes. É mais um colega de trabalho do que uma ferramenta.

O que o torna único comparado com concorrentes como Cursor ou GitHub Copilot:

  • Ele realmente executa ações no seu ambiente (não é só sugestão).
  • Entende projetos completos, não só a linha que você está escrevendo.
  • Tem um modo "plano" que propõe um plano antes de codar.
  • Fala português perfeito e se adapta ao seu nível.

Instalar Claude Code em 5 minutos

A instalação de Claude Code é simples e funciona em Mac, Windows e Linux.

Passo 1 — Crie ou acesse sua conta Claude

Vá para claude.ai e crie uma conta se não tiver uma. Uma assinatura Claude Pro (cerca de 20 reais por mês) é necessária para usar Claude Code confortavelmente. Estudantes podem ter acesso a preços reduzidos através de programas específicos.

Passo 2 — Baixe Claude Code

Vá para claude.ai/code. Você verá um botão "Download Claude Code". Escolha sua plataforma (macOS, Windows, Linux). O arquivo tem cerca de 50 MB e o instalador é oficialmente assinado pela Anthropic.

No macOS, Claude Code se instala como um app normal na pasta Aplicativos. No Windows, um instalador clássico te guia. No Linux, você usa um pacote deb ou rpm conforme sua distribuição.

Passo 3 — Inicie sua primeira sessão

Abra um terminal (Terminal no Mac, PowerShell no Windows), vá para a pasta onde quer trabalhar com cd /caminho/para/pasta, depois digite:

claude

Na primeira vez, Claude Code pedirá para você se conectar. Um navegador abre, você valida, e volta ao terminal. Pronto.

Seu primeiro projeto com Claude Code

O melhor projeto para aprender é uma pequena página web que você vê imediatamente no navegador.

Crie uma pasta vazia na sua área de trabalho, por exemplo meu-primeiro-projeto. Abra o terminal dentro dela e digite claude. Depois escreva este pedido:

Quero criar uma página inicial simples para meu café fictício "A Raposa". Uma foto de fundo, um título, um parágrafo descrevendo o café, horários e um botão para reservar mesa. Não entendo nada de código, me guia.

Claude provavelmente fará 2 ou 3 perguntas (que clima, que cores, etc.). Responda naturalmente. Depois ele criará os arquivos: index.html, styles.css, às vezes script.js. Você os verá aparecer na pasta.

Abra index.html com um duplo clique. Seu navegador mostra o resultado. Pode não ser perfeito, e tudo bem. Volte ao terminal e peça mudanças: "Faz o título maior", "Coloca um fundo azul noite", "Adiciona um logo no canto superior esquerdo". A cada iteração, você atualiza e vê a mudança.

Em 30 a 45 minutos, você tem uma página que gosta.

Os 10 comandos Claude Code que você precisa conhecer

Alguns comandos especiais permitem aproveitar ao máximo Claude Code sem ler toda a documentação. Aqui estão os que você usará 80% do tempo.

Comando O que faz
/help Mostra a lista de comandos disponíveis
/clear Limpa o histórico da sessão atual
/model Muda o modelo usado (Opus, Sonnet, Haiku)
/init Cria um arquivo CLAUDE.md para documentar o projeto
/plan Ativa o modo plano antes de executar
/compact Resume a conversa para liberar memória
/exit Fecha a sessão corretamente
Arrastar um arquivo Adiciona o arquivo no contexto (como uma imagem)
Escrever @nomearquivo Faz Claude ler um arquivo específico
!comando Executa um comando shell sem passar por Claude

Para a lista completa e detalhes de cada comando, nosso artigo os 20 comandos Claude Code que você precisa conhecer cobre tudo.

O arquivo CLAUDE.md, seu melhor aliado

O arquivo CLAUDE.md é um pequeno documento onde você escreve as regras do seu projeto para que Claude se lembre em cada sessão. É como deixar um post-it para seu eu do futuro e para Claude.

Você pode colocar:

  • A stack usada (React, Next.js, Python, etc.)
  • Os comandos de teste e build
  • As convenções de código a seguir
  • As regras de linguagem (ex: "todos os textos do usuário em português com acentos")
  • As áreas que nunca devem ser tocadas

Claude lê automaticamente este arquivo a cada nova sessão. É o segredo para não repetir as mesmas instruções toda vez. Comece pequeno (5-10 linhas) e enriqueça conforme identifica o que te serve.

O modo plano: pensar antes de agir

O modo plano é uma funcionalidade única que pede a Claude para propor um plano antes de executar qualquer coisa. Em tarefas importantes, evita surpresas desagradáveis.

Digite /plan na sua sessão, depois formule seu pedido. Claude vai analisar, fazer perguntas se necessário, e apresentar um plano estruturado em várias etapas. Você pode aceitar, ajustar ou recusar completamente. Uma vez validado, Claude executa o plano passo a passo.

É particularmente útil quando você ainda não sabe bem o que quer: Claude te ajuda a definir melhor.

Erros de iniciante a evitar

Aqui estão os 4 problemas que sistematicamente bloqueiam iniciantes e como contorná-los.

  • Abrir Claude na sua pasta home: sempre abra em uma subpasta dedicada. Senão ele tem acesso a tudo.
  • Pedir várias features de uma vez: "Faz um site de e-commerce completo" → divida em pequenas etapas.
  • Não ler as perguntas de Claude: quando ele pergunta, ele realmente quer sua resposta. Não pule.
  • Esquecer de salvar no git: use git para manter um histórico do seu projeto. Claude pode te ajudar a configurar.

Para ir além

Claude Code é uma ferramenta profunda: sempre há algo a aprender. Mas você não precisa saber tudo para começar a criar coisas úteis. O progresso é contínuo: cada projeto te torna melhor.

Se quer um caminho estruturado em português, o programa Vibe Coding da Skilzy te leva da mão do zero até um projeto real deployado, com exercícios gamificados e guiados passo a passo.

A única coisa que te separa do seu primeiro projeto é abrir um terminal hoje.