صلاحيات Claude Code: متى تستخدم --dangerously-skip-permissions؟

ما الذي يعطّله خيار تجاوز صلاحيات Claude Code فعليًا؟

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

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

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

ما الضوابط التي تظل سارية رغم التجاوز؟

كلمة «تجاوز» لا تعني اختفاء جميع الضوابط. وتظهر أهمية الفروق التالية حين تتوقف جلسة يُفترض أنها تعمل بلا إشراف، أو ترفض تنفيذ إجراء:

الإعداد الدقيق للقراءة في الصف الأخير هو permissions.blockReadsOutsideWorkingDirectories: true. وقد تستمر أوامر Bash المعروفة بقراءة الملفات في طلب الموافقة عند القراءة خارج المجلدات المسموح بها؛ أما المنع الذي تفرضه بيئة العزل فله سلوك مختلف. وعند تشغيل وضع التجاوز بصورة غير تفاعلية باستخدام -p، تُرفض الاستدعاءات التي لا تزال تتطلب موافقة بدلًا من عرض الطلب. الإجراءات التي لا يوافق عليها أي وضع تلقائيًا، إعداد القراءة خارج مجلدات العمل

وتظل خطافات PreToolUse التي تمنع التنفيذ جزءًا من عملية الموافقة على الأدوات. وهناك استثناء خاص بـEndConversation: لا تقيّده قواعد المنع وطلب الموافقة ما دامت أداة أخرى متاحة. ويمكن لوحدات التعديل (mods) المثبّتة أن تتجاوز بعض قرارات الصلاحيات التي لا تفرضها الإدارة، لذا ينبغي وضع ضوابط الفريق الإلزامية ضمن السياسة المُدارة. ويستطيع المسؤولون حظر وضع التجاوز باستخدام "permissions": {"disableBypassPermissionsMode": "disable"}. كذلك ترفض الجلسة التي تبدأ بالخيار --restricted هذا الوضع. أولوية الخطافات والقواعد، إعداد تعطيل وضع التجاوز

وضع التجاوز يسمح بالكتابة في المسارات المحمية

لا تفترض أن الكتابة في .git أو .claude ستظل تتطلب تأكيدًا. يسمح وضع التجاوز بالكتابة في المسارات المحمية. وهذه مسألة تختلف عن فحوص حذف المجلدات الحساسة المذكورة أعلاه.

تشمل قائمة المسارات المحمية لدى Anthropic ما يلي:

توجد استثناءات محددة داخل .claude، منها أشجار العمل الخاصة بـClaude، وملفات الخطط الحالية، ومساحة الملفات المؤقتة لجلسات الخلفية، وبعض ملفات الذاكرة بصيغة Markdown. في الجلسات المعتادة بالوضع اليدوي Manual ووضع acceptEdits، تتطلب الكتابة في المسارات المحمية موافقة؛ أما الوضع التلقائي فيحيلها إلى نموذج التصنيف. ولا يمكن لقاعدة سماح في ملف الإعدادات أن تمنح هذه الكتابات موافقة مسبقة. المسارات المحمية واستثناءاتها

أربع طرق أكثر أمانًا لتقليل المقاطعات

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

استخدم الوضع التلقائي لأعمال البرمجة المعتادة

ابدأ جلسة بالأمر claude --permission-mode auto. يتولى نموذج تصنيف، وهو نموذج منفصل يراجع الإجراءات المقترحة، قرارات الموافقة المعتادة. ولجعله الوضع الافتراضي الدائم في الطرفية، ادمج "permissions": {"defaultMode": "auto"} في ~/.claude/settings.json.

وضع هذه القيمة في .claude/settings.json أو .claude/settings.local.json لا يفعّلها. كما يعتمد الوضع التلقائي على النماذج المدعومة وإعدادات المؤسسة، وتظل قواعد طلب الموافقة الصريحة تعرض طلباتها. فهو يقلل المقاطعات من دون أن يضمن الأمان. إعداد الوضع الافتراضي، متطلبات الوضع التلقائي

يوضح دليلنا للوضع التلقائي في Claude Code متى يلائم نموذج المراجعة هذا سير عملك.

اسمح بالمهام المعتادة وامنع إجراءات بعينها

استخدم permissions.allow للأوامر التي راجعتها، وpermissions.deny للعمليات التي تريد حظرها. يفحص Claude Code قواعد المنع أولًا، ثم طلب الموافقة، ثم السماح. ولا تستطيع قاعدة سماح واسعة إلغاء قاعدة منع مطابقة. قواعد الصلاحيات

يجمع المثال التالي بين موافقات محددة وخطاف يمنع التنفيذ، لاستخدامه في مستودع موثوق. ادمجه في .claude/settings.json مع الاحتفاظ بالمفاتيح الموجودة. وهو يتعمد بدء جلسات الطرفية بالوضع اليدوي Manual لكي تتولى الموافقات المدرجة ضبط العمل. راجع ما تنفّذه نصوص الاختبار وفحص الكود في المشروع قبل السماح بها.

{
  "permissions": {
    "defaultMode": "default",
    "allow": ["Bash(npm test)", "Bash(npm run lint)"],
    "deny": ["Bash(git push *)", "Read(./.env)", "Read(./.env.*)"]
  },
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "if": "Bash(rm *)",
        "command": "echo 'Use the approved cleanup task instead.' >&2; exit 2"
      }]
    }]
  }
}

استخدم .claude/settings.local.json لتخصيص إعدادات المشروع لنفسك؛ وأضفه إلى .gitignore إذا أنشأته بنفسك. افتح /permissions للاطلاع على القواعد الفعالة والملفات التي جاءت منها. نطاق تطبيق الإعدادات

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

ابدأ بوضع التخطيط قبل إجراء تغيير واسع

ابدأ بالأمر claude --permission-mode plan، أو ضع "permissions": {"defaultMode": "plan"} في إعدادات المشروع. يستكشف Claude المشروع ويقترح العمل قبل الموافقة على تعديل ملفات المصدر. ويعطّل الإعداد "useAutoModeDuringPlan": false على المستوى الأعلى موافقات نموذج التصنيف على أوامر التخطيط، فتحتاج الأوامر التي تتجاوز مجموعة القراءة فقط المدمجة إلى موافقتك. إعداد وضع التخطيط

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

استخدم الخطافات لمنع أوامر محددة

يستخدم معالج hooks.PreToolUse في المثال الحقول matcher: "Bash" وtype: "command" وif: "Bash(rm *)". عند تحقق الشرط، يطبع أمر الصدفة سبب المنع ويخرج برمز الحالة 2، فيحظر استدعاء الأداة. ولا يحتاج إلى ملف نصي منفصل. أمر الصدفة هذا مثال صغير وضعناه باستخدام حقول الخطافات ورمز الخروج المانع الموثّقين لدى Anthropic. إعداد الخطافات، رموز الخروج التي تمنع التنفيذ

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

أين تسمح Anthropic بتشغيل وضع التجاوز؟

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

على Linux وmacOS، يُرفض عادةً تشغيل وضع التجاوز بحساب root أو عبر sudo. وتشير الوثائق إلى استثناء تلقائي داخل بيئة عزل يتعرّف إليها النظام؛ أما طريقة حاوية التطوير الموثّقة فتستخدم حسابًا غير root. لا تعالج خطأ التشغيل بحساب root بإضعاف هذا الحاجز.

إعداد مختصر لحاوية التطوير المرجعية

استخدم نسخة عمل قابلة للاستغناء عنها من مستودع موثوق. بعد تثبيت Docker وVS Code وامتداد Dev Containers، ابدأ بمشروع Anthropic المرجعي:

git clone https://github.com/anthropics/claude-code.git claude-code-isolated
code claude-code-isolated

1. في VS Code، شغّل Dev Containers: Reopen in Container. يجمع الإعداد المرجعي بين واجهة سطر الأوامر ووحدات تخزين دائمة وجدار ناري للاتصالات الصادرة. تأكد من أن remoteUser يحدد حسابًا غير root.
2. في طرفية الحاوية، شغّل id -u وتأكد من أن الناتج ليس 0. شغّل claude لتسجيل الدخول، ثم اخرج من تلك الجلسة.
3. في طرفية الحاوية نفسها، شغّل claude -p "Inspect this repository and summarize its structure. Do not change files." --dangerously-skip-permissions.
4. لاستخدام مشروعك، انسخ مجلد .devcontainer/ المرجعي إلى نسخة عمل قابلة للاستغناء عنها، وعدّل Dockerfile ليلائم أدوات المشروع. راجع فروق التغييرات في مساحة العمل بعد كل مهمة.

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

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

الجلسات السحابية تتجاهل التجاوز كإعداد افتراضي

تتجاهل الجلسات السحابية، من دون تنبيه، القيمتين defaultMode: "bypassPermissions" وdefaultMode: "dontAsk" في ملفات الإعدادات. وتبدأ بالوضع المعروض في قائمة الأوضاع السحابية المنسدلة. ولا يستطيع إعداد JSON محفوظ في المستودع إجبار جلسة سحابية على استخدام وضع التجاوز. سلوك الأوضاع السحابية

لا ينتقل ملفك المحلي ~/.claude/settings.json إلى جلسة سحابية تستضيفها Anthropic. ولإعدادات المستودع حدودها أيضًا: فالجلسات التي تشمل عدة مستودعات لا تحمّل قواعد الصلاحيات والخطافات من كل مستودع. افحص السياسة الفعلية للبيئة السحابية بدلًا من افتراض أن إعدادات طرفيتك انتقلت إليها. الإعدادات في الجلسات السحابية

اختر الوضع المناسب لطبيعة العمل

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

في حالة التكامل المستمر، توثّق Anthropic الأمر claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read" كنقطة بداية. وهو يرفض العمليات التي كانت ستطلب الموافقة لولا ذلك. الإعدادات الشائعة

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

أداتان مفيدتان يمكن لفريقك بناؤهما

أبرز فرصة هي أداة لفحص إعدادات الصلاحيات. تقدّر DataForSEO حجم البحث عن “claude code permissions” بـ720 عملية بحث شهريًا في الولايات المتحدة. يشير ذلك إلى صعوبة العثور على المعلومات، ولا يثبت وجود نية للشراء. يستطيع فريق منصة المطورين بناء أداة صغيرة تشرح نطاق تطبيق الإعدادات، وتنبّه إلى قيم defaultMode التي يجري تجاهلها، وتعرض أثر قواعد الأوامر الواسعة قبل تعريف الزملاء الجدد ببيئة العمل. وأول مخرج مفيد لها هو تقرير يقترح تعديلات. أما التحدي فهو مواصلة صيانتها مع تغيّر سلوك إعدادات Claude Code.

وقد يفيد مشغّل للمهام في بيئات مؤقتة الفرق التي تكرر العمل بلا إشراف. يقدّر تحليل الطلب نفسه حجم البحث عن “claude code docker” بـ260 عملية بحث شهريًا في الولايات المتحدة. يمكن لنسخة أولية قابلة للاستخدام أن تتحقق من قالب حاوية خضع للمراجعة، والمسارات المسموح بربطها، والتشغيل بمستخدم غير root، وسياسة الاتصالات الصادرة، ثم تجمع فروق التغييرات والسجلات الناتجة لمسؤول الصيانة. وتكمن قيمتها في توحيد الإعداد. أما حدودها فهي أن أداة التشغيل لا تستطيع جعل كود مستودع غير موثوق آمنًا، أو ضمان العزل لمجرد وجود Docker.

كلتاهما فرصة لبناء أدوات داخلية ينبغي اختبار جدواها مع مستخدمين فعليين. ولا تتطلب أي منهما جعل التجاوز الوضع الافتراضي على أجهزة المطورين.

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

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