Conta e dadosIniciantesAtualizado em

Cobrança de cache do Claude Code e economia: como continuar depois de uma pausa

Se uma conversa antiga ficou muito longa e você vai fazer uma pausa, o cache pode expirar antes do seu retorno. Nesse caso, uma opção geralmente mais econômica é pedir à IA um resumo breve de transferência e iniciar uma nova sessão somente com esse resumo e os arquivos necessários para a próxima tarefa. Se você está trabalhando continuamente na mesma tarefa e o cache continua sendo reutilizado, não é preciso trocar de sessão repetidamente para economizar.

O objetivo não é simplesmente abrir mais ou menos sessões, mas evitar reconstruir repetidamente um contexto antigo muito grande depois que o cache expira.

Por que uma mensagem curta pode gerar uma cobrança alta?

O Claude Code normalmente envia ao modelo mais do que a mensagem que você acabou de digitar. Também pode incluir arquivos do projeto, conversa anterior, resultados de ferramentas e registros de alterações de código. Juntos, esses elementos formam o contexto da requisição.

Tokens são as unidades que o modelo usa para processar texto e código; não equivalem a palavras ou caracteres. A cobrança usa a quantidade real de tokens e os preços unitários atuais em RMB. Consulte preços, saldo e uso para encontrar as páginas correspondentes.

Como são cobrados entrada, cache e saída?

ComponenteQuando ocorreO que significa
Entrada comumHá conteúdo novo que não usa cacheProcessamento da nova entrada
Escrita de cacheO cache é criado, reconstruído após expirar ou ampliado com novo conteúdoColocação do contexto no cache temporário
Leitura de cacheConteúdo válido em cache pode ser reutilizadoReutilização do contexto, normalmente mais barata que gravá-lo novamente
SaídaO modelo gera resposta, código ou raciocínioGeração de novo conteúdo

Uma requisição com leitura e escrita de cache ao mesmo tempo costuma ser uma atualização incremental normal. O modelo lê o contexto antigo e grava a parte acrescentada; isso não significa que toda a conversa antiga foi cobrada de novo. Se a leitura de cache for zero e a escrita for muito grande, normalmente o cache antigo não foi reutilizado, e vale conferir os detalhes de uso.

Por que o cache pode precisar ser recriado depois de uma pausa?

Cache é um espaço temporário para acelerar requisições futuras, não um arquivo permanente. Os tempos de vida comuns são 5 minutos ou 1 hora. Depois da expiração, ou quando o início do contexto muda, a próxima requisição pode não conseguir mais ler o cache. Se a tarefa ainda precisar desse conteúdo, o sistema terá de processá-lo e gravá-lo novamente.

Isso não é uma cobrança automática quando o prazo termina. Só há nova cobrança de escrita quando você faz outra requisição que precisa reconstruir o cache. “Cache de 1 hora” não significa uma hora de uso pré-pago. O preço de escrita pode variar conforme a duração; consulte a página de preços atual. Uma duração maior não garante menor custo total.

Fluxo recomendado: conclua a tarefa e transfira com um resumo

Quando uma conversa estiver grande e você for pausar ou passar à próxima etapa:

  1. Conclua a unidade atual de trabalho: confirme que as alterações de código foram salvas e que os testes ou verificações necessários foram executados.
  2. Peça um resumo de transferência à IA: mantenha apenas objetivo, progresso, arquivos importantes e próximos passos, sem copiar toda a conversa.
  3. Abra uma nova sessão: cole o resumo e acrescente somente os arquivos ou requisitos necessários para a próxima tarefa.
  4. Confira o uso real: compare tokens de escrita de cache e cobranças nos detalhes de uso, em vez de avaliar o custo apenas pelo tamanho da última mensagem.

Você pode enviar este prompt antes de fechar a conversa antiga:

text
Vamos encerrar esta conversa e iniciar uma nova. Crie um resumo de transferência com no máximo 500 palavras, contendo somente:
1. O objetivo da tarefa;
2. O trabalho concluído;
3. Os arquivos alterados e as mudanças principais;
4. As decisões e restrições importantes;
5. Os comandos de verificação executados e seus resultados;
6. Os próximos passos.
Não repita conversas informais nem cole o código completo.

Abrir uma nova sessão não desfaz alterações salvas nos arquivos do projeto, mas também não traz automaticamente a memória da conversa antiga. O resumo precisa conter informação suficiente para continuar.

Um exemplo simples

Suponha que uma conversa antiga tenha 600.000 tokens de contexto. Continuá-la depois da expiração do cache pode exigir a gravação desses 600.000 tokens novamente. Se o resumo de transferência e o contexto necessário tiverem apenas 30.000 tokens, a criação inicial do cache da nova sessão processará somente esses 30.000 tokens.

As duas opções ainda podem gerar cobranças de escrita de cache, entrada comum e saída. A economia vem de não processar novamente um contexto antigo muito grande, e não de tornar a nova sessão gratuita. A quantidade real de tokens depende do cliente, do projeto e da tarefa; confira os detalhes de uso.

Quando vale manter a conversa antiga?

  • Você trabalha continuamente na mesma tarefa e o cache ainda é reutilizado: normalmente é mais barato continuar.
  • Você pensa em abrir uma sessão a cada poucas mensagens: cada uma pode precisar criar novamente o contexto inicial, aumentando o custo.
  • A conversa antiga contém detalhes essenciais que não podem ser resumidos com segurança: confirme que o resumo é suficiente antes de trocar.

Um hábito mais seguro é concluir uma tarefa por vez e trocar de sessão em limites claros de trabalho depois de fazer um resumo, em vez de voltar intermitentemente a uma única conversa muito grande durante um longo período. Para tarefas simples, considere também um modelo mais adequado na página de preços.