بالنسبة لمطوري Vibe Coders، أصبحت أدوات مثل Claude Code من Anthropic لا غنى عنها للعديد من المهندسين. فمن توليد الكود النموذجي إلى تصحيح الأخطاء في الخوارزميات المعقدة، يمكن لـ Claude Code أن يعزز الإنتاجية بشكل كبير. ومع ذلك، تأتي هذه القوة مع الحاجة إلى الرقابة. فالاستخدام غير المراقب يمكن أن يؤدي إلى تكاليف غير متوقعة، واختناقات في الأداء، وفهم غير كامل لكيفية تأثير هذه الأدوات القوية على دورة حياة تطويرك.
المراقبة الفعالة لا تتعلق فقط بتتبع النفقات؛ بل تتعلق بفهم القيمة. هل تستخدم النماذج الأكثر فعالية من حيث التكلفة لمهامك؟ هل هناك أنماط في سير عملك يمكن تحسينها؟ كيف تترجم المساعدة المدعومة بالذكاء الاصطناعي إلى مكاسب إنتاجية ملموسة لفريقك؟ تتطلب الإجابة على هذه الأسئلة بيانات، وهنا يأتي دور أدوات المراقبة مفتوحة المصدر.
بينما يوفر Claude Code بعض مستوى من معلومات الاستخدام، فقد ظهر نظام بيئي مخصص من الأدوات مفتوحة المصدر لتقديم رؤى أعمق وأكثر قابلية للتنفيذ. تلبي هذه الأدوات مجموعة من الاحتياجات، من المطور الفردي الذي يرغب في فحص سريع لاستهلاكه اليومي للرموز (tokens) إلى فريق المؤسسة الذي يتطلع إلى بناء منصة مراقبة شاملة حول استخدامهم للذكاء الاصطناعي.
في هذه المقالة، سنتعمق في ثلاث أدوات مميزة مفتوحة المصدر تساعدك على مراقبة استخدامك لـ Claude Code:
ccusage: واجهة سطر أوامر (CLI) سريعة وبسيطة للتحليل السريع والمخصص لبيانات الاستخدام المحلية لديك.Claude-Code-Usage-Monitor: لوحة تحكم طرفية تفاعلية في الوقت الفعلي تساعدك على البقاء على اطلاع بجلسة عملك الحالية وتجنب الوصول إلى حدود الرموز.claude-code-otel: مكدس مراقبة كامل من فئة المؤسسات لمراقبة شاملة وطويلة الأجل للاستخدام والأداء والتكاليف على مستوى الفريق.
سنستكشف بنية وميزات وحالات الاستخدام المثالية لكل منها، مما يساعدك على اختيار الأداة المناسبة لإتقان سير عمل تطويرك باستخدام Claude Code.
هل تريد منصة متكاملة وشاملة لفريق المطورين لديك للعمل معًا بأقصى إنتاجية؟
Apidog يلبي جميع متطلباتك، ويحل محل Postman بسعر أكثر اقتصادية بكثير!
ccusage
للمطورين الذين يقدرون السرعة والبساطة والكفاءة، ccusage هي الأداة المثالية. تم إنشاؤها بواسطة مستخدم GitHub ryoppippi، وهي أداة CLI خفيفة الوزن وسريعة بشكل لا يصدق توفر تقارير واضحة وموجزة عن استخدامك لـ Claude Code وتكاليفه عن طريق تحليل ملفات سجل JSONL المحلية التي ينشئها Claude Code.
الميزات الرئيسية:
- طرق عرض تقارير متعددة: احصل على رؤى مصممة خصيصًا لأسئلتك مع تقارير
daily(يومية)، وmonthly(شهرية)، وsession(جلسة)، وblocks(التي تتوافق مع فترات الفوترة البالغة 5 ساعات في Claude Code). - المراقبة المباشرة: باستخدام الأمر
ccusage blocks --live، يمكنك الحصول على لوحة تحكم في الوقت الفعلي تعرض تقدم جلستك النشطة، و"معدل حرق" الرموز، والتكاليف المتوقعة. - تحليل التكلفة والنموذج: لا تقوم الأداة بحساب الرموز فقط؛ بل تترجمها إلى دولارات أمريكية ويمكنها تقسيم التكاليف حسب النماذج المحددة التي استخدمتها (Opus، Sonnet، Haiku، إلخ).
- إخراج مرن: بينما تتميز جداولها الافتراضية سهلة القراءة بالتنسيق الجميل وتتكيف حتى مع عرض محطتك الطرفية، يمكنك أيضًا تصدير أي تقرير إلى JSON باستخدام العلامة
--jsonلسهولة التكامل مع البرامج النصية أو الأدوات الأخرى. - تنفيذ بدون تبعيات: باستخدام
npx، يمكنك تشغيلccusageعلى الفور بدون تثبيت دائم، مما يجعله مثاليًا للفحوصات السريعة لمرة واحدة.
كيف تعمل:
ccusage هي أداة مبنية على NodeJS ومكتوبة بلغة TypeScript. يكمن سحرها في بساطتها. فهي تحلل مباشرة ملفات .jsonl المخزنة في دليل تكوين Claude Code المحلي (على سبيل المثال، ~/.config/claude/logs/). تقرأ سجلات الأحداث هذه، وتجمع عدد الرموز للمطالبات والاستجابات، وتطبق معلومات التسعير المحدثة لكل نموذج، وتقدم البيانات بتنسيق جدولي نظيف. هذا النهج الذي يعتمد على البيانات المحلية أولاً يعني أنها سريعة بشكل لا يصدق وتعمل بالكامل دون اتصال بالإنترنت (شريطة أن تكون قد خزنت بيانات التسعير مرة واحدة).
التثبيت والاستخدام:
البدء مع ccusage لا يمكن أن يكون أسهل. للتشغيل المباشر بدون تثبيت، ما عليك سوى استخدام:
npx ccusage@latest
سيقوم هذا الأمر بجلب أحدث إصدار ويعرض لك تقريرًا يوميًا. للحصول على طرق عرض أكثر تفصيلاً، يمكنك تحديد نوع التقرير:
# See a summary of usage for each month
npx ccusage@latest monthly
# Group usage by conversation sessions
npx ccusage@latest session --breakdown
# Monitor the current 5-hour billing block in real-time
npx ccusage@latest blocks --live
لمن هي؟
ccusage هي الأداة المثالية للمطور الفردي. إنها مثالية لـ:
- الإجابة على السؤال، "كم أنفقت على Claude Code بالأمس؟"
- التحقق من استخدامك للرموز في نهاية جلسة ترميز طويلة.
- إجراء تحليل بسيط ومخصص دون تكلفة إعداد معقد.
- توجيه بيانات الاستخدام إلى برامج نصية أخرى عبر إخراج JSON الخاص بها.
إذا كنت بحاجة إلى طريقة سريعة وغير معقدة للتحكم في استخدامك الشخصي لـ Claude Code، فإن ccusage هي نقطة انطلاق رائعة.
Claude-Code-Usage-Monitor
بينما تتفوق ccusage في التحليل اللاحق، تم تصميم Claude-Code-Usage-Monitor بواسطة Maciek-roboblog ليكون رفيقك المباشر أثناء جلسات الترميز الخاصة بك. توفر هذه الأداة المبنية على Python لوحة تحكم طرفية مستمرة في الوقت الفعلي لا تعرض لك ما استخدمته فحسب، بل تتنبأ أيضًا بما ستستخدمه، مما يساعدك على تجنب الوصول إلى حدود الرموز بشكل غير متوقع.
الميزات الرئيسية:
- لوحة تحكم تفاعلية في الوقت الفعلي: توفر الشاشة عرضًا محدثًا باستمرار (كل 3 ثوانٍ) لاستخدامك للرموز ضمن نافذة الجلسة الحالية البالغة 5 ساعات.
- التحليل التنبؤي: ميزتها البارزة هي حساب "معدل الحرق". فهي تحلل استخدامك الأخير للتنبؤ بالوقت الذي قد تستنفد فيه الرموز لجلسة العمل، مما يمنحك فرصة للتباطؤ.
- أشرطة التقدم المرئية: واجهة المستخدم غنية وبديهية، مع أشرطة تقدم مرمزة بالألوان لكل من استهلاكك للرموز والوقت المتبقي في جلستك.
- مراعاة الخطة والمنطقة الزمنية: يمكنك تكوين الشاشة لخطط Claude Code المختلفة (Pro، Max5، Max20) وتعيين منطقتك الزمنية المحلية لتوقعات دقيقة لإعادة تعيين الجلسة. يمكنها حتى الكشف التلقائي عن خطتك بناءً على الاستخدام السابق.
- نظام التحذير: تنبهك الأداة بنشاط عندما تقترب من حد الرموز الخاص بك، مما يساعدك على إدارة استخدامك بشكل استباقي.
كيف تعمل:
على غرار ccusage، تراقب هذه الأداة أيضًا ملفات سجل Claude Code المحلية. ومع ذلك، بدلاً من مجرد الإبلاغ عن البيانات السابقة، فإنها تحتفظ بحالة حية لجلستك الحالية البالغة 5 ساعات. إنها تفهم نظام النافذة المتنقلة لـ Claude Code وتحسب استخدامك للرموز ومعدل الحرق ضمن هذا السياق. وهي مكتوبة بلغة Python وتستخدم مكتبة rich لإنشاء واجهتها الطرفية المصقولة والتفاعلية.
التثبيت والاستخدام:
الطريقة الموصى بها لتثبيت Claude-Code-Usage-Monitor هي استخدام uv، وهو مثبت حزم Python حديث يتعامل مع البيئات الافتراضية تلقائيًا.
# Install uv (if you don't have it)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install the tool
uv tool install claude-monitor
# Run the monitor
claude-monitor
بمجرد التشغيل، ستسيطر على نافذة محطتك الطرفية وتعرض لوحة التحكم المباشرة. يمكنك تخصيصها باستخدام علامات مختلفة:
# Specify your plan and timezone
claude-monitor --plan max20 --timezone America/New_York
لمن هي؟
Claude-Code-Usage-Monitor مخصصة للمطور الذي يريد البقاء على اطلاع مستمر أثناء عمله. إنها مثالية لـ:
- المستخدمين على المستوى المجاني أو "Pro" الذين لديهم حدود رموز أكثر صرامة ويحتاجون إلى إدارتها بعناية.
- المطورين المنخرطين في جلسات ترميز طويلة ومكثفة والذين يرغبون في تحديد وتيرة استخدامهم.
- أي شخص يريد تجنب التجربة المزعجة المتمثلة في قطع الاتصال في منتصف الفكرة بسبب الوصول إلى حد معين.
- المتعلمين البصريين الذين يفضلون لوحة تحكم رسومية على التقارير الثابتة.
إذا كنت تريد أداة تعمل كـ "ملاك حارس" لميزانية الرموز الخاصة بك، وتراقبك وتبقيك على المسار الصحيح، فهذه هي الأداة المناسبة لك.
claude-code-otel
الأداتان الأوليان رائعتان للمطورين الأفراد، ولكن ماذا لو كنت بحاجة إلى مراقبة استخدام Claude Code عبر فريق أو مؤسسة بأكملها؟ هذا هو المكان الذي تتألق فيه claude-code-otel بواسطة ColeMurray. إنها ليست مجرد أداة؛ إنها حل مراقبة كامل ذاتي الاستضافة مبني على مكونات مفتوحة المصدر قياسية في الصناعة.
الميزات الرئيسية:
- مكدس مراقبة كامل: يوفر إعدادًا مسبقًا لـ OpenTelemetry وPrometheus وLoki وGrafana، وهي نفس الأدوات القوية المستخدمة لمراقبة البنية التحتية للإنتاج.
- لوحات تحكم شاملة: يأتي المشروع مع لوحات تحكم Grafana مسبقة البناء لتحليل عميق للتكلفة ونشاط المستخدم وأداء الأداة ومقاييس الإنتاجية (مثل سطور الكود المتغيرة) وزمن استجابة واجهة برمجة التطبيقات (API latency) والأخطاء والمزيد.
- المراقبة على مستوى الفريق: تم تصميمها من الألف إلى الياء لتجميع البيانات من عدة مستخدمين، مما يتيح لك رؤية الاتجاهات وتحديد المستخدمين الأكثر نشاطًا وإدارة التكاليف على مستوى الفريق أو المشروع.
- سيادة البيانات والأمان: نظرًا لأنك تستضيف المكدس بأكمله بنفسك، فإن جميع بيانات الاستخدام الخاصة بك، بما في ذلك مطالبات المستخدم الحساسة المحتملة (إذا اخترت تسجيلها)، تبقى ضمن البنية التحتية الخاصة بك.
- قائمة على المعايير: باستخدام OpenTelemetry، تلتزم بمعيار محايد للبائع لبيانات القياس عن بعد، مما يجعلها قابلة للتوسيع ومقاومة للمستقبل.
كيف تعمل:
يتبع هذا الحل نهجًا مختلفًا جذريًا. فهو يستفيد من دعم Claude Code المدمج لـ OpenTelemetry (OTel). عن طريق تعيين عدد قليل من متغيرات البيئة، يمكنك تكوين Claude Code CLI لإصدار مقاييس وسجلات مفصلة. يوفر claude-code-otel إعداد docker-compose الذي يقوم بتشغيل الواجهة الخلفية بأكملها لاستقبال ومعالجة هذه البيانات:
- OpenTelemetry Collector: يستقبل بيانات القياس عن بعد من جميع مثيلات Claude Code للمستخدمين.
- Prometheus: يقوم بجمع وتخزين المقاييس (على سبيل المثال، عدد الرموز، التكاليف، زمن الاستجابة).
- Loki: يستقبل ويخزن سجلات الأحداث (على سبيل المثال، مطالبات المستخدم، نتائج الأدوات، أخطاء API).
- Grafana: يستعلم Prometheus وLoki لتصور البيانات في لوحات تحكم قوية وتفاعلية.
التثبيت والاستخدام:
يعد إعداد claude-code-otel أكثر تعقيدًا من الأدوات الأخرى ولكنه مبسط بشكل ملحوظ بفضل Docker.
- استنساخ المستودع:
git clone https://github.com/ColeMurray/claude-code-otel.git
cd claude-code-otel
2. بدء المكدس:
make up
3. قم بتكوين بيئة Claude Code المحلية الخاصة بك لإرسال البيانات إلى المكدس الجديد عن طريق تعيين متغيرات البيئة:
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
# ... and a few others
4. الوصول إلى لوحات التحكم الخاصة بك عن طريق الانتقال إلى http://localhost:3000 في متصفحك.
لمن هي؟
claude-code-otel هو الحل النهائي لفرق الهندسة، وفرق المنصات، والإدارة. إنه مثالي لـ:
- المؤسسات التي تتطلع إلى قياس عائد الاستثمار لأدوات تطوير الذكاء الاصطناعي الخاصة بها.
- قادة الفرق الذين يحتاجون إلى إدارة ميزانية مشتركة لاستخدام Claude Code.
- مهندسي المنصات الذين يحتاجون إلى مراقبة أداء وموثوقية أدوات الذكاء الاصطناعي.
- أي مؤسسة تتطلب طريقة مركزية وآمنة وقوية لفهم كيفية استخدام الذكاء الاصطناعي عبر فرق التطوير الخاصة بها.
الخلاصة: اختيار عدستك
تبدأ رحلة إتقان استخدامك لـ Claude Code بالرؤية. توفر الأدوات الثلاث التي استكشفناها عدسات مختلفة يمكن من خلالها رؤية تفاعلك مع مساعد الذكاء الاصطناعي القوي هذا.
- ابدأ بـ
ccusageللحصول على طريقة بسيطة وقوية وسريعة للحصول على إجابات للأسئلة الشائعة حول استخدامك السابق. - انتقل إلى
Claude-Code-Usage-Monitorعندما تريد الانتقال من التحليل التفاعلي إلى الإدارة الاستباقية في الوقت الفعلي لميزانية الرموز الخاصة بك أثناء جلسات الترميز. - اعتمد
claude-code-otelعندما يتحول تركيزك من الاستخدام الفردي إلى المراقبة على مستوى الفريق وإدارة التكاليف وتحليل الأداء.
يمثل كل من هذه المشاريع مفتوحة المصدر مساهمة رائعة في مجتمع المطورين، وتمكين المستخدمين من الانتقال من كونهم مستهلكين سلبيين لتقنية الذكاء الاصطناعي إلى مشاركين نشطين ومطلعين. من خلال اختيار الأداة المناسبة لاحتياجاتك، يمكنك فتح مستوى جديد من التحكم والرؤية، مما يضمن حصولك على أقصى قيمة من سير عمل التطوير المدعوم بالذكاء الاصطناعي.
هل تريد منصة متكاملة وشاملة لفريق المطورين لديك للعمل معًا بأقصى إنتاجية؟
Apidog يلبي جميع متطلباتك، ويحل محل Postman بسعر أكثر اقتصادية بكثير!