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 sobra tempo.

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

⭐️ Aqui estão 12 dicas certeiras para o Claude Code. ⭐️

Todos os comandos e prompts estão incluídos para você copiar e colar 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 quão profundamente 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 configuram como Max ou XHigh incondicionalmente, assumindo que quanto maior, melhor.

Mas isso nem sempre é verdade.

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

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

Aqui está o que resumi da 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 até melhor.

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

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

Desde 7 de out.. 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 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 encher 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 requisiçã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 drasticamente de uma vez.

Casos comuns em que o cache quebra:

1. Retomar uma sessão gigante 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 cada vez que eu cometia um erro.

A maioria foi escrita para modelos mais antigos.

Novos modelos seguem instruções muito melhor que os antigos.

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

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. Preso no mesmo 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..

--> Peça para 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 (Codex também serve) e cole isto:

1"<Session ID>" → Encontre pontos onde esta sessão do Claude Code falhou duas vezes ou mais.
2
3Encontre coisas que eu apontei, mas que continuaram sendo feitas errado, e gargalos.
4
5Categorize por que aconteceram (suposições erradas, falta de contexto, estrutura de 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 requisições que falharam antes e veja se agora funciona.

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

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

• Regras gerais do 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 Num Relance com a Statusline

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

• Esta sessão é Opus? Sonnet? Haiku?
• Qual esforço está configurado?
• 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 pastel, 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 postagens 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 apps 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 roda o app do projeto e o manipula para verificar as mudanças.
• /verify: Compila e roda o app para confirmar que a funcionalidade alterada funciona. Não substitui por testes/checagens de tipo.
• /run-skill-generator: Salva como executar este projeto (comandos, variáveis de ambiente, passos de preparação) como uma skill. 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 a funcionalidade, 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 é igual.

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

⭐️ Então, use um revisor com 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 apenas relata; adicione --fix para corrigir automaticamente.)

• /security-review: Verifica problemas de segurança (auth, 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 achar 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 toda vez.

⚠️ 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 código.

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 "plan mode on", 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 de editar um arquivo/executar um 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 config 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

O atalho -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/excluir o trabalho restante ao encerrar a sessão.

Cuidados:

1. O Worktree isola apenas arquivos/branches. Bancos de dados locais/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 separadamente. Paralelo ≠ 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 (ex.: "mostre o comando de teste/resultados"). O modelo juiz precisa de provas.

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

--> 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 (ex.: /loop 5m check deploy).

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

Combine para 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é atingir os critérios com /goal (Dica #12)

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

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

Resumo

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

2. Não encha 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 por ler!

Postagens únicas 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 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