وضع التخطيط في Claude Code: راجع خطتك قبل تعديل الكود

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

ما الذي يتيحه وضع التخطيط في Claude Code اليوم؟

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

لكن هناك استثناء مهم تنص عليه الوثائق: في جلسة طرفية تفاعلية تتيح تجاوز الصلاحيات، لا تُطبّق قيود وضع التخطيط. تظل تعليمات Claude تقضي بالتخطيط، لكن محاولة تعديل الملفات قد تُنفّذ. ويشمل ذلك إتاحة التجاوز عبر --allow-dangerously-skip-permissions، حتى إن لم تختره وضعًا نشطًا. إذا كان هدفك منع تعديل ملفات المصدر إلى أن توافق، فابدأ من دون إتاحة التجاوز. قواعد أوضاع الصلاحيات لدى Anthropic.

تتكامل آلية التخطيط مع نظام الصلاحيات. توضّح الخطة ما ينوي Claude تغييره، بينما يحدد وضع الصلاحيات الإجراءات التي يمكن تنفيذها من دون سؤالك.

كيف تدخل وضع التخطيط وتخرج منه؟

لبدء جلسة طرفية في وضع التخطيط مباشرةً:

claude --permission-mode plan

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

بدءًا من auto، تنتقل الدورة إلى default، أي الوضع اليدوي (Manual)، ثم acceptEdits، ثم plan. وبعدها تأتي الأوضاع الاختيارية المتاحة: تجاوز الصلاحيات أولًا، وauto أخيرًا. وعلى Windows، توثّق Anthropic الاختصار Alt+M بوصفه البديل عندما لا تفعّل بيئة تشغيل Node أو Bun وضع إدخال VT. التبديل بين الأوضاع، مرجع اختصارات لوحة المفاتيح، مرجع الأوامر.

عندما يعرض Claude خطته، تتيح لك نافذة الموافقة الخيارات التالية:

• اختيار No, keep planning، أي متابعة التخطيط، مع تقديم تصحيحات محددة.
• اختيار Yes, manually approve edits للموافقة على النهج مع مراجعة كل تعديل على حدة.
• اختيار Yes, and use auto mode للموافقة والمتابعة في الوضع التلقائي، إن كان متاحًا.

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

هل تستخدم واجهة محرر؟ في VS Code، انقر مؤشر الوضع أسفل مربع الإدخال واختر Plan. وفي تبويب Code بتطبيق Desktop، استخدم محدد الوضع بجوار Send. أما JetBrains فيستخدم عناصر تحكم CLI داخل الطرفية. ويسجّل سجل التغييرات أيضًا دعم كتابة /plan في VS Code بدءًا من v2.1.280. عناصر التحكم في الواجهات، سجل التغييرات الرسمي.

إعدادات يجدر بك معرفتها

لبدء جلسات الطرفية الخاصة بمشروعك في وضع التخطيط، ادمج الإعداد التالي في .claude/settings.json:

{
  "permissions": {
    "defaultMode": "plan"
  }
}

أما إذا أردته الوضع الافتراضي لجلسات الطرفية على مستوى حساب المستخدم، فاستخدم ~/.claude/settings.json. تتقدم راية التشغيل على الإعدادات، ويمكن لإعدادات المشروع أو الإعدادات المُدارة تجاوز الوضع الافتراضي الذي حددته لحسابك. ولـVS Code إعداد مستقل عند بدء التشغيل: ضع "claudeCode.initialPermissionMode": "plan" ضمن إعدادات المستخدم في VS Code. لا تقرأ الإضافة إعدادات المشروع لتحديد وضع الصلاحيات عند البدء. ضبط وضع بدء التشغيل.

توضع المفاتيح الإضافية التالية في المستوى الأعلى من إعدادات Claude Code، خارج permissions:

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

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

ما علاقة وضع التخطيط بالوضع التلقائي؟

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

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

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

تحدد الوثائق الحالية auto بوصفه وضع البدء المضمّن لجلسات الطرفية التفاعلية وVS Code بدءًا من v2.1.283، مع مراعاة قواعد الإعدادات والمؤسسة والتوافر. لذلك يظل تحديد وضع التخطيط صراحةً عند بدء التشغيل مهمًا. القواعد الحالية لوضع البدء.

قد تُغفل الإرشادات القديمة تغييرات مؤثرة. يسجّل سجل تغييرات Anthropic إضافة وسيط الوصف إلى /plan في v2.1.72، وإخفاء خيار مسح السياق افتراضيًا في v2.1.81، وإسناد تقييم أوامر Bash غير المؤكد اقتصارها على القراءة إلى المصنّف أثناء التخطيط مع auto في v2.1.218. سجل التغييرات الرسمي.

مثال تطبيقي: توحيد منطق التسعير مع الحفاظ على المبالغ المحصّلة

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

ادخل وضع التخطيط وحدد القيد الفعلي:

لنفترض أن ملفات المشروع المعنية هي التالية:

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

عدّل الخطة قبل قبولها. اضغط Ctrl+G عند المراجعة، واستبدل خطوة الحذف المبكر بالتعديل التالي:

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

يفترض أن تصبح الخطة المعدّلة الآن سلسلة خطوات قابلة للتنفيذ:

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

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

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

متى يكون البدء بالتخطيط أكثر فائدة؟

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

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

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

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

ما المنتجات التي تستحق البناء حول هذا الأسلوب؟

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

تشير تقديرات الكلمات المفتاحية للسوق الأمريكية من DataForSEO، التي جرى جلبها في 12 أكتوبر 2026، إلى أن عبارة “code refactoring tools” تسجل 170 عملية بحث شهريًا. هذه إشارة محدودة إلى الاهتمام بالمهمة، وليست دليلًا على استعداد الباحثين لشراء منتج لمراجعة الخطط. يمكن لأصغر نسخة مفيدة من المنتج أن تستقبل خطة مُصدّرة وخريطة لملفات المستودع، وتبحث عن جهات استدعاء مفقودة أو افتراضات غير مسندة، ثم تنتج موجزًا لطلب سحب. لكن التحدي أن توليد الخطط العامة متاح أصلًا ضمن Claude Code. ولكي يستحق المنتج مكانه، يحتاج إلى فحوص خاصة بالفريق ومخرج مراجعة مفيد.

هناك فرصة أضيق نطاقًا هي حزمة لتقييم جاهزية الترحيل لدى الوكالات: إعداد قائمة بالمكونات المتأثرة، وقائمة تحقق للطرح المرحلي، وقائمة بالقرارات العالقة، قبل تسعير عملية الترقية. ويقدّر فحص DataForSEO نفسه 20 عملية بحث شهرية في الولايات المتحدة عن “code migration tools.” ضآلة حجم هذا الاستعلام ذي النية التجارية تدعو إلى اختبار الفكرة مع العملاء الحاليين قبل بناء منتج واسع النطاق.

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

لم يعد Ultraplan متاحًا

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

أسئلة قد تطرحها قبل جلستك التالية

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

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