Voraussetzungen
Code Guardian läuft als Skill- und Hook-Paket in Claude Code; für die OpenAI Codex CLI gibt es stattdessen das eigene Codex-Paket. 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 das Codex-Paket |
| 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 Rückgabewert 3. Ohne jq prüfen im Claude-Paket nur noch die vier Befehlssperren (Löschen, Auslieferung, Migration, Commit-Secret), weil sie in Python laufen; ohne jq halten der Schreibschutz für unbeaufsichtigte Läufe und der Halt für Entscheidungsfragen im Autopilot nichts mehr an. Im Codex-Paket hält der Verteiler – ein Programm, das die Befehle an die Prüfungen weiterleitet – ohne jq jeden Befehl an. |
| shasum oder sha256sum | für Prüfsummen, eines von beiden reicht |
Empfohlen, nicht Pflicht: das Paket obra/superpowers, eine Sammlung zusätzlicher Skills.
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 Sperren 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 Platzhalter, den der Microsoft Store dafür anlegt (den sogenannten Stub). Der Stub besteht jede reine Existenzprüfung – ob die Datei überhaupt vorhanden ist –, lässt sich aber nicht ausführen. Die Folge: jede Sperre fragt vor jedem Befehl nach. - jq installiert man unter Windows per
winget install jqlang.jq. - Fehlt Python weiterhin, bleiben die Sperren nicht stumm: sie fragen vor jedem Befehl nach, und eine Zeile landet in
~/.claude/code-guardian-failopen.log. - Die Prüfung kostet unter Windows spürbar mehr Zeit als unter macOS oder Linux, weil dort jeder Programmstart teurer ist. Gemessen auf GitHub
windows-latest: im Median rund 1700 ms vor einem Bash-Befehl und rund 600 ms danach; insgesamt liegt ein Aufruf im Median bei rund 2400 ms. - Der Sitzungsstart misst unter Windows, was ein Programmstart auf Ihrem Rechner kostet, und warnt, wenn die Zeitgrenze der Sperren dafür zu knapp ist.
- Anders als die reine Existenzprüfung der Sperren prüft die Werkzeug-Erkennung am Installationspfad, ob
python3der Platzhalter aus dem Microsoft Store ist, und zählt ihn dann nicht als installiertes Python; der Installer erkennt ihn daran, dass er sich nicht ausführen lässt.
In einem Satz
Python ab 3.9, Bash, git und jq genügen; unter Windows dazu Git Bash oder ein vollständiges WSL 2 – nicht aber Claude Code unter Windows mit Prüfungen über WSL.