Do criador do Kumamap (389 mil usuários)

Domine o Claude Code em Dias, Nao Meses

Os workflows, atalhos e configuracoes que separam iniciantes de usuarios avancados.

Comecar a Ler

Por que confiar neste guia?

Danyel Koca
"Descobri o que realmente funciona com Claude Code através de centenas de horas de tentativa e erro. Este guia é tudo o que aprendi."

Danyel Koca

Engenheiro de Pesquisa Aplicada na Sakana AI

Anteriormente Cientista de Dados Sênior na McKinsey & Company

Parece familiar?

Essas frustrações me levaram a escrever este guia

Claude ignora CLAUDE.md

Suas instruções personalizadas são ignoradas ou esquecidas no meio da conversa

Super-engenheira tudo

Você pede uma função simples, recebe 500 linhas de abstração

Resultados diferentes toda vez

O mesmo prompt, qualidade de saída muito diferente

Diz pronto mas está quebrado

Entrega código com confiança que na verdade não funciona

A Experiência Por Trás Deste Guia

Eu não apenas li sobre esses problemas, eu os vivi.

Terminal
$ ccusage --total
Total Tokens: 2.772.274.103
Total Cost: US$ 2.288,41
Period: 28 Nov 2025 - 5 Jan 2026

2,7 bilhões de tokens de lições conquistadas, condensadas em 51 dicas práticas.

Prova de que Funciona

Construí o Kumamap — o rastreador de ursos #1 do Japão — inteiramente com Claude Code. Este guia ensina os padrões exatos que usei.

389.000
usuários
1,3 milhão
visualizações
3 meses
para construir
Ver o produto ao vivo →
Kumamap

O Que Esta Incluido

51 dicas em 13 secoes

Configuracao

Terminal, CLAUDE.md, atalhos e comandos

3 dicas
1

Use o Terminal

Usar Claude Code no terminal é a forma mais flexível de interagir com ele.

2

Crie o CLAUDE.md

O manual de instruções do seu projeto para o Claude. O arquivo mais importante para uso eficaz do Claude Code.

3

Atalhos e Comandos

Atalhos de teclado e comandos essenciais para uso eficiente do Claude Code.

Seguranca

Git, permissoes, protecao de arquivos sensiveis

4 dicas
4

Use Git Extensivamente

Git é sua rede de segurança quando Claude faz mudanças amplas. Faça commits frequentes, revise diffs e conheça seus comandos de recuperação.

5

Proteja Arquivos Sensíveis

Claude Code lê automaticamente arquivos .env sem perguntar. Adicione regras deny para proteger segredos.

6

Nunca Auto-Aprove Comandos Bash

Auto-aprovar comandos bash é a coisa mais perigosa que você pode fazer com Claude Code.

7

Auto-Aprove Ações Seguras

Acelere seu fluxo de trabalho auto-aprovando ações de baixo risco como leituras e buscas.

Planejamento

Modo plano, planos detalhados, pensamento de ponta a ponta

4 dicas
8

Sempre Use o Modo Plano

Pressione Shift+Tab duas vezes para entrar no modo plano antes de tarefas complexas. Claude pensa antes de codificar.

9

Nunca Aceite Planos Genéricos

Sempre certifique-se de que o plano seja detalhado em nível de código e factual.

10

Valide Contra o CLAUDE.md

Peça ao Claude para validar seu plano contra as regras do CLAUDE.md. Claude esquece instruções conforme as conversas crescem.

11

Force o Pensamento de Ponta a Ponta

Faça Claude traçar o caminho completo da ação ao resultado.

Prompting

Ultrathink, ser direto, exagerar importancia

6 dicas
12

Ultrathink Sempre Ativo

Nunca deixe Claude dizer o que vem à mente primeiro. Deixe-o pensar. SEMPRE.

13

Seja Direto

Seja explícito sobre quantidades. Claude tende a escolher o caminho fácil.

14

Diga O Que Fazer, Não O Que NÃO Fazer

Sempre forneça uma alternativa quando disser ao Claude o que não fazer.

15

Exagere a Importância

Claude calibra o esforço com base na importância percebida. Alta importância = trabalho minucioso.

16

Trate Claude como Ferramenta, Não Pessoa

Não se preocupe em ser educado. Claude se comporta melhor quando você é direto.

17

Claude Excele em Tarefas de Assistente - Guie-o em Trabalhos Estratégicos

Converta tarefas estratégicas em trabalhos tipo assistente guiando Claude a pesquisar primeiro.

Sessao

Gerenciamento de contexto, retomar, degradacao de qualidade

4 dicas
18

Uma Tarefa = Uma Sessão

Quando a tarefa terminar, feche-a. Use /clear para limpar o contexto e começar de novo.

19

Qualidade Degrada em Sessões Longas

A janela de contexto enche. Claude fica mais lento. Saiba quando compactar ou limpar.

20

Use /resume para Continuar Sessões

Claude travou? Terminal fechou? Use /resume para retomar de onde parou.

21

Nunca Confie em 'Tudo Pronto'

Claude frequentemente perde casos limite ou pula passos silenciosamente. Sempre verifique.

Entrada

Imagens, capturas de tela, mensagens de erro

2 dicas
22

Use Imagens/Capturas de Tela

Cole capturas diretamente com Ctrl+V para bugs visuais. Uma imagem vale mil tokens.

23

Copie Mensagens de Erro Literalmente

Não parafraseie. Stack trace completo com números de linha.

Multi-Agente

Agentes paralelos, worktrees, subagentes

5 dicas
24

Não Espere Perfeito na Primeira

Deixe um agente codificar, use outro agente para verificar o código.

25

Múltiplos Agentes para Trabalhos Grandes

Lance múltiplos agentes com o mesmo prompt. Para tarefas grandes, é raro um agente acertar.

26

Divida Problemas Complexos em Etapas

Melhor ter uma sessão por sub-tarefa do que uma sessão massiva.

27

Git Worktrees

Múltiplos diretórios de trabalho do mesmo repo. Execute Claude em cada um.

28

Subagentes - Use com Cautela

Resumos de subagentes perdem detalhes. Para código crítico, faça o agente principal ler arquivos diretamente.

Personalizacao

Configs hierarquicas, comandos, agentes personalizados

3 dicas
29

CLAUDE.md Hierárquico

CLAUDE.md na raiz do projeto + subdiretórios + global. Claude prioriza o mais específico.

30

Comandos Slash Personalizados

Crie fluxos de trabalho reutilizáveis na pasta .claude/commands/.

31

Agentes Personalizados

Crie agentes especializados com sua própria janela de contexto, prompt de sistema e restrições de ferramentas.

Armadilhas

Comportamentos comuns do Claude para observar

8 dicas
32

Claude Inventa URLs

Alucina URLs que não existem. Sempre verifique antes de confiar em links externos.

33

Claude Sobre-Engenheira

Peça uma função simples, receba uma classe abstrata com padrão factory.

34

Claude Cria Duplicatas

Claude não pesquisa seu código. Ele apenas escreve código novo.

35

Claude é Aditivo, Nunca Subtrativo

Claude só adiciona código. Nunca remove. Você tem que forçar a remoção explicitamente.

36

Claude é um YES MAN

Claude concorda com tudo que você diz. Diga para ele questionar suas suposições.

37

Claude Assume em Vez de Perguntar

Requisito ambíguo? Claude escolhe uma interpretação e segue em frente.

38

Claude Lê Arquivos Parcialmente

Claude lê o primeiro bloco e começa a trabalhar. Função crítica na linha 400? Perdeu.

39

Claude Modifica Testes em Vez de Corrigir Código

Quando o código está errado, Claude muda as asserções do teste para corresponder ao código ruim.

Avancado

Hooks, servidores MCP, skills, modo headless

5 dicas
40

Hooks

Comandos shell que executam em eventos específicos como edições, uso de ferramentas ou início de sessão.

41

Servidores MCP

Conecte ferramentas externas - bancos de dados, automação de navegador, busca de docs.

42

Skills

Comportamentos auto-acionados que carregam automaticamente quando relevantes.

43

GitHub Actions

Execute /install-github-app para configurar Claude para seus repos.

44

Modo Headless

Execute Claude sem sessão interativa. Para automação e scripts.

Casos de Uso

Verificacoes de qualidade, POCs, aprendizado, commits

5 dicas
45

Execute Verificações de Qualidade Periodicamente

Cada consulta = 1 sessão. Verifique textos hardcoded, consistência de design, etc.

46

Aproveite Claude Code para POCs

Perfeito para prototipagem rápida. Para POCs, deixe Claude trabalhar.

47

Claude é Ótimo para Boilerplate

Operações CRUD, formulários, arquivos de config, padrões repetitivos. Deixe Claude cuidar.

48

Use Claude para Aprender

Não apenas deixe Claude escrever código. Faça-o explicar.

49

Claude para Mensagens de Commit

Deixe Claude escrever commits do seu diff. Formato consistente, captura o 'porquê'.

Conclusao

Sabedoria final sobre encontrar seu workflow

1 dicas
50

Não Persiga Cada Nova Funcionalidade

Claude Code tem novas funcionalidades toda semana. Foque no que funciona.

Bonus

CLAUDE.md testado em batalha de 6 meses de uso diario

1 dicas
51

CLAUDE.md Testado em Batalha

Um exemplo real de CLAUDE.md destilado de 6 meses de lições, falhas e correções.

Featured Tips

Start with these popular tips

Crie o CLAUDE.md
#2

Crie o CLAUDE.md

O manual de instruções do seu projeto para o Claude. O arquivo mais importante para uso eficaz do Claude Code.

Ultrathink Sempre Ativo
#12

Ultrathink Sempre Ativo

Nunca deixe Claude dizer o que vem à mente primeiro. Deixe-o pensar. SEMPRE.

Qualidade Degrada em Sessões Longas
#19

Qualidade Degrada em Sessões Longas

A janela de contexto enche. Claude fica mais lento. Saiba quando compactar ou limpar.

Subagentes - Use com Cautela
#28

Subagentes - Use com Cautela

Resumos de subagentes perdem detalhes. Para código crítico, faça o agente principal ler arquivos diretamente.