⚙️ Hack 1 — /init
O primeiro comando que você deve executar em qualquer projeto é o /init. Ele escaneia toda a estrutura do projeto e gera automaticamente um arquivo CLAUDE.md na raiz — uma memória persistente que o Claude consulta no início de cada sessão, eliminando a necessidade de reexplicar o projeto toda vez.
💡 Como funciona o /init
Ao executar /init, o Claude percorre toda a estrutura do projeto e gera um arquivo CLAUDE.md contendo:
- •Visão geral da arquitetura e dos diretórios principais
- •Tecnologias e frameworks identificados automaticamente
- •Arquivos de configuração importantes (package.json, tsconfig, etc.)
- •Convenções de código e padrões encontrados no projeto
- •Comandos de build, test e deploy disponíveis
💻 Exemplo Prático
# Abra o terminal na raiz do projeto
$ /init
Escaneando estrutura do projeto...
Analisando dependências em package.json...
Identificando padrões de código...
✓ CLAUDE.md criado com sucesso (247 linhas)
# O CLAUDE.md agora documenta todo o projeto
# Sessões futuras começam com contexto completo
⚡ Dica Prática
Após gerar o CLAUDE.md, edite-o manualmente para adicionar regras específicas do projeto: convenções de nomenclatura, decisões arquiteturais importantes, endpoints de API e qualquer contexto que o Claude precisaria saber. O /init cria a base — você refina.
✓ O que FAZER
- ✓Execute /init em todo projeto novo antes de começar a trabalhar
- ✓Edite o CLAUDE.md gerado para adicionar regras específicas
- ✓Mantenha o CLAUDE.md versionado no git junto com o código
- ✓Atualize o CLAUDE.md quando houver mudanças arquiteturais importantes
✗ O que NÃO fazer
- ✗Ignorar o CLAUDE.md gerado e não editar nada nele
- ✗Reexplicar o projeto manualmente toda sessão sem usar /init
- ✗Adicionar o CLAUDE.md ao .gitignore — deve ser versionado
- ✗Esperar problemas aparecerem antes de configurar o projeto
📄 Exemplo de CLAUDE.md gerado
# Projeto: meu-app-saas
## Stack
- Next.js 14 (App Router)
- TypeScript + Tailwind CSS
- Prisma + PostgreSQL
- Auth: NextAuth.js
## Estrutura
- /app: rotas e pages
- /components: componentes reutilizáveis
- /lib: utilitários e helpers
## Comandos
- npm run dev: desenvolvimento
- npm run build: build de produção
- npx prisma migrate dev: migrar DB
📊 Hack 2 — Statusline
O statusline é um mini painel que fica na parte inferior do terminal, exibindo informações críticas da sessão em tempo real. Você configura o que quer ver, o Claude gera o script — e você nunca mais opera no escuro sobre quanto contexto resta na sessão.
💡 O que o Statusline monitora
Ao chamar /statusline, diga ao Claude o que deseja monitorar:
- •Modelo ativo: claude-opus-4, sonnet, haiku — para saber qual modelo está em uso
- •Porcentagem de contexto: 0% a 100% — o indicador mais crítico para evitar degradação
- •Custo da sessão: Valor em USD acumulado — para controle de gastos
- •Tokens usados: Número exato de tokens consumidos na sessão
- •Tempo de sessão: Duração desde o início da conversa atual
📈 Por que o contexto importa
- •0–50%: Desempenho ótimo — o Claude tem todo o espaço para raciocinar
- •50–70%: Zona de atenção — considere compactar em breve
- •70–85%: Degradação visível — respostas começam a perder coerência e detalhes
- •85–100%: Zona crítica — erros, alucinações e perda de contexto anterior frequentes
💻 Configurando o Statusline
# Execute e especifique o que quer ver
$ /statusline
Quero ver: modelo, % de contexto e custo
# Claude gera o script e ativa
✓ Statusline configurado
# Aparece na parte inferior do terminal:
[ claude-sonnet-4 | Contexto: 23% | Custo: $0.042 ]
⚡ Dica Prática
Configure o statusline para mostrar a porcentagem de contexto como prioridade. Quando chegar a 60%, execute /compact imediatamente — antes de perder qualidade. O statusline torna esse monitoramento passivo e automático.
✓ O que FAZER
- ✓Configure sempre que iniciar uma sessão longa
- ✓Inclua % de contexto como métrica obrigatória
- ✓Use o custo para controlar gastos em projetos de equipe
✗ O que NÃO fazer
- ✗Operar sem monitorar o contexto — você não sabe quando vai degradar
- ✗Ignorar o indicador quando passa de 70% — age imediatamente
- ✗Esperar erros aparecerem para perceber que o contexto estourou
🎤 Hack 3 — Entrada por Voz
Digitar prompts complexos é lento. A entrada por voz permite articular contexto rico, descrever problemas e dar instruções longas em fração do tempo — sem sacrificar nenhuma informação. O Claude Code tem suporte nativo via /voice e qualquer app de ditado do sistema operacional funciona perfeitamente no terminal.
💡 Opções de entrada por voz
Três maneiras de usar voz com o Claude Code:
-
1.
/voice nativo: Comando embutido no Claude Code. Execute
/voicee comece a falar diretamente no terminal. -
2.
Ditado do macOS: Fn+Fn (dois taps) ativa o ditado nativo em qualquer campo de texto, incluindo o terminal.
-
3.
Apps de terceiros: Whisper Flow, Superwhisper, ou qualquer app de ditado por voz funciona com o terminal.
🎯 Quando usar voz vs teclado
Use voz para:
Contexto e descrições longas
Explicar o problema, descrever o contexto do negócio, dar instruções complexas em múltiplas etapas, articular o que você quer que o Claude entenda sobre a situação.
Use teclado para:
Comandos precisos e código
Comandos curtos como /init ou /compact, trechos de código que precisam ser exatos, nomes de variáveis e paths de arquivo específicos.
⚡ Dica Prática
Combine voz com o CLAUDE.md. Como o CLAUDE.md já contém o contexto do projeto, você não precisa redigitar nada sobre a arquitetura — use a voz para dar instruções ricas sobre a tarefa específica do momento. Os dois juntos eliminam praticamente toda a fricção de comunicação.
✓ O que FAZER
- ✓Use voz para prompts de contexto rico e descrições de problema
- ✓Teste o /voice nativo antes de instalar apps de terceiros
- ✓Fale naturalmente — o Claude entende linguagem coloquial
✗ O que NÃO fazer
- ✗Ditar nomes de variáveis ou paths de arquivo — typos são difíceis de detectar
- ✗Usar voz em ambiente barulhento sem checar o texto antes de enviar
- ✗Ignorar essa funcionalidade por hábito — o ganho de velocidade é real
🎯 Resumo do Módulo 1.1
Próximo Módulo:
1.2 — Gerenciar Contexto: aprenda a diagnosticar, compactar e reiniciar o contexto no momento certo para manter a qualidade máxima nas sessões longas.