> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# تثبيت السياسات

> فعّل السياسات لكي تعمل على كل استدعاء أداة وكيل

```bash theme={null}
failproofai policies --install [policy-names...] [options]
```

يكتب إدخالات خطاف في ملف الإعدادات الخاص بواجهة سطر الأوامر للوكيل المثبتة لديك (Claude Code أو OpenAI Codex أو GitHub Copilot CLI *(beta)*) بحيث يعترض failproofai استدعاءات الأدوات.

الأسماء المستعارة: `failproofai p -i`

## الخيارات

| العلم                          | الوصف                                                                                                                                                                          |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--cli claude\|codex\|copilot` | واجهات سطر الأوامر للوكيل المراد التثبيت لها؛ مفصولة بمسافات (مثل `--cli claude codex copilot`) أو مكررة. اتركها فارغة للكشف التلقائي عن واجهات سطر الأوامر المثبتة والمطالبة. |
| `--scope user`                 | التثبيت في ملف إعدادات النطاق العام (`~/.claude/settings.json` لـ Claude؛ `~/.codex/hooks.json` لـ Codex؛ `~/.copilot/hooks/failproofai.json` لـ Copilot). الخيار الافتراضي.   |
| `--scope project`              | التثبيت في ملف إعدادات نطاق المشروع (`<cwd>/.claude/settings.json` لـ Claude؛ `<cwd>/.codex/hooks.json` لـ Codex؛ `<cwd>/.github/hooks/failproofai.json` لـ Copilot).          |
| `--scope local`                | Claude فقط — التثبيت في `<cwd>/.claude/settings.local.json`. Codex و Copilot لا يملكان نطاق `local`.                                                                           |
| `--custom <path>` / `-c`       | المسار إلى ملف JavaScript يحتوي على سياسات خطاف مخصصة                                                                                                                          |

## السلوك

* **بدون أسماء سياسات** - يفتح موجه تفاعلي لتحديد السياسات
* **أسماء محددة** - تفعيل تلك السياسات (تضاف إلى أي سياسات مفعلة بالفعل)
* **`all`** - تفعيل كل السياسات المتاحة

التثبيت عملية إضافية: تشغيل `--install` مرة أخرى يضيف سياسات جديدة دون إزالة السياسات الموجودة.

## أمثلة

```bash theme={null}
# تثبيت جميع السياسات الافتراضية عالميًا (تفاعلي)
failproofai policies --install

# تثبيت سياسات محددة للمشروع الحالي
failproofai policies --install block-sudo sanitize-api-keys --scope project

# تفعيل جميع السياسات دفعة واحدة
failproofai policies --install all

# التثبيت مع ملف سياسات مخصص
failproofai policies --install --custom ./my-policies.js

# التثبيت لـ OpenAI Codex (نطاق المشروع)
failproofai policies --install --cli codex --scope project

# التثبيت لـ GitHub Copilot CLI (beta) للمشروع الحالي
failproofai policies --install --cli copilot --scope project

# التثبيت لجميع واجهات سطر الأوامر الثلاث في وقت واحد
failproofai policies --install --cli claude codex copilot
```

عند توفير `--custom <path>`، يتم التحقق من صحة الملف فورًا - يجب أن يستدعي `customPolicies.add()` مرة واحدة على الأقل. يتم حفظ المسار المحل في `policies-config.json` باسم `customPoliciesPath`.