> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260623-1106.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Örnekler
> Claude Code ve Agents SDK için hook'lar nasıl kurulur
Yaygın senaryolar için hazır kullanılabilir örnekler. Her biri kurulumu ve neyi bekleyeceğinizi gösterir.
***
## Claude Code için hook'ları ayarlama
Failproof AI, Claude Code ile [hook'lar sistemi](https://docs.anthropic.com/en/docs/claude-code/hooks) aracılığıyla entegre olur. `failproofai policies --install` çalıştırdığınızda, Claude Code'un `settings.json` dosyasında her araç çağrısında tetiklenen hook komutlarını kaydeder.
```bash theme={null}
npm install -g failproofai
```
```bash theme={null}
failproofai policies --install
```
```bash theme={null}
cat ~/.claude/settings.json | grep failproofai
```
`PreToolUse`, `PostToolUse`, `Notification` ve `Stop` etkinlikleri için hook girdilerini görmelisiniz.
```bash theme={null}
claude
```
Politikalar artık her araç çağrısında otomatik olarak çalışır. Claude'dan `sudo rm -rf /` çalıştırmasını istemeyi deneyin - engellenir.
***
## Agents SDK için hook'ları ayarlama
[Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) ile geliştiriyorsanız, aynı hook sistemini programlı bir şekilde kullanabilirsiniz.
```bash theme={null}
npm install failproofai
```
Aracı işleminizi oluştururken hook komutlarını geçin. Hook'lar Claude Code'daki gibi aynı şekilde çalışır - stdin/stdout JSON aracılığıyla:
```bash theme={null}
failproofai --hook PreToolUse # her araçtan önce çağrılır
failproofai --hook PostToolUse # her araçtan sonra çağrılır
```
```javascript theme={null}
import { customPolicies, allow, deny } from "failproofai";
customPolicies.add({
name: "limit-to-project-dir",
description: "Aracı proje dizini içinde tutar",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
const path = String(ctx.toolInput?.file_path ?? "");
if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
return deny("Araç proje dizini ile sınırlandırılmıştır");
}
return allow();
},
});
```
```bash theme={null}
failproofai policies --install --custom ./my-agent-policies.js
```
***
## Yıkıcı komutları engelle
En yaygın kurulum - aracıların geri döndürülemez hasara neden olmasını önle.
```bash theme={null}
failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
```
Bunu ne yapar:
* `block-sudo` - tüm `sudo` komutlarını engeller
* `block-rm-rf` - özyinelemeli dosya silmeyi engeller
* `block-force-push` - `git push --force`'u engeller
* `block-curl-pipe-sh` - uzak komutları shell'e yönlendirmeyi engeller
***
## Sır sızıntısını önle
Aracıların kimlik bilgilerini görmesini veya araç çıktısında sızdırmasını engelle.
```bash theme={null}
failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
```
Bunlar `PostToolUse`'de çalışır - bir araç çalıştıktan sonra, araç çıktısını ajan görmeden temizlerler.
***
## Aracılar dikkat gerektirdiğinde Slack uyarıları al
Bildirimi hook'unu kullanarak boşta bekleme uyarılarını Slack'e yönlendir.
```javascript theme={null}
import { customPolicies, allow, instruct } from "failproofai";
customPolicies.add({
name: "slack-on-idle",
description: "Araç girdi için beklerken Slack'e uyarı gönder",
match: { events: ["Notification"] },
fn: async (ctx) => {
const webhookUrl = process.env.SLACK_WEBHOOK_URL;
if (!webhookUrl) return allow();
const message = String(ctx.payload?.message ?? "Araç beklemede");
const project = ctx.session?.cwd ?? "bilinmiyor";
try {
await fetch(webhookUrl, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
text: `*${message}*\nProje: \`${project}\``,
}),
signal: AbortSignal.timeout(5000),
});
} catch {
// Slack ulaşılamazsa aracı hiçbir zaman engelleme
}
return allow();
},
});
```
Yükle:
```bash theme={null}
SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
```
***
## Aracıları bir dalda tut
Aracıların dal değiştirmesini veya korumalı dallara göndermesini önle.
```javascript theme={null}
import { customPolicies, allow, deny } from "failproofai";
customPolicies.add({
name: "stay-on-branch",
description: "Aracının diğer dallara geçmesini önle",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolName !== "Bash") return allow();
const cmd = String(ctx.toolInput?.command ?? "");
if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
return deny("Geçerli dalda kal. Gerekirse -b ile yeni dal oluştur.");
}
return allow();
},
});
```
***
## Commit'ten önce testler gerekli kıl
Aracılara commit'lemeden önce testleri çalıştırmalarını hatırlat.
```javascript theme={null}
import { customPolicies, allow, instruct } from "failproofai";
customPolicies.add({
name: "test-before-commit",
description: "Aracıya commit'lemeden önce testleri çalıştırmasını hatırlat",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolName !== "Bash") return allow();
const cmd = String(ctx.toolInput?.command ?? "");
if (/git\s+commit/.test(cmd)) {
return instruct("Commit'lemeden önce testleri çalıştır. Önce `npm test` veya `bun test`'i kullan.");
}
return allow();
},
});
```
***
## Production deposunu kilitlenmiş hale getir
Proje seviyesinde bir config commit'le, böylece ekibinizdeki her geliştirici aynı politikaları alır.
Deponuzda `.failproofai/policies-config.json` dosyası oluştur:
```json theme={null}
{
"enabledPolicies": [
"block-sudo",
"block-rm-rf",
"block-force-push",
"block-push-master",
"block-env-files",
"sanitize-api-keys",
"sanitize-jwt"
],
"policyParams": {
"block-push-master": {
"protectedBranches": ["main", "release", "production"]
}
}
}
```
Sonra commit'le:
```bash theme={null}
git add .failproofai/policies-config.json
git commit -m "Add failproofai team policies"
```
failproofai yüklü olan her takım üyesi otomatik olarak bu kuralları alacaktır.
***
## Konvansiyonel politikalarla kuruluş çapında kalite standardı oluştur
En etkili kurulum: `.failproofai/policies/`'ni projenize commit'le ve politikaları projenize göre özelleştir. Her takım üyesi otomatik olarak alır — kurulum komutu yok, yapılandırma değişikliği yok.
```bash theme={null}
mkdir -p .failproofai/policies
```
```js theme={null}
// .failproofai/policies/team-policies.mjs
import { customPolicies, allow, deny, instruct } from "failproofai";
// Takımının tercih ettiği paket yöneticisini zorunlu kıl
// (veya bunun yerine yerleşik prefer-package-manager politikasını etkinleştir)
customPolicies.add({
name: "enforce-bun",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolName !== "Bash") return allow();
const cmd = String(ctx.toolInput?.command ?? "");
if (/\bnpm\b/.test(cmd)) return deny("npm yerine bun'ı kullan.");
return allow();
},
});
// Aracıya commit'lemeden önce testleri çalıştırmasını hatırlat
customPolicies.add({
name: "test-before-commit",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolName !== "Bash") return allow();
if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
return instruct("Commit'lemeden önce testleri çalıştır.");
}
return allow();
},
});
```
```bash theme={null}
git add .failproofai/policies/
git commit -m "Add team quality policies"
```
Takımınız yeni hata modlarına ulaştıkça, politikalar ekle ve gönder. Herkes bir sonraki `git pull`'da güncellemeyi alır. Bu politikalar, takımınızla birlikte büyüyen bir yaşayan kalite standardı haline gelir.
***
## Daha fazla örnek
Repodaki [`examples/`](https://github.com/failproofai/failproofai/tree/main/examples) dizini şunları içerir:
| Dosya | Ne gösterir |
| ---------------------------- | ---------------------------------------------------------------------------------------------- |
| `policies-basic.js` | Başlangıç politikaları - production yazılarını, force-push'u, yönlendirilmiş komutları engelle |
| `policies-notification.js` | Boşta bekleme bildirimleri ve oturum sonu için Slack uyarıları |
| `policies-advanced/index.js` | Geçişli içe aktarımlar, async hook'lar, PostToolUse çıktısı temizliği, Stop olayı işleme |