Repolode
karanb192

karanb192/cache-tax

Mod para Claude Code que mantém o cache do prompt aquecido durante pausas e estima o custo de reescrita antes de enviar uma mensagem com o cache frio.

Estrelas
359
Forks
55
Issues abertas
20
Último commit
anteontem

O que é?

Cache Tax é um mod para Claude Code que resolve o custo de retomar uma sessão longa depois que o cache do prompt expira. Antes de fazer uma pausa, o comando /keepwarm ativa uma janela com duração limitada; durante esse período, uma bifurcação da sessão envia um ping pequeno em intervalos para manter o contexto em cache ativo. O ping só é enviado enquanto a janela está ativa e é interrompido se a leitura de confirmação do cache indicar que ele não está mais aquecido.

Ao voltar para uma sessão com o cache frio e um contexto grande, o mod segura uma vez sua primeira mensagem comum e mostra o custo estimado para reescrever o cache. Reenviar a mensagem dá continuidade normalmente, e /clear permite começar de novo a partir de uma anotação. Uma linha de status acima do prompt mostra o estado do aquecimento, o próximo ping e a última leitura de confirmação. As estimativas de preço usam os preços de tabela por modelo, e o mod observa que os planos de assinatura não cobram esses valores como cobranças extras.

Recursos principais

  • 01Mantém o cache do prompt aquecido com pings periódicos durante uma janela definida
  • 02Mostra o custo estimado para reescrever o cache antes de um envio com o cache frio e pode segurar a mensagem uma vez
  • 03Interrompe o aquecimento automaticamente quando a leitura de confirmação do cache indica que ele esfriou
  • 04Fornece o status de /cache-tax e uma linha de status acima do prompt
  • 05Instala como plugin do Claude Code a partir de um marketplace

Casos de uso

  • Fazer uma pausa em uma sessão longa de programação para almoçar ou participar de uma reunião sem pagar pela reescrita de todo o contexto
  • Decidir se vale retomar uma sessão desatualizada ou começar do zero a partir de uma anotação com o resumo
  • Monitorar o estado e o custo do cache durante sessões longas do Claude Code com cobrança por chave de API

Início rápido

  1. 1

    Adicione o marketplace

    claude plugin marketplace add karanb192/claude-code-mods
  2. 2

    Instale o plugin cache-tax

    claude plugin install cache-tax@claude-code-mods
  3. 3

    Reinicie o Claude Code ou recarregue os plugins em uma sessão aberta

    /reload-plugins
  4. 4

    Em uma sessão aquecida, ative o keepwarm por seis horas

    /keepwarm

Antes de usar

  • Requer o Claude Code 2.1.287 ou posterior, e o Claude Code precisa continuar em execução para que os pings aconteçam.
  • Cada ping do keepwarm consome tokens, portanto não é gratuito.
  • Sessões com API-key e provedores de nuvem usam um cache de cinco minutos por padrão; é necessário definir promptCacheTtl como "1h".

Em coleções

Tópicos

#claude-code#prompt-caching#llm-cost#cli-plugin#typescript#claude-code-plugin#claude-mods#function-hooks

Perguntas frequentes

O que é cache-tax?
Mod para Claude Code que mantém o cache do prompt aquecido durante pausas e estima o custo de reescrita antes de enviar uma mensagem com o cache frio. Cache Tax é um mod para Claude Code que resolve o custo de retomar uma sessão longa depois que o cache do prompt expira. Antes de fazer uma pausa, o comando /keepwarm ativa uma janela com duração limitada; durante esse período, uma bifurcação da sessão envia um ping pequeno em intervalos para manter o contexto em cache ativo. O ping só é enviado enquanto a janela está ativa e é interrompido se a leitura de confirmação do cache indicar que ele não está mais aquecido.
cache-tax é gratuito? Qual é a licença?
cache-tax é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
cache-tax ainda é mantido?
Manutenção ativa. O último commit de cache-tax foi em 5 de nov. de 2026.
Para que posso usar cache-tax?
Fazer uma pausa em uma sessão longa de programação para almoçar ou participar de uma reunião sem pagar pela reescrita de todo o contexto Decidir se vale retomar uma sessão desatualizada ou começar do zero a partir de uma anotação com o resumo Monitorar o estado e o custo do cache durante sessões longas do Claude Code com cobrança por chave de API
Como instalar cache-tax?
Adicione o marketplace: claude plugin marketplace add karanb192/claude-code-mods Instale o plugin cache-tax: claude plugin install cache-tax@claude-code-mods Reinicie o Claude Code ou recarregue os plugins em uma sessão aberta: /reload-plugins Em uma sessão aquecida, ative o keepwarm por seis horas: /keepwarm
Onde consigo cache-tax?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/karanb192/cache-tax

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados