Skip to content

Proxy d'optimisation du cache pour Claude Code

claude-code-cache-fix est un petit outil open source tiers dont le rôle est d'aider Claude Code à économiser du crédit. Il agit comme un « intermédiaire » placé entre votre ordinateur et l'amont : il met en forme chaque requête et y appose les bons marqueurs de cache, ce qui permet à l'amont de toucher plus facilement le cache et donc de dépenser moins de crédit. Il ne rend pas l'IA plus intelligente ; il rend simplement votre crédit plus durable.

Avertissement sur l'outil tiers

claude-code-cache-fix n'est pas un outil maintenu officiellement par Tianshu ; les requêtes transitent par un proxy local. Auditez son code source et ses dépendances avant l'installation.

À qui s'adresse-t-il

  • ✅ Usage intensif de Claude Code, sensibilité au crédit
  • ✅ Recours fréquent à --resume sur de longues sessions, beaucoup de MCP / Skills activés
  • ✅ Disposé à manipuler un peu la ligne de commande
  • ❌ Utilisateurs qui ne veulent pas du tout toucher au terminal et veulent du prêt-à-l'emploi (peuvent s'en passer pour l'instant)

Utilisateurs Windows : utilisez WSL

L'utilisation de cet outil dans le CMD / PowerShell natif de Windows est déconseillée. Sous Windows, réalisez toute la configuration (Node.js, Claude Code, Tianshu et cet outil) dans l'environnement Linux de WSL pour éviter les incohérences de chemins / variables d'environnement / ports.

Processus de validation minimal

Sous Linux / macOS / WSL, vérifiez d'abord que le proxy fonctionne (upstream pointant vers Tianshu) :

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

Si vous utilisez la ligne directe, remplacez CACHE_FIX_PROXY_UPSTREAM par https://api.tian-shu.org.

Faire passer Claude Code par le proxy local

Une fois le proxy démarré, remplacez ANTHROPIC_BASE_URL dans le settings.json de Claude Code par l'adresse du proxy local, en gardant votre jeton Tianshu pour ANTHROPIC_AUTH_TOKEN :

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"
  }
}

Dans un autre terminal, vérifiez l'état de santé du proxy :

bash
curl http://127.0.0.1:9801/health

S'il renvoie {"status":"ok"} puis que relancer claude répond normalement, c'est que le proxy et Tianshu sont bien connectés.

Usage à long terme

Le démarrage manuel du proxy ne convient qu'à une validation ponctuelle. Pour un usage durable, configurez le proxy en service d'arrière-plan (systemd / launchd, etc.) afin d'éviter de le lancer à la main avant chaque utilisation de Claude Code.

Configuration assistée par IA recommandée

Cet outil implique un proxy local, des variables d'environnement et un service d'arrière-plan ; il est facile d'oublier une étape manuellement. Vous pouvez envoyer à une IA votre environnement système, l'adresse de l'interface Tianshu et le lien du projet GitHub de l'outil, et lui demander de générer les commandes adaptées à votre machine. Veillez à pointer l'upstream vers https://tian-shu.org et à utiliser votre jeton Tianshu.

Il ne résout pas tous les problèmes de crédit

Cet outil n'optimise que les problèmes liés à la structure des requêtes locales et au cache. Le prix du modèle lui-même, la consommation de longs contextes, un mauvais choix de modèle, les lectures fréquentes de gros fichiers, etc. doivent être traités séparément.