Proxy de Otimização de Cache do Claude Code

O claude-code-cache-fix é uma pequena ferramenta open-source de terceiros que ajuda o Claude Code a economizar créditos. Ele atua como um "intermediário" entre o seu computador e o upstream, organizando cada requisição e adicionando os marcadores de cache corretos para que o upstream tenha mais chance de acertar o cache, o que significa gastar menos créditos. Ele não deixa a IA mais inteligente — apenas faz seus créditos durarem mais.

Aviso sobre ferramenta de terceiros

O claude-code-cache-fix não é mantido pelo Tianshu, e as requisições passam por um proxy local. Revise você mesmo o código-fonte e as dependências antes de instalar.

Para quem é

✅ Usuários intensos do Claude Code que se importam com créditos
✅ Pessoas que frequentemente usam --resume em sessões longas e rodam vários MCP / Skills
✅ Pessoas dispostas a mexer um pouco na linha de comando
❌ Usuários que não querem tocar em um terminal de jeito nenhum e só querem que funcione direto (você pode pular isso por enquanto)

Usuários do Windows devem usar o WSL

Não recomendamos usar esta ferramenta no CMD / PowerShell nativo do Windows. Usuários do Windows devem configurar toda a pilha — Node.js, Claude Code, Tianshu e esta ferramenta — dentro de um ambiente Linux WSL, para evitar incompatibilidades de caminhos / variáveis de ambiente / portas.

Fluxo mínimo de verificação

No Linux / macOS / WSL, primeiro verifique se o proxy funciona (com o upstream apontando para o Tianshu):

bash

npm install -g claude-code-cache-fix
CACHE_FIX_PROXY_UPSTREAM=https://tian-shu.org cache-fix-proxy server

Se você usa a rota direta, altere CACHE_FIX_PROXY_UPSTREAM para https://api.tian-shu.org.

Aponte o Claude Code para o proxy local

Após o proxy iniciar, altere o ANTHROPIC_BASE_URL no settings.json do Claude Code para o endereço do proxy local, mantendo o ANTHROPIC_AUTH_TOKEN como o seu token do Tianshu:

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:9801",
    "ANTHROPIC_AUTH_TOKEN": "xxx",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
  }
}

Abra outro terminal para verificar a saúde do proxy:

bash

curl http://127.0.0.1:9801/health

Assim que ele retornar {"status":"ok"} e executar claude novamente responder normalmente, o proxy e o Tianshu estão conectados.

Uso de longo prazo

Iniciar o proxy manualmente só é bom para verificação rápida. Para uso de longo prazo, configure o proxy como um serviço em segundo plano (systemd / launchd, etc.) para que você não precise iniciá-lo manualmente antes de cada sessão do Claude Code.

Deixe a IA ajudar a configurar

Esta ferramenta envolve um proxy local, variáveis de ambiente e um serviço em segundo plano, que são fáceis de errar manualmente. Você pode enviar o seu ambiente de sistema, o endpoint do Tianshu e o link do projeto da ferramenta no GitHub para uma IA e pedir que ela gere os comandos para a sua máquina. Não se esqueça de apontar o upstream para https://tian-shu.org e usar o seu token do Tianshu.

Ele não resolve todo problema de crédito

Esta ferramenta só otimiza questões relacionadas à estrutura de requisição local e cache. O preço do próprio modelo, o consumo de contexto longo, escolher o modelo errado, leituras frequentes de arquivos grandes e afins ainda precisam ser tratados separadamente.

Proxy de Otimização de Cache do Claude Code ​

Para quem é ​

Fluxo mínimo de verificação ​

Aponte o Claude Code para o proxy local ​