شجرة عمل Claude Code — عزل Git حتى لا يتعارض الوكلاء المتوازون
اعتبارًا من 2026-10-20، يعزل Claude Code الجلسات المتوازية باستخدام أشجار عمل git: ينشئ claude --worktree feature-auth شجرة تحت .claude/worktrees/ على الفرع worktree-feature-auth؛ ويمكن للوكلاء الفرعيين تعيين isolation: worktree. ويعتمد التنظيف عند الخروج على ما قد يُفقد.
ما شجرة العمل ولماذا تهم
شجرة عمل git هي دليل عمل منفصل بملفاته وفرعه الخاص، ويشترك في تاريخ المستودع والـ remote نفسه مع checkout الرئيسي. يشغّل Claude Code كل جلسة متوازية في شجرة عمل خاصة بها: claude --worktree feature-auth (أو -w) ينشئ المسار .claude/worktrees/feature-auth/ في جذر المستودع على الفرع worktree-feature-auth. تكتب الجلسة A الميزة X وتصلح الجلسة B الخلل Y دون أن تلمس إحداهما ملفات الأخرى.
أداة EnterWorktree وإعداد isolation
يمكنك أيضًا أن تطلب من Claude العمل داخل شجرة عمل أثناء الجلسة؛ فينشئ واحدة باستخدام أداة EnterWorktree. قبل الدخول إلى مسار خارج دليل .claude/worktrees/ الخاص بالمستودع، يطلب Claude Code موافقتك؛ وقبل v2.1.206، كان Claude يستطيع الدخول إلى أي مسار شجرة عمل موجود دون سؤال. ويمكن لوكيل فرعي مخصص إضافة isolation: worktree إلى frontmatter الخاص به كي تحصل كل عملية إرسال على شجرة عمل مؤقتة. أضف .claude/worktrees/ إلى .gitignore، واستخدم .worktreeinclude لنقل .env والملفات المتجاهلة الأخرى إلى أشجار العمل الجديدة.
أشجار عمل الوكلاء الفرعيين والوكلاء المتوازون
يمكن للوكلاء الفرعيين العمل في أشجار العمل الخاصة بهم: اطلب من Claude استخدام أشجار العمل لوكلائك، أو أضف isolation: worktree إلى وكيل فرعي مخصص. يحصل كل وكيل فرعي على شجرة عمل مؤقتة تُزال تلقائيًا عندما ينتهي دون تغييرات؛ أما التي لديها تغييرات فتبقى على القرص إلى أن يستطيع الفحص الدوري إزالتها دون فقدان العمل. مثال: ثلاثة وكلاء يعيدون كتابة المصادقة، ويضيفون اختبارات وحدة، ويكتبون ترحيلات في الوقت نفسه — لا تتصادم تعديلات الملفات أبدًا، ثم تدمج في النهاية. عند الخروج، يتحقق Claude من وجود عمل: تُزال الجلسة النظيفة غير المسماة تلقائيًا، وتطالبك الجلسة التي بها تغييرات بالاحتفاظ بها أو إزالتها، ولا تُنظف تشغيلات -p تلقائيًا.
التنظيف التلقائي، المزالق الشائعة، اتفاقيات الفريق
عند خروجك من جلسة شجرة عمل تفاعلية، يتحقق Claude من الملفات المتغيرة أو غير المتتبعة وعمليات commit الجديدة: تُزال الجلسة النظيفة غير المسماة تلقائيًا، وتسأل الجلسة المسماة أولًا، وتسأل التي بها تغييرات عما إذا كان ينبغي الاحتفاظ بها أو إزالتها؛ ولا تُنظف تشغيلات -p تلقائيًا. المزالق الشائعة: 1) تعارض أسماء الفروع بين الوكلاء؛ 2) بقاء أشجار عمل الوكلاء الفرعيين ذات التغييرات على القرص إلى أن يجري الفحص الدوري؛ 3) نسيان إضافة .claude/worktrees/ إلى .gitignore. ينبغي أن تتفق الفرق على بادئة فرع ثابتة (مثل wt/agent-<name>-<ts>) لتجنب التعارضات.
FAQ
كيف تختلف شجرة العمل عن فرع git عادي؟
الفرع مؤشر إلى commit؛ والتبديل إليه يعني إجراء checkout يستبدل الملفات. أما شجرة العمل فهي دليل عمل منفصل، لذا يمكن إجراء checkout لعدة فروع في مسارات فعلية مختلفة في الوقت نفسه. وهذا شرط أساسي لتشغيل الوكلاء على التوازي.
هل تلوث أشجار عمل الوكلاء الفرعيين المستودع الرئيسي؟
لا. يحصل كل وكيل فرعي على شجرة عمل مؤقتة؛ ويتتبع git أشجار العمل تحت .git/worktrees/<id>. تُزال شجرة عمل الوكيل الفرعي التي لا تتضمن تغييرات تلقائيًا؛ أما التي تتضمن تغييرات فتبقى إلى أن تتمكن عملية المسح من إزالتها دون فقدان العمل، لذا تبقى نسخة العمل الرئيسية نظيفة.
هل يمكنني استخدام أشجار العمل مع Claude Code من الصين؟
نعم. أشجار العمل ميزات محلية في git وفي عميل Claude Code؛ ويمر استدلال النموذج عبر نقطة نهاية QCode التي أعددتها. تتطلب أشجار العمل مستودع git؛ وبالنسبة إلى أنظمة التحكم في الإصدارات الأخرى، اضبط خطافات WorktreeCreate وWorktreeRemove لاستبدال منطق git.
شغّل وكلاء Claude Code المتوازين عبر QCode
يمر استدلال النموذج عبر نقطة نهاية API الخاصة بـ QCode؛ وتعمل أشجار العمل محليًا، لذا تستخدم الجلسات المتوازية الأوامر أعلاه فقط.
ابدأ خطة QCode الخاصة بك