Skip to content

Proxy de optimización de caché para Claude Code

claude-code-cache-fix es una pequeña herramienta de código abierto de terceros que ayuda a Claude Code a ahorrar crédito. Actúa como un "intermediario" entre tu computadora y el upstream, ordenando cada solicitud y agregando los marcadores de caché correctos para que el upstream tenga más probabilidades de acertar la caché, lo que significa gastar menos crédito. No hará que la IA sea más inteligente: solo hace que tu crédito dure más.

Aviso sobre herramienta de terceros

claude-code-cache-fix no es mantenida por Tianshu, y las solicitudes pasan a través de un proxy local. Revisa su código fuente y dependencias por tu cuenta antes de instalarla.

Para quién es

  • ✅ Usuarios intensivos de Claude Code a los que les importa el crédito
  • ✅ Personas que a menudo usan --resume en sesiones largas y ejecutan muchos MCP / Skills
  • ✅ Personas dispuestas a usar un poco la línea de comandos
  • ❌ Usuarios que no quieren tocar una terminal en absoluto y solo quieren que funcione de inmediato (puedes omitirla por ahora)

Los usuarios de Windows deberían usar WSL

No recomendamos usar esta herramienta en el CMD / PowerShell nativo de Windows. Los usuarios de Windows deberían configurar todo el stack —Node.js, Claude Code, Tianshu y esta herramienta— dentro de un entorno Linux con WSL, para evitar rutas / variables de entorno / puertos que no coincidan.

Flujo de verificación mínimo

En Linux / macOS / WSL, primero verifica que el proxy funcione (con upstream apuntando a Tianshu):

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

Si usas la ruta directa, cambia CACHE_FIX_PROXY_UPSTREAM a https://api.tian-shu.org.

Apunta Claude Code al proxy local

Después de que el proxy inicie, cambia ANTHROPIC_BASE_URL en el settings.json de Claude Code a la dirección del proxy local, manteniendo ANTHROPIC_AUTH_TOKEN como tu token de 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"
  }
}

Abre otra terminal para verificar el estado del proxy:

bash
curl http://127.0.0.1:9801/health

Una vez que devuelva {"status":"ok"} y al ejecutar claude de nuevo responda con normalidad, el proxy y Tianshu están conectados.

Uso a largo plazo

Iniciar el proxy manualmente solo sirve para una verificación rápida. Para uso a largo plazo, configura el proxy como un servicio en segundo plano (systemd / launchd, etc.) para no tener que iniciarlo manualmente antes de cada sesión de Claude Code.

Deja que la IA te ayude a configurarlo

Esta herramienta involucra un proxy local, variables de entorno y un servicio en segundo plano, que son fáciles de equivocar a mano. Puedes enviar tu entorno de sistema, el endpoint de Tianshu y el enlace al proyecto de GitHub de la herramienta a una IA y pedirle que genere los comandos para tu máquina. Asegúrate de apuntar el upstream a https://tian-shu.org y de usar tu token de Tianshu.

No puede resolver todos los problemas de crédito

Esta herramienta solo optimiza problemas relacionados con la estructura de solicitudes local y la caché. El precio propio del modelo, el consumo de contexto largo, elegir el modelo equivocado, lecturas frecuentes de archivos grandes y similares aún deben abordarse por separado.