> ## 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.

# Cài đặt policies

> Bật policies để chúng chạy trên mọi lệnh gọi công cụ của agent

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

Ghi các mục hook vào tệp cài đặt của agent CLI đã cài đặt (Claude Code, OpenAI Codex, hoặc GitHub Copilot CLI *(beta)*) để failproofai có thể chặn các lệnh gọi công cụ.

Bí danh: `failproofai p -i`

## Các tùy chọn

| Cờ                             | Mô tả                                                                                                                                                                 |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--cli claude\|codex\|copilot` | Agent CLI(s) để cài đặt; cách nhau bằng dấu cách (ví dụ: `--cli claude codex copilot`) hoặc lặp lại. Bỏ qua để phát hiện các CLI đã cài đặt và nhắc nhở.              |
| `--scope user`                 | Cài đặt vào tệp cài đặt phạm vi người dùng (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Mặc định. |
| `--scope project`              | Cài đặt vào tệp cài đặt phạm vi dự án (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`).     |
| `--scope local`                | Chỉ Claude — cài đặt vào `<cwd>/.claude/settings.local.json`. Codex và Copilot không có phạm vi `local`.                                                              |
| `--custom <path>` / `-c`       | Đường dẫn đến tệp JS chứa các policies hook tùy chỉnh                                                                                                                 |

## Hành vi

* **Không có tên policy** - mở một lời nhắc tương tác để chọn policies
* **Tên cụ thể** - bật các policies đó (được thêm vào bất kỳ policies nào đã được bật)
* **`all`** - bật tất cả các policies có sẵn

Cài đặt là cộng dồn: chạy `--install` lại sẽ thêm các policies mới mà không xóa các policies hiện có.

## Ví dụ

```bash theme={null}
# Cài đặt tất cả default policies toàn cục (tương tác)
failproofai policies --install

# Cài đặt policies cụ thể cho dự án hiện tại
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Bật tất cả policies cùng một lúc
failproofai policies --install all

# Cài đặt với tệp policies tùy chỉnh
failproofai policies --install --custom ./my-policies.js

# Cài đặt cho OpenAI Codex (phạm vi dự án)
failproofai policies --install --cli codex --scope project

# Cài đặt cho GitHub Copilot CLI (beta) cho dự án hiện tại
failproofai policies --install --cli copilot --scope project

# Cài đặt cho cả ba CLI cùng một lúc
failproofai policies --install --cli claude codex copilot
```

Khi `--custom <path>` được cung cấp, tệp sẽ được xác thực ngay lập tức - nó phải gọi `customPolicies.add()` ít nhất một lần. Đường dẫn được phân giải sẽ được lưu vào `policies-config.json` dưới dạng `customPoliciesPath`.