زيادة حد مخرجات Claude Code: متى ترفع الحد ومتى تقرأ الملف؟

الخلاصة السريعة

وصل عنصرا التحكم الجديدان في Claude Code 2.1.261 بتاريخ 4 سبتمبر 2026. وهما يعالجان مشكلة محددة: نُفِّذ الأمر، والدليل موجود، لكن الجزء الذي وصل منه إلى النموذج داخل الجلسة كان أصغر من اللازم.

هذه حدود لعدد الأحرف، وليست حدودًا للرموز المميزة (tokens). تخيّلها كسعة نافذة تمر عبرها النتائج: توسيع النافذة يمنح Claude جزءًا أكبر من السجل دفعة واحدة، لكن كل سطر إضافي يعبرها يشغل بدوره مساحة من سياق الجلسة.

استعد المخرجات المفقودة أولًا

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

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

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

# Baseline: run the command normally and observe where its inline result stops
npm test

# Recovery for a failing run: keep the whole log at a path Claude can inspect
mkdir -p .claude/logs
test_status=0
npm test > .claude/logs/test-full.log 2>&1 || test_status=$?
wc -c .claude/logs/test-full.log
tail -n 120 .claude/logs/test-full.log
printf 'test exit code: %s\n' "$test_status"

يصبح الملف .claude/logs/test-full.log عندئذ المرجع المعتمد. اطلب من Claude البحث فيه عن أسماء الاختبارات الفاشلة والاستثناءات وتتبع المكدس، بدل لصق الملف كاملًا في المحادثة. كما تُبقي هذه الطريقة رمز الخروج الأصلي ظاهرًا بوصفه دليلًا.

تعرض أوامر الخلفية أصلًا مسار الملف الذي تكتب إليه عند انتقالها إلى الخلفية. وتصف Anthropic الآن TaskOutput بأنه مهمل، وتوصي باستخدام Read على مسار المخرجات؛ وهو غالبًا الأسلوب الأنظف لاستعادة النتائج.

كيفية زيادة حد مخرجات Claude Code بأقل تعديل مفيد

إذا كان الأمر الناجح نفسه يحتاج باستمرار إلى أكثر من النافذة الافتراضية، فارفع bashOutputMaxChars وحده. والبدء عند 60,000 حرف يضاعف السعة الافتراضية داخل الجلسة تقريبًا، من دون القفز إلى السقف الكامل البالغ 128,000 حرف:

{
  "bashOutputMaxChars": 60000
}

ضع هذا الكائن في النطاق الذي يناسب المشكلة:

شغّل /status للتأكد من الملف الذي حمّله Claude Code. ثم أعد تشغيل الأمر نفسه، وقارن عدد الأحرف الذي يعرضه wc -c بالقيمة التي اخترتها. وإذا ظل السجل أكبر منها، فمن المفترض أن يقدّم Claude Code مجددًا معاينة ومسارًا للملف المحفوظ عند نجاح الأمر.

استخدم taskOutputMaxChars بدلًا منه لمهام الخلفية. وينطبق عليه النطاق نفسه، من 4,000 إلى 128,000 حرف. وإذا ظلت مخرجات المهمة المكتملة تتجاوز الحد، يتلقى Claude أحدث الأحرف؛ لذلك يبقى ملف المخرجات المرجع الموثوق لفحص السجل كاملًا.

يتجاوز كلٌّ من الإعدادين متغير البيئة الأقدم المقابل له. فعند وجود bashOutputMaxChars، يتجاهل Claude Code المتغير BASH_MAX_OUTPUT_LENGTH. وعند وجود taskOutputMaxChars، يتجاهل TASK_MAX_OUTPUT_LENGTH. الجمع بين آليتي التحكم يصعّب استكشاف المشكلات، لذا اعتمد مرجعًا واحدًا للإعداد.

تكلفة السياق تنتقل ولا تختفي

قد يؤدي رفع حد أمر ناجح من القيمة الافتراضية البالغة نحو 30,000 حرف إلى 60,000 إلى الاستغناء عن خطوة منفصلة لقراءة الملف، إذا كانت النتيجة كاملة تناسب هذا الحد. لكنه قد يضيف أيضًا ما يصل إلى نحو 30,000 حرف إلى الجلسة فورًا. وعند 128,000 حرف، تصبح النافذة المسموح بها أكبر بقليل من أربعة أمثال نافذة الأمر الناجح الافتراضية.

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

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

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

سبعة مسارات عمل تستفيد من الإعداد، مرتبة حسب الأولوية

1. ملخصات اختبارات المستودع البرمجي الموحّد (Monorepo)

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

2. بيئات التكامل العاملة في الخلفية

قد يترك فريق المنصة خادمًا محليًا أو محاكيًا أو بيئة تكامل تعمل كمهمة في الخلفية بينما يعمل Claude في موضع آخر. ويتيح رفع taskOutputMaxChars لـ Claude تلقّي قدر أكبر من أحدث المخرجات عند فحص المهمة. ومع ذلك يظل ملف المهمة الكامل مهمًا، لأن الإعداد يفضّل الأحرف الأحدث بعد تجاوز الحد.

3. مراجعة تحذيرات المترجمات وأدوات التدقيق

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

4. التشغيل التجريبي لترحيلات قواعد البيانات

قد يشغّل مهندس بيانات تجربة ناجحة تطبع كل إجراء مقترح على المخطط. وإبقاء خطة محدودة الحجم داخل الجلسة يتيح لـ Claude مقارنة التغييرات المترابطة في نتيجة واحدة. الفائدة هي استمرارية المراجعة، ولكن بعد استبعاد الأسرار ومعرّفات الإنتاج من السجل فقط.

5. تدقيق التبعيات والتراخيص

قد يتلقى مهندس أمن قائمة جرد ناجحة وطويلة تتوزع نتائجها على الجزء الأوسط. ويمكن لحد Bash خاص بالمستودع أن يجعل التقرير المحدود كاملًا متاحًا خلال جلسة تدقيق واحدة. والعائد هو تقليل احتمال اختفاء حزمة لمجرد وقوعها خارج المعاينة.

6. التحقيق في الاختبارات المتقطعة

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

7. مولدات الشيفرة كثيرة المخرجات

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

لمن لم يعتد بعد بنية ملفات الإعدادات، يشرح دليل إعداد Claude Code الأشمل موضع الأداة في سير العمل قبل ضبط هذه الحالة الطرفية.

ما الذي يستحق البناء؟

الفرصة الأفضل: وسيط سجلات واعٍ بالسياق

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

الطلب المجاور صغير، لكنه واضح تجاريًا. تقدّر بيانات الكلمات المفتاحية في الولايات المتحدة 320 عملية بحث شهريًا عن log analyzer، بقصد شرائي وتكلفة نقرة تبلغ $60.95. وتؤكد ميزانيات أدوات المراقبة القائمة أن للسجلات مشترين بالفعل: تعرض Better Stack باقة بسعة 40 GB للسجلات والتتبعات والمقاييس مقابل $25 شهريًا عند الدفع السنوي، إضافة إلى محادثة AI SRE مقابل $5 لكل مليون رمز مميز. تعالج تلك المنتجات مهمة أوسع، لكن هذا الإنفاق دليل على أن الفرق تدفع مقابل استخلاص الإشارة من السجلات.

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

فرصة متخصصة: أداة لتجميع أدلة الاختبارات

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

تحصل عبارة البحث test failure analysis على ما يُقدّر بـ20 عملية بحث شهريًا في الولايات المتحدة، مع منافسة منخفضة ودرجة صعوبة للكلمة المفتاحية تبلغ 11. لا يكفي هذا الطلب لتسويق خدمة SaaS مستقلة وواسعة، لكنه يكفي لتبرير ميزة مركزة داخل وسيط السجلات أو أداة مدفوعة للفرق ذات حزم الاختبار المكلفة.

تحتاج النسخة الأولية إلى موائمين أو ثلاثة لأدوات التشغيل، وتخزين حتمي للسجل الخام، وعرض متجاور للدليل المستخرج وأسطر المصدر. أما التحدي فهو التجزؤ: تنسق Jest وPytest وGradle وأدوات التشغيل المخصصة حالات الفشل بطرق مختلفة، وقد يحذف مستخرج مفرط في ثقته القرينة التي احتاج إليها Claude. لذا يجب أن يظل الملف الخام متاحًا بعملية قراءة واحدة دائمًا.

متى لا يفيد هذا الإعداد؟

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

كذلك لا يجعل المخرجات غير المحدودة آمنة. فمخرجات الأمر الناجح التي يحفظها Claude Code تُقتطع بعد 64 MiB، ويُوقَف الأمر قسرًا إذا تجاوزت مخرجاته المتدفقة 5 GB. والأهم أن نتيجة بحجم 128,000 حرف داخل الجلسة قد تزاحم سياق المحادثة المفيد. الحد الأقصى حاجز أمان، وليس توصية.

وتضيف الجلسات السحابية فخًا متعلقًا بالنطاق. فهي تقرأ ملف .claude/settings.json المودع في المستودع، لكنها لا تقرأ إعدادات المستخدم أو الإعدادات المحلية على جهازك. ولا تصل إليها سوى إعدادات المؤسسة المُدارة على الخادم. إذا بدا أن قيمة ما يجري تجاهلها، فتحقق عبر /status قبل تغييرها مرة أخرى.

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