Claude Code

O Claude Code se conecta ao seu espaço de trabalho do Pathrule pelo Pathrule CLI ou pela extensão do VS Code. O Pathrule oferece duas camadas de integração: hooks que enviam contexto vinculado ao caminho antes que o agente aja, e ferramentas MCP que o Claude pode consultar quando precisa de mais. O Claude Code é um dos dois clientes, junto com o Codex, que o Pathrule alcança com um hook de envio de prompt.

Esta página mostra o que é gravado no seu projeto, como as duas camadas se encaixam e como verificar a integração de ponta a ponta.

Duas camadas, um espaço de trabalho

• Hooks (push). O Claude Code aciona o supervisor de hooks do Pathrule no início da sessão, a cada prompt e em torno das chamadas de ferramentas de arquivo e de shell. O supervisor lê uma fatia pré-calculada do cache local e a devolve como contexto.
• Ferramentas MCP (pull). Quando o conteúdo do hook não basta (prompts de exploração, corpos completos de memórias, gravações), o Claude chama o servidor MCP do Pathrule diretamente, com ferramentas como pathrule_get_context e pathrule_write_memory.

Os hooks são o padrão. As ferramentas MCP são o caminho para ir mais fundo. A mesma árvore de conteúdo alimenta as duas.

Arquivos complementares

Quando você instala o Pathrule no Claude Code, estes são os arquivos envolvidos.

• ~/.claude.json. A configuração de usuário do Claude Code. O Pathrule adiciona aqui a entrada do seu servidor MCP e não mexe nos seus outros servidores.
• .claude/settings.json no projeto. O Pathrule mescla os registros de hooks dele neste arquivo e mantém os hooks que você mesmo adicionou.
• CLAUDE.md. Com o hook instalado, a região do Pathrule neste arquivo é uma nota curta dizendo que o Pathrule está ativo e que o conhecimento dele é entregue pelo hook. Tudo o que você escreveu fora dessa região continua sendo seu.
• .claude/rules/*.md. Gravados apenas quando o hook não está instalado, conforme descrito abaixo.
• .claude/skills/<name>/SKILL.md. Skills vinculadas ao seu espaço de trabalho, materializadas para que o Claude possa invocá-las pelo nome.

O protocolo e o conhecimento por caminho não precisam ficar em arquivos. Quando o hook do Claude Code está instalado, o protocolo vai junto com o hook SessionStart e o conhecimento chega pelos hooks por prompt e por ferramenta; por isso o Pathrule remove a cópia do protocolo e os arquivos de conhecimento que gravou em versões anteriores. Além do registro do hook, da nota curta e das suas skills, ele não grava nada na sua árvore. Se o hook não estiver instalado, o Pathrule recorre aos arquivos compilados: o protocolo completo e a visão geral do espaço de trabalho no CLAUDE.md, uma cópia do protocolo em .claude/rules/pathrule-protocol.md, o conhecimento do espaço de trabalho em .claude/rules/pathrule-knowledge.md e um CLAUDE.md em cada diretório que tem conhecimento vinculado.

Aplicação de regras

Uma regra tem uma prioridade (high, medium, low) que define com que destaque ela aparece. A prioridade não decide o bloqueio. Uma regra só bloqueia quando tem um padrão de bloqueio aprovado: uma forma proibida no conteúdo, um local proibido para o arquivo, ou ambos.

• Um assistente pode propor um padrão de bloqueio quando grava ou atualiza uma regra. A proposta fica armazenada com a regra como proposta e não é aplicada. Um agente não pode aprová-la; nada é bloqueado até que uma pessoa aprove o padrão.
• No PreToolUse, antes de uma edição ou gravação, o hook compara o novo conteúdo e o caminho de destino com todas as regras que têm um padrão de bloqueio aprovado para aquele caminho, qualquer que seja a prioridade delas.
• Se houver correspondência, o hook nega a chamada de ferramenta antes que o arquivo seja gravado. O Claude vê Pathrule blocked: com o nome da regra, uma prévia dela, a mensagem aprovada de "faça isto em vez disso" e um link para a regra completa, e tenta de novo respeitando a restrição.

Todas as outras regras são orientativas. Elas acompanham o trabalho como contexto e o assistente decide como aplicá-las. O bloqueio acontece pelo hook local; o Remote MCP não tem hooks, então ele apresenta as regras apenas como contexto.

Instalação

Pelo Pathrule CLI:

pathrule setup

Execute o comando na pasta do projeto e escolha Claude Code quando ele perguntar quais ferramentas de IA você usa. O setup faz você entrar no Pathrule Cloud quando necessário, vincula a pasta a um espaço de trabalho, instala a entrada do MCP, guarda a sua escolha para esta pasta e grava o hook e os arquivos complementares. Para usar o Pathrule sem conta, execute pathrule setup --local; nesse caso, o conhecimento fica nesta máquina.

Para configurar as peças manualmente em uma pasta que já está vinculada:

pathrule install claude
pathrule sync
pathrule doctor

pathrule install claude adiciona a entrada do MCP ao ~/.claude.json. pathrule sync instala o script do hook e grava .claude/settings.json, CLAUDE.md e as suas skills para as ferramentas de IA escolhidas para esta pasta.

Pela extensão do VS Code, escolha Claude Code em Connect AI Clients. A extensão grava a mesma entrada do MCP e a mesma configuração de hooks usando o CLI que vem embutido nela.

Remote MCP

O Claude Code também pode se conectar ao endpoint hospedado, sem nenhuma instalação local:

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

Depois, conclua o login OAuth com a sua conta do Pathrule. O Remote MCP dá ao Claude apenas as ferramentas MCP: ele não instala hooks, não grava arquivos locais e não tem modo local. Veja Pathrule Remote MCP.

Verificação

Abra o Claude Code em um diretório que você vinculou. Comece um novo turno. A seção do Pathrule deve aparecer no contexto antes da primeira chamada de ferramenta, listando o caminho que ele resolveu, as regras correspondentes, os corpos das memórias mais fortes e, pelo título, os candidatos menos certos.

Se nada aparecer, execute:

pathrule doctor

O doctor é somente leitura. Ele informa o seu login, o espaço de trabalho e se esta pasta está vinculada, se a entrada do MCP do Pathrule está instalada para o Claude Code e para cada um dos outros clientes, e quais arquivos gerenciados pelo Pathrule existem na pasta e quem os gravou. Adicione --json para ver o relatório completo, que também aponta uma entrada do MCP que referencia um runtime que não existe mais. Para colocar tudo de volta no lugar, execute:

pathrule repair

O repair regrava uma entrada do MCP desatualizada, reinstala o script e o registro do hook, sincroniza de novo o CLAUDE.md e as suas skills e executa o doctor outra vez.

Quando o Claude grava conteúdo

O Claude pode gravar memórias, regras e skills de volta no Pathrule usando as ferramentas de gravação do MCP. O runtime marca a origem como claude, para que o conteúdo escrito por uma IA continue distinguível do conteúdo escrito por uma pessoa.

Use a ferramenta pathrule_log_activity para que toda resposta que modifica arquivos apareça no log de atividades. É ela que liga o que o Claude fez ao que a sua equipe vê.

O que ler em seguida

• Como os hooks funcionam, para entender o modelo por trás da camada de push.
• Visão geral do MCP, para a camada de pull.
• Referência das ferramentas MCP, com todas as ferramentas que o Claude pode chamar.