Claude Code na prática: o fluxo completo do primeiro projeto ao deploy (e o que você paga por isso)

Tem uma coisa que muda a tua opinião sobre a ferramenta na hora: ver o Claude Code trabalhando de verdade, no teu terminal, não num slide bonito 🙂

A ideia deste post é mostrar UM fluxo só, do primeiro projeto ao deploy, com o custo real amarrado em cada etapa

Você vai entender o que faz cada passo, onde ele economiza teu tempo e, no fim, o que exatamente você está pagando quando assina o plano

O que você precisa antes de começar

O Claude Code é uma ferramenta de linha de comando, então o ponto de partida é simples

• Um terminal (o do seu sistema já serve)
• Um projeto, mesmo que seja uma pasta em branco
• Um acesso pago: ou uma assinatura Pro/Max, ou pagamento por token via API/Console da Anthropic

Não tem versão de graça pra rodar de verdade, então esse acesso pago é pré-requisito, não detalhe

Se você ainda tá na dúvida entre ele e outras opções pra tocar o projeto, já rolou um papo por aqui sobre qual ferramenta escolher pro seu projeto

Um aviso que evita dor de cabeça: o Node.js 22+ só é exigido se você for instalar pela rota do npm

A instalação nativa (que é a recomendada hoje) não pede Node

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

O fluxo completo, passo a passo

Aqui é o coração do post

Cada passo tem o comando/ação e o erro comum que a galera tropeça

1. Instalar a ferramenta

Durante boa parte de 2025 ela rodava como pacote npm sobre o Node

Agora é distribuída como binário nativo, e a Anthropic recomenda a instalação nativa

O npm continua suportado e instala o MESMO binário, então se você prefere o caminho que já conhece:

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

O -g deixa o comando claude disponível em qualquer terminal, e o pacote vem sob o escopo oficial @anthropic-ai

Erro comum: tentar a rota npm sem o Node 22+ instalado e quebrar na cara

2. Rodar o /init pra gerar o CLAUDE.md

Dentro do projeto, o primeiro comando de verdade:

   /init

Isso cria o arquivo CLAUDE.md, que é lido no começo de CADA sessão

Pensa nele como o briefing do projeto: o que é a stack, a estrutura, e o como (comandos de build, teste, lint, deploy)

Erro comum: pular o /init e depois reclamar que ele "não entende" o projeto

Ele entende o que você conta, e o CLAUDE.md é onde você conta

3. Planejar antes com o Plan Mode

Antes de deixar ele tocar em arquivo, ative o Plan Mode:

   Shift+Tab   (ou o comando /plan)

É um estado somente leitura: ele analisa o código e te devolve um plano de implementação, sem mudar nada ainda

Esse comportamento de planejar antes de executar eu já destrinchei em como planejar antes de executar mudanças no código

Erro comum: mandar uma tarefa grande direto no modo de execução e ele sair mexendo em dez arquivos antes de você concordar com o caminho

4. Executar no ciclo agêntico

Aprovado o plano, é aqui que a mágica acontece

O Claude Code trabalha em ciclo: reúne o contexto, executa a ação e verifica o resultado

E as ações são amplas: operações de arquivo, busca, execução de shell (git incluído) e web

É essa a diferença pra um chat comum: ele não só sugere, ele FAZ e confere

Erro comum: achar que é um autocomplete

Ele é mais um dev que senta na cadeira e mexe no teclado, então descreva a tarefa como você descreveria pra uma pessoa

5. Versionar com git, commit e PR

Como o shell tem git, o versionamento entra no fluxo natural

Ele roda os comandos git direto no terminal, e existe um fluxo por slash command que faz o pacote inteiro num passo:

– cria a branch se precisar – faz o commit – dá push pro remoto – abre um pull request com resumo e plano de teste

Erro comum: deixar tudo no working tree sem versionar e perder a régua do que mudou

Quando o próprio agente commita com resumo, você tem rastro do que foi feito

6. Deploy

O deploy em si depende da tua hospedagem e da tua stack, isso não tem fórmula única

O que a ferramenta faz é rodar os comandos de deploy no shell, como qualquer comando de terminal

Erro comum: esperar um botão mágico de deploy

Não existe: você define o comando (ele costuma estar no CLAUDE.md) e o agente executa

Na prática: do plano no NotebookLM ao app pronto

Aqui eu paro a teoria e mostro um projeto de ponta a ponta, porque foi assim que rodei de verdade

No vídeo abaixo eu monto um SaaS gerador de currículos com IA usando um workflow que junta o NotebookLM com o Claude Code

A ideia é essa: o NotebookLM vira um especialista no produto e gera o plano, e ele constrói o app a partir dele

Comecei alimentando o NotebookLM com fontes: artigos, docs, sites de concorrentes, pesquisa própria, vídeos do YouTube, PDFs

Recomendo usar a busca web com deep research pra trazer fontes melhores, o resultado fica bem melhor do que com a pesquisa rápida

Revisei as fontes na mão, entrando em cada uma pra descartar as ruins, porque fonte ruim piora a resposta, simples assim

Depois vem a parte que muda o jogo: eu faço perguntas ao NotebookLM pensando como product manager, pra definir as funcionalidades essenciais do MVP que diferenciam dos concorrentes

Salvei a resposta do MVP nas observações do NotebookLM (dá pra virar fonte também)

Por que esse rodeio todo? Porque pedir direto pra IA gera projetos MUITO parecidos entre si, o tal do AI slop

Passando pela pesquisa antes, o produto ganha um diferencial de verdade

Na hora de gerar o material pro agente, eu prefiro pedir um PRD em vez de um prompt gigante

Um prompt enorme faz ele se enrolar

O PRD eu salvo num arquivo e mando ele se referenciar ali

Quando o primeiro prompt saiu curto demais, mudei nas configurações do NotebookLM pra resposta mais longa e pedi de novo

O PRD já vem formatado em Markdown, então copiei, criei um prd.md no projeto e tirei a primeira linha de introdução da resposta

Aí iniciei o Claude Code numa pasta em branco e pedi pra construir o MVP baseado no prd.md e num prompt inicial

Confesso: iniciei no modo dangerous (pulando permissões) pra não ter que aprovar cada ação

É prático, mas é você por sua conta e risco, então cuidado 😅

No prompt eu defini a stack, as telas seguindo a jornada do usuário, o esquema do banco, a lógica da IA (o usuário cola a vaga e a IA adapta o currículo), dois templates e exportação em PDF

Pra ligar o banco ao projeto, conectei via MCP, que foi o jeito mais simples que achei

E o fluxo é iterativo: depois da V1 eu volto ao NotebookLM, faço novas perguntas, recebo novos prompts e vou melhorando o produto

É o NotebookLM definindo o produto e gerando o plano, e ele construindo, pra depois iterar

O que você paga por esse fluxo: qual plano faz sentido

Agora a pergunta que trouxe você até aqui: quanto custa tocar esse fluxo?

O Claude Code entra junto com a assinatura do Claude, e você tem três degraus principais:

Tem ainda uma quarta via: usá-lo pagando por token via API/Console da Anthropic, sem assinatura fixa

Boa pra uso pontual ou pra quem quer amarrar o gasto ao consumo real

Agora, o detalhe que quase ninguém explica: como o consumo é medido

É um sistema de dois níveis

Uma janela móvel de 5 horas pro uso de curto prazo, mais um teto semanal

E tem um ponto que pega muita gente de surpresa: o saldo é COMPARTILHADO entre o Claude Code e o Claude.ai

Ou seja, gastar conversando no chat consome o mesmo bolo que você usaria programando no terminal

Então o veredito honesto:

• Tá começando o fluxo, testando o passo a passo, projeto pequeno? O Pro por US$ 20/mês dá conta de sobra pra você sentir o valor
• Usa todo dia, roda tarefas longas, esbarra no teto no meio do trabalho? Aí o Max 5x (US$ 100/mês) ou o Max 20x (US$ 200/mês) deixam de ser luxo e viram ferramenta de produção
• Uso irregular ou de projeto pontual? A API por token pode sair mais justa que assinar um mês inteiro

A régua é o quanto você esbarra no limite

Se a janela de 5 horas te trava no meio da tarefa toda hora, o degrau de cima se paga

Conclusão

Agora você não tá pagando às cegas: sabe o que o plano entrega em trabalho real

Instalar, rodar /init pra ter o CLAUDE.md, planejar no Plan Mode, executar no ciclo agêntico e versionar com commit e PR: esse é o fluxo do primeiro projeto ao deploy

O custo você já viu, degrau por degrau

O próximo passo é o mais barato de todos: instala, roda o /init e testa o Plan Mode num projeto pequeno antes de subir de plano

Sente o valor primeiro, decide o degrau depois 😉

Até o próximo post!