Claude Code

Claude Code verbindet sich über Pathrule CLI oder die VS Code-Erweiterung mit deinem Pathrule-Workspace. Pathrule bietet dafür zwei Integrationsebenen: Hooks, die pfadbezogenen Kontext liefern, bevor der Agent handelt, und MCP-Tools, die Claude bei Bedarf selbst abruft. Claude Code ist neben Codex einer der beiden Clients, die Pathrule mit einem Prompt-Submit-Hook erreicht.

Diese Seite beschreibt, was in dein Projekt geschrieben wird, wie die beiden Ebenen zusammenspielen und wie du die Integration von Anfang bis Ende prüfst.

Zwei Ebenen, ein Workspace

• Hooks (Push). Claude Code ruft den Hook-Supervisor von Pathrule beim Start der Session, bei jedem Prompt und rund um Datei- und Shell-Tool-Aufrufe auf. Der Supervisor liest einen vorberechneten Ausschnitt aus dem lokalen Cache und gibt ihn als Kontext zurück.
• MCP-Tools (Pull). Reicht die Hook-Payload nicht aus (Prompts zur Erkundung, vollständige Memory-Inhalte, Schreibzugriffe), ruft Claude den Pathrule-MCP-Server direkt über Tools wie pathrule_get_context und pathrule_write_memory auf.

Hooks sind der Standardweg, MCP-Tools der Weg in die Tiefe. Beide speisen sich aus demselben Inhaltsbaum.

Begleitdateien

Wenn du Pathrule in Claude Code installierst, sind diese Dateien beteiligt.

• ~/.claude.json. Die Benutzerkonfiguration von Claude Code. Pathrule ergänzt hier seinen MCP-Server-Eintrag und lässt deine übrigen Server unangetastet.
• .claude/settings.json im Projekt. Pathrule führt seine Hook-Registrierungen in diese Datei ein und behält alle Hooks bei, die du selbst angelegt hast.
• CLAUDE.md. Ist der Hook installiert, besteht Pathrules Bereich in dieser Datei nur aus einem kurzen Hinweis, dass Pathrule aktiv ist und sein Wissen über den Hook geliefert wird. Alles, was du außerhalb dieses Bereichs geschrieben hast, bleibt deins.
• .claude/rules/*.md. Wird nur geschrieben, wenn der Hook nicht installiert ist, wie unten beschrieben.
• .claude/skills/<name>/SKILL.md. Die Skills deines Workspace, als Dateien abgelegt, damit Claude sie über ihren Namen aufrufen kann.

Protokoll und Pfadwissen müssen nicht in Dateien liegen. Ist der Claude Code-Hook installiert, kommt das Protokoll über den SessionStart-Hook und das Wissen über die Hooks pro Prompt und pro Tool-Aufruf. Pathrule entfernt deshalb die Protokollkopie und die Wissensdateien, die frühere Versionen geschrieben haben. Abgesehen von der Hook-Registrierung, dem kurzen Hinweis und deinen Skills schreibt es nichts in deinen Verzeichnisbaum. Ist der Hook nicht installiert, greift Pathrule auf die kompilierten Dateien zurück: das vollständige Protokoll und die Workspace-Übersicht in CLAUDE.md, eine Protokollkopie in .claude/rules/pathrule-protocol.md, das Workspace-Wissen in .claude/rules/pathrule-knowledge.md und eine CLAUDE.md in jedem Verzeichnis, dem Wissen zugeordnet ist.

Durchsetzung von Regeln

Eine Regel hat eine Priorität (high, medium, low), die bestimmt, wie weit oben sie erscheint. Über das Blockieren entscheidet die Priorität nicht. Eine Regel blockiert nur, wenn sie ein genehmigtes Blockiermuster hat: eine verbotene Form im Inhalt, einen verbotenen Speicherort für die Datei oder beides.

• Ein Assistent kann ein Blockiermuster vorschlagen, wenn er eine Regel schreibt oder aktualisiert. Der Vorschlag wird als solcher zusammen mit der Regel gespeichert und nicht durchgesetzt. Ein Agent kann ihn nicht genehmigen; blockiert wird erst, wenn ein Mensch das Pattern genehmigt hat.
• Bei PreToolUse prüft der Hook vor einer Bearbeitung oder einem Schreibvorgang den neuen Inhalt und den Zielpfad gegen jede Regel, die für diesen Pfad ein genehmigtes Blockiermuster hat, unabhängig von ihrer Priorität.
• Gibt es einen Treffer, lehnt der Hook den Tool-Aufruf ab, bevor die Datei geschrieben wird. Claude sieht Pathrule blocked: mit dem Namen der Regel, einer Vorschau der Regel, der genehmigten „do this instead“-Nachricht und einem Verweis auf die vollständige Regel und versucht es dann innerhalb der Vorgabe erneut.

Alle anderen Regeln sind Empfehlungen. Sie werden als Kontext mitgeliefert, und der Assistent entscheidet, wie er sie anwendet. Blockiert wird über den lokalen Hook; Remote MCP hat keine Hooks und liefert Regeln daher nur als Kontext.

Installation

Über Pathrule CLI:

pathrule setup

Führe den Befehl im Projektordner aus und wähle Claude Code, wenn nach deinen KI-Tools gefragt wird. Das Setup meldet dich bei Bedarf bei Pathrule Cloud an, verknüpft den Ordner mit einem Workspace, installiert den MCP-Eintrag, merkt sich deine Auswahl für diesen Ordner und schreibt den Hook und die Begleitdateien. Mit pathrule setup --local nutzt du Pathrule stattdessen ohne Konto; das Wissen bleibt dann auf diesem Rechner.

So richtest du die einzelnen Teile von Hand in einem bereits verknüpften Ordner ein:

pathrule install claude
pathrule sync
pathrule doctor

pathrule install claude ergänzt den MCP-Eintrag in ~/.claude.json. pathrule sync installiert das Hook-Skript und schreibt .claude/settings.json, CLAUDE.md und deine Skills für die KI-Tools, die für diesen Ordner ausgewählt sind.

In der VS Code-Erweiterung wählst du Claude Code unter Connect AI Clients. Die Erweiterung schreibt über ihre mitgelieferte CLI denselben MCP-Eintrag und dieselbe Hook-Konfiguration.

Remote MCP

Claude Code kann sich auch ohne lokale Installation mit dem gehosteten Endpunkt verbinden:

claude mcp add --transport http pathrule https://cloud.pathrule.io/mcp

Schließe danach die OAuth-Anmeldung mit deinem Pathrule-Konto ab. Remote MCP stellt Claude ausschließlich die MCP-Tools bereit: Es installiert keine Hooks, schreibt keine lokalen Dateien und hat keinen lokalen Modus. Siehe Pathrule Remote MCP.

Prüfen

Öffne Claude Code in einem verknüpften Verzeichnis und starte einen neuen Turn. Der Pathrule-Abschnitt sollte vor dem ersten Tool-Aufruf im Kontext erscheinen und den aufgelösten Pfad, die passenden Regeln, die Inhalte der stärksten Memories und weniger sichere Kandidaten mit ihrem Titel auflisten.

Erscheint nichts, führe Folgendes aus:

pathrule doctor

Der Doctor ändert nichts, er liest nur. Er meldet deine Anmeldung, den Workspace und ob dieser Ordner verknüpft ist, ob der Pathrule-MCP-Eintrag für Claude Code und jeden anderen Client installiert ist und welche von Pathrule verwalteten Dateien im Ordner liegen und wer sie geschrieben hat. Mit --json erhältst du den vollständigen Bericht, der zusätzlich MCP-Einträge markiert, die auf eine nicht mehr vorhandene Runtime verweisen. Um alles wieder in Ordnung zu bringen, führe Folgendes aus:

pathrule repair

Repair schreibt einen veralteten MCP-Eintrag neu, installiert Hook-Skript und Hook-Registrierung erneut, synchronisiert CLAUDE.md und deine Skills neu und führt anschließend den Doctor noch einmal aus.

Wenn Claude Inhalte schreibt

Claude kann über die MCP-Schreib-Tools Memories, Regeln und Skills zurück in Pathrule schreiben. Die Runtime kennzeichnet die Quelle als claude, sodass sich von einer KI geschriebene Inhalte weiterhin von Inhalten unterscheiden lassen, die ein Mensch geschrieben hat.

Nutze das Tool pathrule_log_activity, damit jede Antwort, die Dateien ändert, im Aktivitätsprotokoll sichtbar wird. Das ist die Brücke zwischen dem, was Claude getan hat, und dem, was dein Team sieht.

Weiterlesen

• So funktionieren Hooks für das Modell hinter der Push-Ebene.
• MCP-Überblick für die Pull-Ebene.
• MCP-Tools-Referenz für alle Tools, die Claude aufrufen kann.