Descrição: Entenda o e-mail do Claude Console sobre cache, o que significa a promessa de economia, quando Claude Code fica de fora e como medir a diferença na fatura.
1. Até a IA resolveu te dar uma nota?
O e-mail chega com uma frase nada simpática: “Your prompt cache hit rate is low”. Logo depois, aparece a promessa de uma possível economia de até 45% nos gastos diretos com a API. Parece que o robô está corrigindo sua prova de como fazer perguntas.
Mas a história é outra. O aviso trata do custo de processar repetidamente as mesmas instruções. Não é erro, cobrança extra nem desconto automático. [1]
2. Treinar o mesmo funcionário todo santo dia
Imagine um aplicativo que envia um manual longo antes de cada pergunta ao Claude. Numa chamada, ele resume uma planilha; na seguinte, classifica e-mails. A tarefa muda, o manual continua idêntico.
Sem cache, esse material é cobrado como entrada comum a cada chamada. Quando há acerto de cache, a API reutiliza por um período o prefixo já processado. É como descobrir que o funcionário contratado ontem não precisa refazer a integração toda manhã.
Há um detalhe importante: a parte estável deve vir antes dos dados variáveis. Se você coloca a data, um identificador aleatório ou o pedido específico no começo, pode atrapalhar a reutilização. [1]
3. O tal 45% não é cupom de promoção
A porcentagem do e-mail é uma estimativa de economia possível sobre o tráfego direto da API. Se uma conta mensal de US$ 100 realmente caísse 45%, passaria a US$ 55. É só um exemplo matemático.
Nos preços oficiais consultados em 13 de novembro de 2026, gravar um cache de cinco minutos custa 1,25 vez o preço da entrada normal; gravar um cache de uma hora custa o dobro. Ler do cache geralmente custa 0,1 vez a entrada normal, podendo ser menos em alguns modelos. O texto gerado na saída continua sendo cobrado separadamente. [2]
O benefício aparece quando você reutiliza o mesmo conteúdo. Criar cache e nunca voltar a usá-lo é comprar plano anual da academia para malhar uma única vez.
4. Quem usa apenas Claude Code precisa fazer algo?
O próprio e-mail informa que Claude Code administra o cache automaticamente e fica fora dessa estimativa. Portanto, usar apenas Claude Code normalmente não exige uma corrida para configurar cache manual.
A análise faz sentido para sistemas que chamam a Claude API diretamente: aplicativos próprios, scripts, ferramentas internas e automações. Assinatura de chat e cobrança de API são categorias diferentes.
5. Como conferir se o dinheiro diminuiu
Primeiro, veja se existe cobrança direta de API. Depois, identifique textos longos e repetidos e organize-os antes das informações que mudam. A opção automática pode ser ativada com "cache_control": {"type": "ephemeral"} no nível principal da requisição. Se a ponta final muda sempre, um ponto explícito ao fim do conteúdo estável pode funcionar melhor. [1]
Acompanhe cache_read_input_tokens, que indica leituras reaproveitadas; cache_creation_input_tokens, que mostra gravações; e input_tokens, que contabiliza as demais entradas. Confira também a fatura total. O cache padrão dura cinco minutos; existe uma opção de uma hora com gravação mais cara. [1][2]
6. Resumindo
O Claude não está dizendo que você tem memória ruim. Está sugerindo que o sistema pare de pagar para reler a mesma apostila. O número mais interessante não é o 45% do assunto do e-mail: é quanto você realmente deixou de pagar depois de medir.
- Conferido em 13/11/2026. A economia de 45% é estimada, não garantida.
- Anthropic: Prompt caching platform.claude.com
- Anthropic: Preços platform.claude.com
