Code Guardian installieren: Anleitung und Stolpersteine

Offenlegung: Code Guardian ist ein Angebot der Provimedia GmbH. Deren Geschäftsführer Alexander Weipprecht ist Bruder und Geschäftspartner des Herausgebers von digital zentral. Der Herausgeber setzt Code Guardian selbst für diese Seite ein. Dieser Beitrag enthält Partnerlinks: Kommt darüber ein Kauf zustande, erhält digital zentral eine Provision; der Preis für Sie ändert sich nicht.

Code Guardian wird nicht in ein Projekt installiert, sondern in das Nutzerverzeichnis von Claude Code. Danach gilt es für jedes Projekt, das Sie mit dem Assistenten öffnen. Die Installation dauert laut Anbieter zehn Minuten; laut Anleitung des Anbieters haben typische Probleme danach wenige, schnell prüfbare Ursachen. Dieser Beitrag geht die Schritte nach der Anleitung des Anbieters durch, Stand 4. November 2026, Version 17.16, und ergänzt, was uns dabei aufgefallen ist.

Voraussetzungen

Sie brauchen Claude Code oder OpenAI Codex, Git und Python ab 3.9 mit Standardbibliothek; zusätzliche Python-Pakete sind nicht nötig. Unter Linux kommt jq dazu. Unter Windows läuft das Paket nativ über Git for Windows, also in der Git Bash; WSL ist nicht nötig, und die Mischform aus Claude Code unter Windows mit Prüfungen in WSL wird laut Anbieter nicht unterstützt. Für Python unter Windows empfiehlt die Anleitung die Fassung von python.org oder per winget, nicht den Platzhalter aus dem Microsoft Store. Prüfen Sie beides vorab:

python3 --version
which jq

Ist python3 nicht vorhanden oder älter als 3.9, bricht der Installer ab und ändert nichts. Fehlt jq, installiert er trotzdem alles, endet aber mit einer Warnung und dem Rückgabewert 3; dann prüfen nur noch die vier Befehlssperren, die in Python laufen. jq bekommen Sie unter macOS mit brew install jq, unter Debian und Ubuntu mit sudo apt install jq.

Installation in vier Schritten

Entpacken. Das Paket kommt als ZIP aus dem Kundenportal: unzip code-guardian-v17.16-update.zip -d code-guardian, dann in den Ordner wechseln.
Installieren. ./install.sh schreibt nach ~/.claude/, also global und nicht in Ihr Projekt. Ihre Projekte und deren .gitignore fasst der Installer nicht an. Eine Statuszeile richtet er nicht ein; eine frühere Statuszeile des Pakets baut er zurück, eine eigene bleibt erhalten.
Neu starten. Claude Code vollständig beenden und neu öffnen. Die Anleitung ist hier deutlich: nicht der Befehl zum Leeren des Gesprächs, sondern Beenden und neu öffnen, weil Hooks und Agenten-Definitionen nur beim Start eingelesen werden.
Prüfen. In der neuen Sitzung zeigt die Hook-Übersicht die Einträge der Sperren, die Agenten-Übersicht die Prüf-Agenten und die Hilfe den Skill in der Liste.

Für die Codex-Variante liegt im Kundenportal ein fertiger Prompt zum Kopieren, und die Schritte stehen in einer eigenen Anleitungsdatei im Codex-Paket. Unter Codex ist die Sperre erst nach ausdrücklicher Bestätigung aktiv, und diese Bestätigung fällt nach jedem Update ohne Warnung wieder weg; das ist laut Anleitung ein typischer Grund, warum unter Codex „nichts passiert“.

Prüfen, ob die Riegel scharf sind

Die Zahl der registrierten Hooks lässt sich mit einer Python-Zeile aus der Einstellungsdatei von Claude Code lesen; die Anleitung nennt sie. Für einen echten Test schickt man einen vorbereiteten JSON-Eingabetest an die beiden Hook-Skripte für Deploy und Entscheidungsfragen: Der Deploy-Riegel muss mit einer Verweigerung antworten, der Entscheidungs-Hook außerhalb des Autopiloten nur mit einem Hinweis. Die genaue Vorgehensweise steht in der Update-Anleitung im Paket. Zwei Fehlerbilder sind typisch: Antwortet der Deploy-Riegel mit einer Nachfrage statt einer Verweigerung, fehlt Python oder antwortet nicht; kommt beim Entscheidungs-Hook kein Hinweis, fehlt jq. Sind gar keine Sperren aktiv, wurde Claude Code nicht neu gestartet.

Welche Werkzeuge das Projekt haben sollte

Die Gates sind sprachunabhängig, die Analysewerkzeuge dahinter nicht. Der Installer installiert bewusst keines davon; beim Sitzungsstart meldet das Paket, was fehlt. Laut Anleitung erwartet es je Stack:

PHP: PHPStan mit Larastan als Pflicht; PHPUnit oder Pest empfohlen; Infection, Pint und Rector optional.
JavaScript, TypeScript, Vue: ESLint als Pflicht; tsc oder vue-tsc und Vitest empfohlen; Stryker, Prettier und knip optional.
Python: Ruff als Pflicht; mypy und pytest empfohlen; mutmut und Hypothesis optional.
Blade und HTML: html-validate empfohlen.

Fehlt ein Pflicht-Werkzeug, meldet der Detektor eine Lücke, und das Statik-Gate für diese Sprache greift nicht. Infection und Stryker sind zwar optional, aber ohne sie bleibt unbelegt, ob die Tests überhaupt etwas prüfen. Für die Einrichtung bringt das Paket vier Skills mit, die je Projekt einmal laufen und Konfiguration, Grundeinstellung und eine Baseline für bestehende Befunde anlegen: je einen für PHP, für JavaScript und Vue, für Python und für Markup. Für Go, Rust und Java gibt es laut Anbieter weder ein Statik- noch ein Mutations-Gate.

Was wir auf dem Mac erlebt haben

Zwei Dinge fielen auf, festgehalten im Aufgabenordner und im Audit-Protokoll: Die Projektwerkzeuge dieser Seite brauchen eine Bildbibliothek, die in keinem der drei Python-Interpreter auf dem Rechner installiert war; ein Importtest brach in allen drei ab, behoben haben wir das mit derselben Version, die auch der Build-Server nutzt. Und der Lösch-Riegel hat beim Aufräumen eines Probebaums in der Sitzung dieser Serie angehalten, weil ein Pfad in einer Shell-Variablen stand (Audit-Protokoll vom 4. November); was das bedeutet, steht in Vier harte Riegel.

Häufig gestellte Fragen

Muss ich Code Guardian in jedem Projekt neu installieren?

Nein. Es liegt im Nutzerverzeichnis von Claude Code und gilt für alle Projekte. Nur die Analysewerkzeuge werden je Projekt eingerichtet.

Wie kommen Updates?

Mit einem gültigen Lizenzschlüssel kann Claude Code oder Codex neue Versionen laut Anbieter selbst abrufen; die ersten 30 Tage nach dem Kauf sind Updates enthalten, danach über ein monatlich kündbares Abo. Details in Code Guardian kaufen.

Was ist, wenn ich kein jq installieren darf?

Dann laufen die vier Befehlssperren weiter, weil sie in Python prüfen. Die übrigen Hooks, die jq brauchen, bleiben stumm. Der Installer sagt das mit Rückgabewert 3.

Lässt es sich wieder entfernen?

Die Schnellstart-Seite behandelt das nicht; sie verweist auf die Hinweisdatei und die Update-Anleitung im Paket. Das Paket liegt im Nutzerverzeichnis; die Protokolldateien, die es während der Arbeit im Projekt anlegt (Audit-Protokoll, Ledger, Beweis-Ordner, Aufgabenliste), bleiben dort und werden von Hand entfernt.

Weiterlesen in dieser Serie

Code Guardian ansehen

Alle Angaben zu Umfang und Lizenz stehen beim Anbieter: Code Guardian bei Provimedia (öffnet in neuem Fenster)Anzeige. Mit dem Code PARTNER-4B79 erhalten Sie 10 % Rabatt auf den Einmalkauf der Firmenlizenz (nicht auf das Update-Abo; Stand 4. November 2026).

Mit „Anzeige“ markierte Links sind Partnerlinks. Kommt darüber ein Kauf zustande, erhalten wir eine Provision. Der Preis ändert sich für Sie nicht.

Code Guardian installieren: Claude Code, Codex, macOS, Linux, Windows