Codex CLI

Codex CLI, Pathrule çalışma alanınıza Pathrule CLI veya VS Code eklentisi üzerinden bağlanır. Entegrasyon üç parçadan oluşur: Codex'in yerleşik hook'ları, çalışma alanının kök dizinindeki tamamlayıcı AGENTS.md dosyası ve diğer istemcilerin de kullandığı MCP araç yüzeyinin aynısı. Codex, Claude Code ile birlikte Pathrule'un prompt gönderme hook'uyla ulaştığı iki istemciden biridir.

Bu sayfada entegrasyon için projenize nelerin yazıldığı, akışın Claude Code ve Cursor'dakinden nasıl ayrıldığı ve kurulumu nasıl doğrulayacağınız anlatılıyor.

Pathrule'un yazdıkları

Pathrule'u Codex CLI'a kurduğunuzda şunlar oluşur:

• Bir MCP sunucu girdisi, ~/.codex/config.toml içinde. Bu sayede asistan pathrule_* araçlarını çağırabilir. Bu dosyadaki diğer sunucularınız olduğu gibi kalır.
• .codex/hooks.json, projenin içinde. Hook kayıtları birleştirilerek yazılır, böylece kendi eklediğiniz hook'lar korunur.
• Projenin .codex/config.toml dosyasında işaretli bir blok, Codex'in hook'larını etkinleştirir. Dosyanın geri kalanı size aittir ve dokunulmaz.
• AGENTS.md, çalışma alanının kök dizininde. Hook kuruluyken Pathrule'un bu dosyadaki kısmı, Pathrule'un etkin olduğunu ve bilginin hook ile iletildiğini belirten kısa bir nottan ibarettir.
• Diske yazılmış beceriler, .agents/skills/<name>/SKILL.md altında. Böylece Codex bunları adıyla çağırabilir.

AGENTS.md, Codex için CLAUDE.md dosyasının karşılığıdır. Codex hook'u kuruluyken protokol dosya yerine SessionStart hook'u ile gelir, yola bağlı bilgi de prompt ve araç hook'ları üzerinden iletilir. Bu yüzden dizin ağacınıza protokol kopyası ya da bilgi dosyası yazılmaz. Hook yoksa AGENTS.md protokolün tamamını ve çalışma alanı özetini taşır, Pathrule da bilgi bağlanmış her dizine bir AGENTS.md ekler. Codex, çalışma o dizine girdiğinde bu dosyayı yükler.

Hook kapsamı

Codex'in hook sözleşmesi Claude Code'unkine yakındır. Pathrule oturum başlangıcı, prompt gönderme, araç öncesi, araç sonrası ve durdurma hook'larını kaydeder:

• Oturum başlangıcı, çalışma alanı meta verilerini, protokolü ve ekip bağlamınızı oturum başına bir kez iletir.
• Prompt gönderme, turu prompt'a uyan kurallar ve hafıza kayıtlarıyla kapsamlandırır. En güçlü hafıza kayıtları gövdelerinin tamamıyla gelir.
• Araç öncesi, yamanın ya da komutun dokunduğu yol için geçerli olanların adlarını ekler ve yama uygulanmadan önce onaylı engelleme kalıbı olan kuralları denetler.
• Araç sonrası, sonucu kaydeder.
• Durdurma, onaylı bir zorunlu kontrolün, komutu başarıyla geçene kadar turu açık tutmasını sağlar.

Claude Code'dan temel farklar araç yüzeyindedir: Codex ayrı Edit ve Write araçları yerine kendi apply_patch biçimini (*** Update File: işaretleriyle) kullanır ve Read hook'u yoktur. Pathrule'un ortak hook betiği apply_patch biçimini anlar, etkilenen yolları çalışma alanı düğümlerine çözümler ve yamayı düzenleme olarak ele alır. Böylece onaylı engelleme kalıbı olan bir kural, eşleşen bir yamayı uygulanmadan önce durdurur. Bir asistanın önerdiği engelleme kalıbı, bir kişi onaylayana kadar otomatik denetime girmez.

Emek istemcide değil, içerik katmanında durur. Bu yüzden aynı hafıza kayıtları, kurallar ve beceriler Codex'e de diğer tüm istemcilere de hizmet eder.

İstemci bazında yalıtım

Codex aynı makinede Claude Code ve Cursor ile birlikte çalışabilir. Bunlardan birini, ikisini ya da üçünü birden kurabilirsiniz. Hepsi aynı Pathrule çalışma alanını, aynı MCP sunucusunu ve aynı içerik ağacını paylaşır. Her istemcinin okuduğu yapılandırmalar ise birbirinden bağımsızdır.

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 Codex'i 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 Codex dosyalarını yazar. Pathrule'u hesap olmadan kullanmak için bunun yerine pathrule setup --local komutunu çalıştırın. Bu durumda bilgi bu makinede kalır.

Zaten bağlı olan bir klasörde parçaları elle kurmak için:

pathrule install codex
pathrule sync
pathrule doctor

pathrule install codex, MCP girdisini ~/.codex/config.toml dosyasına ekler. pathrule sync ise hook betiğini kurar ve proje dosyalarını bu klasör için seçilen yapay zekâ araçlarına göre, hiçbiri seçilmemişse klasörde algıladığı araçlara göre yazar.

VS Code eklentisi üzerinden kurmak için Connect AI Clients içinde Codex'i seçin. Eklenti, aynı MCP girdisini ve hook yapılandırmasını içinde gelen CLI ile yazar.

Remote MCP

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

codex mcp add pathrule --url https://cloud.pathrule.io/mcp

Ardından Pathrule hesabınızla OAuth girişini tamamlayın. Remote MCP, Codex'e yalnızca MCP araçlarını verir: hiçbir hook kurmaz, yerel dosya yazmaz ve yerel modu yoktur. Ayrıntılar için Pathrule Remote MCP sayfasına bakın.

Doğrulama

Codex CLI'ı bir çalışma alanına bağladığınız bir dizinde açın. Pathrule oturum meta verileri oturum başında gelmeli ve asistan, çalışma dizininiz için pathrule_get_context aracını çağırabilmelidir.

İçerik bulunan bir yola dokunan basit bir prompt çalıştırın. İlgili kurallar ve hafıza kayıtları prompt'la birlikte gelmeli, asistan da MCP üzerinden daha derine inebilmelidir. Hiçbir şey gelmiyorsa ş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 Codex ve diğer her istemci için kurulu olup olmadığını, klasörde hangi Pathrule yönetimli dosyaların bulunduğunu ve bunları kimin yazdığını raporlar. Tam rapor için --json ekleyin. Tam rapor, artık var olmayan bir çalışma ortamını gösteren MCP girdilerini de işaretler. pathrule repair eskimiş bir girdiyi yeniden yazar, hook betiğini ve hook yapılandırmasını yeniden kurar, AGENTS.md dosyasını yeniden senkronize eder ve doctor'ı tekrar çalıştırır.

Değişmeyenler

İçerik katmanı tüm istemcilerde aynıdır.

• Claude Code'a hook üzerinden gelen hafıza kaydının aynısı Codex'e de kendi hook'ları ve MCP araçları üzerinden gelir.
• Onaylı engelleme kalıbı olan bir kural, Claude Code'da bir düzenlemeyi nasıl engelliyorsa Codex'te de eşleşen bir yamayı öyle engeller.
• Bir beceri adıyla çağrılabilir.

Ekibiniz içeriği tek bir asistan için yazsa da her asistan ona ulaşır.

Sırada ne okumalı

• Yerleşik hook'larla çalışan kardeş entegrasyon için Claude Code.
• Cursor entegrasyonu için Cursor.
• Codex'in çağırabileceği tüm araçlar için MCP araçları referansı.