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

# Başlangıç

> failproofai'yi yükleyin, politikaları etkinleştirin ve ajanlarınızı güvenilir şekilde çalıştırın

## Gereksinimler

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

***

## Kurulum

<CodeGroup>
  ```bash npm theme={null}
  npm install -g failproofai
  ```

  ```bash bun theme={null}
  bun add -g failproofai
  ```
</CodeGroup>

***

## Hızlı başlangıç

<Steps>
  <Step title="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 modlarını yakalarlar.

    ```bash theme={null}
    failproofai policies --install
    ```

    Bu, yüklü ajan CLI'lerinize kanca girdileri yazar (Claude Code'un `~/.claude/settings.json`, OpenAI Codex'in `~/.codex/hooks.json`, GitHub Copilot CLI'nin `~/.copilot/hooks/failproofai.json`, Cursor Agent'ın `~/.cursor/hooks.json`, OpenCode'un `~/.config/opencode/plugins/failproofai.mjs` konumundaki oluşturulan eklenti shim'i ve `~/.config/opencode/opencode.json` dosyasının `plugin` dizisinde bir kayıt girdisi, Pi'nin `~/.pi/agent/settings.json` veya Gemini CLI'nin `~/.gemini/settings.json`). Birden fazlası mevcut olduğunda size sorulacaktır; istem atlamak için `--cli claude codex copilot cursor opencode pi gemini` (herhangi bir alt küme) parametresini geçin.

    GitHub Copilot CLI, Cursor Agent, OpenCode, Pi ve Gemini CLI desteği **beta** aşamasındadır — `--cli copilot`, `--cli cursor`, `--cli opencode`, `--cli pi` veya `--cli gemini` ile yükleyin.

    ```bash theme={null}
    failproofai policies --install --scope project
    failproofai policies --install --cli codex --scope project
    failproofai policies --install --cli copilot --scope project
    failproofai policies --install --cli cursor --scope project
    failproofai policies --install --cli opencode --scope project
    failproofai policies --install --cli pi --scope project
    failproofai policies --install --cli gemini --scope project
    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
    ```
  </Step>

  <Step title="Doğrulayın">
    ```bash theme={null}
    failproofai policies
    ```

    Her politikayı, etkin olup olmadığını ve yapılandırılmış parametreleri gösterir.
  </Step>

  <Step title="Panoyu başlatın">
    ```bash theme={null}
    failproofai
    ```

    `http://localhost:8020` konumunda oturumları tarayabileceğiniz, araç çağrılarını inceleyebileceğiniz ve politikaları yönetebileceğiniz yerel bir panoyu açar.
  </Step>

  <Step title="Ajanınızı çalıştırın">
    Claude Code'u her zamanki gibi başlatın. Ajan riskli bir şey denerse, failproofai otomatik olarak bunu engeller. Bunu arka planda çalışır bırakın ve panoda ne olduğunu gözden geçirin.
  </Step>
</Steps>

***

## Politikalar nasıl çalışır?

Bir ajan bir araç çalıştırdığında, Claude Code failproofai'yi bir alt işlem olarak çağırır:

```text theme={null}
Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON'u okur
                                                 politikaları değerlendirir
                                                 kararı stdout'a yazar
```

Her politika üç karardan birini döndürür:

* **allow** - ajan normal şekilde ilerlenir
* **deny** - işlem engellenir, ajana neden olduğu söylenir
* **instruct** - ajanın istemesine ekstra bağlam eklenir

<Note>
  Politikalar yerel işleminizde çalışır. Uzak bir hizmete hiçbir şey gönderilmez.
</Note>

***

## Kural tabanlı politikalarla takım politikaları kurun

Takım genelinde kalite standartları oluşturmanın en hızlı yolu `.failproofai/policies/` kuralıdır. Bu dizine politika dosyalarını bırakın ve otomatik olarak yüklenir — hiçbir bayrak, yapılandırma değişikliği veya kurulum komutu gerekmez.

<Steps>
  <Step title="Politikalar dizinini oluşturun">
    ```bash theme={null}
    mkdir -p .failproofai/policies
    ```
  </Step>

  <Step title="Politika dosyaları ekleyin">
    Başlangıç örneklerini kopyalayın veya kendi örneklerinizi yazın:

    ```bash theme={null}
    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
    ```

    Veya yeni bir tane oluşturun:

    ```js theme={null}
    // .failproofai/policies/team-policies.mjs
    import { customPolicies, allow, deny, instruct } from "failproofai";

    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 yapmadan önce testleri çalıştırın.");
        }
        return allow();
      },
    });
    ```
  </Step>

  <Step title="Git'e işleyin">
    ```bash theme={null}
    git add .failproofai/policies/
    git commit -m "Takım kalite politikaları ekle"
    ```

    failproofai yüklü olan her takım üyesi bu politikaları otomatik olarak alır. Geliştirici başına kurulum gerekmez.
  </Step>
</Steps>

<Tip>
  `.failproofai/policies/` dosyasını deponuza işleyin, böylece tüm takım aynı standartları paylaşır. Takımınız yeni hata modları keşfettikçe, politikalar ekleyin ve gönderin — herkes bir sonraki `git pull` konusunda güncelleme alır. Zaman içinde bu politikalar, gelişmeye devam eden yaşayan bir kalite standardı haline gelir.
</Tip>

***

## Veri depolama

Tüm yapılandırma ve günlükler makinenizde kalır:

| Yol                                       | Depoladığı şey                                      |
| ----------------------------------------- | --------------------------------------------------- |
| `~/.failproofai/policies-config.json`     | Genel politika yapılandırması                       |
| `~/.failproofai/hook-activity.jsonl`      | Kanca yürütme geçmişi                               |
| `~/.failproofai/hook.log`                 | Özel kanca hatalarına ilişkin hata ayıklama günlüğü |
| `.failproofai/policies-config.json`       | Proje başına yapılandırma (işlenmiş)                |
| `.failproofai/policies-config.local.json` | Kişisel geçersiz kılmalar (gitignored)              |

***

## Kaldırma

```bash theme={null}
failproofai policies --uninstall
```

`~/.claude/settings.json` dosyasından kanca girdilerini kaldırır. `~/.failproofai/` konumundaki yapılandırma dosyaları tutulur.

***

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="Yapılandırma" icon="gear" href="/tr/configuration">
    Kapsamlar ve yapılandırma dosyası biçimi
  </Card>

  <Card title="Yerleşik politikalar" icon="shield" href="/tr/built-in-policies">
    Parametreleri olan 26 politikanın tümü
  </Card>

  <Card title="Özel politikalar" icon="code" href="/tr/custom-policies">
    JavaScript'te kendi politikalarınızı yazın
  </Card>

  <Card title="Ajan monitörü" icon="chart-line" href="/tr/dashboard">
    Oturumları izleyin ve politika faaliyetini gözden geçirin
  </Card>
</CardGroup>