Ana içeriğe atla

​
Gereksinimler

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (isteğe bağlı - yalnızca kaynaktan derleme için gerekli)

​
Kurulum

npm install -g failproofai

​
Hızlı başlangıç

1

Politikaları etkinleştirin

Politikalar, her ajan araç çağrısından önce ve sonra çalışan kurallardır. Yıkıcı komutları, gizli bilgi sızıntılarını ve hasar vermeden önce diğer hata durumlarını yakalarlar.
failproofai policies --install
Bu, Claude Code’un settings.json dosyasına hook girdileri yazar. Ayrıca tek bir proje için veya belirli politikalar için kurulum yapabilirsiniz:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

Doğrulayın

failproofai policies
Her politikayı, etkin olup olmadığını ve yapılandırılan parametreleri gösterir.
3

Panoyu başlatın

failproofai
http://localhost:8020 adresinde yerel bir panoya açılır; burada oturumları tarayabilir, araç çağrılarını inceleyebilir ve politikaları yönetebilirsiniz.
4

Ajanınızı çalıştırın

Claude Code’u normal şekilde başlatın. Ajan riskli bir işlem yapmaya çalışırsa, failproofai bunu otomatik olarak engeller. Onu çalışır durumda bırakın ve panoda neler olduğunu gözden geçirin.

​
Politikalar nasıl çalışır

Her ajan bir araç çalıştırdığında, Claude Code failproofai’ı bir alt işlem olarak çağırır: 
Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON'ı okur
                                                 politikaları değerlendirir
                                                 kararı stdout'a yazar
Her politika üç karardan birini döndürür:
  • allow - ajan normal şekilde devam eder
  • deny - işlem engellenir, ajana neden engellendiği söylenir
  • instruct - ajanın komutuna ek bağlam eklenir
Politikalar yerel işleminizde çalışır. Uzak bir hizmete hiçbir şey gönderilmez.

​
Veri depolama

Tüm yapılandırma ve günlükler makinenizde kalır:
YolSakladığı veriler
~/.failproofai/policies-config.jsonGlobal politika yapılandırması
~/.failproofai/hook-activity.jsonlHook yürütme geçmişi
~/.failproofai/hook.logÖzel hook hataları için hata ayıklama günlüğü
.failproofai/policies-config.jsonProje başına yapılandırma (işlenen)
.failproofai/policies-config.local.jsonKişisel geçersiz kılmalar (gitignored)

​
Kaldırma

failproofai policies --uninstall
~/.claude/settings.json dosyasından hook girdilerini kaldırır. ~/.failproofai/ içindeki yapılandırma dosyaları tutulur.

​
Sonraki adımlar

Yapılandırma

Kapsamlar ve yapılandırma dosyası biçimi

Yerleşik politikalar

26 politikaların tümü ve parametreleri

Özel politikalar

JavaScript’te kendi politikalarınızı yazın

Ajan monitörü

Oturumları izleyin ve politika etkinliğini gözden geçirin