דלג לתוכן הראשי

​
title: התחלה description: “התקן את failproofai, הפעל מדיניות, והנח לסוכנים שלך לפעול בהאמינות” icon: rocket

​
דרישות

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (אופציונלי - נדרש רק לבנייה מקוד מקור)

​
התקנה

npm install -g failproofai

​
התחלה מהירה

1

הפעל מדיניות

מדיניות הן כללים שרצים לפני ואחרי כל קריאת כלי של סוכן. הם תופסים פקודות הרסניות, דליפות סודיות וקלקלויות אחרות לפני שהם גורמים נזק.
failproofai policies --install
זה כותב ערכי hook ל-settings.json של Claude Code. אתה יכול גם להתקין עבור פרויקט יחיד או לבחור מדיניויות ספציפיות:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

אימות

failproofai policies
מציג כל מדיניות, האם היא פעילה, וכל פרמטרים מוגדרים.
3

הפעל את לוח הבקרה

failproofai
פותח לוח בקרה מקומי ב-http://localhost:8020 שבו אתה יכול לעיין בהפעלות, לבדוק קריאות כלים, ולנהל מדיניות.
4

הריץ את הסוכן שלך

הפעל את Claude Code כרגיל. אם הסוכן מנסה משהו מסוכן, failproofai יתקע אותו באופן אוטומטי. השאר אותו פועל ללא השגחה ובדוק את מה שקרה בלוח הבקרה.

​
איך מדיניות עובדות

כל פעם שסוכן מריץ כלי, Claude Code קורא ל-failproofai כתהליך משנה: 
Claude Code  →  failproofai --hook PreToolUse  →  קורא JSON מ-stdin
                                                 מעריך מדיניות
                                                 כותב החלטה ל-stdout
כל מדיניות מחזירה אחת משלוש החלטות:
  • allow - הסוכן ממשיך כרגיל
  • deny - הפעולה חסומה, הסוכן מקבל הסבר
  • instruct - הקשר נוסף מתווסף להנחיות של הסוכן
המדיניות רצות בתהליך המקומי שלך. שום דבר לא נשלח לשירות מרוחק.

​
אחסון נתונים

כל התצורה והיומנים נשארים במכונה שלך:
נתיבמה זה שומר
~/.failproofai/policies-config.jsonתצורת מדיניות גלובלית
~/.failproofai/hook-activity.jsonlהיסטוריית הוכן
~/.failproofai/hook.logיומן ניפוי עבור שגיאות hook מותאמות
.failproofai/policies-config.jsonתצורה לכל-פרויקט (מחויבת)
.failproofai/policies-config.local.jsonעקיפות אישיות (מתוך gitignored)

​
הסרה

failproofai policies --uninstall
מסיר ערכי hook מ-~/.claude/settings.json. קבצי תצורה ב-~/.failproofai/ נשמרים.

​
הצעדים הבאים

תצורה

היקפים וצורת קובץ תצורה

מדיניות מובנות

כל 26 המדיניות עם פרמטרים

מדיניות מותאמות

כתוב את המדיניות שלך שלך ב-JavaScript

צג סוכן

עקוב אחר הפעלות ובדוק פעילות מדיניות