Tutorial do Claude Code: Do Zero ao Primeiro Projeto
A primeira vez que executei o Claude Code pelo terminal, dei uma única linha de instrução e observei ele gerar um jogo 2D funcional em cerca de quatro minutos.
Não foi uma demo de brinquedo. Um shooter top-down jogável — HTML, CSS, JavaScript, game loop, detecção de colisão, o pacote completo — na minha pasta de projeto e rodando no navegador antes mesmo de eu terminar meu café.
Trabalho com programação profissionalmente há anos. Sei quanto tempo leva para construir algo que realmente funciona do zero. Quatro minutos não é isso. Quatro minutos é outra coisa.
O que me surpreendeu não foi a velocidade — eu já esperava que a IA fosse rápida. O que me pegou de guarda foi como o processo parecia estruturado. O Claude não simplesmente despejou código na minha cara. Ele planejou primeiro, propôs a arquitetura, esperou minha confirmação e depois construiu metodicamente. A saída foi organizada, legível e documentada. Não foi aquele código improvisado que tecnicamente roda, mas estruturalmente não faz sentido nenhum.
Essa diferença entre o que eu esperava e o que recebi é exatamente o motivo pelo qual quis escrever este guia. A maioria dos tutoriais do Claude Code foca em desenvolvedores que já conhecem a ferramenta ou pula rápido demais as partes que realmente confundem as pessoas.
Este aqui não faz isso. Seja você alguém que nunca abriu um terminal na vida ou um desenvolvedor que ouviu falar do Claude Code mas nunca sentou de verdade com ele — este guia cobre o que você realmente precisa saber, na ordem em que precisa saber.
Uma coisa que vou mencionar agora e retomar depois: existe uma funcionalidade de memória persistente sobre a qual quase ninguém fala nos tutoriais para iniciantes, e é provavelmente a coisa mais importante de configurar antes do seu primeiro projeto de verdade. Guarde isso na cabeça enquanto lê.
O Que o Claude Code Realmente É (E O Que Não É)
Antes da instalação, o modelo mental importa. O Claude Code é muito descrito como "um assistente de programação com IA" — o que é preciso, mas não faz jus ao que o torna diferente.
A maioria das ferramentas de IA para código são integradas a editores. Você escreve código, a IA sugere completações ou responde perguntas em uma barra lateral. O fluxo de trabalho é liderado pelo humano; a IA auxilia. O Claude Code inverte isso. Você descreve o que quer construir em linguagem natural, e a IA gera, modifica e gerencia a base de código. Você está dirigindo, não digitando.
É uma ferramenta CLI — uma interface de linha de comando — o que significa que roda dentro do seu terminal. Não é um aplicativo desktop com botões e menus. É um prompt de terminal onde você digita instruções e o Claude constrói. O design terminal-first é intencional: mantém o Claude Code próximo de onde o código realmente vive e dá acesso direto ao seu sistema de arquivos, processos em execução e comandos do shell.
A Anthropic tem um aplicativo desktop separado para o Claude — uma interface visual com modo de chat, modo de código e integração com GitHub. Essa ferramenta é excelente para iniciantes que querem uma entrada mais suave. Mas o CLI é onde está o verdadeiro poder, e este guia foca nele.
O Claude Code requer uma assinatura paga do Claude: Pro, Max, Teams ou Enterprise. Você também pode usar uma API key com créditos. Uma nota honesta sobre custo: uso intenso consome créditos mais rápido do que você imagina, especialmente em projetos complexos com o modelo mais poderoso. Começar com um plano mais barato e fazer upgrade quando você entender seus padrões de uso é a decisão mais sensata.
Os modelos disponíveis — Opus, Sonnet e Haiku — não são apenas níveis de qualidade. São ferramentas diferentes para trabalhos diferentes. Opus para arquitetura complexa e raciocínio multi-arquivo, Sonnet para trabalho intermediário equilibrado, Haiku para iteração rápida em tarefas simples. Você alterna entre eles durante uma sessão com /model. Entender qual modelo usar é algo que você desenvolve com a prática, não algo que se descobre logo de cara.
Configuração Inicial: A Parte Que Todo Tutorial Passa Correndo
A instalação é feita pelo terminal. Usuários de Windows devem abrir o PowerShell; usuários de Mac e Linux usam o Terminal. O comando exato de instalação varia por sistema operacional e está na documentação da Anthropic — não vou colar um comando aqui que pode estar desatualizado quando você ler isto.
Após a instalação, você se autentica pela sua conta Anthropic ou Claude no navegador. Essa parte é tranquila.
O passo que confunde muitos iniciantes: quando você navega pela primeira vez até uma pasta de projeto, o Claude Code vai pedir para você confiar naquele diretório. Isso é uma verificação de segurança — você está explicitamente dizendo ao Claude Code que ele tem permissão para ler e modificar arquivos naquela localização. Não pule isso sem prestar atenção. Entenda em qual pasta você está e o que está concedendo acesso.
Agora — antes de fazer qualquer outra coisa — instale o Git.
Digo isso com ênfase porque é o passo de configuração com mais consequências e o que a maioria dos tutoriais trata como opcional. Não é. Trabalhar com código gerado por IA sem controle de versão é um tipo específico de dor: a IA produz algo que funciona, você itera sobre isso, algo quebra, e você não tem como voltar ao estado que funcionava.
Git é o sistema de checkpoints. Cada vez que você chega a um estado que te agrada, você faz um commit. Se algo quebra — alucinação da IA, instrução ruim, caso extremo inesperado — você reverte. O Claude Code pode ajudar na instalação do Git se você não tem familiaridade com o terminal, incluindo lidar com as solicitações de privilégio de administrador que aparecem no Windows.
Depois que o Git estiver configurado localmente, conecte-o a uma conta gratuita do GitHub usando gh auth login. O Claude pode executar esse comando por você. O que você ganha: seu código com backup remoto, um histórico de cada estado funcional e a capacidade de compartilhar ou colaborar se quiser. Essa configuração leva talvez quinze minutos e te poupa horas de dor de cabeça depois.
Parear o Claude Code com um editor de código completa a configuração. VS Code e Cursor funcionam bem. O fluxo de trabalho é: abra sua pasta de projeto no editor, use o terminal integrado do editor para rodar o Claude Code, e veja o explorador de arquivos atualizar em tempo real conforme o Claude gera e modifica arquivos. A camada visual torna o processo significativamente mais legível do que um terminal puro, especialmente quando você está gerenciando projetos com múltiplos arquivos.
Uma dica prática sobre o pareamento com editor: mantenha o explorador de arquivos e o terminal lado a lado. Quando o Claude gerar um novo arquivo, clique nele imediatamente e dê uma olhada antes da próxima instrução. Você não está revisando cada linha — está construindo um mapa mental do que existe para que suas instruções subsequentes sejam precisas. Dizer ao Claude para "atualizar o componente de cabeçalho" quando o arquivo na verdade se chama navbar.jsx desperdiça uma ida e volta. Conhecer a estrutura dos seus arquivos significa que seus prompts acertam de primeira.
Cursor tem uma leve vantagem sobre o VS Code aqui porque sua própria integração com IA funciona naturalmente junto ao Claude Code sem que os dois se atrapalhem. Você pode usar as sugestões inline do Cursor para edições pequenas enquanto usa o Claude Code para qualquer coisa envolvendo múltiplos arquivos ou raciocínio em nível de projeto. As ferramentas se complementam em vez de competir.
Os Três Modos Que Mudam Sua Forma de Trabalhar
O Claude Code tem três modos de operação, cada um útil para situações diferentes. Alternar entre eles é um simples Shift + Tab.
Modo Ask é o padrão. O Claude pede sua confirmação antes de executar qualquer comando ou escrever qualquer arquivo. Cada ação requer sua aprovação explícita. Este é o modo certo para território desconhecido — quando você está trabalhando em uma base de código que não construiu, em uma tarefa com alto risco de quebrar algo, ou sempre que quiser visibilidade total antes de o Claude agir.
Modo Auto-accept (às vezes chamado de modo de codificação) remove a etapa de confirmação. O Claude executa edições e roda comandos automaticamente. A vantagem de velocidade é real: tarefas que exigem dezenas de pequenas modificações em arquivos avançam significativamente mais rápido sem prompts constantes de aprovação. Use isso para projetos que você conhece bem e confia que o Claude pode lidar, não para suas primeiras sessões com uma base de código desconhecida.
Modo Planning é o que a maioria dos iniciantes pula e a maioria dos usuários avançados jura de pé junto. Antes de escrever uma única linha de código, o Claude gera um plano detalhado — a abordagem arquitetural, a estrutura de arquivos, a ordem de implementação, os casos extremos que ele antecipa. Você revisa o plano, modifica se necessário e depois confirma. O Claude constrói de acordo com o plano.
A diferença na qualidade do resultado entre pular direto para a codificação e usar o modo planning primeiro não é sutil. A abordagem planejada produz código que se sustenta como um sistema. A abordagem de ir direto produz código que funciona para a tarefa descrita e frequentemente precisa de reestruturação no momento em que você pede qualquer coisa adjacente ao pedido original.
Para qualquer projeto maior que um único arquivo, comece no modo planning. Os poucos minutos que leva para gerar e revisar um plano se pagam imediatamente.
Seu Primeiro Projeto Real: Como o Fluxo de Trabalho Realmente Funciona
Aqui está como uma sessão de projeto real se parece do início ao fim.
Abra seu terminal (ou o terminal integrado do seu editor), navegue até a pasta onde você quer que o projeto fique, e inicie o Claude Code. Confie no diretório quando solicitado.
Mude para o modo planning com Shift + Tab. Descreva seu projeto em linguagem natural — seja específico sobre o que você quer. "Construa um jogo shooter 2D top-down" te dá algo. "Construa um jogo shooter 2D top-down em JavaScript puro com controles de teclado, um sistema de vida do jogador, inimigos que reaparecem depois de destruídos e um contador de pontuação exibido no canto superior direito" te dá algo significativamente melhor. Especificidade é uma habilidade no desenvolvimento assistido por IA, e ela se acumula rapidamente.
O Claude gera um plano. Leia. Leia de verdade — não role até o final e confirme. O plano mostra quais suposições o Claude está fazendo. Se você vir algo que não corresponde à sua intenção, corrija antes de o build começar. Mudar de direção durante um plano custa trinta segundos. Mudar de direção depois de vinte arquivos terem sido gerados custa muito mais.
Confirme o plano. Observe o Claude construir.
O projeto vai incluir uma pasta .claw que o Claude usa para rastreamento interno. Você não precisa gerenciar isso manualmente. Seus arquivos reais do projeto aparecem ao lado. Quando o build terminar, teste o resultado — no caso de um projeto web, abra o HTML gerado no navegador e interaja com ele. Testes reais revelam problemas reais que nenhuma quantidade de revisão de código encontra.
Itere a partir daí. "O respawn dos inimigos está muito rápido, adicione um atraso de três segundos" é uma instrução válida. "A fonte do contador de pontuação deveria combinar com a estética geral do jogo" é uma instrução válida. Refinamento em linguagem natural funciona durante toda a sessão — você não precisa mudar para uma mentalidade de programação para fazer ajustes.
Depois de uma iteração significativa — algo funciona do jeito que você quer, uma feature está completa, um bug foi corrigido — faça commit no Git. Isso leva dez segundos. git add . depois git commit -m "player health system working". O Claude Code pode fazer isso por você se você preferir não digitar os comandos manualmente: basta pedir para ele fazer commit do estado atual com uma mensagem descritiva e ele fará. A disciplina de fazer commit em pontos estáveis é o que separa o desenvolvimento produtivo assistido por IA das sessões que terminam com "preciso recomeçar porque não consigo voltar para quando funcionava."
Dois atalhos que vale a pena conhecer imediatamente: Alt + Enter (Windows) ou Option + Enter (Mac) insere uma quebra de linha dentro do seu prompt sem enviá-lo. Essencial para instruções de múltiplos parágrafos. Esc Esc (dois pressionamentos rápidos) limpa o prompt atual se você quiser recomeçar sua instrução. E @ seguido de um nome de arquivo permite referenciar um arquivo específico na sua instrução — "atualize a lógica em @game.js para aumentar a velocidade dos inimigos em 20% após cada onda" é mais preciso do que "atualize a lógica do jogo", e precisão é o que mantém as sessões nos trilhos.
As Funcionalidades Que Mudaram Minha Forma de Trabalhar
Memória persistente com CLAUDE.md.
As sessões não retêm contexto ilimitado. Quando você fecha o Claude Code e reabre no dia seguinte, ele começa do zero. Para um script curto, isso é tranquilo. Para um projeto que você está construindo ao longo de dias ou semanas, é um problema sério — cada sessão exige re-explicar o que é o projeto, quais convenções você está usando, quais decisões já foram tomadas.
O CLAUDE.md resolve isso. Criado com o comando /init (às vezes mostrado como /nit na documentação), é um arquivo markdown que fica na raiz do seu projeto e armazena tudo que o Claude precisa para manter continuidade: visão geral do projeto, padrões de design, convenções de nomenclatura, decisões arquiteturais, restrições e quaisquer preferências de como o Claude deve se comportar nesta base de código específica.
A cada nova sessão, o Claude lê o CLAUDE.md primeiro. Ele retoma de onde você parou sem que você precise instruí-lo novamente.
Invista tempo escrevendo um bom CLAUDE.md no início de qualquer projeto com múltiplas sessões. Atualize-o quando tomar decisões significativas no meio do projeto. Pense nele como o briefing que você escreveria para um novo membro da equipe — abrangente o suficiente para que alguém sem contexto prévio consiga entender o sistema.
Seleção de modelo no meio da sessão.
O comando /model permite alternar entre Opus, Sonnet e Haiku a qualquer momento. Uso prático: comece o planejamento e o trabalho de arquitetura no Opus, onde a qualidade do raciocínio importa mais, e mude para Sonnet ou Haiku para os passos mecânicos de implementação, onde você está apenas gerando boilerplate ou fazendo pequenas alterações repetitivas. Essa abordagem gerencia custos sem sacrificar qualidade onde a qualidade importa.
Tarefas em segundo plano.
Alguns comandos bloqueiam o terminal — rodar um servidor de desenvolvimento local, observar mudanças em arquivos, processar uma operação longa. O Claude Code permite empurrar essas tarefas para segundo plano para que você possa continuar dando instruções enquanto elas rodam. Ctrl + T lista as tarefas ativas em segundo plano; K encerra uma tarefa selecionada. Isso mantém seu fluxo de trabalho ininterrupto em vez de forçar você a abrir uma segunda janela de terminal para tudo que roda continuamente.
Agentes e skills.
Agentes são processos paralelos especializados que lidam com partes distintas de um projeto simultaneamente. Um agente gerencia a estilização do frontend enquanto outro cuida da lógica do backend, ambos rodando em paralelo e reportando de volta à sessão principal. A integração com servidor MCP estende isso ainda mais — agentes podem se conectar ao Notion, Gmail, Google Drive e outros serviços externos, puxando contexto real do seu ambiente de trabalho real.
Skills são fluxos de trabalho repetíveis que você treina o Claude a executar de forma consistente. Se você roda a mesma sequência de deploy, a mesma rotina de testes ou o mesmo fluxo de geração de conteúdo repetidamente, uma skill empacota isso em um comando reutilizável. Com o tempo, sua biblioteca de skills se torna um sistema de automação pessoal construído em torno de como você realmente trabalha.
O Que Esperar vs. O Que as Demos Mostram
Avaliação honesta, porque isso importa antes de você investir tempo configurando tudo.
O Claude Code é genuinamente impressionante para tarefas bem definidas com entradas claras. Geração de jogos, scaffolding de API, scripts utilitários, geração de documentação, processamento de dados estruturados — essas categorias consistentemente produzem excelentes primeiros rascunhos. A saída do modo planning é coerente e a implementação a segue.
Onde fica complicado: grandes bases de código existentes que não foram escritas com assistência de IA em mente. Colocar o Claude Code em um projeto legado complexo e pedir para ele refatorar ou estender funcionalidades requer construção de prompt mais cuidadosa e supervisão mais ativa do que construir algo do zero. A janela de contexto do modelo tem limites, e sistemas complexos multi-arquivo com interdependências profundas podem exceder o que ele mantém de forma limpa.
Instruções precisam ser específicas. "Melhore isso" não é uma instrução útil. "O layout mobile quebra em 375px — a navegação sobrepõe a seção hero, corrija o z-index e ajuste as regras de flex-wrap" é uma instrução útil. A qualidade do que você recebe escala diretamente com a especificidade do que você fornece. Isso é uma habilidade que exige prática deliberada para desenvolver, e as primeiras sessões frequentemente produzem resultados medianos não porque a ferramenta é fraca, mas porque os prompts são vagos.
O consumo de créditos em sessões pesadas se acumula. Geração complexa multi-arquivo no Opus pode queimar créditos significativos em uma única tarde. Se você está experimentando sem um objetivo claro de projeto, faça no Haiku. Reserve o Opus para o trabalho que realmente precisa dele.
E sempre revise código gerado por IA antes de executá-lo em qualquer ambiente que importa. Não porque o Claude Code não é confiável — a qualidade da saída é alta — mas porque código gerado por IA pode conter casos extremos, considerações de segurança ou suposições sobre seu ambiente que ele não poderia saber sem ser explicitamente informado. Revisão é um hábito profissional, não um sinal de que a ferramenta falhou.
Construindo o Modelo Mental Certo
Os desenvolvedores que mais aproveitam o Claude Code compartilham uma característica: pararam de pensar nele como autocomplete e começaram a pensar nele como direção.
Um bom diretor não escreve cada linha de diálogo. Um bom diretor tem uma visão clara, comunica-a especificamente, dá feedback sobre o que não está funcionando e molda a performance em direção a algo que não poderia ter produzido sozinho. Essa é a habilidade a desenvolver com o Claude Code — não a capacidade de fazer prompts espertos, mas a capacidade de manter uma visão clara do que você está construindo, comunicá-la com precisão e iterar em direção a ela de forma eficiente.
Os iniciantes que ficam frustrados com a ferramenta geralmente estão tentando fazer ela ler suas mentes. "Me construa algo legal" produz algo genérico. "Construa um rastreador de finanças pessoais com resumos semanais de gastos exibidos como gráficos de barras, um sistema simples de categorização por tags e exportação CSV — sem necessidade de login, apenas armazenamento local" produz algo que você pode realmente usar.
A configuração que descrevi neste guia — integração com Git, CLAUDE.md para memória persistente, modo planning antes de cada projeto substancial, seleção de modelo adequada à complexidade da tarefa — cria as condições para a ferramenta performar bem. Estas não são boas práticas opcionais. São a base que faz todo o resto funcionar.
Uma coisa que vale a pena começar hoje: crie uma pasta de projeto para testes, instale o Claude Code, configure o Git e construa algo pequeno com o modo planning ativo. Um app de tarefas, uma calculadora básica, uma landing page estática. Não porque o resultado será útil — não será, é um projeto de testes — mas porque a memória muscular do fluxo de trabalho é o verdadeiro produto daquela primeira sessão. Tudo depois disso fica mais rápido.
Os desenvolvedores que serão mais eficazes com ferramentas de IA nos próximos anos não são necessariamente os melhores programadores. São as pessoas que aprenderam cedo a dirigir bem.
Vamos Trabalhar Juntos
Procurando construir sistemas de IA, automatizar fluxos de trabalho ou escalar sua infraestrutura de tecnologia? Adoraria ajudar.
- Fiverr (builds customizados e integrações): fiverr.com/s/EgxYmWD
- Portfolio: mejba.me
- Ramlit Limited (soluções empresariais): ramlit.com
- ColorPark (design e branding): colorpark.io
- xCyberSecurity (serviços de segurança): xcybersecurity.io
