Claude Code ve Codex ayarlarını rulesync, Ruler ve agentsync ile eşitleme
Claude Code ve Codex için kuralları, becerileri ve MCP ayarlarını tek yerden yönetmenin yollarını karşılaştırıyoruz.
Güncelleme (9 Kasım 2026): Claude Fable 5.2 ve Mythos 5.2 çıktı - fiyatlar, erişim ve benchmark sonuçları Claude Fable 5.2 rehberimde.
👁 113 okunma
Kendim Claude Code ve Codex’i birlikte kullanmaya başladığımda, her kural değişikliği için iki ayrı yerde düzenleme yapmam gerekiyordu. Bir kuralı Claude’un belleğine ekliyor, sonra Codex’in bundan haberi olmadığını hatırlıyordum. Kuralları, becerileri ve MCP sunucularını tek bir yerde tutup diğer araçlara otomatik dağıtacak bir araç aradım. Birkaç tane buldum; hepsi ücretsiz ve MIT lisanslıydı. Ama hiçbirini kurmadım.
Aşağıda en ilginç bulduğum dört aracı karşılaştırıyor, tek kişi ve iki araç kullanırken neden kısa bir betiğin bana yettiğini, ekipler içinse neden başka bir seçim yapacağımı anlatıyorum.
Ayar eşitleme araçlarına kısa bakış
- rulesync: En geniş kapsamlı seçenek; onlarca araç için kurallar, komutlar, MCP, alt ajanlar ve beceriler. npm ile kuruluyor.
- Ruler: Projede tek bir
.ruler/klasörü veruler applykomutu kullanıyor; beceri desteği şimdilik deneysel. - agentsync: Genel kullanıma yönelik AGENTS.md, beceri klasörü ve MCP dosyası; kopyalar yerine bağlantılar, yedekleme ve geri alma özellikleri.
- agent-rules-sync: Dosyaları iki yönde ve sürekli izleyerek eşitleyen bir arka plan hizmeti.
- Benim tercihim: Codex’in yerleşik seçenekleri ve yaklaşık 100 satırlık bir betik.
Tek bir doğruluk kaynağı
Bu araçların çalışma mantığı benzer. Kuralları, becerileri ve MCP sunucusu tanımlarını tek bir yerde tutuyorsunuz; program da bunları her aracın beklediği biçimde kaydediyor: Claude Code için CLAUDE.md ve bir JSON dosyası, Codex için AGENTS.md ve config.toml, Cursor için ayrı kural dosyaları. Araçlar bu tek kaynağın nerede durduğu, kaç aracı desteklediği ve kopyaları mı yoksa bağlantıları mı dağıttığı konusunda farklılaşıyor.
rulesync en fazla içeriği destekliyor: kurallar, komutlar, MCP, yok sayma dosyaları, alt ajanlar ve beceriler. Desteklediği araçların listesinde Claude Code ve Codex CLI dâhil onlarca seçenek bulunuyor. npm install -g rulesync komutuyla kuruluyor. Önce rulesync import --targets claudecode komutuyla mevcut CLAUDE.md dosyasını .rulesync/ klasörüne aktarıyor, ardından rulesync generate ile içeriği diğer araçlara dağıtıyorsunuz.
Ruler proje düzeyinde çalışıyor. Kuralları .ruler/ klasöründeki Markdown dosyalarına, ayarları ve MCP sunucularını ruler.toml dosyasına yazıyorsunuz. ruler apply komutu bunları ajanlara kaydediyor. Codex için AGENTS.md, MCP ayarları için .codex/config.toml, beceriler içinse .agents/skills/ kullanılıyor. Geliştirici, beceri desteğini deneysel olarak işaretliyor. Ruler için Node.js 20.19 veya daha yeni bir sürüm gerekiyor.
agentsync tek bir projeye değil, genel ayarlara odaklanıyor. Bir AGENTS.md dosyanız, bir skills/ klasörünüz ve bir mcp.json dosyanız oluyor. Program, bilgisayarınızda bulabildiği desteklenen yirmiyi aşkın araca bunları bağlıyor. Kopya oluşturmak yerine bağlantı kullandığından, bir yerde yaptığınız değişiklik diğer araçlarda da hemen görülüyor. Yazmadan önce kontrol için (--check), değişiklikleri izlemek için (--watch) ve yedekten son duruma dönmek için (--rollback latest) seçenekleri var. Windows’ta sistem normal bağlantı oluşturmaya izin vermiyorsa klasör bağlantıları için geliştirici modunu açmak gerekiyor. Geliştirici ayrıca mcp.json dosyasını ortak bir depoya koymamanız konusunda uyarıyor; bu dosyada bazen belirteçler bulunabiliyor.
agent-rules-sync bir adım daha ileri gidiyor. pip install agent-rules-sync komutuyla kurduğunuzda sistem hizmeti olarak çalışıyor: herhangi bir araçta bir kuralı değiştirdiğinizde, değişikliği diğerlerine dağıtıyor. Kuralları ve becerileri iki yönde eşitliyor, Claude’un genel yapılandırmasındaki ayarları seçtiğiniz depolara aktarıyor ve MCP sunucu listelerini birleştiriyor.
Codex işin yarısını zaten hallediyor
Bu araçlardan birini kurmadan önce gerçekten neye ihtiyacınız olduğunu düşünün. Codex’in yerleşik iki seçeneği, benim sorunumun büyük bölümünü çözdü. İlki, ~/.codex/config.toml dosyasına eklenen project_doc_fallback_filenames = ["CLAUDE.md"] ayarı. Bu ayarla Codex, AGENTS.md bulunmayan yerlerde CLAUDE.md dosyasını okuyor; böylece proje kuralları kopyalamaya gerek kalmadan ortak oluyor. İkincisi beceri biçimi: SKILL.md dosyası içeren bir klasör iki araçta da çalışıyor; yalnızca dosyayı okudukları konum değişiyor.
Geriye genel kurallar ve beceriler kalıyordu. Genel AGENTS.md dosyasını bir kez yazdım ve Codex’e Claude belleği klasörünü bilgi kaynağı olarak gösterdim; böylece projelere ait notlar da ortak oldu. Beceri eşitlemek için yalnızca ~/.claude/skills klasöründekileri ~/.agents/skills klasörüne kopyalayan ve Codex’te elle oluşturduklarıma dokunmayan bir betik yeterli oldu. Betiği ve tüm adımları [pwlink slug=”claude-code-do-codexa”]Claude Code’dan Codex’e geçiş[/pwlink] yazısında paylaşıyorum.
Kendime ait altı becerim var; klavyenin başında tek kişi, kullandığım araç sayısı da iki. Arka planda hizmet olarak çalışan bir program, bende olmayan bir sorunu çözerken bozulabilecek yeni bir bileşen ekleyecekti. Codex’in resmî içe aktarma aracıyla da benzer bir sorun yaşadım: İlk dosyadaki Lehçe karakterlerde hata verdi.
Hazır bir araç ne zaman mantıklı?
Üç durumda tercih değişiyor:
- Ekipte herkes farklı araç kullanıyorsa. Bir kişi Cursor, diğeri Claude Code, bir başkası Codex kullanıyor ama proje kurallarının hepsinde aynı olması gerekiyorsa rulesync veya Ruler depoda düzeni sağlar. Bunu elle sürdürmek zor olur.
- Aynı bilgisayarda üçten fazla araç kullanıyorsanız. Claude Code, Codex, Gemini CLI ve Cursor’ı birlikte kullanırken agentsync bağlantıları epey iş azaltabilir.
- MCP sunucularını sık sık değiştiriyorsanız. Her araç bunları farklı biçimde kaydediyor: Codex TOML, Claude ise JSON kullanıyor. Bunları elle aktarmak kısa sürede sorun çıkarabiliyor.
İki araç kullanan tek kişiyseniz Codex’in yerleşik seçenekleriyle başlayın. Claude Code ile Codex’i iki yönde birlikte kullanmaya başlarsanız [pwlink slug=”wtyczka-codex-claude-code”]Claude Code için resmî Codex eklentisi[/pwlink] yazısı işinize yarayabilir. İki ayrı konumu elle takip etmek yorucu hâle geldiğinde hazır bir araç ekleyebilirsiniz. Bense bir beceriyi değiştirdikten sonra tek bir komut çalıştırıyorum: python synchronizuj-skille.py.
Kaynaklar
- rulesync: https://github.com/dyoshikawa/rulesync
- Ruler: https://github.com/intellectronica/ruler
- agentsync: https://github.com/x0c/agentsync
- agent-rules-sync: https://github.com/dhruv-anand-aintech/agent-rules-sync
- OpenAI, AGENTS.md ile özel talimatlar: https://learn.chatgpt.com/docs/agent-configuration/agents-md
- OpenAI, Agent Skills: https://learn.chatgpt.com/docs/build-skills


