في الجلسات الطويلة قد يتوقف Claude Code عند حد الاستخدام في منتصف تعديل. تقرأ إضافة usage-limits من Ridelink نسبة ما استُهلك من نافذة الخمس ساعات والنافذة الأسبوعية وموعد إعادة ضبطهما من ملفات Claude Code، وتقيس من سجلات جلساتك كلفة الدور الواحد، ثم تخبر Claude قبل كل طلب كم دورًا بقي، ليبدأ ردّه بما يُنجَز الآن وما يؤجَّل. تعمل في الطرفية وVS Code وJetBrains وتطبيق سطح المكتب، وتقرأ حدود Codex أيضًا، ولا تعمل في محادثات claude.ai، فهي تقرأ ملفات جهازك.
ما يعمل تلقائيًا قبل كل طلب وبعده
- brief.js عند إرسال الطلب: سطر يسمّي النافذة الأقرب إلى النفاد ونسبتها وعدد الأدوار وموعد إعادة الضبط.
- pulse.js يجدّد الرقم أثناء الأدوار الطويلة وقبل Agent أو Workflow، فالوكلاء الفرعيون يستهلكون من النافذة نفسها.
- stop.js بعد كل رد: تكلفة الرد والجلسة، تُعرض لك خارج سياق Claude.
- sessionend.js: سطر ختامي بمدة الجلسة وتكلفتها.
ثمانية أوامر داخل المحادثة
/usage-limits:check: التقرير، ثم يقيس ما طلبته على الأدوار المتبقية ويقول ما يُحذف إن لم يتسع./usage-limits:session: الطلبات والأدوار والتوكنات وحجم السياق في الجلسة الحالية./usage-limits:panel: لوحة حية بجوار المحادثة في Windows Terminal وtmux وWezTerm وkitty وzellij وiTerm2./usage-limits:statusline: أشرطة الاستهلاك تحت سطر الكتابة، وoff يعيد سطر الحالة السابق كما كان./usage-limits:usage-mode: مستوى التدخل بين max وhigh وstandard وoff، وoff --guard 95يصمت حتى 95%./usage-limits:relay: مغلق افتراضيًا؛ إن اقترب الحد في جلسة لها مهام لم تكتمل، يحجز تنبيهًا بعد إعادة الضبط بنص الإكمال، وmode resume يستأنفها./usage-limits:defer: يؤجّل العمل إلى وقت مثل in 2h أو reset بمهمة مجدولة في نظامك./usage-limits:voice: ملف محلي صغير يرصد أسلوب كتابتك لتُكتب رسالة الاستئناف بأسلوبك، وforget يحذفه.
المهارة: قياس المهمة بالأدوار
يطلب SKILL.md من Claude تقدير العمل قبل بدئه: تعديل مع فحصه من دورين إلى أربعة، وميزة تمسّ ثلاثة ملفات أو أربعة من 10 إلى 20 دورًا، مع حجز نحو خُمس الرصيد للاختبار والـ commit وملاحظة التسليم. وإن لم تتسع المهمة يرتّبها ليصل الأهم أولًا بدل أن يختصر ما طلبته.
تسعير مهمة قبل بدئها
الأمر node skills/usage-limits/scripts/usage.js --forecast 15 يسعّر مهمة من 15 دورًا بما كلّفته أدوارك الأخيرة. وفي مثال README يعرض لكل نافذة نطاقًا لما ستستهلكه، وما يتبقى بعدها، وحكمًا مثل fits.
التشغيل من هذه الحزمة
- فك الضغط، ثم شغّل
claude --plugin-dirمع المسار الكامل لمجلد plugin، للجلسة الحالية فقط. - يلزم Node.js 18 أو أحدث، وإن لم يجد التقرير قراءة فاكتب /usage مرة واحدة.
- مع نسخ مجلد المهارة وحده تغيب الأوامر، وتُضاف الـ hooks يدويًا في settings.json كما في README.
- في
Codex: node bin/cli.js --host codexللتقرير، وcodex-hook on يضيف كتلة إلى AGENTS.md.
أرفقتُ دليلًا عربيًا بخطوات التحميل، وتركتُ ملفات الأداة كما نشرها صاحبها.
ما لا تضمنه الأرقام
- عدد الأدوار تقدير يفترض أن القادم يشبه الساعة الأخيرة، ولا يرى الاستهلاك من جهاز آخر أو من claude.ai.
- المبالغ بالدولار وحدة داخلية للحساب، ولا تُحاسَب عليها في الاشتراك.
- تطلب اللوحة، والـ hooks حين تقدُم القراءة، قراءة جديدة من Anthropic برمز دخول Claude Code دون أن تكتبه في ملف، وUSAGE_LIMITS_FETCH=off يمنع ذلك.
- السطر المضاف قبل كل طلب يستهلك من السياق، وusage-mode off يوقفه.
الترخيص MIT والحقوق لـ Ridelink، والمصدر: ridelink0/claude-code-usage-limits (الإصدار 1.34.1).
