كيفية التحقق من استخدام رموز Claude Code: 4 طرق لرؤية ما ينفقه وكلاؤك

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

إليك أربع طرق للتحقق من استخدام رموز Claude Code، من الأمر المدمج الأسرع إلى مقياس حي يظهر كل وكيل في الوقت الفعلي. اختر الطريقة التي تناسب مدى عمق ما تحتاجه.

1. أسرع طريقة: الأمر /cost

داخل أي جلسة Claude Code، اكتب:

/cost

تقوم Claude Code بطباعة التكلفة الإجمالية وعدد الرموز للجلسة الحالية، بالإضافة إلى مدة تشغيلها. إنها أسرع إجابة على "ما الذي أنفقته هذه الجلسة حتى الآن"، ولا تحتاج إلى أي شيء مثبت.

المشكلة: /cost محصورة في الجلسة التي أنت فيها. لا تخبرك بما أنفقته بالأمس، أو ما كلفه مشروع مختلف، أو كيف يقارن وكيل معين بآخر. بالنسبة لفحص سريع واحد، إنها مثالية. لأي شيء تاريخي، تابع القراءة.

2. اقرأ المصدر: نصوص الجلسة

تكتب Claude Code كل جلسة على القرص كنص JSONL. على macOS وLinux ستجدها هنا:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

كل سطر هو رسالة واحدة، ورسائل المساعد تحمل كائن usage مع الأعداد الدقيقة: input_tokens، output_tokens، وحقول التخزين المؤقت (cache_creation_input_tokens، cache_read_input_tokens). تعتبر قراءات التخزين المؤقت الجزء المثير للاهتمام: فهي أرخص بكثير من المدخلات الجديدة، لذا فإن جلسة ذات معدل نجاح تخزين مؤقت مرتفع تكلف أقل بكثير مما تقترحه الأعداد الخام من الرموز.

هذه هي الحقيقة الأساسية. كل أداة أخرى، بما في ذلك الأداتين أدناه، تقرأ هذه الملفات نفسها. إذا كنت تريد كتابة تقرير خاص بك، فإن jq على JSONL سيوصلك إلى هناك.

3. واجهة سطر الأوامر المخصصة: ccusage

إذا كنت تفضل عدم كتابة محلل خاص بك، فإن أداة المجتمع ccusage تقرأ تلك النصوص وتجمعها في إجماليات يومية وشهرية وإجمالية لكل جلسة:

npx ccusage@latest

إنها نقطة وسط جيدة: المزيد من التاريخ مقارنة بـ /cost، وعملاً أقل من كتابة jq يدويًا. لكنها تبقى في الطرفية، لذا فهي تجيب على "ماذا أنفقت" ولكن ليس "أي وكيل، الآن، ينفق ذلك".

4. مقياس حي: استخدام لكل جلسة في AgentsRoom

تشترك الطرق الثلاثة أعلاه في نقطة عمياء واحدة: إنها بعد الحدث وتدفق واحد. في اللحظة التي تقوم فيها بتشغيل عدة وكلاء بالتوازي، تريد رؤية الاستخدام لكل وكيل، مباشرة، دون كتابة أمر في كل طرفية.

هذا ما يفعله مقياس استخدام رموز Claude Code في AgentsRoom. إنه يقرأ نفس نصوص JSONL، لكل جلسة، ويظهر:

• رموز الإدخال والإخراج والتخزين المؤقت لكل وكيل، مع التحديث أثناء تشغيل الجلسة
• معدل نجاح التخزين المؤقت، حتى تتمكن من رؤية متى يتم إعادة استخدام السياق بدلاً من إعادة إرساله
• تحذير قبل أن تنحرف جلسة نحو حد المعدل

لأنها تعزو الاستخدام حسب الجلسة، تظل صحيحة حتى عندما تقوم بتشغيل حسابات متعددة لـ Claude Code جنبًا إلى جنب: يحتفظ كل حساب بإجمالياته الخاصة، مما يجعل إعادة الفوترة لكل عميل مباشرة.

أي واحدة يجب أن تستخدمها

• هل تحتاج فقط إلى رقم هذه الجلسة؟ /cost.
• هل تريد كتابة تقرير مخصص؟ اقرأ نصوص JSONL مباشرة.
• هل تريد إجماليات يومية وشهرية في الطرفية؟ ccusage.
• هل تقوم بتشغيل عدة وكلاء وترغب في مشاهدة الاستخدام مباشرة، لكل وكيل ولكل حساب؟ استخدم المقياس في AgentsRoom.

التحقق من الاستخدام هو الخطوة الأولى. إذا جعلتك الأرقام تتجعد، فإن الخطوة التالية هي تقليلها: انظر كيفية تقليل تكاليف رموز Claude Code للحصول على الرافعات التي تهم حقًا، بدءًا من إعادة استخدام التخزين المؤقت.