Ajanlar için sandbox yalıtımı
Sandbox hangi sınırları oluşturur?
Anthropic, sandbox yalıtımını iki sınır üzerinden açıklar: dosya sistemi ve ağ. Dosya sistemi sınırı, bir ajanın erişebileceği veya değiştirebileceği dizinleri belirler. Ağ sınırı ise bağlanabileceği sunucuları kısıtlar.
Anthropic'e göre etkili bir sandbox için iki sınır birlikte gerekir. Ağ yalıtımı olmadan ele geçirilmiş bir ajan hassas dosyaları dışarı aktarabilir. Dosya sistemi yalıtımı olmadan ise sandbox'tan çıkıp ağ erişimi elde edebilir.
Claude Code, shell komutları için işletim sisteminin uyguladığı bir sandbox kullanır. Bu sınır Bash, PowerShell ve Monitor komutlarına ve bunların başlattığı süreçlere uygulanır. Komutların erişebileceği dosyalar ve ağ alan adları ayarlarla belirlenir. Bir komutun başlattığı alt süreçler de aynı sınırların kapsamındadır.
Claude Code'da komut erişimi
Anthropic'e göre Claude Code'da sandbox varsayılan olarak kapalıdır. Bir oturumda /sandbox çalıştırıldığında sandbox paneli açılır. Panelde Mode, Overrides ve Config sekmeleri bulunur. Mode, sandbox içindeki komutların nasıl onaylanacağını belirler. Overrides, sandbox altında başarısız olan komutların sandbox dışında yeniden çalıştırılabilmesiyle ilgilidir. Config ise çözümlenmiş sandbox ayarlarını gösterir.
Sandbox, bir ayarlar dosyasında sandbox.enabled değeri true yapılarak da açılabilir. Panelde seçilen mod projenin yerel ayarlarına kaydedilir. Kullanıcı ayarlarındaki sandbox.enabled değeri ise sandbox'ı tüm projelerde açabilir. Claude Code, kuruluş genelinde sandbox uygulamak için managed settings de sunar.
Claude Code'un iki sandbox modunda aynı dosya sistemi ve ağ kısıtları uygulanır. Modlar, sandbox içindeki komutların onaylanma biçiminde ayrılır. Auto-allow modunda sandbox içindeki komutlar otomatik onaylanır. Regular permissions modunda ise komut sandbox içinde olsa da normal izin istemleri sürer.
Auto-allow her istemi ortadan kaldırmaz. Bir Bash deny kuralıyla eşleşen komut yine engellenir. Kritik bir yolu hedeflediği tespit edilen rm veya rmdir komutları normal izin akışından geçer. Bash(git push ) gibi içeriğe bağlı ask kuralları da sandbox içindeki komutlar için istem oluşturur.
Dosya okuma ve yazma alanı
Claude Code sandbox'ındaki komutlar varsayılan olarak çalışma dizinine, kullanıcıya ayrılmış geçici dizine ve eklenmiş dizinlere yazabilir. Yazma erişimine açık bir dizinin içindeki bazı korumalı yollar yine yazmaya kapalıdır. Varsayılan okuma alanı daha geniştir: komutlar makinenin büyük bölümünü, kimlik bilgisi dosyaları dahil okuyabilir.
Dosya erişimi için sandbox.filesystem.allowWrite, sandbox.filesystem.denyWrite ve sandbox.filesystem.denyRead alanları kullanılır. sandbox.filesystem.allowRead ise okuması engellenmiş bir alanın içindeki belirli yolları yeniden açabilir. Okuma kuralları çakıştığında daha dar yolu kapsayan kural uygulanır.
Claude Code, sandbox içindeki yazma kurallarını işletim sistemi düzeyinde uygular. Bu kurallar komutun başlattığı alt süreçler için de geçerlidir. Dosya sistemi listeleri bir oturum sırasında değiştirildiğinde yeni yollar sonraki sandbox komutuna uygulanır. Farklı ayar kapsamlarında aynı dosya sistemi dizisi tanımlanırsa Claude Code yolları birleştirir.
Bazı yollar çalışma dizininde bulunsalar bile sandbox içindeki komutların yazmasına kapalıdır. Anthropic'in saydığı örnekler arasında Claude Code ayar dosyaları, .claude/skills, .claude/agents, .mcp.json ve çalışma dizinindeki bazı shell başlangıç dosyaları bulunur. Sandbox bu korumayı komut çalışırken uygular. İzin sistemi ise araç çalışmadan önce ayrı bir değerlendirme yapar.
Ağ ve kimlik bilgileri
Claude Code sandbox'ındaki bir komutun dışarıya doğrudan ağ yolu yoktur. Bağlantılar, makinede çalışan bir proxy üzerinden geçer. Proxy her host'u izin verilen alan adlarıyla karşılaştırır. İzin verilen alan adları listesi başlangıçta boştur. Diğer host'lar için ne olacağını izin modu belirler.
Dosya sistemi ve ağ yalıtımı Claude Code'da bağımsız katmanlardır. sandbox.filesystem.disabled değeri true olduğunda dosya sistemi yalıtımı kapanırken ağ yalıtımı kalır. Bu durumda sandbox içindeki komutlar host dosya sisteminde sınırsız okuma ve yazma erişimi alır; ağ çıkışları ise izin verilen alan adlarıyla sınırlı kalır. Anthropic, bu durumda bir komutun sonraki komutların çalıştıracağı veya okuyacağı dosyaları değiştirebileceğini belirtir.
sandbox.credentials ayarı, sandbox içindeki komutlardan korunacak dosyaları ve environment variable'ları tanımlar. Bir dosya girdisindeki deny modu sandbox içinde okumayı engeller. Bir environment variable için aynı mod, her sandbox komutu çalışmadan önce değişkeni ortamdan kaldırır. Dosya koruması dosya sistemi katmanının parçasıdır. Environment variable koruması ise o katman kapatıldığında da uygulanır.
Claude Code'da yerleşik bir credential deny listesi yoktur. Bu ayarla yalnızca listelenen dosyalar ve değişkenler kısıtlanır. Ayrıca sandbox.credentials yalnızca sandbox içindeki Bash komutlarını etkiler. Dosya araçları ve sandbox dışında çalışan başka süreçler aynı kapsamda değildir.
Chainabit CLI'da güven ve izinler
Chainabit CLI, izin modunu, klasöre duyulan güveni ve işletim sistemi sandbox'ını ayrı sınırlar olarak tanımlar. İzin modu onayları yönetir. Klasör güveni ve işletim sistemi sandbox'ı ise hangi local tools'un kullanılabileceğini belirler. Bir mod, başka bir hesaba veya workspace'e erişim vermez.
Chainabit CLI'da local tools yalnızca güvenilen bir klasörde çalışır ve izin moduna uyar. Programlar yalnızca işletim sistemi sandbox'ı içinde çalıştırılır. Chainabit, sandbox'ı kullanmadan önce çalışan süreçte etkin olduğunu doğrular. Sandbox'ın bulunmadığı sistemlerde local programlar kullanılamaz. chainabit doctor, local execution durumunu ve kullanılan sandbox'ı bildirir.
Plan modunda local tools yalnızca dosya okur ve değişiklik yapılmaz. Ask before edits modunda da local tools dosya okuyabilir; her değişiklik kullanıcının onayını gerektirir. Auto approve modunda Chao, güvenilen klasörlerde dosyaları düzenleyebilir ve rutin sandbox programlarını sormadan çalıştırabilir. Güvenlik ve izin kuralları bu modda da uygulanır.
Plan, Ask before edits ve Auto approve modlarında silme işlemleri, interpreter çalıştırma ve başka araçların çalıştırdığı yapılandırmada değişiklik yapma işlemleri sorulmadan gerçekleşmez. Programdan ağ erişimi de izin ister. Chainabit, macOS üzerindeki Auto approve için bir istisna tanımlar: programlar yerel bir filtre üzerinden belirli developer registry'lerine ve yapılandırılmış hedeflere erişebilir. Filtre private veya local adreslere erişmez.
Klasör güveni hiyerarşiktir. Güvenilen bir klasör, altındaki klasörleri de kapsar; bir alt klasöre güven verilmesi üst klasöre güven vermez. Güven, diğer izinleri geçersiz kılmaz. İzin modu, güvenlik kuralları ve sandbox uygulanmaya devam eder. Güven kaldırıldığında bu karar sonraki istekte geçerli olur ve bekleyen dosya değişiklikleri yapılmaz.
Chainabit'e göre güvenilen klasörlerde de bazı alanlar local tools'a ve Chao'nun çalıştırdığı programlara kapalıdır. Bunlar arasında adlarıyla tanımlanan .env varyantları, .ssh, .aws, .gnupg, .kube, .git, özel anahtarlar ve sertifikalar bulunur. Chainabit yapılandırması, güven kayıtları ve konuşmalar da korunan alanlar arasındadır.
Sınırlar ve kapsam dışındaki işlemler
Claude Code sandbox'ı shell komutlarını kapsar. Anthropic'e göre yerleşik Read, Edit, Write, WebFetch ve WebSearch araçları sandbox dışında çalışır ve kendi izin kurallarına uyar. Bir denyRead girdisi Read aracını durdurmaz; allowedDomains da WebFetch erişimini sınırlamaz. Local MCP server'lar, command hook'ları ve bazı yardımcı süreçler de sandbox dışında kullanıcının tam erişimiyle çalışır.
Claude Code'da excludedCommands ile eşleşen komutlar sandbox dışında çalışır. Bu komutlara sandbox'ın dosya sistemi kısıtları ve ağ proxy'si uygulanmaz. Sandbox içindeki bir komut başarısız olduğunda Claude ayrıca komutu sandbox dışında yeniden çalıştırmak için izin isteyebilir. allowUnsandboxedCommands değerinin false olması bu yeniden deneme yolunu kapatır; excludedCommands ile eşleşen komutlar ayrı kalır.
Anthropic'e göre platform sandbox'ı desteklemediğinde veya başlangıçtaki bağımlılık denetimi başarısız olduğunda Claude Code varsayılan olarak komutları sandbox olmadan çalıştırır. sandbox.failIfUnavailable değeri true yapılırsa bu durumda başlangıçta çıkar. Linux ve WSL2 üzerinde dosya sistemi yalıtımı için bubblewrap, ağ trafiğini proxy üzerinden yönlendirmek için socat kullanılır.
Chainabit, güven kaldırıldığında kendi oturumuna ayrılmış bir programın çalışmayı sürdürebileceğini belirtir. Görünür bir klasörde önceden oluşturulmuş ve kapalı bir dosyaya işaret eden hard link de programlar tarafından okunabilir. Dosya araçları ise birden fazla link'i olan dosyaları reddeder. Linux ve Windows üzerinde program sandbox'ı bulunmadığından local programlar kullanılamaz. Güvenilen klasörlerde dosya araçları çalışmaya devam eder.