Cache Claude Code: migre projetos e meça a economia

Por que isso importa

Quem usa IA para trabalhar com relatórios, planilhas e documentos extensos conhece a interrupção: você precisa conferir o resultado, preparar correções e, quando volta, o limite do plano parece desaparecer depressa. Esse intervalo de revisão faz parte do trabalho. Uma ferramenta útil precisa acomodá-lo.

No vídeo, Macks Wendhell apresenta sua migração dos projetos do Claude no navegador para o Claude Code. O exemplo envolve análise estatística, mas a questão interessa também a quem produz propostas, pesquisa documentação ou transforma dados em entregas recorrentes: como preservar um processo que já funciona e aproveitar melhor o plano?

Minha leitura é que a proposta merece um teste com critérios claros. O número “20x” mistura uma relação de preços de cache com um relato de consumo de sessões. Para decidir se a mudança compensa, eu avaliaria três resultados juntos: consumo, qualidade da entrega e tempo humano de correção. Abaixo, proponho um roteiro para fazer essa comparação sem atribuir ao Luiz uma experiência que ainda precisa ser medida.

Pontos principais

• 01:41 O intervalo entre interações entra na conta. A explicação de cache ajuda a entender por que uma rotina com pausas longas pode ter consumo diferente de uma conversa contínua. A janela precisa combinar com o tempo necessário para revisar o trabalho.
• 05:04 Uma entrega precisa ser reproduzível. Ao guardar scripts e dados de origem, o autor cria condições para conferir o relatório depois. Para trabalhos técnicos, conseguir reconstruir uma tabela é um critério de qualidade tão importante quanto sua apresentação.
• 07:49 As correções acumuladas fazem parte do projeto. Preferências e decisões aprendidas durante o uso podem estar fora das instruções principais. Migrar exige localizar esse conhecimento e verificar o que continua válido.
• 10:05 A migração tem várias dependências. Instruções, referências, memórias e skills precisam ser inventariadas. Uma pasta aparentemente completa pode continuar sem um modelo de tabela ou procedimento necessário para reproduzir a entrega.
• 17:16 O teste começa depois da organização. Criar arquivos e diretórios demonstra que a preparação terminou. Executar uma tarefa conhecida permite verificar se o novo ambiente preservou os critérios de aprovação.
• 21:44 A economia apresentada é um relato do autor. Ele compara duas sessões e meia com menos de 40% de uma sessão. São números relevantes para formular uma hipótese, mas faltam registros comparáveis para atribuir todo o ganho ao cache ou estabelecer um fator universal.

Como aplicar

Cache Claude Code: o que o “20x” realmente mede

É útil distinguir três coisas: duração do cache, tamanho do contexto e limite de uso do plano. O cache expirar não apaga a conversa; significa perder a possibilidade de reaproveitar aquele processamento na próxima requisição. A documentação explica esse mecanismo em como o Claude Code usa cache.

Na consulta de 27/10/2026, a documentação informa uma hora como padrão para a conversa principal com assinatura, dentro da franquia incluída. Com créditos de uso, chave de API ou provedor de nuvem, o padrão é cinco minutos. Portanto, abrir o Claude Code não garante uma hora em qualquer configuração. Regras de duração do cache.

Tomando o Sonnet 4.6 como exemplo da tabela da API, um milhão de tokens custa US$ 6 para gravação de cache de uma hora e US$ 0,30 para leitura: uma relação de 20:1 nessa parcela. Texto novo, respostas e ferramentas entram no custo da tarefa. Essa tabela também não converte diretamente consumo de assinatura em dinheiro. Preços oficiais da API.

Há outra conta: 2,5 dividido por 0,4 resulta em 6,25. Como o autor relata menos de 0,4 sessão, o quociente nominal seria maior. Ainda assim, sessões relatadas não constituem uma medição controlada de custo por tarefa.

1. Escolha uma entrega que você consegue conferir

Eu começaria por um trabalho concluído: um relatório mensal, uma análise de planilha ou uma proposta técnica. Guarde a entrada original, a saída aprovada e os critérios usados na revisão. Para um relatório comercial brasileiro, por exemplo, defina tratamento de datas, vírgula decimal, moeda e regra para valores ausentes.

Escreva cinco verificações objetivas antes da migração: totais corretos, referências identificáveis, formato esperado, arquivos intermediários preservados e ausência de informações inventadas. Isso evita aprovar o novo fluxo apenas porque o texto ficou convincente.

2. Faça um inventário com destino e teste

Use esta estrutura como proposta inicial, adaptando os nomes ao seu trabalho:

| Material | Destino sugerido | Como conferir | | --- | --- | --- | | Regras recorrentes | CLAUDE.md | Pedir ao agente que explique o fluxo | | Modelos e referências | referencias/ | Reproduzir uma tabela conhecida | | Decisões anteriores | decisoes.md | Verificar uma correção já estabelecida | | Procedimentos reutilizáveis | .claude/skills/ | Executar cada procedimento necessário | | Entradas e entregas | execucoes/ | Identificar arquivos usados e gerados |

CLAUDE.md recebe instruções persistentes. Eu manteria ali as regras essenciais e os caminhos para materiais maiores, seguindo a orientação de escrever instruções concisas da documentação de memória.

Para skills locais do projeto, a estrutura documentada é .claude/skills/nome/SKILL.md, acompanhada de seus arquivos de apoio. Confira o conteúdo efetivamente carregado antes de considerar a instalação concluída. Documentação de skills.

3. Comece com um pedido de migração verificável

Este é um prompt original para iniciar o trabalho; não é o arquivo oferecido pelo autor:

Examine os materiais desta pasta e faça um inventário de instruções, referências, decisões e skills. Preserve os originais. Prepare uma estrutura de projeto para reproduzir o fluxo documentado, indicando a origem de cada regra. Registre dependências ausentes e conflitos encontrados. Ao terminar, apresente um teste de aceitação usando a entrada e a entrega aprovada fornecidas.

Leia o arquivo de instruções resultante. Uma preferência antiga pode ter virado uma regra inadequada. Se também usar Codex, registre as orientações correspondentes em AGENTS.md, arquivo reconhecido pela ferramenta. Instruções oficiais do Codex.

4. Compare ambientes sem mudar tudo ao mesmo tempo

Rode a tarefa no navegador e no ambiente migrado, mantendo modelo, arquivos, objetivo e critérios tão próximos quanto possível. Repita a comparação em três trabalhos representativos. Separe o esforço inicial de configuração do custo recorrente de execução.

Registre consumo indicado pela ferramenta, duração, quantidade de correções e minutos de revisão humana. Na API, registre também valores cobrados. Quando disponíveis, os campos cache_creation_input_tokens e cache_read_input_tokens ajudam a observar gravações e leituras. Como acompanhar o cache.

Para transformar isso em decisão, eu usaria custo por entrega aprovada. Uma execução econômica que exige quarenta minutos extras de correção pode sair mais cara no trabalho real. No Brasil, anote separadamente o custo cobrado em dólar e o valor efetivamente pago em reais.

5. Defina quando ampliar a migração

Minha regra seria ampliar o uso quando três entregas consecutivas passarem pelos mesmos critérios, com consumo menor ou ganho claro de tempo. Se o resultado variar demais, investigue a dependência ausente, a diferença de instruções ou a revisão que foi pulada.

Depois desse teste, acrescente outras automações conforme a necessidade. Assim, você terá uma medida do ganho produzido pela migração e poderá avaliar separadamente o efeito de novas integrações.