Cache de prompt do Claude
Esta página explica como ativar o cache de prompt do Claude e confirmar o acerto de cache. IDs de modelo e endereços de endpoint estão na visão geral da família Claude.
ResumoO cache do Claude exige marcar cache_control explicitamente; nenhum dos dois endpoints faz cache automaticamente.
Coloque o conteúdo longo e fixo (prompt de sistema, documentos, definições de ferramentas) no início da requisição e marque cache_control no último bloco de conteúdo fixo. Quando o prefixo das requisições seguintes for exatamente igual, o cache será aproveitado.
Endpoint nativo da Anthropic
claude_cache.py
import os
import anthropic
client = anthropic.Anthropic(base_url="https://api.ofox.ai/anthropic", api_key=os.environ["OFOX_API_KEY"])
LONG_DOC = open("manual.txt", encoding="utf-8").read() # um documento fixo e relativamente longo
for question in ["Do que trata o capítulo 3?", "Resuma os pontos principais do texto."]:
message = client.messages.create(
model="anthropic/claude-sonnet-4.6",
max_tokens=1024,
system=[
{"type": "text", "text": "Responda às perguntas com base no documento abaixo."},
{"type": "text", "text": LONG_DOC, "cache_control": {"type": "ephemeral"}},
],
messages=[{"role": "user", "content": question}],
)
u = message.usage
print("Gravados:", u.cache_creation_input_tokens, "Lidos:", u.cache_read_input_tokens)As informações gerais sobre cache estão em Cache de prompt.
Outros erros estão em Erros comuns.
Última atualização em