شرح /checkup في Claude Code: تنظيف السياق، إصلاح التكوين، وتحسين سلامة الوكيل

مقدمة

اكتسب Claude Code أداة فحص إعدادات داخلية أكثر تطوراً. في الإصدار 2.1.205، وسعت Anthropic سير عمل /doctor الحالي ليتمكن من تشخيص مشكلات التكوين والمساعدة في إصلاحها. يتوفر /checkup كاسم مستعار لنفس سير العمل داخل الجلسة.

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

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

/checkup

يمكنك أيضاً استخدام الأمر التقليدي:

/doctor

فحص إعدادات بأمر واحد

وفقاً لسجل التغييرات في Claude Code 2.1.205، أصبح /doctor الآن فحصاً كاملاً للإعدادات يمكنه تشخيص وإصلاح المشكلات، بينما /checkup هو اسمه المستعار.

هذا يختلف عن أمر الجهاز المنفصل:

claude doctor

يقوم أمر الجهاز بطباعة تشخيصات التثبيت والإعدادات للقراءة فقط دون بدء جلسة تفاعلية. يمكن لسير عمل /doctor أو /checkup داخل الجلسة أن يذهب أبعد من ذلك من خلال اقتراح إصلاحات والسماح لـ Claude بتنسيق عملية التنظيف من خلال أدواته المتاحة.

وصف منشئ Claude Code، بوريس تشيرني، العديد من المهام التي صُمم الفحص للتعامل معها:

1. تنظيف المهارات غير المستخدمة، خواديم MCP، والإضافات.
2. إزالة التكرار من تعليمات CLAUDE.md المحلية مقابل تعليمات المشروع المودعة.
3. تقسيم ملف CLAUDE.md الجذري كبير الحجم إلى ملفات متداخلة ومهارات قابلة لإعادة الاستخدام.
4. تحديد وتعطيل الخطافات البطيئة.
5. تحديث Claude Code إلى أحدث إصدار متاح.
6. تمكين الوضع التلقائي افتراضياً عندما يكون مناسباً.
7. الموافقة المسبقة على أوامر القراءة فقط التي يتم رفضها بشكل متكرر.
8. اكتشاف مشكلات الإعداد الأخرى التي تجعل البيئة أبطأ أو أقل موثوقية.

يطلب الأمر التأكيد قبل إجراء التغييرات.

ما يراجعه الفحص فعلياً

1. المهارات غير المستخدمة، خواديم MCP، والإضافات

يمكن توسيع Claude Code بالمهارات والإضافات والخطافات وخواديم MCP. هذه التكاملات مفيدة، لكن الإعداد الناضج غالباً ما يراكم مكونات لم تعد

ذات صلة.

ربما تمت إضافة خادم MCP لتتبع مشكلات قديم. ربما تم إنشاء مهارة لسير عمل لم يعد الفريق يستخدمه. ربما لا يزال ملحق مفعّلاً رغم استبدال أوامره.

يمكن للفحص أن يكشف عن هذه المكونات غير المستخدمة ويقترح إزالتها أو تعطيلها.

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

2. تعليمات CLAUDE.md المكررة أو المفرطة الحجم

ملفات CLAUDE.md توفر تعليمات دائمة لـ Claude Code. يمكن أن تحتوي على أوامر البناء، اصطلاحات الترميز، الملاحظات المعمارية، متطلبات الاختبار، وقواعد خاصة بالمشروع.

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

مع مرور الوقت، قد يطور المشروع عدة مشكلات شائعة:

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

يمكن للفحص مقارنة التعليمات المحلية وتعليمات المشروع، وتحديد التكرار، واقتراح هيكل أكثر تركيزًا.

قد يبدو التخطيط العملي على النحو التالي:

project/
├── CLAUDE.md
├── .claude/
│   ├── rules/
│   │   ├── frontend.md
│   │   ├── backend.md
│   │   └── testing.md
│   └── skills/
│       └── release/
│           └── SKILL.md
└── packages/
    └── api/
        └── CLAUDE.md

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

3. الروابط البطيئة أو الزائدة عن الحاجة

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

يكون الرابط مفيدًا فقط عندما تبرر قيمته تكلفته. قد يتسبب برنامج نصي يضيف ثانيتين أو ثلاث ثوانٍ لكل استدعاء أداة في تأخير كبير خلال جلسة طويلة.

يمكن للفحص أن يساعد في تحديد الروابط التي:

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

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

4. مشكلات التثبيت والتحديث

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

للتحقق من الإصدار المثبت يدويًا، استخدم:

claude --version

تعتمد طريقة التحديث الدقيقة على كيفية تثبيت Claude Code.

قد تقوم عمليات النشر المُدارة للمؤسسات بتثبيت إصدار معين عمدًا، لذا لا ينبغي للمستخدمين تجاوز سياسة المؤسسة لمجرد وجود إصدار أحدث.

5. طلبات متكررة لأذونات القراءة فقط

يستخدم Claude Code نظام أذونات يفصل بين عمليات الفحص منخفضة المخاطر والإجراءات التي تُعدّل البيئة.

تنص وثائق الأمان الخاصة بـ Anthropic على أن مجموعة مدمجة من أوامر القراءة فقط، بما في ذلك أوامر مثل ls و cat و git status، يمكن تشغيلها دون طلب إذن. أما الأوامر التي تعدّل الملفات، أو تشغيل عمليات Bash التي قد تُحدث تعديلات، أو الوصول إلى أنظمة إضافية، فقد تتطلب موافقة.

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

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

لماذا الحفاظ على السياق أمر مهم

يجب على وكيل البرمجة الذكي استيعاب عدة أنواع من المعلومات في سياق عمل واحد:

• المحادثة الحالية.
• ملفات المصدر ذات الصلة.
• نتائج الأدوات ومخرجات الأوامر.
• تعليمات CLAUDE.md.
• أوصاف المهارات.
• تعريفات أدوات MCP.
• الخطط، حالة المهام، والنتائج الوسيطة.

نافذة السياق محدودة. وجود كمية كبيرة من معلومات الإعداد غير ذات الصلة قد يترك مساحة أقل للمشكلة الفعلية.

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

لذلك، تحتاج التهيئة السليمة إلى نفس نوع الصيانة الذي يحتاجه مشروع برمجي:

1. إزالة ما لم يعد مستخدمًا.
2. إبقاء التعليمات العامة قصيرة.
3. نقل الإجراءات المتخصصة إلى ملفات أو مهارات محدودة النطاق.
4. تدقيق عمليات التكامل والأذونات.
5. قياس تكلفة الخطافات (hooks).
6. مراجعة التهيئة بعد التغييرات الكبرى في المشروع.

من التشخيص إلى التنظيف المُساعد

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

يتبع الفحص المُحسّن داخل الجلسة نمطًا أكثر وكالة (agentic):

1. فحص البيئة الحالية.
2. تحديد المشكلات المحددة.
3. تقدير فائدة التنظيف.
4. عرض التغييرات المقترحة.
5. السماح للمستخدم باختيار التنظيف الكامل، أو إصلاحات محددة، أو خيار التقرير فقط.
6. تطبيق التغييرات المعتمدة فقط.
7. ترك تعديلات الملفات مرئية للمراجعة.

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

خطوة الموافقة مهمة. لا ينبغي للأداة

إزالة مهارة مشروع بصمت، أو إعادة كتابة ملفات التعليمات، أو تغيير سلوك الإذن لمجرد أنها ترى أن الإعداد غير فعال.

## تحسينات السلامة حول الأوامر المستقلة

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

### الحماية ضد الموافقة المزيفة في سجلات الجلسة

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

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

### تأكيد إضافي لأوامر `rm -rf` الخطيرة

يسجل سجل التغييرات أيضًا تحسينًا في الوضع التلقائي: يسأل Claude Code قبل تشغيل `rm -rf` عندما يحتوي المسار على متغير لا يمكنه حله من السياق.

مثال خطير هو:

```Bash
rm -rf "$TARGET_DIR/"

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

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

الاستقلالية تحتاج إلى حدود

يجمع الإصدار بين هدفين قد يبدوان متعارضين:

• تقليل المقاطعات غير الضرورية للعمل الروتيني للقراءة فقط.
• إضافة تأكيد أقوى حول الإجراءات غير المؤكدة أو المدمرة.

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

/doctor و /checkup و claude doctor

الأسماء المتشابهة يمكن أن تكون مربكة.

الأمر	مكان التشغيل	الغرض الرئيسي	هل يمكنه اقتراح أو تطبيق إصلاحات؟
/doctor	داخل جلسة Claude Code	فحص كامل للإعداد	نعم
/checkup	داخل جلسة Claude Code	اسم مستعار لـ /doctor	نعم
claude doctor	الطرفية، دون فتح جلسة	تشخيصات التثبيت والإعدادات للقراءة فقط	لا

بالنسبة لمعظم المستخدمين الذين يريدون من Claude فحص الإعداد النشط والمساعدة في تنظيفه، فإن /doctor أو /checkup هو الأمر المناسب.

بالنسبة للبرامج النصية، أو فحوصات الدعم، أو تشخيصات التثبيت السريعة خارج الجلسة، فإن claude doctor هو الأكثر ملاءمة.

طريقة آمنة لتشغيل /checkup

الخطوة 1: التحقق من حالة المستودع الحالية

قبل السماح لأداة بتعديل ملفات التكوين، تأكد من أن العمل الهام قد تم تسليمه أو نسخه احتياطيًا.

git status

راجع الملفات غير المسلمة وتجنب خلط تغييرات التعليمات البرمجية غير ذات الصلة بتنظيف التكوين.

الخطوة 2: بدء Claude Code في المشروع المقصود

cd /path/to/project
claude

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

الخطوة 3: تشغيل الفحص

/checkup

اقرأ التقرير قبل قبول التغييرات.

الخطوة 4: اختيار النطاق

اعتمادًا على ما يكتشفه Claude

بناءً على النتائج، قد تعرض الواجهة خيارات مثل:

- تطبيق التنظيف الموصى به.
- تحديد فئات فردية.
- الاحتفاظ بالإعدادات الحالية وإنشاء تقرير.
- مناقشة توصية قبل اتخاذ القرار.

يُفضّل التنظيف الانتقائي عندما يحتوي المستودع على أدوات داخلية مخصصة أو تكوين فريق مشترك.

### الخطوة 5: مراجعة التغييرات

بعد تغيير ملفات التكوين، قم بفحصها:

```Bash
git diff

انتبه بشكل خاص إلى:

• ملفي CLAUDE.md و CLAUDE.local.md.
• الملفات الموجودة داخل .claude/.
• تعريفات الخطافات (hooks).
• إعدادات الإضافات (plugins).
• تكوين MCP.
• قواعد الأذونات.
• أي مهارات تم إنشاؤها.

الخطوة 6: اختبار سير عمل طبيعي

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

الخطوة 7: تنفيذ التنظيف في عملية تأكيد منفصلة

عند تغيير تكوين المشروع المشترك، استخدم عملية تأكيد مركزة (focused commit) ليتمكن زملاء الفريق من مراجعتها وتراجع عنها بشكل مستقل.

git add CLAUDE.md .claude/
git commit -m "chore: تنظيف تكوين Claude Code"

اضبط المسارات لتتناسب مع الملفات التي تم تغييرها فعلياً.

متى لا تقبل التنظيف التلقائي فوراً

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

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

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

الأسئلة الشائعة

ما هو أمر /checkup في Claude Code؟

/checkup هو اسم مستعار لسير العمل الموسع /doctor داخل الجلسة الذي تم تقديمه في Claude Code 2.1.205. يقوم بتدقيق مشكلات الإعداد ويمكنه اقتراح إصلاحات للتكوين والسياق والتكاملات والخطافات وحالة التثبيت والمشكلات ذات الصلة.

هل /checkup يختلف عن /doctor؟

في إصدارات Claude Code الحالية، /checkup هو اسم مستعار لـ /doctor. كلاهما يستدعي نفس الفحص الكامل للإعداد داخل جلسة Claude Code التفاعلية.

هل claude doctor هو نفسه /doctor؟

لا. claude doctor يُشغّل من الطرفية ويطبع تشخيصات التثبيت والإعداد للقراءة فقط دون فتح جلسة. بينما يمكن لأمر الشرطة المائلة (slash command) تنسيق الإصلاحات بعد طلب الموافقة.

هل يمكن لـ /checkup حذف المهارات أو خوادم MCP تلقائياً؟

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

لماذا يؤثر ملف CLAUDE.md الكبير على Claude Code؟

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

هل يجب نقل كل الإجراءات من CLAUDE.md؟

لا. ا

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

هل يجعل أمر /checkup الوضع التلقائي آمنًا تمامًا؟

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

كم مرة يجب تشغيل أمر الفحص (setup checkup)؟

لا يوجد جدول زمني محدد. يكون مفيدًا بعد تغييرات التكوين الرئيسية، أو عندما يصبح أداء Claude Code أبطأ أو أقل اتساقًا، أو بعد إضافة عدة تكاملات، أو كجزء من مراجعة دورية لصيانة المشروع.

أدوات ذات صلة

• Claude Code: أداة الترميز الوكيلة من Anthropic للطرفيات، وبيئات التطوير المتكاملة، وسطح المكتب، والويب.
• مهارات Claude Code: أنشئ إجراءات قابلة لإعادة الاستخدام وحسب الطلب لتوسيع قدرات Claude Code.
• بروتوكول سياق النموذج في Claude Code: اربط Claude Code بالأدوات الخارجية وواجهات برمجة التطبيقات وقواعد البيانات والخدمات.
• خطافات Claude Code: قم بتشغيل أتمتة حتمية في نقاط محددة من دورة حياة الوكيل.
• إضافات Claude Code: قم بتجميع وتوزيع المهارات والوكلاء والخطافات وتكاملات MCP.
• حزمة تطوير وكيل Claude: قم ببناء وكلاء قابلين للبرمجة باستخدام نفس الأدوات الأساسية وحلقة الوكيل التي يستخدمها Claude Code.

روابط ذات صلة

• سجل تغييرات Claude Code: سجل الإصدارات الرسمي، بما في ذلك تغييرات إعداد الفحص في الإصدار 2.1.205.
• مرجع أوامر Claude Code: مرجع للأوامر المدمجة التي تبدأ بالشرطة المائلة والمهارات المجمعة.
• مرجع واجهة سطر أوامر Claude Code: المرجع الرسمي لأوامر الطرفية وعلامات واجهة سطر الأوامر.
• كيف يتذكر Claude مشروعًا: إرشادات لهيكلة وصيانة ملفات CLAUDE.md.
• أمان Claude Code: سلوك الأذونات، والعزل، وضوابط الموافقة، وإرشادات السلامة.
• إعدادات Claude Code: نطاقات التكوين، والإعدادات المُدارة، والإضافات، وسياسات MCP، وضوابط نظام الملفات.
• استكشاف أخطاء Claude Code وإصلاحها: إرشادات التشخيص والاسترداد الرسمية.
• أتمتة الإجراءات باستخدام الخطافات: إرشادات عملية لإنشاء ومراجعة خطافات دورة الحياة.

ملخص

يقوم الإصدار Claude Code 2.1.205 بتحويل أمر /doctor إلى سير عمل أوسع لصيانة الإعدادات، ويُضيف /checkup كاسم مستعار له. يمكن للأمر فحص الإضافات غير المستخدمة، والتعليمات المكررة، وملفات CLAUDE.md كبيرة الحجم، والخطافات البطيئة، ومشكلات التثبيت،

وسلوك الإذن المتكرر.

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

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

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