> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260626-1023.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

> تفعيل السياسات بحيث يتم تشغيلها على كل استدعاء أداة وكيل

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

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

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

## الخيارات

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

## السلوك

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

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

## أمثلة

```bash theme={null}
# Install all default policies globally (interactive)
failproofai policies --install

# Install specific policies for the current project
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Enable all policies at once
failproofai policies --install all

# Install with a custom policies file
failproofai policies --install --custom ./my-policies.js

# Install for OpenAI Codex (project scope)
failproofai policies --install --cli codex --scope project

# Install for GitHub Copilot CLI (beta) for the current project
failproofai policies --install --cli copilot --scope project

# Install for all three CLIs at once
failproofai policies --install --cli claude codex copilot
```

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