Zum Inhalt springen

Kapitel 1 von 7

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.exe ist 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/c kostet das spürbar mehr Zeit.
  • Python gehört per winget install Python.Python.3.12 oder ü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.

Dieses Kapitel als Auftrag an Claude

Kopieren, die spitzen Klammern durch Ihre eigene Angabe ersetzen, in Claude Code einfügen.

Prüfe, ob dieser Rechner alle Voraussetzungen für Code Guardian erfüllt (Python-Version, Bash, git, jq, shasum oder sha256sum), und nenne mir knapp, was fehlt oder falsch installiert ist.