مراقبة استخدام كود Claude في الوقت الفعلي: أداة مفتوحة المصدر

في عصر "البرمجة الحسية" (Vibe Coding)، أصبحت مساعدات البرمجة المدعومة بالذكاء الاصطناعي حجر الزاوية في سير عمل التطوير الحديث. يبرز Claude Code من Anthropic كحليف قوي بشكل خاص، قادر على فهم قواعد بيانات ضخمة من الأكواد وتسريع مهام البرمجة المعقدة. ومع ذلك، على الرغم من كل قوته، غالباً ما يواجه المطورون عنق زجاجة شائع ومحبط: الطبيعة الغامضة وغير المتسامحة لحدود استخدام التوكن (token usage limits). يمكن أن تتوقف جلسة برمجة مكثفة فجأة برسالة "انتهت الجلسة"، مما يترك المطورين في حيرة بشأن استهلاكهم.

لمعالجة نقطة الضعف الحرجة هذه بشكل مباشر، يأتي مراقب استخدام Claude Code، وهي أداة طرفية مفتوحة المصدر ومصممة بشكل جميل أنشأها المطور Maciek-roboblog. هذه ليست مجرد عداد؛ إنها مركز قيادة شامل لتفاعلاتك مع Claude AI. توفر تتبعاً في الوقت الفعلي، وأشرطة تقدم مرئية، وحسابات ذكية لمعدل الاستهلاك (burn rate)، وتنبؤات ذكية لتحويل إدارة التوكن لديك من لعبة تخمين تفاعلية إلى ميزة استراتيجية استباقية. يقدم هذا المقال دليلاً شاملاً حول كيفية تثبيت هذه الأداة التي لا غنى عنها واستخدامها وإتقانها.

لماذا تحتاج إلى مراقب استخدام Claude Code

لتقدير قيمة المراقب، يجب أولاً فهم التحدي الذي يحله. يخضع استخدام Claude Code لنظام نوافذ الجلسات المتجددة لمدة 5 ساعات. تبدأ الجلسة، بحد التوكن المقابل لها، مع رسالتك الأولى إلى Claude وتنتهي بعد خمس ساعات بالضبط. والأهم من ذلك، يمكن للمطور أن يكون لديه جلسات متعددة ومتداخلة نشطة في وقت واحد. إذا بدأت محادثة جديدة في الساعة 10:30 صباحاً، تبدأ الجلسة A. إذا بدأت أخرى في الساعة 12:15 ظهراً، تعمل الجلسة B بالتوازي مع الجلسة A.

هذا النظام، على الرغم من مرونته، يجعل التتبع اليدوي مهمة شبه مستحيلة. أي حد جلسة تقترب منه؟ ما هو معدل استهلاك التوكن الإجمالي لديك؟ بدون أداة مخصصة، يعمل المطورون بشكل أعمى، غير قادرين على تخطيط عملهم بفعالية ومعرضين باستمرار لخطر الانقطاع في منتصف الفكرة، مما يعطل تركيزهم ويعرقل إنتاجيتهم.

كيفية تثبيت وإعداد مراقب استخدام Claude Code

تم تصميم مراقب استخدام Claude Code لسهولة الاعتماد، حيث يقدم كلاً من البدء السريع للاختبار وإعداداً قوياً جاهزاً للإنتاج يوصى به بشدة للاستخدام اليومي.

المتطلبات الأساسية

قبل البدء، تأكد من تثبيت ما يلي على نظامك:

1. Python 3.6+
2. Node.js (لتثبيت أداة سطر الأوامر الأساسية ccusage)

البدء السريع (للاختبار فقط)

لتقييم سريع، يمكنك استخدام الأوامر التالية:Bash

# Install dependencies
npm install -g ccusage
pip install pytz

# Clone and run
git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
cd Claude-Code-Usage-Monitor
python ccusage_monitor.py

على الرغم من بساطتها، تقوم هذه الطريقة بتثبيت الحزم عالمياً وليست مثالية للاستقرار طويل الأمد أو عزل المشاريع.

إعداد الإنتاج (موصى به)

لإعداد نظيف ومستقر واحترافي، استخدام بيئة Python افتراضية أمر غير قابل للتفاوض. إنها تعزل تبعيات المشروع، وتمنع التعارضات مع تثبيت Python على نظامك، وتجعل المشروع سهل النقل وإعادة الإنتاج.

دليل خطوة بخطوة:

تثبيت ccusage عالمياً: هذه التبعية الأساسية تجلب بيانات الاستخدام من Claude.Bash

npm install -g ccusage

استنساخ المستودع:Bash

git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
cd Claude-Code-Usage-Monitor

إنشاء بيئة افتراضية:Bash

# This creates a 'venv' folder in your project directory
python3 -m venv venv

تفعيل البيئة الافتراضية: يجب عليك القيام بذلك في كل مرة تبدأ فيها جلسة طرفية جديدة للعمل على المشروع.Bash

# On Linux/macOS:
source venv/bin/activate

# On Windows:
venv\Scripts\activate

يجب أن يسبق موجه الأوامر لديك الآن (venv)، مما يشير إلى أن البيئة نشطة.

تثبيت تبعيات Python: مع تفعيل البيئة الافتراضية، قم بتثبيت الحزم الضرورية.Bash

pip install pytz

جعل السكريبت قابلاً للتنفيذ (اختياري، لأنظمة Linux/macOS):Bash

chmod +x ccusage_monitor.py

تشغيل المراقب:Bash

# On Linux/macOS (if made executable):
./ccusage_monitor.py

# On all systems:
python ccusage_monitor.py

الاستخدام اليومي ونصائح احترافية

بمجرد الإعداد، يصبح سير عملك اليومي بسيطاً:Bash

cd Claude-Code-Usage-Monitor
source venv/bin/activate
./ccusage_monitor.py
# When finished, simply type:
deactivate

لأقصى قدر من الكفاءة، أنشئ اسم مستعار للصدفة (shell alias). أضف السطر التالي إلى ملف ~/.bashrc أو ~/.zshrc:Bash

alias claude-monitor='cd ~/path/to/Claude-Code-Usage-Monitor && source venv/bin/activate && ./ccusage_monitor.py'

الآن، يمكنك تشغيل المراقب من أي مكان بمجرد كتابة claude-monitor في الطرفية لديك.

إتقان المراقب: الاستخدام والتكوين

تشغيل المراقب بسيط مثل تنفيذ السكريبت، ولكن قوته الحقيقية تُفتح من خلال خيارات سطر الأوامر الخاصة به.

الاستخدام الأساسي:

للتشغيل بالإعدادات الافتراضية (خطة Pro، ~7,000 توكن) والخروج بشكل طبيعي، اضغط على Ctrl+C.

خيارات التكوين:

تحديد خطتك: قم بتخصيص المراقب ليناسب مستوى اشتراكك للحصول على حدود دقيقة.Bash

# Pro plan (~7,000 tokens) - Default
./ccusage_monitor.py --plan pro

# Max5 plan (~35,000 tokens)
./ccusage_monitor.py --plan max5

# Max20 plan (~140,000 tokens)
./ccusage_monitor.py --plan max20

# Auto-detect from your highest previous session
./ccusage_monitor.py --plan custom_max

تخصيص أوقات إعادة الضبط والمناطق الزمنية: المراقب يستخدم Europe/Warsaw كإعداد افتراضي. قم بمواءمته مع يوم عملك المحلي لتخطيط أكثر سهولة.Bash

# Set reset time to 9 AM in US Eastern Time
./ccusage_monitor.py --reset-hour 9 --timezone US/Eastern

# Use UTC for international team collaboration
./ccusage_monitor.py --timezone UTC