Claude Code

Claude Code se connecte à votre espace de travail Pathrule via Pathrule CLI ou l'extension VS Code. Pathrule propose deux couches d'intégration : des hooks qui transmettent le contexte lié au chemin avant que l'agent n'agisse, et des outils MCP que Claude peut solliciter lorsqu'il a besoin de plus. Claude Code est l'un des deux clients, avec Codex, que Pathrule atteint par un hook à la soumission du prompt.

Cette page décrit ce qui est écrit dans votre projet, la façon dont les deux couches s'articulent et comment vérifier l'intégration de bout en bout.

Deux couches, un seul espace de travail

• Hooks (push). Claude Code appelle le superviseur de hooks de Pathrule au démarrage de la session, à chaque prompt et autour des appels d'outils sur les fichiers et le shell. Le superviseur lit une portion précalculée dans le cache local et la renvoie comme contexte.
• Outils MCP (pull). Lorsque le contenu transmis par le hook ne suffit pas (prompts d'exploration, corps complets des mémoires, écritures), Claude appelle directement le serveur MCP de Pathrule via des outils comme pathrule_get_context et pathrule_write_memory.

Les hooks sont le mode par défaut. Les outils MCP sont la voie d'approfondissement. La même arborescence de contenu alimente les deux.

Fichiers associés

Voici les fichiers concernés lorsque vous installez Pathrule dans Claude Code.

• ~/.claude.json. La configuration utilisateur de Claude Code. Pathrule y ajoute l'entrée de son serveur MCP et ne touche pas à vos autres serveurs.
• .claude/settings.json dans le projet. Pathrule fusionne ses enregistrements de hooks dans ce fichier et conserve les hooks que vous avez ajoutés vous-même.
• CLAUDE.md. Avec le hook installé, la section de ce fichier gérée par Pathrule se limite à une courte note indiquant que Pathrule est actif et que ses connaissances sont fournies par le hook. Tout ce que vous avez écrit en dehors de cette section vous appartient.
• .claude/rules/*.md. Écrits uniquement lorsque le hook n'est pas installé, comme décrit ci-dessous.
• .claude/skills/<name>/SKILL.md. Les skills rattachés à votre espace de travail, matérialisés pour que Claude puisse les invoquer par leur nom.

Le protocole et les connaissances liées aux chemins n'ont pas besoin de résider dans des fichiers. Lorsque le hook Claude Code est installé, le protocole passe par le hook SessionStart et les connaissances arrivent par les hooks déclenchés à chaque prompt et à chaque appel d'outil ; Pathrule supprime donc la copie du protocole et les fichiers de connaissances écrits par les versions précédentes. En dehors de l'enregistrement du hook, de la courte note et de vos skills, il n'écrit rien dans votre arborescence. Si le hook n'est pas installé, Pathrule se rabat sur les fichiers compilés : le protocole complet et la vue d'ensemble de l'espace de travail dans CLAUDE.md, une copie du protocole dans .claude/rules/pathrule-protocol.md, les connaissances de l'espace de travail dans .claude/rules/pathrule-knowledge.md et un CLAUDE.md dans chaque répertoire auquel des connaissances sont rattachées.

Application des règles

Une règle possède une priorité (high, medium, low) qui détermine la façon dont elle remonte. La priorité ne décide pas du blocage. Une règle ne bloque que si elle porte un motif de blocage approuvé : une forme interdite dans le contenu, un emplacement interdit pour le fichier, ou les deux.

• Un assistant peut proposer un motif de blocage lorsqu'il écrit ou met à jour une règle. La proposition est enregistrée avec la règle en tant que proposition et n'est pas appliquée. Un agent ne peut pas l'approuver ; rien n'est bloqué tant qu'une personne n'a pas approuvé le motif.
• Sur PreToolUse, avant une modification ou une écriture, le hook compare le nouveau contenu et le chemin cible à chaque règle disposant d'un motif de blocage approuvé pour ce chemin, quelle que soit sa priorité.
• En cas de correspondance, le hook refuse l'appel d'outil avant l'écriture du fichier. Claude voit Pathrule blocked: avec le nom de la règle, un aperçu de celle-ci, le message approuvé « à faire à la place » et un renvoi vers la règle complète, puis réessaie en respectant la contrainte.

Toutes les autres règles sont indicatives. Elles accompagnent le contexte et l'assistant décide de la façon de les appliquer. Le blocage passe par le hook local ; Remote MCP n'a pas de hooks et ne présente donc les règles que comme contexte.

Installation

Via Pathrule CLI :

pathrule setup

Lancez cette commande dans le dossier du projet et choisissez Claude Code lorsqu'elle vous demande quels outils d'IA vous utilisez. La configuration vous connecte à Pathrule Cloud si nécessaire, rattache le dossier à un espace de travail, installe l'entrée MCP, mémorise votre choix pour ce dossier et écrit le hook ainsi que les fichiers associés. Lancez plutôt pathrule setup --local pour utiliser Pathrule sans compte ; les connaissances restent alors sur cette machine.

Pour assembler les éléments manuellement dans un dossier déjà rattaché :

pathrule install claude
pathrule sync
pathrule doctor

pathrule install claude ajoute l'entrée MCP à ~/.claude.json. pathrule sync installe le script du hook et écrit .claude/settings.json, CLAUDE.md et vos skills pour les outils d'IA choisis pour ce dossier.

Via l'extension VS Code, choisissez Claude Code dans Connect AI Clients. L'extension écrit la même entrée MCP et la même configuration de hooks grâce à son CLI intégré.

Remote MCP

Claude Code peut aussi se connecter à l'endpoint hébergé, sans aucune installation locale :

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

Effectuez ensuite la connexion OAuth avec votre compte Pathrule. Remote MCP ne donne à Claude que les outils MCP : il n'installe aucun hook, n'écrit aucun fichier local et ne propose pas de mode local. Consultez Pathrule Remote MCP.

Vérification

Ouvrez Claude Code dans un répertoire que vous avez rattaché. Démarrez un nouveau tour. La section Pathrule doit apparaître dans le contexte avant le premier appel d'outil, en indiquant le chemin résolu, les règles correspondantes, le corps des mémoires les plus pertinentes et, par leur titre, les candidates moins certaines.

Si rien n'apparaît, lancez :

pathrule doctor

Le diagnostic fonctionne en lecture seule. Il indique votre connexion, votre espace de travail et si ce dossier y est rattaché, si l'entrée MCP de Pathrule est installée pour Claude Code et pour chacun des autres clients, ainsi que les fichiers gérés par Pathrule présents dans le dossier et qui les a écrits. Ajoutez --json pour obtenir le rapport complet, qui signale aussi une entrée MCP pointant vers un environnement d'exécution qui n'existe plus. Pour tout remettre en place, lancez :

pathrule repair

La réparation réécrit une entrée MCP obsolète, réinstalle le script et l'enregistrement du hook, resynchronise CLAUDE.md et vos skills, puis relance le diagnostic.

Quand Claude écrit du contenu

Claude peut écrire des mémoires, des règles et des skills dans Pathrule grâce aux outils d'écriture MCP. L'environnement d'exécution marque la source comme claude, de sorte que le contenu écrit par une IA reste distinguable de celui écrit par une personne.

Utilisez l'outil pathrule_log_activity pour rendre visible dans le journal d'activité chaque réponse qui modifie des fichiers. C'est le lien entre ce que Claude a fait et ce que voit votre équipe.

Pour aller plus loin

• Fonctionnement des hooks pour le modèle sur lequel repose la couche push.
• Présentation du MCP pour la couche pull.
• Référence des outils MCP pour tous les outils que Claude peut appeler.