Claude Code

Claude Code se conecta a tu espacio de trabajo de Pathrule mediante Pathrule CLI o la extensión de VS Code. Pathrule ofrece dos capas de integración: hooks que envían contexto vinculado a una ruta antes de que el agente actúe, y herramientas MCP que Claude puede consultar cuando necesita más. Claude Code es uno de los dos clientes, junto con Codex, a los que Pathrule llega con un hook al enviar el prompt.

Esta página explica qué se escribe en tu proyecto, cómo encajan las dos capas y cómo verificar la integración de principio a fin.

Dos capas, un espacio de trabajo

• Hooks (push). Claude Code invoca el supervisor de hooks de Pathrule al iniciar la sesión, en cada prompt y alrededor de las llamadas a herramientas de archivos y de shell. El supervisor lee un fragmento precalculado de la caché local y lo devuelve como contexto.
• Herramientas MCP (pull). Cuando el contenido del hook no basta (prompts de exploración, cuerpos completos de memorias, escrituras), Claude llama directamente al servidor MCP de Pathrule mediante herramientas como pathrule_get_context y pathrule_write_memory.

Los hooks son la vía predeterminada. Las herramientas MCP son la vía para profundizar. El mismo árbol de contenido alimenta ambas.

Archivos complementarios

Cuando instalas Pathrule en Claude Code, estos son los archivos involucrados.

• ~/.claude.json. La configuración de usuario de Claude Code. Pathrule agrega aquí su entrada de servidor MCP y no toca tus otros servidores.
• .claude/settings.json en el proyecto. Pathrule combina sus registros de hooks con este archivo y conserva los hooks que hayas agregado tú.
• CLAUDE.md. Con el hook instalado, la sección de Pathrule en este archivo es una nota breve que indica que Pathrule está activo y que su conocimiento lo entrega el hook. Todo lo que escribiste fuera de esa sección sigue siendo tuyo.
• .claude/rules/*.md. Se escriben solo cuando el hook no está instalado, como se describe más abajo.
• .claude/skills/<name>/SKILL.md. Las skills asociadas a tu espacio de trabajo, materializadas para que Claude pueda invocarlas por nombre.

El protocolo y el conocimiento de cada ruta no tienen por qué vivir en archivos. Cuando el hook de Claude Code está instalado, el protocolo viaja con el hook SessionStart y el conocimiento llega mediante los hooks por prompt y por herramienta, así que Pathrule elimina la copia del protocolo y los archivos de conocimiento que escribía en versiones anteriores. Aparte del registro del hook, la nota breve y tus skills, no escribe nada en tu árbol. Si el hook no está instalado, Pathrule recurre a los archivos compilados: el protocolo completo y la descripción general del espacio de trabajo en CLAUDE.md, una copia del protocolo en .claude/rules/pathrule-protocol.md, el conocimiento del espacio de trabajo en .claude/rules/pathrule-knowledge.md y un CLAUDE.md en cada directorio que tenga conocimiento asociado.

Aplicación de reglas

Una regla tiene una prioridad (high, medium, low) que determina con cuánta prominencia aparece. La prioridad no decide el bloqueo. Una regla bloquea solo cuando tiene un patrón de bloqueo aprobado: una forma prohibida en el contenido, una ubicación prohibida para el archivo, o ambas.

• Un asistente puede proponer un patrón de bloqueo cuando escribe o actualiza una regla. La propuesta se guarda con la regla como propuesta y no se aplica. Un agente no puede aprobarla; nada se bloquea hasta que una persona haya aprobado el patrón.
• En PreToolUse, antes de una edición o una escritura, el hook compara el contenido nuevo y la ruta de destino con cada regla que tenga un patrón de bloqueo aprobado para esa ruta, sea cual sea su prioridad.
• Si alguna coincide, el hook rechaza la llamada a la herramienta antes de que se escriba el archivo. Claude ve Pathrule blocked: con el nombre de la regla, una vista previa de la regla, el mensaje aprobado de "haz esto en su lugar" y una referencia a la regla completa, y vuelve a intentarlo dentro de la restricción.

Todas las demás reglas son orientativas. Viajan como contexto y el asistente decide cómo aplicarlas. El bloqueo funciona mediante el hook local; Remote MCP no tiene hooks, así que muestra las reglas solo como contexto.

Instalación

Mediante Pathrule CLI:

pathrule setup

Ejecútalo en la carpeta del proyecto y elige Claude Code cuando te pregunte qué herramientas de IA usas. Setup inicia tu sesión en Pathrule Cloud si hace falta, asocia la carpeta a un espacio de trabajo, instala la entrada MCP, recuerda tu elección para esta carpeta y escribe el hook y los archivos complementarios. Ejecuta pathrule setup --local en su lugar para usar Pathrule sin cuenta; en ese caso el conocimiento se queda en esta máquina.

Para configurar las piezas a mano en una carpeta que ya está asociada:

pathrule install claude
pathrule sync
pathrule doctor

pathrule install claude agrega la entrada MCP a ~/.claude.json. pathrule sync instala el script del hook y escribe .claude/settings.json, CLAUDE.md y tus skills para las herramientas de IA elegidas para esta carpeta.

Mediante la extensión de VS Code, elige Claude Code en Connect AI Clients. La extensión escribe la misma entrada MCP y la misma configuración de hooks mediante su CLI integrada.

Remote MCP

Claude Code también puede conectarse al endpoint alojado, sin instalación local:

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

Después, completa el inicio de sesión con OAuth usando tu cuenta de Pathrule. Remote MCP le da a Claude solo las herramientas MCP: no instala hooks, no escribe archivos locales y no tiene modo local. Consulta Pathrule Remote MCP.

Verificación

Abre Claude Code en un directorio que hayas asociado. Inicia un turno nuevo. La sección de Pathrule debería aparecer en el contexto antes de la primera llamada a una herramienta, con la ruta que resolvió, las reglas que coinciden, los cuerpos de las memorias más relevantes y, por título, los candidatos menos seguros.

Si no aparece nada, ejecuta:

pathrule doctor

El doctor es de solo lectura. Informa tu sesión, tu espacio de trabajo y si esta carpeta está asociada, si la entrada MCP de Pathrule está instalada para Claude Code y para cada uno de los demás clientes, y qué archivos administrados por Pathrule hay en la carpeta y quién los escribió. Agrega --json para obtener el informe completo, que además señala una entrada MCP que apunta a un runtime que ya no existe. Para dejar todo en su lugar, ejecuta:

pathrule repair

Repair reescribe una entrada MCP obsoleta, reinstala el script del hook y el registro del hook, vuelve a sincronizar CLAUDE.md y tus skills, y ejecuta el doctor de nuevo.

Cuando Claude escribe contenido

Claude puede escribir memorias, reglas y skills de vuelta en Pathrule con las herramientas de escritura de MCP. El runtime etiqueta el origen como claude, de modo que el contenido escrito por una IA se puede distinguir del contenido escrito por una persona.

Usa la herramienta pathrule_log_activity para que cada respuesta que modifique archivos quede visible en el registro de actividad. Es el puente entre lo que hizo Claude y lo que ve tu equipo.

Qué leer a continuación

• Cómo funcionan los hooks para entender el modelo detrás de la capa push.
• Descripción general de MCP para la capa pull.
• Referencia de herramientas MCP para ver todas las herramientas que Claude puede llamar.