12 Dicas Essenciais do Claude Code para Máxima Eficiência (Out 2026)

O mesmo Claude Code gera resultados completamente diferentes dependendo de quem o usa.

Algumas pessoas esgotam rapidamente o limite de 5 horas, enquanto outras acham que é mais do que suficiente.

--> A diferença está nas configurações e nos hábitos.

⭐️ Aqui estão 12 dicas essenciais para usar o Claude Code corretamente. ⭐️

Todos os comandos e prompts estão incluídos para que você possa copiá-los e colá-los diretamente.

--> É um pouco longo para ler tudo de uma vez... Que tal salvar nos favoritos primeiro???

⚠️ Antes de começar.. Verifique sua versão ⚠️

A maioria dos recursos mencionados neste artigo foi lançada nos últimos meses. Se a sua versão for antiga, os comandos não vão funcionar.

Verifique com claude --version no terminal e, se estiver desatualizada, basta rodar claude update.

Os comandos deste artigo são baseados na v2.1.302, de 18 de outubro.

1. Defina Esforços Diferentes para Cada Subagente

O esforço (effort) determina o quanto o Claude pensa antes de responder. As opções incluem low, medium, high, xhigh e max, embora os níveis disponíveis variem um pouco conforme o modelo.

Muitas pessoas definem como Max ou XHigh incondicionalmente, assumindo que quanto maior, melhor.

Mas isso nem sempre é verdade.

Ao construir o mesmo aplicativo para comparação, o nível Max levou 79 minutos, enquanto outros níveis levaram 16 minutos.

Os resultados foram praticamente idênticos. Você só está gastando mais tempo e tokens.

Aqui está o que resumi com base na minha experiência:

--> (Essencial) 🔥 Se você consegue escrever prompts detalhados, o resultado final costuma ser parecido, seja usando low ou max. 🔥

--> Para brainstorming, low ou medium funcionaram melhor, na verdade.

No entanto, designs difíceis, bugs complicados e revisões importantes às vezes exigem um esforço maior.

A chave não é "sempre usar low".

Desde 7 de outubro.. Especifique o esforço ao chamar subagentes!

A partir da atualização de 7 de outubro (v2.1.292), o Claude Code principal pode especificar o esforço ao chamar subagentes.

Agora você pode instruir assim:

Divida a tarefa atual em três etapas e prossiga com subagentes.

1. Localização de arquivos e organização de dados com esforço low

2. Revisão dos prós/contras da direção da modificação com esforço medium

3. Revisão do código final em busca de bugs com esforço high

Mostre qual esforço foi realmente atribuído a cada subagente,

e traga apenas as conclusões e os caminhos dos arquivos de evidência de volta para o agente principal.

Se for chato repetir isso toda vez, salve os agentes como arquivos.

--> Por exemplo, salve como light-research.md na pasta .claude/agents/ do projeto.

name: light-research

description: Pesquisa leve apenas para encontrar arquivos relevantes e locais de evidências

model: haiku

effort: low

Ambos os métodos — especificar por chamada (prompt acima) e fixar via arquivo — funcionam!

2. Gerenciamento de Contexto e Prevenção de Desperdício de Tokens

🤪 O motivo pelo qual o Claude Code de repente fica "burro" é, na maioria das vezes, o contexto.

Contexto é o espaço de trabalho que o Claude consegue lembrar de uma só vez. Conversas, arquivos lidos e resultados de comandos se acumulam aqui.

--> Hoje em dia, o Claude Code tem 1M (1 milhão de tokens) de contexto como 'padrão'.

O problema é preencher esse 1M completamente.

Isso não acontece só com o Claude; é uma limitação comum de todos os LLMs, como o Codex.

⭐️ Dica: Configure o autocompact para 500~700k ⭐️

Por isso, eu antecipo o limite de compactação automática.

/autocompact 600k

Isso reduz o tamanho da janela usada para a compactação automática para 600 mil tokens.

Antes de preencher 1M, o Claude resume as conversas e libera espaço automaticamente.

(Para voltar ao padrão, digite `/autocompact auto`.)

⚠️ Segunda coisa para ficar de olho: Expiração do cache ⚠️

Se você usa uma sessão por muito tempo, definitivamente verifique isso.

O Claude Code reenvia toda a conversa anterior a cada solicitação. É rápido e barato por causa do cache — as partes já processadas não são recalculadas.

Mas esse cache não é permanente.

• Assinatura Pro ou Max (dentro do uso do plano): Cache da conversa principal de 1 hora
• Chave de API ou créditos de uso adicionais: 5 minutos
• Subagentes: 5 minutos, mesmo com assinatura

Uma vez vi ~852k sem cache na minha tela. Nesse estado, enviar apenas uma linha "continue" exige reprocessar ~850k tokens sem cache. O uso pode cair significativamente de uma vez.

Casos comuns em que o cache quebra:

1. Retomar uma sessão enorme após uma longa pausa
2. Trocar de modelo no meio da sessão (o cache é separado por modelo)
3. Alterar as configurações das ferramentas MCP conectadas

As contramedidas são simples:

• Faça uma limpeza antes de sair. Use `/compact` enquanto o cache estiver ativo, ou comece do zero com `/clear`.
• Atualize para a versão mais recente. A partir da v2.1.299, conversas com mais de 200k tokens são comprimidas automaticamente após ~54 minutos ociosas, antes que o cache de 1 hora expire. Você pode desativar isso em /config, na opção Idle compaction.)

**

3. Limpe Diretrizes Antigas com /doctor prompt-audit

CLAUDE.md copiado de conselhos antigos. Regras adicionadas uma a uma toda vez que eu cometia um erro.

A maioria foi escrita para modelos mais antigos.

Modelos novos seguem instruções muito melhor do que os antigos.

⚠️ Então, regras que precisavam de ênfase como "Obrigatório!!" "Nunca!!" no passado podem agora estar ativas demais. ⚠️

Regras que entram em conflito com o código atual ou entre si também se acumularam.

Agora você pode verificar tudo com um único comando.

1/doctor prompt-audit

Recurso adicionado na atualização do final de setembro (v2.1.283).

O que ele verifica?

1. CLAUDE.md e CLAUDE.local.md, AGENTS.md nas pastas do projeto e nas pastas pai
2. ~/.claude/CLAUDE.md (minhas diretrizes pessoais aplicadas a todos os projetos)
3. Regras, skills, comandos personalizados, definições de subagentes e estilos de saída dentro de .claude/

Ele relata problemas, mas não sugere correções para skills de plugins e agentes.

Os critérios são baseados no modelo que você está usando no momento. Ele encontra padrões de prompt desatualizados para aquele modelo e cria um relatório com sugestões de correção.

(Ele não lê arquivos que possam conter chaves, como arquivos de configuração ou .mcp.json.)

4. Corrija o Ambiente de Trabalho Quando o Claude Repetir Erros

⛏️ Quando a IA está errando tudo de novo. Lutando com um único problema por horas. ⛏️

Se você está corrigindo a mesma coisa pela terceira vez, a culpa não é do modelo. É do ambiente de trabalho.

Uso esse método desde o Claude Sonnet 3.7, há mais de um ano. Explicando de forma resumida..

--> Faça a IA analisar a sessão em que ela falhou e, em seguida, reflita as causas nas diretrizes do projeto e nos métodos de verificação.

⭐️ Faça assim! "Analise erros usando o Session ID" ⭐️

1. Digite `/status` na sessão onde os erros se repetiram para obter o Session ID. Copie-o.

2. Abra uma nova sessão do Claude Code (o Codex também serve) e cole isto:

1"<Session ID>" → Encontre pontos em que esta sessão do Claude Code falhou duas vezes ou mais.
2
3Encontre coisas que eu apontei, mas que continuaram sendo feitas de forma errada, e gargalos.
4
5Categorize por que aconteceram (suposições incorretas, falta de contexto, estrutura do código, falta de testes)
6
7e proponha a menor correção possível apenas para CLAUDE.md, .claude/rules, skills,
8hooks ou testes para evitar reincidência.

3. Revise as sugestões e aplique apenas as boas.

4. Verifique a eficácia. Tente novamente as solicitações que falharam antes e veja se agora funciona.

⚠️ Não amontoe tudo no CLAUDE.md. ⚠️

Quanto maior ele fica, mais contexto consome e mais as regras entram em conflito!!!

• Regras de todo o projeto no CLAUDE.md
• Regras para pastas/arquivos específicos em .claude/rules/ ou no CLAUDE.md dentro daquela pasta
• Procedimentos repetitivos como Skills
• Regras absolutas via Hooks e permissões (Dica #10)
• Mesmo bug recorrente via testes de regressão

De vez em quando, limpe as regras acumuladas com a Dica #3 `/doctor prompt-audit`. A Dica #4 constrói, a Dica #3 limpa.

**

5. Mantenha a Memória de Trabalho Entre Sessões com o Claude-Mem

O Claude Code esquece as conversas quando uma sessão termina.

**"Por que fizemos aquilo da última vez?"

"Como corrigimos aquele erro?"**

Você precisa explicar tudo de novo em cada nova sessão.

O único plugin do Claude Code que usei consistentemente por um ano resolve isso.

--> claude-mem.

⭐️ Ele tem mais de 100 mil estrelas no GitHub. ⭐️

Qual a diferença para a memória básica?

O Claude Code tem uma Auto Memory básica. Aqui está a diferença:

A Auto Memory básica resume em notas o conteúdo que o Claude considera importante e os aprendizados do projeto. Pode ser visualizada via /memory, sem necessidade de instalação.

O claude-mem registra automaticamente quais tarefas foram feitas nas sessões anteriores, como os erros foram resolvidos e por que as decisões foram tomadas. Ele recupera os registros necessários na próxima sessão.

Na minha tela, apareceu uma economia de até 87% de tokens.

A instalação é uma linha no terminal:

1npx claude-mem install

Ou instale como um plugin dentro do Claude Code:

1/plugin marketplace add thedotmack/claude-mem
2/plugin install claude-mem

❌ Não recomendado se ❌

1. Você usa principalmente o Codex
2. Você já tem outro plugin de memória ou sistema personalizado de passagem de contexto

Adicionar ferramentas sobrepostas aumenta a complexidade e o custo.

Se você usa apenas o Claude Code, ainda é altamente recomendado.

6. Veja Modelo, Esforço, Contexto e Uso de Relance com a Statusline

Enquanto usa o Claude Code, você fica constantemente se perguntando:

• Esta sessão é Opus? Sonnet? Haiku?
• Qual esforço está definido?
• Quão cheio está o contexto?
• Quanto resta dos limites de 5 horas e semanal?

🔥 A Statusline mantém isso visível na parte inferior do terminal. 🔥

Criá-la é fácil. Descreva o formato desejado após `/statusline`, e o Claude gera e aplica o script.

Meus 5 designs compartilhados

Eu compartilhei anteriormente 5 prompts de statusline prontos para copiar e colar.

1. Minimal: Modelo, esforço, projeto e contexto em uma única linha

2. Pastel Blocks: Blocos de destaque em tons pastéis, ideais para terminais escuros

3. Nord Powerline: Limites suaves em formato de seta entre os segmentos

4. Limit Dot Bar: Para Pro/Max. Uso de 5 horas e 7 dias, tempo para reset em barras de pontos

5. Vivid Gauge: Badge verde-limão e medidor diagonal. Inclui contagem de tokens de contexto

Os prompts completos estão nas publicações originais. Copie, cole e o Claude constrói imediatamente.

1. Minimal: https://x.com/lucian__03/status/2103173295118098750

2. Pastel Blocks: https://x.com/lucian__03/status/2103173396075065594

3. Nord Powerline: https://x.com/lucian__03/status/2103173518573916178

4. Limit Dot Bar: https://x.com/lucian__03/status/2103173612832444536

5. Vivid Gauge: https://x.com/lucian__03/status/2103173754218258607

7. Faça o Claude Executar e Verificar Resultados Diretamente

O Claude diz "Implementação concluída!", mas ao rodar, dá erro. Botões não clicam, telas quebram ou nada aparece.

Testes passam, mas aplicativos falham com mais frequência do que se imagina.

Então, faça o próprio Claude iniciar e interagir com o app. Existem comandos para isso:

• /run: Realmente executa o app do projeto e interage com ele para verificar as mudanças.
• /verify: Compila e executa o app para confirmar que a funcionalidade alterada funciona. Não substitui por testes/checagens de tipo.
• /run-skill-generator: Salva como uma skill a forma de rodar este projeto (comandos, variáveis de ambiente, passos de preparação). Faça isso primeiro em projetos complexos.
• /verify salva o método verificado como uma skill do projeto (.claude/skills/verify/) para reutilização.

Fluxo de uso:

1. Implemente o recurso, verifique testes/build primeiro

2. Rode o app com /run

3. Clique/digite para web, entrada/saída de exemplo para CLI

4. Reconfirme se o objetivo foi atingido com /verify

5. Corrija e rode novamente se falhar. Mantenha os resultados reais dos comandos/capturas de tela como evidência

8. Separe a IA que Programa da IA que Revisa

Você não vê erros de digitação no seu próprio texto. Com a IA é a mesma coisa.

A sessão de programação é enviesada para "isso está correto".

⭐️ Então, use um revisor com um contexto fresco. ⭐️

• /code-review: Encontra bugs/problemas de precisão no código alterado, PRs, branches, caminhos.
• Defina a intensidade como /code-review high (de low a max).

(Padrão gera apenas relatórios; adicione --fix para corrigir automaticamente.)

• /security-review: Verifica problemas de segurança (autenticação, validação de entrada, exposição de informações) no diff entre a branch e o padrão remoto.
• /simplify: Limpa duplicatas/ineficiências/complexidade. Não serve para encontrar bugs (/code-review cuida disso).

Ordem recomendada:

1. Limpe o código com /simplify

2. Verifique a funcionalidade com /verify (Dica #7)

3. Encontre bugs com /code-review

4. Adicione /security-review se mexer com login/pagamento/chaves de API/dados pessoais

Não é necessário rodar os 4 todas as vezes.

⚠️ Pequenas correções podem precisar apenas do /code-review. ⚠️

Para uma revisão mais profunda, use /code-review ultra (o mesmo que /ultrareview).

(Revisão profunda baseada na nuvem; planos Pro/Max ganham 3 tentativas gratuitas.)

9. Defina Critérios de Design e Conclusão Antes de Programações Complexas

Para tarefas complexas, dê ao Claude o escopo e os critérios de conclusão primeiro, não longas instruções de programação.

Sem isso, o Claude expande o escopo arbitrariamente.

⚠️ Ele modifica arquivos desnecessários e faz trabalhos não solicitados. ⚠️

Usando o Plan Mode:

Pressione Shift+Tab para mostrar que o plan mode está ativado, ou digite /plan. Você pode anexar a tarefa, como /plan fix login bug.

(O Plan Mode apenas lê arquivos e planeja. O código muda após a aprovação.)

Fluxo: Explorar → Planejar → Aprovar → Implementar → Verificar.

Pule o planejamento para correções de digitação/mudanças de uma linha. Regra da documentação oficial: se a mudança puder ser descrita em uma frase, pule o plano.

10. Aplique Regras Críticas Automaticamente com Hooks

Mesmo que o CLAUDE.md diga "Não toque neste arquivo", o Claude às vezes toca.

🔥 O CLAUDE.md é orientação; os Hooks são imposição. 🔥

Top 3 mais usados:

• PreToolUse: Logo antes da edição de arquivo/execução de comando. Bloqueia edições em arquivos protegidos/comandos perigosos.
• PostToolUse: Logo após a execução. Formata/aplica lint automaticamente nos arquivos editados.
• Stop: Quando o Claude tenta finalizar. Impede a parada se os testes estiverem incompletos.

Exemplo: Bloquear edições na configuração de produção

Peça ao Claude para criar hooks:

--> "Crie um hook PreToolUse bloqueando edições em config/production.env."

Bons casos de uso:

• Rodar o formatador automaticamente ao editar arquivos de código (PostToolUse)
• Exigir confirmação antes de mexer em pastas críticas (PreToolUse)
• Bloquear a parada se os testes não tiverem sido executados (Stop)
• Bloquear comandos perigosos (PreToolUse + Bash)

11. Rode Várias Sessões do Claude Simultaneamente com Git Worktree

O que acontece se duas janelas do Claude trabalharem na mesma pasta?

🚫 Elas entram em conflito ao editar os mesmos arquivos. (Bem doloroso..) 🚫

O Worktree divide o repositório em pastas/branches separadas por tarefa.

O Claude Code faz isso com um comando:

Rode em dois terminais:

• claude --worktree feature-auth
• claude --worktree feature-dashboard

A versão curta -w também funciona.

Cria .claude/worktrees/feature-auth/ e trabalha na branch worktree-feature-auth.

--> ⭐️ Duas sessões não tocam nos arquivos uma da outra. ⭐️

Observações:

Novos worktrees começam a partir do padrão remoto (main), não da branch atual.

Passe o número do PR como claude --worktree "#1234" para começar a partir do PR.

Ele pergunta se deve manter ou excluir o trabalho restante ao encerrar a sessão.

Cuidados:

1. O Worktree isola apenas arquivos/branches. Banco de dados local/portas/alvos de deploy/contas de API compartilhados causam conflitos.
2. Conflitos de merge são possíveis se os mesmos arquivos forem editados.
3. Defina interfaces ou sequencie tarefas fortemente acopladas.
4. Cada sessão consome uso separado. Paralelismo ≠ economia de tokens.

12. Repita a Verificação Até Atingir o Objetivo com /goal

O Claude para depois de uma rodada. Pode dizer "quase tudo corrigido" mesmo com 3 testes falhando.

• O Goal mantém o Claude trabalhando até que os critérios de conclusão sejam atendidos (desde a v2.1.139).
• /goal mostra o objetivo/status atual.
• /goal clear libera o objetivo/para a execução.

Como funciona...

Após cada rodada, um modelo pequeno e rápido avalia se as condições foram atendidas. Se não, o Claude continua para a próxima rodada.

Inclua o método de verificação no objetivo (por exemplo, "mostre o comando de teste/resultados"). O modelo juiz precisa de provas.

Qual a diferença para /loop ou o hook Stop?

--> O Goal inicia a próxima rodada imediatamente após uma falha. Para quando o juiz confirma o sucesso.

O /loop repete a tarefa em intervalos (por exemplo, /loop 5m check deploy).

O hook Stop roda um script personalizado para verificar condições no final da rodada.

Combine para obter os melhores resultados:

1. Defina escopo/critérios com /plan (Dica #9)

2. Divida tarefas com claude -w (Dica #11)

3. Formate/bloqueie via Hooks (Dica #10)

4. Itere até atender aos critérios com /goal (Dica #12)

5. Confirme com /run e /verify (Dica #7)

6. Revise com um contexto fresco via /code-review (Dica #8)

Resumo

1. Varie o esforço por tarefa. Delegue para subagentes.

2. Não preencha o contexto completamente. Fique de olho na expiração do cache.

3. Limpe o CLAUDE.md antigo com /doctor prompt-audit.

4. Corrija o ambiente, não o modelo, para erros repetidos.

5. Memória entre sessões via claude-mem.

6. Monitore modelo/esforço/contexto/limites via statusline.

7. Verifique com /run e /verify, não apenas com declarações de "pronto".

8. Separe as IAs programadora e revisora.

9. Planeje tarefas complexas primeiro.

10. Imponha regras críticas com Hooks.

11. Paralelize com worktree.

12. Persista até o sucesso com /goal.

O Claude Code é atualizado rapidamente. Compartilharei novas dicas conforme surgirem.

Salve nos favoritos se foi útil e compartilhe com amigos que usam o Claude Code.

Obrigado pela leitura!

Publicações anteriores referenciadas:

Esforço de subagentes: https://x.com/lucian__03/status/2108194703782916166

Esforço, Max nem sempre é o melhor: https://x.com/lucian__03/status/2104641991279874134

autocompact 500~700k: https://x.com/lucian__03/status/2108589402914177236

852k sem cache e expiração de cache: https://x.com/lucian__03/status/2106396357527531800

/doctor prompt-audit: https://x.com/lucian__03/status/2104560017407869028

Autoaperfeiçoamento da IA (atualização do Harness): https://x.com/lucian__03/status/2081761475560157477

claude-mem: https://x.com/lucian__03/status/2108997241864159442

5 designs de statusline: https://x.com/lucian__03/status/2103173166973718537