Chuyển đến nội dung chính

​
Yêu cầu

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (tùy chọn - chỉ cần thiết khi xây dựng từ nguồn)

​
Cài đặt

npm install -g failproofai

​
Bắt đầu nhanh

1

Bật các chính sách

Các chính sách là những quy tắc chạy trước và sau mỗi lời gọi công cụ của agent. Chúng bắt các lệnh có tính phá hủy, rò rỉ thông tin bí mật và các kiểu lỗi khác trước khi gây hại.
failproofai policies --install
Điều này ghi các mục hook vào settings.json của Claude Code. Bạn cũng có thể cài đặt cho một dự án duy nhất hoặc chọn các chính sách cụ thể:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

Xác minh

failproofai policies
Hiển thị mọi chính sách, liệu nó có được bật hay không và bất kỳ tham số nào được cấu hình.
3

Khởi chạy bảng điều khiển

failproofai
Mở bảng điều khiển cục bộ tại http://localhost:8020 nơi bạn có thể duyệt phiên, kiểm tra các lời gọi công cụ và quản lý các chính sách.
4

Chạy agent của bạn

Khởi động Claude Code như bình thường. Nếu agent cố gắng làm điều gì đó rủi ro, failproofai sẽ chặn nó tự động. Hãy để nó chạy không giám sát và xem xét những gì đã xảy ra trong bảng điều khiển.

​
Cách các chính sách hoạt động

Mỗi khi một agent chạy một công cụ, Claude Code gọi failproofai như một tiến trình con: 
Claude Code  →  failproofai --hook PreToolUse  →  đọc JSON từ stdin
                                                 đánh giá các chính sách
                                                 ghi quyết định vào stdout
Mỗi chính sách trả về một trong ba quyết định:
  • allow - agent tiếp tục bình thường
  • deny - hành động bị chặn, agent được thông báo lý do
  • instruct - bối cảnh bổ sung được thêm vào lời nhắc của agent
Các chính sách chạy trong quy trình cục bộ của bạn. Không có gì được gửi đến một dịch vụ từ xa.

​
Lưu trữ dữ liệu

Tất cả cấu hình và nhật ký nằm trên máy của bạn:
Đường dẫnNhững gì nó lưu trữ
~/.failproofai/policies-config.jsonCấu hình chính sách toàn cục
~/.failproofai/hook-activity.jsonlLịch sử thực thi hook
~/.failproofai/hook.logNhật ký gỡ lỗi cho các lỗi hook tùy chỉnh
.failproofai/policies-config.jsonCấu hình cho từng dự án (được cam kết)
.failproofai/policies-config.local.jsonGhi đè cá nhân (gitignored)

​
Gỡ cài đặt

failproofai policies --uninstall
Xóa các mục hook khỏi ~/.claude/settings.json. Các tệp cấu hình trong ~/.failproofai/ được giữ lại.

​
Các bước tiếp theo

Cấu hình

Phạm vi và định dạng tệp cấu hình

Chính sách tích hợp

Tất cả 26 chính sách với tham số

Chính sách tùy chỉnh

Viết các chính sách của riêng bạn bằng JavaScript

Trình giám sát agent

Giám sát phiên và xem xét hoạt động của chính sách