Skip to content

وكيل تحسين التخزين المؤقت لـ Claude Code

claude-code-cache-fix أداة صغيرة مفتوحة المصدر من طرف ثالث تساعد Claude Code على توفير الرصيد. تعمل بمثابة "وسيط" بين جهازك والمصدر الأعلى (upstream)، إذ تنظّم كل طلب وتضيف علامات التخزين المؤقت الصحيحة كي يكون من الأرجح أن يصيب المصدر الأعلى التخزين المؤقت، ما يعني إنفاق رصيد أقل. لن تجعل الذكاء الاصطناعي أكثر ذكاءً — بل تجعل رصيدك يدوم لفترة أطول فحسب.

تنويه بشأن أداة طرف ثالث

claude-code-cache-fix ليست مُدارة من قِبل Tianshu، وتمرّ الطلبات عبر وكيل محلي. راجع شيفرتها المصدرية واعتمادياتها بنفسك قبل التثبيت.

لمن هذه الأداة

  • ✅ مستخدمو Claude Code المكثّفون الذين يهتمون بالرصيد
  • ✅ من يستخدمون --resume كثيرًا لجلسات طويلة ويشغّلون عددًا من أدوات MCP / Skills
  • ✅ من لديهم استعداد للتعامل قليلًا مع سطر الأوامر
  • ❌ المستخدمون الذين لا يريدون التعامل مع الطرفية إطلاقًا ويريدون فقط أن تعمل الأداة جاهزة (يمكنك تخطّيها الآن)

ينبغي لمستخدمي Windows استخدام WSL

لا نوصي باستخدام هذه الأداة في CMD / PowerShell الأصلية في Windows. ينبغي لمستخدمي Windows إعداد المنظومة بأكملها — Node.js وClaude Code وTianshu وهذه الأداة — داخل بيئة WSL Linux، لتجنّب عدم تطابق المسارات / متغيرات البيئة / المنافذ.

مسار التحقّق الأدنى

على Linux / macOS / WSL، تحقّق أولًا من أن الوكيل يعمل (مع توجيه upstream إلى Tianshu):

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

إذا كنت تستخدم المسار المباشر، فغيّر CACHE_FIX_PROXY_UPSTREAM إلى https://api.tian-shu.org.

توجيه Claude Code إلى الوكيل المحلي

بعد بدء تشغيل الوكيل، غيّر ANTHROPIC_BASE_URL في ملف settings.json الخاص بـ Claude Code إلى عنوان الوكيل المحلي، مع الإبقاء على ANTHROPIC_AUTH_TOKEN بوصفه رمز 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"
  }
}

افتح طرفية أخرى للتحقق من سلامة الوكيل:

bash
curl http://127.0.0.1:9801/health

بمجرد أن يعيد {"status":"ok"} ويردّ تشغيل claude مجددًا بشكل طبيعي، يكون الوكيل وTianshu متصلين.

الاستخدام طويل الأمد

بدء تشغيل الوكيل يدويًا مفيد فقط للتحقق السريع. للاستخدام طويل الأمد، اضبط الوكيل بوصفه خدمة تعمل في الخلفية (systemd / launchd، وما إلى ذلك) كي لا تضطر إلى تشغيله يدويًا قبل كل جلسة Claude Code.

دع الذكاء الاصطناعي يساعدك في إعداده

تتضمّن هذه الأداة وكيلًا محليًا، ومتغيرات بيئة، وخدمة تعمل في الخلفية، وهي أمور يسهل ارتكاب خطأ فيها يدويًا. يمكنك إرسال بيئة نظامك، ونقطة نهاية Tianshu، ورابط مشروع الأداة على GitHub إلى ذكاء اصطناعي وجعله يولّد الأوامر المناسبة لجهازك. تأكّد من توجيه upstream إلى https://tian-shu.org واستخدام رمز Tianshu الخاص بك.

لا تستطيع حلّ كل مشكلات الرصيد

تُحسّن هذه الأداة فقط المسائل المتعلقة بـ بنية الطلب المحلي والتخزين المؤقت. أما سعر النموذج نفسه، واستهلاك السياق الطويل، واختيار النموذج الخاطئ، وقراءة الملفات الكبيرة بكثرة، وما شابه، فلا تزال تحتاج إلى معالجتها بشكل منفصل.