إعدادات Claude Code الجديدة: تحكّم في جهد الاستدلال

الخلاصة: كيف تضبط سقف الجهد؟

حدّث Claude Code إلى الإصدار 2.1.267 أو أحدث، ثم أضف "maxEffortLevel": "medium" إلى ملف الإعدادات المناسب للأشخاص والمشروعات التي تريد إخضاعها للسياسة. استخدم ~/.claude/settings.json لوضع سقف عام يخصك، أو .claude/settings.json ليشمل جميع العاملين في مستودع واحد، أو الإعدادات المُدارة لتطبيق قاعدة على مستوى المؤسسة.

يقبل الإعداد القيم low أو medium أو high أو xhigh أو max. وتعني القيمة max أن هذا المصدر لا يفرض سقفًا على الجهد. كذلك فإن عدم تعريف المفتاح يعني عدم وجود سقف.

هذا محدد للسرعة، وليس ميزانية للإنفاق. فهو يقيّد مقدار الاستدلال المسموح لـ Claude في الطلب، لكنه لا يحدد مخصصًا للتوكنز أو سقفًا بالدولار أو حدًا لاستخدام الاشتراك. قِس هذه العناصر بصورة منفصلة عبر /usage أو Claude Console أو Claude Code OpenTelemetry.

ما الذي يغيّره maxEffortLevel فعليًا؟

يؤدي effortLevel وmaxEffortLevel وظيفتين مختلفتين. فمستوى الجهد هو الإعداد المطلوب لجلسة أو نموذج، أما الحد الأقصى لمستوى الجهد فهو الحد الذي لا يمكن لذلك الطلب تجاوزه.

إذا كان السقف medium، يظل بإمكان المطوّر اختيار low أو medium. أما طلب high أو xhigh أو max فيُنفذ عند medium بدلًا منه. كما يضبط السقف الجهد المطلوب عبر /effort ومنتقي /model والخيار --effort والمتغير CLAUDE_CODE_EFFORT_LEVEL والإعداد الافتراضي للنموذج. ويطبّقه Claude Code من جهة العميل قبل كل طلب، لذلك تعمل السياسة نفسها عندما تمر حركة النموذج عبر Anthropic أو Amazon Bedrock أو Google Cloud's Agent Platform أو Microsoft Foundry.

هناك قاعدة محورية يسهل إغفالها: السقف الأدنى بين جميع النطاقات المحمّلة هو الذي يفوز. عادةً ما تتبع إعدادات Claude Code تسلسل أولوية يضع الإعدادات المُدارة فوق إعدادات سطر الأوامر وملفات المشروع وإعدادات المستخدم. لكن maxEffortLevel استثناء تقييدي؛ فسقف المشروع الأدنى يظل نافذًا حتى إذا سمح مصدر مُدار أو مصدر المستخدم بمستوى أعلى.

ضبط إعدادات Claude Code: سقف عام واستثناء لنموذج وسقف أشد للمشروع

ابدأ بالتحقق عبر claude --version. إذا كان الإصدار أقدم من 2.1.267، فنفّذ claude update قبل إضافة المفتاح.

لوضع سقف شخصي يسري على جميع المستودعات، أضف ما يلي إلى ~/.claude/settings.json:

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

تقيّد قيمة المستوى الأعلى كل نموذج مدعوم عند medium. ويستبدل إدخال Sonnet 4.6 هذه القيمة لنموذج Sonnet داخل ملف المستخدم هذا وحده. ولا تُجبر القيمة max نموذج Sonnet على العمل بأقصى جهد؛ بل تعني أن هذا المصدر بعينه لا يفرض سقفًا على ذلك النموذج.

بعد ذلك، أضف قاعدة أشد لمستودع واحد داخل .claude/settings.json:

{
  "maxEffortLevel": "low"
}

والنتيجة الفعلية صارمة عن قصد:

لا يتجاوز استثناء النموذج قاعدة المشروع. فهو لا يفعل سوى إلغاء سقف medium القادم من مصدر المستخدم بالنسبة إلى Sonnet. وهذا هو الخطأ الأرجح في خلق انطباع زائف بأن الاستثناء مطلق.

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

كيف تتحقق من سقف الجهد قبل الاعتماد عليه؟

ملف JSON صالح لا يثبت أن السقف المقصود هو الذي فاز. تحقّق من المصادر المحمّلة ومن المستوى المطبّق معًا.

1. شغّل /status داخل Claude Code. يؤكد سطر Setting sources تحميل إعدادات User وProject وأي إعدادات Managed، لكنه لا يبيّن المصدر الذي قدّم كل مفتاح على حدة.
2. شغّل claude doctor إذا كان أحد المصادر مفقودًا أو بدا أن مفتاحًا جديدًا يجري تجاهله. يعرض الأمر إدخالات الإعدادات المرفوضة. وقد يتأخر مخطط JSON المنشور عن إصدار CLI جديد، لذا لا يكفي تحذير المحرر وحده للحكم.
3. راقب ترويسة الجلسة بجوار اسم النموذج. يعرض Claude Code مستوى الجهد الحالي هناك، كما يظهر لفترة وجيزة في التذييل عند تغيّره.
4. داخل مستودع المثال، اطلب /effort max. سيظل سقف low على مستوى المشروع نافذًا؛ فلا يمكن لطلب أعلى أن يرفعه.
5. في البيئات غير التفاعلية واسعة النطاق، افحص السمة effort في claude_code.cost.usage وclaude_code.token.usage. فهي تسجل المستوى المطبّق على كل طلب إلى جانب النموذج ومصدر الاستعلام.

تكتسب الخطوة الأخيرة أهمية خاصة عند استخدام Bedrock أو Google Cloud أو Foundry. فالسياسة يفرضها Claude Code قبل أن يتلقى المزود الطلب، بينما يكشف القياس عن المستوى الذي طبّقه Claude Code بالفعل.

اختبر الجودة والإنفاق في مسارين منفصلين

لا تعمّم سقف medium أو low لمجرد أن اسمه يوحي بالتوفير. استخدم مهمة روتينية يعرفها فريقك جيدًا، وقارن بين تشغيلات متطابقة الشروط.

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

قيّم النتيجة قبل الاطلاع على التكلفة:

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

سبع حالات يحقق فيها سقف الجهد عائدًا واضحًا

رُتبت حالات الاستخدام التالية بحسب الجهة التي تحصل على أوضح عائد تشغيلي.

1. فرق المنصات التي تضبط الأعمال الروتينية

يمكن لفريق منصات يدعم 20 أو 200 مطوّر أن يضع medium في الإعدادات المُدارة، ويبقي المستويات الأدنى متاحة، ويحصر تغييرات السياسة في الاستثناءات التي جرى قياسها. ولا تقتصر الفائدة على تقليل التوكنز؛ بل تتمثل أيضًا في حد افتراضي موحّد عبر الحواسيب المحمولة وجلسات IDE ومسارات مزودي الخدمات السحابية، ما يجعل مقارنات التكلفة والجودة قابلة للاستخدام.

2. مسؤولو FinOps مع Claude Code المفوتر عبر API

يمكن لمسؤول FinOps الجمع بين سقف مُدار وOpenTelemetry مجمّع حسب effort والنموذج والفريق ومركز التكلفة. وسير العمل بسيط: راقب خط الأساس بلا سقف، وطبّق السقف على مجموعة تجريبية، ثم قارن تكلفة كل مهمة مقبولة. وهكذا تتحول المناقشات حول مستوى الجهد الذي يبدو مكلفًا إلى تقرير مرتبط بالعمل المنجز.

3. المؤسسات التي تستخدم Bedrock أو Google Cloud أو Foundry

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

4. مسؤولو صيانة CI الذين يشغّلون إصلاحات متكررة

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

5. مالكو المستودعات الأحادية الذين يفصلون العمل الروتيني عن الصعب

يمكن لمالك مستودع أحادي الإبقاء على سقف شخصي عند medium، واعتماد سقف مشترك أدنى في مستودع للوثائق أو الشفرة المُنشأة، وترك مستودع الأنظمة الأصعب عند الحد الأوسع. وهكذا يحمل كل مستودع حدوده الخاصة. وتصبح سياسة التكلفة مرتبطة بالعمل بدل اعتمادها على تذكّر كل مطوّر لأمر معين.

6. شركات الاستشارات التي تتنقل بين مستودعات العملاء

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

7. كبار المهندسين الذين يحتفظون باستثناء ضيق لنموذج

يمكن لكبير المهندسين استثناء نموذج واحد من السقف العام لمصدر ما عبر modelSettings، مع إبقاء سقف آخر أدنى في مستودع حرج للسلامة. يمنح ذلك النموذج مساحة حيث يسمح المصدر، من دون تحويل الاستثناء إلى تجاوز شامل. والفائدة هي استثناء دقيق يظل خاضعًا لسياسة أشد على مستوى المشروع أو المؤسسة.

ما الذي يستحق البناء حول هذا الإعداد؟

1. بوابة لاختبار تراجع الجودة حسب الجهد، وهي أقوى فرصة

ابنِ أداة CLI وفحص CI يشغّلان حزمة المهام المقبولة في المستودع عند مستويات الجهد المسموح بها، ثم يعرضان معدل النجاح وعيوب المراجعة والمدة والتوكنز والتكلفة. ستدفع فرق منصات الهندسة مقابل ذلك لأن السقف يطرح فورًا سؤالًا عن الجودة: إلى أي حد يمكن خفض جهد العمل الروتيني قبل أن تلتهم أعمال الإصلاح الوفر؟

مؤشر الطلب التجاري قوي بصورة غير معتادة. يحقق ai code review نحو 1,300 عملية بحث شهريًا في الولايات المتحدة، مع CPC يبلغ $62.38. وأصغر نسخة قابلة للبيع هي مشغّل محلي مع فحص GitHub يقارن ملفّي جهد على العينة النظيفة نفسها، ويمنع تغيير السياسة عندما تتراجع الاختبارات المطلوبة أو قواعد المراجعة.

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

2. أداة تدقيق سياسة جهد Claude Code

ابنِ أداة فحص للقراءة فقط تحول مصادر المستخدم والمشروع المشترك والمشروع المحلي وسطر الأوامر والمصادر المُدارة إلى جدول واحد يوضح سقف كل نموذج. ستستخدمها فرق المنصات والأمن لاكتشاف استثناء max فُهم خطأً على أنه عام، أو سقف مشروع أدنى يفوز على غير المتوقع، أو أجهزة ما زالت تعمل بإصدار أقدم من 2.1.267.

يحقق claude code نحو 550,000 عملية بحث شهريًا في الولايات المتحدة، وتتضمن الأسئلة الرائجة: «ما مستوى الجهد الذي ينبغي استخدامه مع Claude code؟». هذا الحجم واسع أكثر مما هو جاهز للشراء، لكن الالتباس في الإعدادات مباشر. ولا يحتاج المنتج الأولي سوى اكتشاف المصادر، والتحقق من الإصدار، وفحص JSON، وشرح السقف الأدنى الفائز.

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

3. مراقب لإنفاق Claude Code يراعي مستوى الجهد

ابنِ لوحة OpenTelemetry مركّزة تربط سمة effort المطبّقة بالتوكنز والتكلفة والنموذج ومصدر الاستعلام والمستودع وفحوص الجودة، سواء كان النشر عبر Anthropic أو مزودي الخدمات السحابية. ستدفع فرق FinOps وتجربة المطورين لقاء الربط بين السياسة والنتيجة، لا لقاء إجمالي آخر للتوكنز.

يحقق llm observability نحو 590 عملية بحث شهريًا في الولايات المتحدة، مع CPC يبلغ $37.45. وتؤكد الأسعار الحالية وجود بند في الميزانية: تبدأ Datadog Agent Observability مجانًا حتى 40,000 من امتدادات تتبّع LLM، بينما تبدأ خطة Pro من $160 شهريًا مقابل 100,000 امتداد. ويمكن أن تأتي النسخة الأولية المركزة في صورة إعداد مسبق لمجمّع OpenTelemetry، وجرد للسقوف، وثلاثة عروض: الجهد المطبّق، وتكلفة المهمة المقبولة، والتراجعات بعد تغيير نموذج أو سياسة.

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

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

ما الذي لا يحله سقف الجهد؟

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

كذلك لا يجعل السقف low آمنًا لكل مهمة برمجية. توصي Anthropic صراحة باختبار عبء العمل، كما تختلف معايرة اسم مستوى الجهد نفسه بين النماذج. فالتشغيل عند medium على نموذج ما ليس مقدارًا ثابتًا من الاستدلال يمكن مقارنته آليًا مع medium على نموذج آخر.

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

وأخيرًا، يؤكد /status الملفات التي جرى تحميلها، لا الملف الفائز لكل مفتاح. وفي الأتمتة، تمثل سمة القياس effort المطبّقة سجلًا أوضح.

ما الذي ينبغي تنفيذه يوم الاثنين؟

اختر الأسبوع المقبل مهمة روتينية واحدة في مستودع. سجّل خط أساس بلا سقف، وأضف سقفًا عند medium على مستوى المستخدم، ثم أضف استثناء Sonnet الموثق، وبعده ضع low في ملف المشروع المشترك. تأكد من المصادر المحمّلة ومستوى الجهد في ترويسة الجلسة، وكرر المهمة من عينة نظيفة مماثلة، ثم قارن جودة القبول قبل تكلفة /usage. إذا حافظت الجودة على مستواها، فانقل السقف المختبر إلى النطاق المشترك أو المُدار المناسب. وإذا فشل، فارفع السقف الأشد لذلك العبء أو أزله، واحتفظ بالأدلة.

إذا كنت تريد بناء سياسة للجهد وبوابة تقييم وقياس للتكلفة حول سير العمل الهندسي لديك، فتعرّف إلى أنظمة إنتاج AI.