DokümantasyonBaşvuru
İzinler
Ajan başına izin matrisi, yetki şablonları, her iznin sağlayıcıya göre nasıl uygulandığı ve onaylar.
Her ajanın kendi izinleri vardır: dosya okuyup okuyamayacağı, dosya yazıp yazamayacağı, terminal ya da ağ kullanıp kullanamayacağı ve her görevden önce senin onayını bekleyip beklemeyeceği. Bu sayfa izinleri nereden ayarlayacağını, her birinin ne işe yaradığını ve her sağlayıcının bunları gerçekte ne kadar uyguladığını anlatır.
İzinleri nereden ayarlarsın
Aynı izinleri iki yerden düzenleyebilirsin. İkisi senkron kalır ve değişiklikler anında kaydedilir.
- Ayarlar → İzin Matrisi: tüm ajanları ve izinlerini gösteren bir tablo; ek klasörler için Yollar sütunu ve bir Nasıl uygulanır? notu vardır. Ayarları Ctrl+, ile aç.
- Organizasyon → Ajanlar → bir ajan → İzinler: tek bir ajan için aynı anahtarlar, ayrıca Ek izinli klasörler.
İzinler
| İzin | Neye izin verir |
|---|---|
| Dosya okuma | Çalışma alanındaki (proje klasöründeki) dosyaları okuma ve arama. |
| Dosya yazma | Dosya oluşturma ve düzenleme. |
| Terminal | Kabukta senin kullanıcı yetkilerinle komut çalıştırma. |
| Ağ | İnternetten sayfa çekme ve arama yapma. |
| Tarayıcı | Henüz uygulanmıyor: ajanlar uygulama içi tarayıcıyı kullanamaz. |
| Onay iste | Her göreve başlamadan önce senin onayını bekleme. |
| Ek izinli klasörler | Ajanın proje klasörüne ek olarak erişebileceği klasörler. |
Ajanlar her zaman görevin ait olduğu projenin klasöründe başlar. CLI sağlayıcısıyla (Claude Code ya da Codex) çalışan ajanlar bir proje klasörüne ihtiyaç duyar; klasör yoksa çalışmaz. Bkz. Projeler.
Yetki şablonları
Bir ajan oluştururken bir Yetki şablonu seçersin. İzinleri sonradan tek tek değiştirebilirsin.
| Şablon | Açıklama |
|---|---|
| Salt okuma | İnceler, raporlar; dosyalara dokunmaz. |
| Geliştirici | Dosya okur ve yazar; terminal ve ağ kapalı. |
| Tam yetki | Dosya, terminal, ağ ve tarayıcı açık. |
Bir takım şablonundan kurulan ajanlar Onay iste açık başlar (görev almayan Çekirdek Ekip lideri hariç); bu yüzden ilk çalışmalarında sol panelde onay kartları bekle. Bkz. Organizasyon.
Her sağlayıcı izinleri nasıl uygular
Ajanlar izinlerini kendi talimatlarında görür, ama izinleri uygulayan bu değildir. Asıl zorlama, Agentbits’in sağlayıcıyı nasıl başlattığından gelir.
| İzin | Claude Code CLI | Codex CLI | Anthropic / OpenAI API |
|---|---|---|---|
| Dosya okuma | Dosya okuma ve arama araçları açılır, çalışma klasörleriyle sınırlıdır. | Codex her zaman okur; bu izin yoksa Codex ajanı hiç çalışmaz. | Dosya sistemi erişimi yok. |
| Dosya yazma | Düzenleme araçları açılır. Düzenlemeler yalnızca proje klasöründe ve ek klasörlerde otomatik onaylanır; dışarısı reddedilir. | Codex’in workspace-write sandbox’ında çalışır: yalnızca proje klasörüne yazar. İzin yoksa sandbox salt-okunurdur. | Dosya sistemi erişimi yok. |
| Terminal | Kabuk aracı açılır. Açıkken dosya ve ağ kısıtları kabuk üzerinden aşılabilir. | Codex komutları her zaman kendi sandbox’ında çalıştırır. | Terminal yok. |
| Ağ | Web’den sayfa çekme ve web araması açılır. | Sandbox içinde ağ erişimi (Dosya yazma da açıksa). Kısıtsız “tam erişim” modu hiçbir zaman kullanılmaz. | Web erişimi yok. |
| Ek izinli klasörler | Ek çalışma klasörü olarak eklenir. | Desteklenmez. | Geçerli değil. |
| Tarayıcı | Uygulanmaz. | Uygulanmaz. | Uygulanmaz. |
| Onay iste | Uygulanır. | Uygulanır. | Uygulanır. |
Bunlara ek olarak:
- Claude Code, deponun kendi
.claudeayarları ve hook’ları olmadan çalışır ve projenin.mcp.jsondosyasını yok sayar; böylece bir depo ajanın izinlerini değiştiremez ya da kendi sunucularını ekleyemez. İzinlerin reddettiği araç çağrıları ajanın terminalinde uyarı olarak görünür. - Anthropic ve OpenAI API ajanları hiç dosya düzenleyemez ve komut çalıştıramaz. Metinle ve Agentbits’in kendi araçlarıyla (bağlantılar, dosya ekleri, skill’ler, uygulamalar) çalışırlar; bunların her biri kendi izniyle denetlenir. Proje klasöründe kod değiştirmek için bir CLI sağlayıcısı kullan. Bkz. Sağlayıcılar.
- Demo işi canlandırır, dosyalarına dokunmaz.
- Sohbet yanıtları ve lider incelemeleri hiçbir zaman dosya düzenleme ya da terminal aracı almaz.
- Dosya, terminal ve ağ değişiklikleri ajanın bir sonraki çalışmasından itibaren geçerlidir. Bağlantı ve uygulama değişiklikleri bir sonraki araç çağrısından itibaren geçerlidir.
Uyarı: Claude Code’da Terminal izni olan bir ajan, senin kullanıcı hesabının yapabildiği her şeyi yapabilir. İşletim sistemi düzeyinde bir yalıtım yoktur. Bu izni yalnızca güvendiğin ajanlara ver ya da Agentbits’i kısıtlı bir işletim sistemi kullanıcısıyla çalıştır. Terminal ve Ağ birlikte açıksa ajan, bilgisayarında kayıtlı kimlik bilgileriyle sunuculara doğrudan da ulaşabilir.
Onay iste
Onay iste açıkken ajanın aldığı her görev, sol paneldeki Çalışan işler altında, istediği yetkileri gösteren bir onay kartıyla bekler. Çalışmayı başlatmak için onayla ya da reddet. Bu her sağlayıcıda çalışır; API sağlayıcılarında sen onaylamadan modele istek gönderilmez.
Bu, tek tek işlemlerin tetikleyebildiği onaylardan ayrıdır:
- Production bağlantılarda yazma ve admin işlemleri (Bağlantılar),
- Önce bana sor politikalı uygulama araçları (Uygulamalar).
Diğer erişimler
İzin matrisi dosyaları, terminali ve ağı kapsar. Diğer erişimler ayrı verilir ve hepsi varsayılan olarak kapalıdır:
| Ne | Nereden verilir |
|---|---|
| Sunucular ve veritabanları | Ayarlar → İzin Matrisi → Bağlantı izinleri ya da bağlantının Ajan erişimi sekmesi. Bkz. Bağlantılar. |
| Uygulamalar (MCP) | Uygulamanın Erişim sekmesi ya da ajanın Uygulamalar bölümü. Bkz. Uygulamalar. |
| Skill’ler | Ajana ya da birimlerinden birine atama. Bkz. Skill’ler. |
| Dosya ekleri | Dosyayı eklerken paylaşım ya da dosyanın Erişim sekmesi. Bkz. Dosyalar. |
Genel model ve sınırları için bkz. Güvenlik.
Yanlış ya da eksik bir şey mi buldun? GitHub'da bildir