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?
| Componente | Quando ocorre | O que significa |
|---|---|---|
| Entrada comum | Há conteúdo novo que não usa cache | Processamento da nova entrada |
| Escrita de cache | O cache é criado, reconstruído após expirar ou ampliado com novo conteúdo | Colocação do contexto no cache temporário |
| Leitura de cache | Conteúdo válido em cache pode ser reutilizado | Reutilização do contexto, normalmente mais barata que gravá-lo novamente |
| Saída | O modelo gera resposta, código ou raciocínio | Geraçã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:
- 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.
- Peça um resumo de transferência à IA: mantenha apenas objetivo, progresso, arquivos importantes e próximos passos, sem copiar toda a conversa.
- Abra uma nova sessão: cole o resumo e acrescente somente os arquivos ou requisitos necessários para a próxima tarefa.
- 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:
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.
Guias relacionados
Onde vejo preços em RMB, saldo e detalhes de uso?
Consulte preços RMB ao vivo, saldo, logs, uso de tokens, detalhes de cobrança e disponibilidade atual de pagamento nas superfícies públicas e do painel.
Instalar o Claude Code, Configurar a API e Resolver Erros no Windows
Instale o Claude Code, configure chave e URL da API, verifique o ambiente e resolva erros de autenticação, limites e conexão no Windows, macOS e Linux.
Perguntas frequentes
Resolva problemas comuns de chave de API, respostas 401 e 429, variáveis do Windows, conexão dos clientes, cotas e contato com suporte.