Voraussetzungen
Code Guardian läuft als Skill- und Hook-Paket in Claude Code, für die Codex-Ausgabe zusätzlich in der OpenAI Codex CLI. Diese Seite listet, was auf dem Rechner vorhanden sein muss, bevor der Installer läuft.
Pflicht-Werkzeuge
| Werkzeug | Anforderung |
|---|---|
| Claude Code | Grundvoraussetzung |
| OpenAI Codex CLI | nur für die Codex-Ausgabe |
| Python | Version 3.9 oder neuer, nur Standardbibliothek, keine zusätzlichen Pakete |
| Bash und git | beide vorausgesetzt |
| jq | fehlt es, installiert der Installer trotzdem, endet dann aber mit Exit 3. Ohne jq ist nichts geprüft. |
| shasum oder sha256sum | für Prüfsummen, eines von beiden reicht |
Empfohlen, nicht Pflicht: das Paket obra/superpowers.
Plattformen
- macOS
- Linux
- Windows, nativ über Git Bash (Git for Windows)
- Windows, vollständig innerhalb von WSL 2
Nicht unterstützt ist die Mischform: Claude Code läuft unter Windows, die Prüfungen laufen über WSL.
Windows
C:\Windows\System32\bash.exeist der Starter für WSL, nicht für Git Bash. Code Guardian benutzt ihn bewusst nie.- In WSL gehört das Projekt ins Linux-Dateisystem, also nach
~/, nicht nach/mnt/c. Die Riegel lesen bei jedem Befehl Dateien, und über/mnt/ckostet das spürbar mehr Zeit. - Python gehört per
winget install Python.Python.3.12oder über den Installer von python.org auf den Rechner, nicht über den Microsoft-Store-Stub. Der Stub besteht jede Existenzprüfung, lässt sich aber nicht ausführen. Die Folge: jeder Riegel fragt vor jedem Befehl nach. - jq installiert man unter Windows per
winget install jqlang.jq. - Fehlt Python trotzdem, bleiben die Riegel nicht stumm: sie fragen vor jedem Befehl nach, und eine Zeile landet in
~/.claude/code-guardian-failopen.log.
In einem Satz
Python ab 3.9, Bash, git und jq genügen; unter Windows dazu Git Bash oder ein vollständiges WSL 2, nie beides gemischt.