Sat Jun 27 2026 20:00:00 GMT-0400 (Eastern Daylight Time)

أفضل ممارسات أمن Claude Code للفرق في عام 2026

دليل أمني عملي ومفصل للفرق التي تستخدم Claude Code: يغطي أوضاع الأذونات، وقوائم السماح (allowlists)، والتحقق من MCP، ومعالجة الأسرار، وتشغيلات CI ذات الامتياز الأدنى.

أفضل ممارسات أمن Claude Code للفرق في عام 2026

آخر تحديث: June 28, 2026

إن وكيل الترميز القائم على الذكاء الاصطناعي الذي يمكنه قراءة مستودع التعليمات البرمجية الخاص بك، وتشغيل أوامر Shell، واستدعاء الخدمات الخارجية مفيد تحديداً لأنه يتمتع بمدى وصول واسع. وهذا المدى الواسع هو أيضاً مصدر الخطر. قد يؤدي سوء تفسير الأمر (prompt)، أو قائمة السماح غير الدقيقة (allowlist)، أو خادم MCP واحد غير موثوق به إلى تسريب رمز مميز (token) أو مسح فرع كامل. هذا الدليل مخصص للمطور أو قائد المنصة الذي يريد استخدام Claude Code في العمل اليومي وفي بيئة CI دون أن يمنحه مفاتيح الإنتاج.

إجابة سريعة: كيف تحافظ الفرق على أمان Claude Code؟

قم بتشغيل الوكيل بأقل امتياز (least privilege) وراجع ما يفعله. عملياً، يعني هذا خمسة أشياء:

  • ابدأ في وضع صلاحيات مقيّد (restrictive permission mode) ومنح الأدوات عبر قائمة سماح ضيقة، وليس "السماح دائماً" الشامل.
  • حافظ على الأسرار بعيداً عن سياق النموذج: لا لصق مفاتيح، وقاعدة deny على ملفات .env ومسارات الأسرار.
  • تحقق من كل خادم MCP قبل توصيله، لأن الخادم غير الموثوق به يمكنه قراءة البيانات والتصرف نيابةً عنك.
  • تعامل مع محتوى الويب المسترجع كمدخل غير موثوق قد يحمل تعليمات حقن الأمر (prompt-injection).
  • في بيئة CI، امنح الوكيل رمزاً مميزاً قصير الأجل ومقتصر النطاق على القراءة، ولا تكشف أبداً عن بيانات اعتماد الإنتاج.

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

كيف تعمل أوضاع الصلاحيات وقوائم السماح فعلياً؟

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

  • default يطلب الأوامر عند الاستخدام الأول لكل أداة أو أمر.
  • plan للقراءة فقط: يمكن للوكيل قراءة الملفات واقتراح خطة عمل ولكنه لا يستطيع التعديل أو تشغيل الأوامر. استخدمه للمراجعة.
  • acceptEdits يقبل تعديلات الملف تلقائياً ولكنه يظل يطلب الإذن لتشغيل أوامر Shell.
  • bypassPermissions يتخطى كل طلب إذن. تعامل معه على أنه مخصص لبيئة Sandbox فقط.

توجد الضوابط الدائمة في ملف .claude/settings.json ضمن permissions، مع قواعد allow و ask و deny. يتم تحديد نطاق القواعد حسب الأداة والنمط (pattern)، لذلك تمنح بالضبط ما تحتاجه المهمة:

{
  "permissions": {
    "allow": ["Read", "Edit", "Bash(npm test:*)", "Bash(git diff:*)"],
    "ask": ["Bash(git push:*)", "WebFetch"],
    "deny": ["Read(./.env)", "Read(./secrets/**)", "Bash(curl:*)", "Bash(rm -rf:*)"]
  }
}

قاعدة deny تفوز دائماً على قاعدة allow، ولهذا السبب تظل مسارات الأسرار المذكورة أعلاه غير قابلة للقراءة حتى لو كانت هناك قاعدة Read واسعة النطاق. توثق Anthropic بناء الجملة الكامل لقواعد الترتيب والأسبقية في وثائق إدارة الهوية والوصول لـ Claude Code.

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

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

مرجع المخاطر والتخفيف منها

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

الخطر سبب حدوثه التخفيف (Mitigation)
انكشاف الأسرار لصق المفاتيح في الدردشة أو قراءتها من .env deny مسارات الأسرار؛ تمرير بيانات الاعتماد عبر البيئة، وليس عبر الأمر النصي
أمر مدمر السماح الواسع أو استخدام bypassPermissions على rm/git reset الاحتفاظ بـ rm -rf و force-push في ask أو deny؛ مراجعة الفروقات (diffs)
حقن الأمر (Prompt injection) محتوى الصفحة المسترجع أو نص المشكلة يحمل تعليمات مخفية تعامل مع محتوى الويب/المشكلة كمدخل غير موثوق به؛ تحديد نطاق WebFetch على النطاقات المعروفة
خادم MCP غير موثوق به خادم ذو صلاحيات كتابة/شبكة يتصرف نيابةً عنك التحقق من المؤلف والصلاحيات؛ تثبيت الإصدارات؛ أقل نطاق ممكن (least scope)
الوصول المفرط للملفات يقوم الوكيل بقراءة أو تعديل شيء خارج المشروع تحديد النطاق على المستودع؛ تجنب additionalDirectories الإضافية
إعادة كتابة التاريخ يؤدي الـ Force-push أو Hard reset إلى فقدان العمل حماية الفروع (Branch protection)؛ ask عند استخدام git push --force
تسريب بيانات اعتماد CI وضع رموز الإنتاج في بيئة التشغيل (runner env) رموز قصيرة الأجل ومقتصرة النطاق على القراءة؛ عدم وجود مفاتيح إنتاج في مهام المراجعة

يتبع التأطير هنا قائمة OWASP لأهم 10 تطبيقات LLM، والتي تسلط الضوء على حقن الأمر، ومعالجة المخرجات غير الآمنة، والإفراط في الوكالة (excessive agency) باعتبارها مخاطر الوكيل الرئيسية.

مرجع الصلاحيات والنطاق

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

الإعداد / العلم (flag) ما يتحكم فيه القيمة الافتراضية الموصى بها
permissions.allow استدعاءات الأدوات التي تعمل دون طلب إذن قائمة ضيقة، مثل Read أو Bash(npm test:*)
permissions.ask الاستدعاءات التي تطلب الإذن دائماً أولاً الكتابة، الشبكة، تثبيت الحزم
permissions.deny الاستدعاءات المحظورة تماماً Read(./.env)، Bash(curl:*)، مسارات الأسرار
--permission-mode plan تخطيط للقراءة فقط، لا تعديلات أو أوامر مراجعة الكود والتدقيق (audits)
وضع acceptEdits قبول التعديلات تلقائياً، ولا يزال يطلب إذن Shell إعادة الهيكلة المحلية الموثوق بها
--dangerously-skip-permissions يتخطى كل طلب إذن Sandbox يمكن التخلص منه فقط
additionalDirectories مجلدات إضافية قد يقرأها الوكيل اتركه غير محدد؛ حدد النطاق على المستودع

التحقق من خوادم MCP قبل توصيلها

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

قبل إضافة خادم، أجب عن خمسة أسئلة:

  1. من ينشره، وهل المصدر عام ومُدار؟
  2. ما هي النطاقات التي يطلبها: للقراءة فقط، أم للكتابة والشبكة؟
  3. ما البيانات التي يمكنه رؤيتها بمجرد الاتصال: هذا المستودع فقط، أم جهازك بالكامل؟
  4. هل بيانات الاعتماد محددة النطاق وقصيرة الأجل، أم أنها رمز إداري طويل الأجل؟
  5. هل يمكنك تثبيت إصدار (pin a version) بحيث لا يمكن لتحديث تلقائي أن يوسع وصوله بصمت؟

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

إبقاء الأسرار بعيداً عن متناول النموذج

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

كومة من الأقفال الرمزية التي تمثل تدوير الأسرار وإبقاء مفاتيح API خارج سياق وكيل الذكاء الاصطناعي

تغطي ثلاث عادات معظم المخاطر:

  • أضف قاعدة deny لملفات .env و *.pem وأي دليل secrets/ حتى لا يتمكن الوكيل من قراءتها حتى عن طريق الخطأ.
  • استخدم ماسحاً سرياً قبل الالتزام (pre-commit secret scanner) (مثل gitleaks أو git secrets) بحيث يفشل الالتزام، وليس التدقيق.
  • قم بتدوير أي شيء يتم الكشف عنه فوراً، ثم تحقق من السجلات والتاريخ. التدوير هو الإصلاح الوحيد الذي يغلق النافذة فعلياً.

إذا وصل مفتاح بالفعل إلى النسخ المكتوبة أو الالتزام، فافترض أنه مخترق وقم بتدويره. يساعد البحث في تاريخ git باستخدام git log -S في العثور على مكان وصوله إليه.

سيناريو: تمكين Claude Code في CI دون بيانات اعتماد الإنتاج

يريد فريق عمل أن يراجع Claude Code طلبات السحب (pull requests) في GitHub Actions. الهدف هو تعليقات مراجعة آلية، مع صفر قدرة على النشر، أو الكتابة إلى الفرع الرئيسي (main)، أو لمس قاعدة بيانات الإنتاج.

خوادم مركز البيانات خلف ضوابط الوصول، مما يمثل أقل امتياز لـ CI الخاص بـ Claude Code

إليك الإعداد الذي يحافظ على فائدة المهمة ولكن ضمن حدودها:

  • تشغيل بدون واجهة رسومية (headless) باستخدام claude -p في وضع plan حتى يقرأ الوكيل الفرق (diff) ويكتب تعليقاً، ولكنه لا يعدل الملفات أو يشغل أوامر البناء.
  • منح سير العمل صلاحيات contents: read و pull-requests: write فقط. لا يوجد مهمة نشر، ولا نطاق للبنية التحتية.
  • استخدام الرمز المميز القصير الأجل الخاص بالمهمة (GITHUB_TOKEN)، وليس رمزاً مميزاً شخصياً، وعدم وضع مفاتيح قاعدة البيانات أو الإنتاج السحابي في بيئة هذه المهمة أبداً.
  • إضافة قائمة deny لمسارات الأسرار و curl الصادر، بحيث لا يمكن لمحاولة حقن الأمر داخل فرق طلب السحب تسريب أي شيء.
  • تثبيت إصدار الإجراء (action) و Claude Code، وتحديد أي خطوة نشر خلف بيئة منفصلة يوافق عليها البشر.
permissions:
  contents: read
  pull-requests: write
steps:
  - run: claude -p "Review the diff for security issues" --permission-mode plan
    env:
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

ترى مهمة المراجعة الكود وتنشر التعليقات. لا يمكنها الوصول إلى الإنتاج لأن بيانات اعتماد الإنتاج ليست ضمن النطاق أبداً. يصف نظرة عامة أمنية لـ Claude Code من Anthropic هذا الوضع بأقل امتياز للتشغيل الآلي والتشغيل بدون واجهة رسومية.

ما الذي لا يجب عليك أبداً لصقه في وكيل ترميز يعمل بالذكاء الاصطناعي؟

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

  • مفاتيح API الحية، عناوين URL لقواعد البيانات بكلمات مرور، أو بيانات اعتماد الجذر السحابي.
  • معلومات تعريف الهوية الشخصية (PII) للعملاء أو البيانات المنظمة التي لن تضعها في تذكرة دعم.
  • مفاتيح التوقيع الخاصة، الشهادات، أو ملفات .pem.
  • سلاسل الاتصال الكاملة لبيئة الإنتاج عندما يكفي نسخة للقراءة فقط (read replica) أو مُثبت محلي (local fixture).

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

التدقيق، الخطافات (hooks)، والمراجعة المستمرة

يحدد أقل امتياز الحد الأدنى؛ والمراجعة تبقيك هناك. اقرأ خطة الوكيل قبل الموافقة على خطوة محفوفة بالمخاطر، واقرأ الفرق (diff) قبل الالتزام. بالنسبة للتغييرات الأكبر، ينطبق نفس الانضباط الذي يجعل إعادة الهيكلة بمساعدة الذكاء الاصطناعي آمنة هنا: الخطوات الصغيرة القابلة للمراجعة تتفوق على تشغيل واحد عملاق دون مراقبة.

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

قائمة مراجعة متكررة وسريعة للفريق:

  • مراجعة قوائم السماح والرفض في .claude/settings.json وفق جدول زمني، وليس فقط عند الإعداد.
  • إعادة التحقق من خوادم MCP بعد التحديثات الرئيسية للإصدار.
  • التأكد من أن مهام CI لا تزال تعمل في وضع plan ولا تحمل أسرار إنتاج.
  • تدوير الرموز المميزة (tokens) وفق جدول زمني وبعد أي انكشاف مشتبه به.
  • الاحتفاظ بملف CLAUDE.md ينص على ما لا يمكن التفاوض عليه: لا force-push إلى main، ولا وصول مباشر لقاعدة بيانات الإنتاج، ولا أسرار في الأوامر النصية (prompts).

بالنسبة لسير العمل الأوسع حول كل هذا، يمر الدليل الشامل لـ Claude Code عبر الإعداد من البداية إلى النهاية.

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

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

استخدم الأدوات المجانية أثناء متابعة الدليل.

ضغط صورةإزالة خلفية

تابع القراءة