Shopify CEO’su Claude Code’u Neden Yasaklamakla Tehdit Ediyor?

Shopify’ın Claude Code’u yasaklama ihtimali, görünüşte bir yapılandırma dosyası tartışması gibi duruyor. Ancak anlaşmazlığın asıl konusu, aynı kod deposunda çalışan farklı yapay zekâ yazılım araçlarının ortak kuralları okuyabilmesi.

Shopify CEO’su Tobi Lütke, Claude Code’un yalnızca Anthropic’e özgü CLAUDE.md düzenine bağlı kalmasının, mühendislerin aynı projede farklı araçlar kullanması durumunda “bölünmüş zihin” (split brain) sorununa yol açabildiğini söyledi. Lütke’ye göre büyük bir mühendislik organizasyonunda her araç için ayrı yönerge dosyaları tutmak yerine, tüm ajanların okuyabileceği tek bir ortak kaynak bulunmalı. 415

Shopify’ın itirazı ne?

AGENTS.md, yazılım geliştirme ajanlarına proje hakkında özel bağlam sağlayan basit bir Markdown dosyasıdır. Dosyada projenin nasıl derleneceği ve test edileceği, hangi kodlama kurallarının izleneceği, hangi dizinlere dokunulmaması gerektiği ve katkı süreçleri gibi bilgiler yer alabilir. Dosyanın depoyla birlikte sürüm kontrolünde tutulması, yönergelerin belirli bir geliştiricinin kullandığı araca değil, doğrudan kod tabanına eşlik etmesini sağlar. 2931

Claude Code’un belgelenen proje bağlamı ise CLAUDE.md, .claude/rules, proje becerileri (skills), kancalar (hooks) ve ayar dosyaları etrafında şekilleniyor. Sistem, mevcut dizinde ve üst dizinlerde bulunan dosyaları keşfederek kendine ait özyinelemeli bir yönerge yapısı oluşturuyor. 2

Bu yaklaşım tek başına çalışan bir geliştirici için yönetilebilir olabilir. Fakat büyük bir monorepo’da ekipler aynı anda Claude Code’un yanı sıra Codex, Cursor, Gemini CLI veya GitHub Copilot da kullanıyorsa konu büyüyor. Bir araç AGENTS.md dosyasını okurken diğeri yalnızca CLAUDE.md dosyasını okuduğunda, aynı dizin farklı ajanlara farklı test komutları, kodlama kuralları ya da “bu dosyayı değiştirme” sınırları sunabiliyor.

Monorepo’larda sorun neden yalnızca çift dokümantasyon değil?

Bir şirketin birden fazla yapay zekâ kodlama ajanını aynı anda kullanması hâlinde önündeki seçenekler pek cazip değil:

• depo kökünde hem AGENTS.md hem de CLAUDE.md dosyasını tutmak;
• gerekli alt dizinlerde aynı içeriği tekrar etmek;
• kod tabanı değiştikçe iki dosyayı senkronize etmek;
• yönergelerin birbirinden uzaklaşıp uzaklaşmadığını denetlemek için ek araçlar veya kontroller geliştirmek.

Dosyalardan birinin güncellenmemesi, basit bir dokümantasyon kusuru olarak kalmayabilir. Bir ajan yeni test komutunu izlerken diğeri artık geçerli olmayan komutu kullanabilir. Bir ajan belirli bir klasöre yönelik kısıtlamayı görebilirken diğeri bu kuraldan habersiz olabilir. Sonuç; tutarsız kod değişiklikleri, farklı inceleme sonuçları ve ekip beklentileri anlamına gelebilir. Lütke’nin “bölünmüş zihin” olarak tanımladığı sorun tam da bu. 47

Claude Code için açılan herkese açık özellik talebinde de sorun doğrudan tarif ediliyor: Depoda AGENTS.md bulunduğunda Claude Code bu bağlamı görmezden gelebiliyor; geliştiricinin yönergeleri yeniden CLAUDE.md dosyasına yazması gerekiyor. 12

AGENTS.md nasıl bir birlikte çalışabilirlik meselesine dönüştü?

AGENTS.md, OpenAI’nin Codex ekosistemiyle ilişkilendirilen açık bir yaklaşım olarak ortaya çıktı. Formatın gelişiminde Google, OpenAI, Sourcegraph, Factory ve Cursor gibi şirketlerin yer aldığı daha geniş bir sektör iş birliği rol oynadı. 1931

9 Aralık 2025’te OpenAI ve Anthropic, AGENTS.md ile diğer ajan altyapılarını Linux Foundation destekli Agentic AI Foundation’a bağışladı. Vakfın amacı, ajan teknolojilerinin tek bir ticari araç üreticisinin kontrolünde kalması yerine açık ve birlikte çalışabilir bir altyapının tarafsız biçimde yönetilmesini sağlamak. 2829

Formatın yaygınlaşması, Shopify ile Anthropic arasındaki tartışmaya pratik bir ağırlık kazandırıyor. Linux Foundation’a göre AGENTS.md, Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules ve VS Code’un da aralarında bulunduğu araçlar ve çerçevelerle birlikte 60 binden fazla açık kaynak projesinde kullanılıyor. 31

Bu durum AGENTS.md dosyasını herkes için zorunlu, resmî bir teknik standart hâline getirmiyor. Ancak dosya, ekiplerin proje yönergelerini tek bir görünür ve sürüm kontrollü yerde tutmasına yardımcı olan, araçlar arası yaygın bir taşınabilirlik katmanı işlevi görüyor.

Claude Code hangi çözümleri sunuyor?

Belgelenen geçici çözümlerden biri, Claude Code’un ortak yönergeleri kendi yerel yapılandırması üzerinden yüklemesini sağlamak. Örneğin CLAUDE.md içine AGENTS.md dosyasını içe aktaran bir satır eklenebiliyor. Bir başka yöntem ise sembolik bağlantı veya benzeri bir yapılandırma köprüsü kullanmak. 69

Bu yöntemler kısa vadede uyumsuzluğu azaltabilir; ancak yerel ve doğal desteğin yerini tam olarak tutmuyor. Her depoya özel kurulum yapılmasını gerektiriyor ve içe aktarma sırası, öncelik, dizin kapsamı ile güncellemelerin nasıl yönetileceği sorumluluğunu şirkete bırakıyor. Sembolik bağlantılar da işletim sistemi, Git ayarları, IDE’ler, konteynerler ve kurumsal güvenlik politikalarıyla farklı biçimlerde çalışabilir.

Tartışmada Anthropic adına yanıt veren Thariq, Claude Code’u daha kolay özelleştirilebilir hâle getirmek için çalıştıklarını; bunun AGENTS.md dosyasını kullanmayı veya diğer sistem istemi ayarlarını değiştirmeyi kolaylaştıracağını söyledi. 15 Mevcut kaynaklar, Anthropic’in neden yerel desteği doğrudan eklemediğine ilişkin kesin ve doğrulanmış bir teknik ya da ticari gerekçe sunmuyor. Bu nedenle şirketin motivasyonuna dair kesin hükümler spekülasyon olarak değerlendirilmelidir.

Ortaya çıkan standart çelişkisi

Tartışmayı dikkat çekici kılan noktalardan biri de Anthropic’in Agentic AI Foundation ekosisteminde yer alması, buna karşın Claude Code’un belgelenen proje yönergelerinde Anthropic’e özgü dosyaların merkezde durması. 22829

Bu durum tek başına Anthropic’in açık standartlara karşı olduğu anlamına gelmeyebilir. Bir araç üreticisi, ortak bir temel standardı desteklerken kendi modellerine veya ürün özelliklerine özel uzantıları koruyabilir. Ancak kurumsal müşteriler açısından kritik soru daha basit: Projenin temel yönergeleri başka bir araç tarafından kullanılmadan önce yeniden yazılmak veya bir köprüyle bağlanmak zorunda mı?

Bu restleşme yapay zekâ geliştirici araçlarını nasıl etkileyebilir?

Sürekli bir “yapılandırma vergisi”

Her üreticiye özgü yönerge ağacı; yinelenen dosyalar, senkronizasyon kontrolleri, taşıma betikleri ve testler anlamına geliyor. Kuruluşlar daha fazla kodlama ajanı ekledikçe bu bakım yükü, kullanılan araç ve depo kapsamlarının sayısıyla birlikte büyüyor.

Üretici bağımlılığına karşı daha fazla baskı

Depo yönergeleri ekip alışkanlıklarını, güvenlik sınırlarını, iş akışlarını ve operasyonel bilgiyi içerebilir. Bu bilgiler tek bir üreticinin formatında en iyi şekilde çalışıyorsa araç değiştirmek veya birden fazla aracı paralel kullanmak pahalılaşır. Ortak bir format, geçiş maliyetini düşürür ve mühendislik yöneticilerinin satın alma kararlarında elini güçlendirir.

Muhtemel iki katmanlı model

En uygulanabilir sonuç, tüm özel formatların tek bir dosyayla ortadan kalkması olmayabilir. AGENTS.md gibi ortak bir temel, taşınabilir proje yönergelerini barındırırken CLAUDE.md veya başka üretici dosyaları isteğe bağlı gelişmiş özellikleri sunabilir. Böylece araçlar farklılaşmaya devam ederken temel proje bağlamı taşınabilir kalır.

Kurumsal müşteriler standartları belirleyebilir

Lütke’nin çıkışı, büyük müşterilerin küçük görünen bir uyumluluk talebini ürün şartına dönüştürebileceğini gösteriyor. Shopify gibi şirketler farklı araçların aynı yönergeleri okuyabilmesini dağıtım veya satın alma kriteri hâline getirirse, üreticiler birlikte çalışabilirliği topluluk için “olsa iyi olur” seviyesinden kurumsal kullanıma hazır olmanın temel şartlarından biri olarak görmek zorunda kalabilir.

Sonuç

Shopify, CLAUDE.md dosyasının AGENTS.md dosyasından özünde daha kötü olduğunu düşündüğü için Claude Code’u yasaklamakla tehdit etmiyor. Sorun, tek bir üreticinin varsayılan formatının, aynı kod tabanında çok sayıda mühendis ve birden fazla yapay zekâ ajanı çalıştığında ek maliyet yaratması.

AGENTS.md formatının yaygın kullanımı, Linux Foundation çatısı altındaki yönetişimi ve büyük kodlama araçları tarafından desteklenmesi onu güvenilir bir ortak katman hâline getiriyor. 2931 Claude Code’un içe aktarma seçenekleri ve sembolik bağlantıları geçici çözüm sunabilir; ancak entegrasyon yükünü her kuruluşun üzerine taşıyor.

Bu nedenle tartışmanın merkezindeki soru bir dosya adından daha büyük: Yapay zekâ kodlama ajanları birlikte çalışabilen geliştirici altyapılarına mı dönüşecek, yoksa proje bilgisinin her araç için yeniden uyarlandığı kapalı platformlar olarak mı kalacak?