Guia oficial de economia de Token do Claude Code: 11 dicas para prolongar seu limite

A Anthropic lançou um guia de economia de Token para o Claude Code. O ponto central é: quanto mais longo o contexto, mais caro fica cada rodada subsequente. Conversas, documentos e saídas de comandos continuarão a consumir Tokens, resultando em um esgotamento mais rápido do limite.

Aqui estão 11 dicas mais úteis:

1. Use /clear ao mudar de tarefa. Limpe o contexto após concluir uma tarefa. Se você ainda estiver na mesma tarefa, mas o conteúdo anterior não for mais útil, use /compact para compactar. Conversas longas ficam mais caras à medida que avançam, pois cada rodada traz de volta o conteúdo anterior.

2. Escolha o modelo e o esforço corretamente desde o início. Executar /model ou /effort no meio do caminho apagará o cache de prompt, e a próxima rodada precisará processar todo o contexto novamente. O modo rápido também deve ser ativado desde o começo.

3. Compacte antes de sair. O cache para usuários assinantes expira em cerca de 1 hora, enquanto a chave API expira em cerca de 5 minutos. Se você voltar após a expiração do cache, a próxima rodada geralmente precisará processar todo o contexto novamente. Compactar enquanto o cache ainda está ativo é mais barato.

4. Use /rewind se as últimas rodadas estiverem fora do caminho. Ele apenas apaga as últimas rodadas, permitindo que o cache anterior continue a ser utilizado. /compact reescreve toda a conversa, o que é mais caro.

5. Use @ seguido do nome do arquivo diretamente. O Claude terá acesso ao arquivo na primeira rodada, economizando uma leitura ou busca. Um arquivo geralmente precisa ser mencionado apenas uma vez; mencionar repetidamente pode acabar inserindo o mesmo arquivo novamente no contexto.

6. Seja específico nos prompts. Em vez de dizer "o teste falhou", diga diretamente ao Claude qual teste e qual arquivo. Caso contrário, ele pode acabar grepando, buscando e lendo muitos arquivos, e esses resultados continuarão a ocupar o contexto em cada rodada subsequente.

7. Minimize a saída de testes e logs. Saídas de Build, teste e git log permanecerão no contexto. Você pode adicionar parâmetros quiet, limitar a saída a erros ou usar tail para truncar. O Claude Code automaticamente escreve saídas de comandos que excedem 30 mil caracteres em um arquivo, mantendo apenas o resumo e o caminho na conversa.

8. Use /context para verificar a carga inicial. No início de uma nova conversa, você pode ver quanto do contexto está ocupado por CLAUDE.md, MCP e definições de ferramentas. CLAUDE.md deve conter apenas regras gerais, enquanto processos específicos devem ser carregados sob demanda nas Skills, e MCPs não utilizados devem ser desligados com /mcp.

9. Use modelos menores e menor esforço para tarefas simples. Modelos grandes têm entradas e saídas mais caras, e o pensamento também conta como Token de saída. Para tarefas puramente executivas, não é necessário usar sempre o modelo mais avançado e a maior intensidade de raciocínio.

10. Deixe logs grandes para subagentes e evite abusar de pequenas tarefas. Subagentes têm contexto independente e trazem apenas o resultado final de volta à conversa principal, sendo adequados para ler grandes logs e buscar documentos. No entanto, eles também precisam ler arquivos novamente e executar várias rodadas, tornando pequenas tarefas potencialmente mais caras. Tarefas como busca e leitura de logs podem ser designadas para Haiku ou Sonnet.

11. É melhor abrir uma sessão separada para /loop. Cada ciclo é uma rodada completa e repetirá todo o contexto atual da conversa. Se o intervalo exceder o tempo de cache, pode haver uma sobreposição de expiração do cache. A recomendação oficial é abrir um terminal separado e usar uma conversa limpa exclusivamente para loops.

A recomendação da Anthropic, em última análise, é: evite inserir conteúdo desnecessário, limpe o contexto ao concluir tarefas e não prolongue as conversas desnecessariamente.

Este conteúdo é fornecido apenas para fins informativos gerais e não constitui aconselhamento financeiro, de investimento, jurídico ou tributário. Quaisquer eventos, recompensas, promoções online ou informações relacionadas mencionadas neste documento não devem ser consideradas uma recomendação, solicitação ou convite para comprar, vender, negociar ou realizar qualquer outra transação com criptoativos. Criptoativos são altamente voláteis e podem resultar em perdas. A disponibilidade dos serviços, produtos e eventos relacionados da WEEX pode variar conforme a região. É de sua responsabilidade garantir que sua participação esteja em conformidade com as leis e regulamentações locais aplicáveis.