قابلية ملاحظة Claude Code: تتبع الرموز المميزة، والتكلفة، والاستخدام لكل مطور
.webp)
Built for Speed: ~10ms Latency, Even Under Load
Blazingly fast way to build, track and deploy your models!
- Handles 350+ RPS on just 1 vCPU — no tuning needed
- Production-ready with full enterprise support
ماذا تعني قابلية الملاحظة لوكيل البرمجة
تسأل قابلية الملاحظة التقليدية عما إذا كانت الخدمة تعمل أم لا. ولكن وكيل البرمجة يعمل دائمًا — فهو يعتمد على جهاز كمبيوتر محمول ويتحدث إلى موفر النموذج. السؤال الذي يهم هو سؤال اقتصادي وسلوكي: من من المطورين أنفق كم، وعلى أي نموذج، ولماذا كلفة إحدى الجلسات عشرة أضعاف جلسة أخرى. هذا حساب للرموز المميزة وليس فحصًا للحالة الصحية، وهو المنظور الذي يستخدمه هذا الدليل. للجانب المتعلق بالفواتير من نفس العملة، راجع شرح تسعير Claude Code.
المخاطر ملموسة. يكلف مطور نشط واحد حوالي $13 لكل يوم نشط و $150–250 شهريًا، مع وجود حوالي 90% من المستخدمين تحت $30/يوم — لذا فإن الحالات الاستثنائية تهم للغاية. بدون رؤية لكل مطور، لا يمكنك العثور على الأشخاص الثلاثة في فريق مكون من ثلاثين شخصًا الذين يتسببون في معظم الفاتورة، أو تحديد ما إذا كانوا يقومون بعمل صعب أو يتركون Opus يعمل بشكل افتراضي. تحول قابلية الملاحظة المجموع المفاجئ إلى قائمة من الأسباب القابلة للإصلاح.
ما يجب تتبعه بالفعل
تحمل سبع إشارات معظم القيمة تقريبًا. وكل شيء آخر مستمد منها.
اثنان من هذه الإشارات — مزيج النماذج ونسبة الذاكرة التخزين المؤقتة — هما أيضًا أكبر أدوات التحكم في التكلفة لديك، ولهذا السبب فإن مراقبتهما تعوض تكلفتهما. يتم تغطية جانب التوجيه في Opus مقابل Sonnet مقابل Haiku: دليل توجيه التكلفة مقابل الإمكانيات، وجانب التخزين المؤقت في التخزين المؤقت للموجهات في Claude: حساب التكلفة الحقيقي.
الرمز المميز ليس رقمًا واحدًا — بل أربعة
تعتبر "الرموز المستخدمة" تجميعًا غير مفيد لأن الفئات الأربع مسعرة بشكل مختلف تمامًا. في Opus 5.5، الفجوة صارخة: تكلفة الإخراج تبدأ من خمسة أضعاف سعر الإدخال الجديد، وتكلفة كتابة الذاكرة التخزين المؤقتة أسرع من الإدخال الجديد، وقراءة الذاكرة التخزين المؤقتة تكلف جزءًا صغيرًا منه. إن دمجها يخفي تمامًا المعلومات التي تحتاجها لخفض الفاتورة.
إن نسبة قراءة الذاكرة التخزين المؤقتة المرتفعة هي الإشارة التي تريدها: إعادة استخدام السياق طويل الأجل بدلاً من إعادة فرض رسوم عليه بسعر الإدخال الكامل. في الاشتراك، تعيش الذاكرة التخزين المؤقتة للموجهات لمدة ساعة تقريبًا؛ وعلى API أو موفر سحابي تكون حوالي خمس دقائق، لذا فإن النسبة المتوقعة تختلف حسب الإعداد. إذا انهارت قراءات الذاكرة التخزين المؤقتة وارتفع الإدخال الجديد، فهذا يعني أن شيئًا ما كسر الذاكرة التخزين المؤقتة — ولن تلاحظ ذلك إلا إذا تم تتبع الأرقام الأربعة بشكل منفصل.
الخيارات الأصلية، وأين يتوقف كل منها
يأتي Claude Code مزودًا بوضوح إمكانية رؤية حقيقية — لكنه مقتصر على الفرد.
/usageفي واجهة السطر البرمجي CLI يعرض الرموز المميزة للجلسة الحالية والتكلفة المقدرة، المحسوبة محليًا بسعر القائمة. إنه دقيق لمطور واحد على جهاز واحد، ويعاد ضبطه عند مسح الجلسة. ولا يمكنه تجميع البيانات لفريق كامل./insightsيلخص الجلسات الأخيرة على ذلك الجهاز — وهو مفيد للمطور الذي يتأمل في أنماطه الخاصة، ولكنه ليس عرضًا شاملاً للمنظمة.- تحليلات الاشتراكات (Teams و Enterprise) تعطي تقرير إنفاق على مستوى المؤسسة لكل مستخدم ولكل نموذج، ويتم تحديثه يوميًا — وهو أمر جيد للمالية، ولكنه ليس عرضًا مباشرًا لكل طلب.
- استخدام موفري الخدمات السحابية غير مرئي للوحات معلومات Anthropic. قم بتشغيل Claude Code على Amazon Bedrock أو Google Vertex أو Microsoft Foundry ولن تراه التحليلات الأصلية ببساطة، لأن الرموز المميزة يتم تحصيلها على حسابك السحابي بدلاً من ذلك.
النمط متسق: الأدوات الأصلية تجيب على "ما الذي أنفقته للتو"، وليس "ما الذي تفعله المنظمة بأكملها الآن". لهذا، تحتاج إلى أن تغادر المقاييس الجهاز.
OpenTelemetry: إخراج المقاييس من الجهاز
الطريقة الأصلية لسد الفجوة هي OpenTelemetry. يمكن لـ Claude Code تصدير مقاييس الرموز المميزة والتكلفة لكل مستخدم عبر OTLP إلى بنية قابلية الملاحظة الخاصة بك، وتعمل على كل إعداد — الاشتراك، أو Console API، أو أي موفر سحابي. وهذا يجعلها الخيار الأصلي الوحيد الذي يعطي أرقامًا شبه فورية لكل مطور بغض النظر عن كيفية مصادقة المطورين.
تفعيل الميزة
يكون التصدير معطلاً بشكل افتراضي ويعتمد كليًا على متغيرات البيئة، التي يتم ضبطها في ملف تعريف الصدفة (shell profile) أو ملف الإعدادات المدارة المدفوع إلى كل جهاز. إعداد أدنى للمقاييس والسجلات:
تتم دفع المقاييس على فترات متباعدة — الافتراضي هو 60000 مللي ثانية للمقاييس، و 5000 مللي ثانية للسجلات — لذا فإن "شبه الفوري" يعني بدقة الدقيقة، وليس لكل طلب. التتبع (Traces) عبارة عن إشارة تجريبية منفصلة محميّة خلف CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 و OTEL_TRACES_EXPORTER=otlp؛ قم بتفعيلها فقط عندما يكون لديك جامع (collector) جاهز لاستقبال النطاقات (spans).
ما تحمله كل إشارة
يصدر OpenTelemetry ثلاثة أنواع من الإشارات: المقاييس (المجمعات التي تبني عليها لوحات المعلومات)، والسجلات (الأحداث المنفصلة)، والتتبعات (نطاقات بيتا لتفاعل واحد). المقاييس هي المكان الذي توجد فيه قصة التكلفة:
يعتمد التنسيب لكل مستخدم على سمات user.email و account-identifier، المضمنة بشكل افتراضي. لاحظ أن session.id يرفع عدد العلاقات (cardinality) بشكل حاد — السلسلة لكل جلسة — لذا إذا كان الخادم الخاص بك يفرض رسومًا حسب السلسلة، فابقها معطلة للوحات معلومات المنظمة وقم بالتنسيب حسب المستخدم بدلاً من ذلك. تضيف سجلات الأحداث (claude_code.user_prompt و claude_code.tool_result و claude_code.api_request) تفاصيل لكل إجراء لا تستطيع المقاييس تقديمها، ويمكنها اختياريًا حمل محتوى الموجه أو الأداة — وهو قرار متعلق بالخصوصية يجب اتخاذه قبل التفعيل.
المفاضلة تشغيلية: يمكنك تجهيز كل جهاز، والحفاظ على المتغيرات في مكانها خلال عمليات التحديث للأجهزة والموظفين الجدد، وتشغيل الجامع ولوحات التحكم بنفسك. إنها تبث المقاييس بشكل جيد، ولكن تدفق المقاييس ليس مسار تدقيق على مستوى الطلب، ولا يفعل شيئًا لفرض الميزانية — بل يقتصر على الإبلاغ عنها فقط. لمعالجة أعمق لحساب الرموز المميزة نفسه، راجع قابلية الملاحظة لـ Claude في الإنتاج: حساب الرموز المميزة والتتبع.
الخيارات الأصلية مقابل OpenTelemetry مقابل البوابة
لا يتعارض OpenTelemetry وبوابة الذكاء الاصطناعي — فالبوابة الجيدة متوافقة مع OpenTelemetry ويمكنها تغذية نفس البنية. الاختلاف هو أن البوابة تقف أيضًا في مسار الطلب، بحيث يمكنها التتبع والحد، وليس فقط العد. إن OTel هو الإجابة الصحيحة عندما تمتلك الأجهزة، وتثق في أن كل جهاز يظل مجهزًا، وتحتاج فقط إلى الإبلاغ. والبوابة هي الإجابة الصحيحة عندما تأتي الأجهزة وتذهب، وتعمل بعض الحركة على موفر سحابي، وحينما يجب أن تتحول "رؤيتها" إلى "إيقافها".
قابلية الملاحظة في TrueFoundry AI Gateway
قم بتوجيه Claude Code عبر TrueFoundry AI Gateway وستعبر كل عملية إكمال نقطة واحدة تتحكم فيها. هذا يحول قابلية الملاحظة من شيء يختاره كل مطور على كل جهاز كمبيوتر محمول إلى شيء موجود ببساطة:
- تتبعات الطلبات — كل طلب مع المستخدم المحدد، والنموذج المقدم، وأعداد الرموز المميزة، وزمن الانتقال، بحيث يمكنك الإجابة عن "من أرسل هذا، وكم كلف" بعد وقوع الأمر.
- لوحات معلومات المقاييس التي تجمع البيانات للمنظمة حسب المستخدم والفريق والنموذج — الصورة الخاصة بكل مطور التي يستعرضها تتبع التكلفة لـ Claude Code.
- عرض واحد عبر الأدوات — يصل Claude Code و Cursor و Codex في نفس المكان بدلاً من ثلاثة أماكن، كما في مركزية التحكم في التكلفة لبيئات تطوير الذكاء الاصطناعي.
- تصدير متوافق مع OpenTelemetry بإضافة حوالي 3–4 مللي ثانية فقط من الحمل الإضافي، بحيث تتدفق نفس الأرقام إلى Grafana أو Datadog أو Prometheus إذا كنت تشغلها بالفعل.
ما يسجله تتبع طلب واحد
تجيب البوابة على الأسئلة التي لا تستطيع مقاييس OpenTelemetry الإجابة عليها لأنها تسجل كل طلب كسجل منفصل، وليس كعداد مجمع حسب الدقيقة. يلتقط التتبع الهوية المحددة، والنموذج المقدم، والتقسيم الرباعي للرموز المميزة، والتكلفة بالسعر المتعاقد عليه، وزمن الانتقال الإجمالي بالمللي ثانية، والحالة، وقرار التوجيه. نظرًا لأن كل صف قابل للبحث ومحفوظ، يمكنك إعادة بناء أي ارتفاع مفاجئ: قم بالتصفية لمطور واحد وساعة واحدة، واقرأ الاستدعاءات الفعلية التي أدت إلى ذلك — مسار التدقيق الذي تسطحه سلسلة المقاييس.
ما يجب التنبيه عليه، ولوحات المعلومات التي يجب بناؤها
إن جمع الإشارات أمر يضيع سدى إذا لم ينظر إليها أحد حتى تصل الفاتورة. الغرض من إخراج المقاييس من الجهاز هو التصرف طالما أنها لا تزال مهمة — مجموعة صغيرة من التنبيهات وعدد قليل من لوحات التحكم، وليس جدارًا من الرسوم البيانية. تتطابق التنبيهات القيمة مع سبب محدد وقابل للإصلاح:
- تجاوز الإنفاق اليومي لكل مطور لحد معين — على سبيل المثال الاستمرار فوق ~$30/يوم الذي يغطي بالفعل حوالي 90% من المستخدمين. هذا يلتقط الحالات الشاذة في اليوم الذي تبدأ فيه، وليس بعد شهر.
- حصة Opus من الرموز المميزة فوق السقف المحدد — أوضح إشارة على الانحراف عن النموذج الافتراضي، حيث تعمل التعديلات الروتينية بهدوء على أغلى نموذج.
- انخفاض نسبة قراءة الذاكرة التخزين المؤقتة — يعني الانخفاض المفاجئ أن التخزين المؤقت قد تراجع ويتم إعادة تحصيل رسوم الإدخال الجديد بالسعر الكامل.
- تجاوز زمن الانتقال p95/p99 بالمللي ثانية للحدود — يكشف عن تدهور الموفر وأنماط مهلة الانتظار قبل أن يبلغ عنها المطورون كـ "Claude بطيء".
- حجم الطلبات خارج ساعات العمل — تظهر المهام المجدولة والعمل في الخلفية الذي يعيد إرسال سياق كبير على فترات متباعدة كإنفاق بدون وجود إنسان على لوحة المفاتيح.
لوحات التحكم التي تستحق الإنشاء قليلة بنفس القدر: تكلفة المنظمة حسب المطور (أعلى N)، التكلفة حسب النموذج بحيث يكون مزيج Opus مقابل Sonnet مقابل Haiku مرئيًا بلمحة، عرض مجمع للأنواع الأربعة من الرموز المميزة لمراقبة نسبة الذاكرة التخزين المؤقتة، التكلفة لكل مستودع أو فريق لإعادة الخصم، توزيع زمن الانتقال بالمللي ثانية، وقبول استدعاءات الأدوات. في البوابة تكون هذه اللوحات مجهزة ومغذاة تلقائيًا؛ وعلى OpenTelemetry تجمعها في Grafana أو الخادم الخاص بك من المقاييس أعلاه.
مثال عملي
لدى فريق المنصات ثلاثون مطورًا على Claude Code، بعضهم على الاشتراك وبعضهم على Bedrock. الفاتورة الشهرية ترتفع ولا أحد يستطيع أن يقول لماذا. يوجهون كل تثبيت إلى البوابة ويقرؤون لوحة التحكم في اليوم التالي: ثلاثة مطورين يمثلون 60% من إنفاق الرموز المميزة، الثلاثة جميعهم لأن Opus هو نموذجهم الافتراضي، وهناك مهمة مجدولة واحدة تعيد إرسال سياق كبير كل ساعة. يضعون سياسة نموذج توجه التعديلات الروتينية إلى Sonnet، ويصلحون المهمة، فيمنحني خط الاتجاه — دون إجبار أي شخص على تشغيل أمر على جهازه المحمول. لم تغير قابلية الملاحظة السلوك؛ بل رؤيتها هي التي فعلت.
الحد الصريح: تعرض البوابة الإنفاق وتتيح لك حده. لا تعيد كتابة الموجهات — بل تجعل الهدر مستحيل النسيان وتمنحك أداة السياسة للتصرف. يتم تغطية جانب التنفيذ في حوكمة Claude Code باستخدام بوابة الذكاء الاصطناعي.
تنبيهات جديرة بالمعرفة
- رقم
/usageبالدولار هو تقدير يحسب محليًا بسعر القائمة. إذا كانت مؤسستك تدفع أسعارًا متعاقدًا عليها، فلن تتطابق مع الفاتورة ما لم يقم المسؤول بتجاوز السعر. /usageيعتمد على كل جهاز. المطور الذي يبرمج على جهاز كمبيوتر محمول وجهاز مكتبي يرى صورتين جزئيتين؛ فقط المقياس الخارجي (OTel أو البوابة) هو الذي يوفق بينهما.- لوحات معلومات موفري الخدمات السحابية تقسم البيانات. في Bedrock أو Vertex أو Foundry، يعيش إنفاقك في وحدة تحكم الفواتير السحابية، ويدعم التنسيب لكل مستخدم OpenTelemetry أو بوابة في الأعلى.
- الجلسات الخاملة تستمر في توليد الطلبات. تقوم المهام المجدولة والعمل في الخلفية بإعادة إرسال السياق الكامل في فتراتها المتباعدة، لذا يمكن لمطور يبدو هادئًا أن يجمع التكاليف — ولن ترى ذلك إلا في تتبع كل طلب.
- العد ليس حدًا. يخبرك OpenTelemetry بأن الميزانية قد تم تجاوزها بعد وقوع الأمر؛ فقط الشيء الموجود في مسار الطلب يمكنه إيقاف الطلب قبل أن ينفق.
session.idيعتبر مصيدة لكثرة البيانات (cardinality trap). تركه يعمل للوحات معلومات المنظمة ينشئ سلسلة مقاييس واحدة لكل جلسة، مما قد يرفع التكلفة على بنية قابلية الملاحظة المسعرة حسب الاستخدام — قم بالتنسيب حسب المستخدم بدلاً من ذلك.- فرق الوكلاء تضاعف الرموز المميزة. تستخدم عمليات التشغيل متعددة الوكلاء حوالي 7 أضعاف الرموز المميزة لجلسة واحدة، لذا فإن اعتمادها يمكن أن يجعل الإنفاق يقفز دون أن يتصرف أي فرد بشكل مختلف.
قراءات ذات صلة
- قابلية الملاحظة لـ Claude في الإنتاج: حساب الرموز المميزة والتتبع — حساب الرموز المميزة بالتفصيل
- تتبع تكلفة Claude Code باستخدام TrueFoundry AI Gateway — التنسيب لكل مطور في الممارسة العملية
- مركزية التحكم في التكلفة لبيئات تطوير الذكاء الاصطناعي — عرض واحد عبر Claude Code و Cursor و Codex
- شرح تسعير Claude Code — كم تكلف الرموز المميزة التي تراقبها بالفعل
- حوكمة Claude Code باستخدام بوابة الذكاء الاصطناعي — تحويل قابلية الملاحظة إلى تنفيذ
الخلاصة
قابلية ملاحظة Claude Code هي في الحقيقة قابلية ملاحظة التكلفة مع رفع مستوى التفاصيل: رموز مميزة مقسمة بأربعة طرق، منسوبة إلى مطور ونموذج ومهمة. تجيب الأدوات الأصلية على هذا لشخص واحد على جهاز واحد؛ ويجيب OpenTelemetry عليه للمنظمة بأكملها إذا قمت بتجهيز كل جهاز؛ وتجيب البوابة عليه للمنظمة افتراضيًا، لأن كل طلب يمر بالفعل من خلالها.
اختر الطبقة التي تتوافق مع مدى الرؤية الذي تحتاجه. إذا كانت الإجابة هي "لكل مطور، عبر كل نموذج وموفر، مع القدرة على التصرف بناءً على ما أجده"، فإن مسار الطلب هو المكان المناسب للوقوف فيه.
TrueFoundry AI Gateway delivers ~3–4 ms latency, handles 350+ RPS on 1 vCPU, scales horizontally with ease, and is production-ready, while LiteLLM suffers from high latency, struggles beyond moderate RPS, lacks built-in scaling, and is best for light or prototype workloads.






















