Claude Code

Claude Code, Pathrule çalışma alanınıza Pathrule CLI veya VS Code eklentisi üzerinden bağlanır. Pathrule iki entegrasyon katmanı sunar: ajan işe başlamadan önce yola bağlı bağlamı ileten hook'lar ve Claude daha fazlasına ihtiyaç duyduğunda kendisinin çağırdığı MCP araçları. Claude Code, Codex ile birlikte Pathrule'un prompt gönderim hook'uyla ulaştığı iki istemciden biridir.

Bu sayfa projenize nelerin yazıldığını, iki katmanın birbirini nasıl tamamladığını ve entegrasyonu baştan sona nasıl doğrulayacağınızı anlatır.

İki katman, tek çalışma alanı

• Hook'lar (push). Claude Code, Pathrule'un hook yöneticisini oturum başında, her prompt'ta ve dosya ile kabuk araç çağrılarının öncesinde ve sonrasında çalıştırır. Hook yöneticisi yerel önbellekten önceden hesaplanmış ilgili kısmı okur ve bağlam olarak döndürür.
• MCP araçları (pull). Hook'un ilettiği içerik yetmediğinde (keşif amaçlı prompt'lar, hafıza kayıtlarının tam içeriği, yazma işlemleri) Claude, pathrule_get_context ve pathrule_write_memory gibi araçlarla Pathrule MCP sunucusunu doğrudan çağırır.

Varsayılan yol hook'lardır. MCP araçları derinlemesine erişim yoludur. İkisini de aynı içerik ağacı besler.

Eşlik eden dosyalar

Pathrule'u Claude Code'a kurduğunuzda ilgili dosyalar şunlardır.

• ~/.claude.json. Claude Code'un kullanıcı yapılandırması. Pathrule kendi MCP sunucu girdisini buraya ekler ve diğer sunucularınıza dokunmaz.
• Projedeki .claude/settings.json. Pathrule kendi hook kayıtlarını bu dosyaya birleştirir ve sizin eklediğiniz hook'ları korur.
• CLAUDE.md. Hook kuruluyken bu dosyadaki Pathrule bölümü, Pathrule'un etkin olduğunu ve bilgisinin hook ile iletildiğini belirten kısa bir nottan ibarettir. Bu bölümün dışında yazdığınız her şey size aittir.
• .claude/rules/*.md. Yalnızca hook kurulu olmadığında yazılır; aşağıda açıklanmıştır.
• .claude/skills/<name>/SKILL.md. Çalışma alanınıza bağlı beceriler; Claude'un bunları adıyla çağırabilmesi için dosya olarak oluşturulur.

Protokolün ve yola ait bilginin dosyalarda durması gerekmez. Claude Code hook'u kuruluyken protokol SessionStart hook'uyla, bilgi ise prompt başına ve araç başına çalışan hook'larla gelir; bu yüzden Pathrule önceki sürümlerde yazdığı protokol kopyasını ve bilgi dosyalarını kaldırır. Hook kaydı, kısa not ve becerileriniz dışında ağacınıza hiçbir şey yazmaz. Hook kurulu değilse Pathrule derlenmiş dosyalara geri döner: tam protokol ve çalışma alanı özeti CLAUDE.md içinde, bir protokol kopyası .claude/rules/pathrule-protocol.md içinde, çalışma alanı bilgisi .claude/rules/pathrule-knowledge.md içinde ve bilgi bağlanmış her dizinde bir CLAUDE.md bulunur.

Kuralların otomatik denetimi

Her kuralın ne kadar öne çıkacağını belirleyen bir önceliği (high, medium, low) vardır. Öncelik engellemeye karar vermez. Bir kural yalnızca onaylanmış bir engelleme kalıbı taşıdığında engeller: içerikte yasaklanmış bir biçim, dosya için yasaklanmış bir konum ya da ikisi birden.

• Bir asistan, kural yazarken veya güncellerken bir engelleme kalıbı önerebilir. Öneri kuralla birlikte öneri olarak saklanır ve uygulanmaz. Ajan bunu onaylayamaz; bir kişi kalıbı onaylayana kadar hiçbir şey engellenmez.
• PreToolUse sırasında, bir düzenleme veya yazmadan önce hook yeni içeriği ve hedef yolu, önceliği ne olursa olsun o yol için onaylanmış engelleme kalıbı taşıyan her kurala karşı kontrol eder.
• Biri eşleşirse hook, dosya yazılmadan önce araç çağrısını reddeder. Claude, kural adı, kuralın bir önizlemesi, onaylanmış "bunun yerine şunu yap" mesajı ve tam kurala bir yönlendirmeyle birlikte Pathrule blocked: ifadesini görür ve kısıtlamaya uyarak yeniden dener.

Diğer tüm kurallar tavsiye niteliğindedir. Bağlamla birlikte gelir ve asistan bunları nasıl uygulayacağına kendisi karar verir. Engelleme yerel hook üzerinden çalışır; Remote MCP'de hook bulunmadığı için kurallar yalnızca bağlam olarak sunulur.

Kurulum

Pathrule CLI ile:

pathrule setup

Komutu proje klasöründe çalıştırın ve hangi yapay zekâ araçlarını kullandığınız sorulduğunda Claude Code'u seçin. Kurulum gerekirse sizi Pathrule Cloud'a giriş yaptırır, klasörü bir çalışma alanına bağlar, MCP girdisini kurar, bu klasör için seçiminizi hatırlar ve hook ile eşlik eden dosyaları yazar. Hesap olmadan kullanmak için bunun yerine pathrule setup --local komutunu çalıştırın; bu durumda bilgi bu makinede kalır.

Zaten bağlanmış bir klasörde parçaları elle bağlamak için:

pathrule install claude
pathrule sync
pathrule doctor

pathrule install claude komutu MCP girdisini ~/.claude.json dosyasına ekler. pathrule sync komutu hook betiğini kurar ve bu klasör için seçilen yapay zekâ araçlarına yönelik .claude/settings.json, CLAUDE.md dosyalarını ve becerilerinizi yazar.

VS Code eklentisi üzerinden kurmak için Connect AI Clients içinde Claude Code'u seçin. Eklenti aynı MCP girdisini ve hook yapılandırmasını kendi içinde gelen CLI aracılığıyla yazar.

Remote MCP

Claude Code, yerel kurulum gerektirmeden barındırılan uç noktaya da bağlanabilir:

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

Ardından Pathrule hesabınızla OAuth girişini tamamlayın. Remote MCP, Claude'a yalnızca MCP araçlarını sağlar: hook kurmaz, yerel dosya yazmaz ve yerel modu yoktur. Bkz. Pathrule Remote MCP.

Doğrulama

Claude Code'u bağladığınız bir dizinde açın. Yeni bir tur başlatın. Pathrule bölümü ilk araç çağrısından önce bağlam alanında görünmeli; çözümlediği yolu, eşleşen kuralları, en güçlü hafıza kayıtlarının içeriklerini ve daha az kesin adayları başlıklarıyla listelemelidir.

Hiçbir şey görünmüyorsa şunu çalıştırın:

pathrule doctor

Doctor yalnızca okuma yapar. Giriş durumunuzu, çalışma alanınızı ve bu klasörün bağlı olup olmadığını, Pathrule MCP girdisinin Claude Code ve diğer her istemci için kurulu olup olmadığını, klasörde Pathrule'un yönettiği hangi dosyaların bulunduğunu ve bunları kimin yazdığını raporlar. Tam rapor için --json ekleyin; bu rapor artık var olmayan bir çalışma ortamını gösteren MCP girdilerini de işaretler. Her şeyi yerine oturtmak için şunu çalıştırın:

pathrule repair

Repair, eskimiş bir MCP girdisini yeniden yazar, hook betiğini ve hook kaydını yeniden kurar, CLAUDE.md dosyasını ve becerilerinizi yeniden senkronize eder ve doctor'ı tekrar çalıştırır.

Claude içerik yazdığında

Claude, MCP yazma araçlarını kullanarak Pathrule'a hafıza kayıtları, kurallar ve beceriler yazabilir. Çalışma ortamı kaynağı claude olarak etiketler; böylece yapay zekânın yazdığı içerik, bir kişinin yazdığı içerikten ayırt edilebilir kalır.

Dosya değiştiren her yanıtı etkinlik günlüğünde görünür kılmak için pathrule_log_activity aracını kullanın. Bu araç, Claude'un yaptıklarıyla ekibinizin gördükleri arasındaki köprüdür.

Sırada ne okumalı

• Push katmanının arkasındaki model için Hook'lar nasıl çalışır.
• Pull katmanı için MCP'ye genel bakış.
• Claude'un çağırabileceği tüm araçlar için MCP araçları referansı.