Seu primeiro projeto real com Claude Code no terminal

Dato clave

O primeiro projeto não precisa ser complexo para ser real. Um script de análise de campanha ou um arquivo CLAUDE.md bem feito já entrega valor imediato.

Depois de instalar e configurar, a pergunta que trava todo mundo é: por onde começo? Aqui está um projeto simples, concreto e útil para você fazer no terminal hoje.

Escolha um problema real

Não tente fazer um app completo. Escolha uma tarefa que você faz toda semana e que toma mais de 30 minutos. Pode ser relatório de campanha, resumo de reuniões, análise de planilha. O importante é ser real.

Use o Claude para gerar o script

Abra o terminal no projeto. Descreva o problema em português. Deixe o Claude propor a estrutura. Itere até funcionar para um exemplo.

Documente no CLAUDE.md

Quando funcionar, anote no CLAUDE.md como o agente deve operar nessa pasta. Isso transforma o experimento em ferramenta permanente.

prompt

# Projeto: análise semanal de campanhas

## Objetivo

Gerar um relatório semanal a partir de export CSV do Gerenciador de Anúncios.

## Regras

- Sempre validar colunas obrigatórias antes de processar
- Gerar saída em markdown com 3 seções: campanhas vencedoras, perdedoras, próximos testes
- Salvar sempre em /relatorios/[YYYY-MM-DD].md

## Stack

- Python 3.12
- pandas para processar CSV
- Claude para gerar o texto narrativo final

Pro tips

01
Não use projeto novo para aprender. Pegue um problema que já te incomoda há meses.
02
Documente no CLAUDE.md o que funcionou. Da próxima vez o Claude já entende o padrão.
03
Mostre o resultado pra alguém da sua equipe. Feedback externo é o que valida se o projeto é útil.

Continue lendo

Claude Code

Instalando Claude Code no terminal (Mac, Windows e Linux)

Passo a passo completo de instalação do Claude Code para os três sistemas operacionais, com os erros mais comuns documentados e os primeiros comandos pra rodar.

Claude Code

Como escrever um CLAUDE.md que realmente funciona

O CLAUDE.md é o arquivo que ensina ao Claude quem você é. Feito do jeito certo, você para de repetir contexto toda sessão. Template completo incluído.

Claude Code

Template de equipe de tráfego para Claude Code

6 agentes especializados (analista, gestor, copywriter, social, designer, closer) prontos para ativar com slash commands. Template CLAUDE.md completo.

Perguntas frequentes

Tem que ser um projeto de código pro Claude Code valer?

Não. Pode ser organização de pastas, geração de relatórios em markdown, manipulação de planilhas, automação de email, qualquer coisa que envolva texto, arquivos ou comandos. Código é só uma das formas.

Quanto tempo o primeiro projeto deve levar?

Entre 1 e 4 horas. Se passar disso, o escopo está grande demais pra primeiro projeto. Quebre em pedaços menores e entregue um pedaço primeiro.

Posso pular o CLAUDE.md no primeiro projeto?

Pode, mas vai sentir falta na segunda sessão. Mesmo um arquivo de 15 linhas já economiza tempo. Crie o mínimo viável depois que algo funcionou.

O que faço se travar no meio?

Volta um passo. Descreve pro Claude o que tentou, o que deu errado e o que você esperava. Geralmente o problema é falta de contexto, não falta de capacidade. Adicione a informação no CLAUDE.md e tenta de novo.

Vale a pena gravar a sessão pra revisar depois?

Sim. Ferramentas como asciinema (Mac/Linux) ou OBS (todos) gravam o terminal. Revisar a sessão é a forma mais rápida de identificar onde você poderia ter sido mais claro no prompt.

Quer implementar isso?

Me chama no WhatsApp. Ajudo você a configurar ou implemento pra você.

Quero ajuda no WhatsApp

Gastão Matos

@gastaomatos