Claude Code

Buggazi + Claude Code

Projektmanagement für Coding-Agents. So einfach wie git. In 30 Sekunden eingerichtet.

Claude Code Cursor Cline Windsurf Aider Codex Claude Web / Raycast

Schritt 1: Installieren + Anmelden

npm install -g buggazi
bgz signup my-project --local

Dein API-Key wird in .bgz/config.json in deinem Projekt gespeichert. Der Key ist sofort LIVE mit vollem Zugriff für 48 Stunden. Leg direkt mit Bugs und Features los, keine Karte und keine E-Mail nötig. Bevor das Fenster schließt, öffnet dein Mensch den Trial-Link ($0-Kartenprüfung), um die kostenlose 7-Tage-Testphase zu starten; derselbe Key funktioniert weiter und deine Daten bleiben erhalten, keine erneute Registrierung.

Schon einen Key? Einfach: bgz login --local --key YOUR_KEY

Von einem Buggazi-Nutzer geworben? Füge --ref BGZ-REF-XXXX zum Signup hinzu: 14 Tage Testphase statt 7.

Kein --api-url nötig. Standard ist buggazi.ai.

Füge .bgz/ zu deiner .gitignore hinzu, um API-Keys nicht zu committen.

Schritt 2: Zu CLAUDE.md hinzufügen

Füge das in die CLAUDE.md deines Projekts ein, damit Claude Code Buggazi nutzt:

## Buggazi
Dieses Projekt nutzt Buggazi fuer Bug-Tracking und Feature-Planung.
Nutze die `bgz` CLI. Konfiguration liegt in .bgz/config.json (automatisch geladen).
Falls nicht konfiguriert: bgz login --local --key DEIN_KEY

Fuehre `bgz init --agent-schema` aus — es liefert jeden Befehl + gueltige Flags.
Das ist die Quelle der Wahrheit: Was nicht im Schema steht, nicht verwenden.

Schritt 3 (empfohlen): Schema-Gate-Hooks installieren

bgz init --claude-hooks

Nur für Claude Code. Schreibt zwei Hook-Skripte nach .claude/ und trägt sie in .claude/settings.json ein (bestehende Hooks bleiben erhalten; Claude Code fragt beim ersten Start nach deiner Freigabe der Projekt-Hooks):

SessionStart aktualisiert das Live-Agent-Schema und erinnert den Agenten daran, dass dieses Projekt seine Arbeit in Buggazi verwaltet. PreToolUse prüft jeden bgz-Befehl gegen dieses Schema, bevor er läuft: Ein erfundenes Verb oder Subkommando wird mit einer Fehlermeldung blockiert, die den korrekten Befehl nennt. Der Agent korrigiert sich im selben Zug, statt einen fehlgeschlagenen Lauf zu verbrennen. Rohe curl-Schreibzugriffe auf die Buggazi-API werden zur CLI oder zum Remote-MCP umgeleitet.

Fail-open by Design: Ist bgz oder die Schema-Datei nicht erreichbar, läuft alles ungehindert durch und deine Session wird nie blockiert. --print zeigt eine Vorschau ohne zu schreiben, --force überschreibt deine angepassten Kopien.

Committe .claude/, damit jedes Teammitglied die Hooks automatisch bekommt. .bgz/ bleibt in der .gitignore. Andere Agenten (Cursor, Cline, Aider, Web) nutzen weiterhin CLAUDE.md / AGENTS.md.

Schritt 4: Loslegen

Gib Claude Code eine beliebige Aufgabe — es ermittelt die Befehle ueber bgz init --agent-schema und legt Bugs, Features und Sprints automatisch an. Mit --project KEY gruppierst du die Arbeit nach Projekt (unbekannte Keys legen das Projekt automatisch an, unbegrenzt in jedem Plan).

Weiter gedacht: Dispatch nach GitHub

Buggazi ist die dauerhafte Wahrheit; GitHub-Issues und PRs sind wegwerfbare Ausführungsartefakte. Du kannst einen bgz-Bug als GitHub-Issue dispatchen, das Claude Code in GitHub Actions aufruft: Der Agent öffnet einen PR, du spiegelst den PR-Status zurück auf das bgz-Item, testest lokal, mergst und löst den Bug dann in bgz. Nur backend/logic/api-Items laufen headless; visuelle Arbeit bleibt bei menschlichen Augen. Das vollständige Muster (Routing, Polling, Workflow-Limits, Subscription-Auth) steht in der llms.txt unter "GitHub Bridge".