Claude · Gelişmiş · 201 Claude Code temeli · Konu 7 / 10
3.7 İzin modları
Claude'un neyi sormadan yapacağını bir kez sen belirle.
Bu sayfada ne öğreneceksin
- Altı izin modunun adlarını ve her birinin sormadan neyi yaptığını
- Modu oturum içinde ve oturum başlarken nasıl değiştireceğini
- Hangi işte hangi modu seçeceğini ve hangi modun hangi riski taşıdığını
Kısaca
İzin modu, Claude Code'un oturumda sana sormadan hangi işleri yapabileceğini belirler. Her işi tek tek onaylamak yerine işe uygun bir mod seçersin ve Claude o güven seviyesinde çalışır.
Modlar rahatlık ile gözetim arasında farklı dengeler kurar. Manual modda Claude dosya düzenleme, kabuk komutu ve ağ erişimi gibi çoğu işte durup sana sorar. Auto modda bu işi ayrı bir model, yani sınıflandırıcı (classifier), senin yerine yapar: her eylem çalışmadan önce onun incelemesinden geçer.
Hangi modla başladığın sürüme, hesap planına, kullandığın ortama ve ayarlarına göre değişir. Doküman, yeni sürümlerde terminal ve VS Code oturumlarının auto ile başlayabildiğini söylüyor; bu yüzden her oturumda durum çubuğuna bak, hangi modda olduğun orada yazar.
Altı mod
Tablo, Claude Code dokümanındaki adları kullanır. Manual modun ayar dosyalarındaki değeri default'tur; komut satırında manual takma adı da çalışır.
| Mod (ayar değeri) | Sormadan ne yapar | Ne için |
|---|---|---|
Manual (default) | Yalnız okur. Gerisini sorar. | Her eylemi kendin görmek, hassas işler |
Accept edits (acceptEdits) | Okur, dosya düzenler ve yaygın dosya sistemi komutlarını (mkdir, touch, mv, cp gibi) çalıştırır. | Sonradan gözden geçireceğin kodu yinelemek |
Plan (plan) | Okur. Düzenleme yapmaz, değişiklik önerir. | Değiştirmeden önce kod tabanını keşfetmek |
Auto (auto) | Her şeyi, arka planda güvenlik denetimiyle yapar. Her eylemi ayrı bir sınıflandırıcı model inceler. | Uzun işler, sürekli onay vermekten yorulmamak |
Don't ask (dontAsk) | Çalışma klasörlerindeki dosya okumalarını ve önceden onaylanmış araçları yapar. Normalde soracak her şey otomatik reddedilir. | Kilitli CI ve betikler |
Bypass permissions (bypassPermissions) | Tüm denetimleri atlar. | Yalnız yalıtılmış kapsayıcı (container) ve sanal makine |
Durum çubuğunda modlar şöyle görünür: ⏸ manual mode on, ⏵⏵ accept edits on, ⏸ plan mode on, ⏵⏵ auto mode on, ⏵⏵ don't ask on, ⏵⏵ bypass permissions on.
Adım adım
- Hangi moddasın, bak. Claude Code'u aç ve ekranın altındaki durum çubuğunu oku. Beklenen sonuç: mevcut mod orada yazar.
- Manual'i dene.
Shift+Tabile Manual moda geç ve Claude'dan küçük bir dosya değişikliği iste. Beklenen sonuç: Claude düzenlemeden önce durup sorar. Onay isteminde Yes, "Yes, and don't ask again for ..." ve No gibi seçenekler görürsün. Bash komutu istemlerinde auto mod mevcutsa "Yes, and switch to auto mode" seçeneği de çıkabilir. - Accept edits'e geç.
Shift+Tab'a bir kez bas. Beklenen sonuç: durum çubuğunda⏵⏵ accept edits onyazar ve dosya düzenlemeleri sormadan yapılır. Değişiklikleri sonradan editöründe ya dagit diffile incele; Claude Code içinde/diffde aynı işe yarar (bkz. 3.9). - Plan'a geç.
Shift+Tab'a yine bas ya da bir istemin başına/planyaz. Beklenen sonuç: Claude düzenleme yapmadan plan çıkarır. Onaylamadan plan modundan çıkmak istersen yineShift+Tab'a bas (bkz. 3.6). - Döngünün sırasını öğren. Dokümana göre auto moddayken ilk
Shift+Tabseni Manual'e götürür; döngü sonra Manual, Accept edits, Plan sırasıyla ilerler. Auto döngüye ancak oturumda mevcutsa girer. Bypass permissions yalnız ilgili bayrakla başlatırsan döngüde çıkar. Don't ask döngüde hiç yoktur. - Belirli bir modda başlat. Bayrak olarak ver (aşağıdaki komutlar). Kalıcı varsayılan için ayar dosyasında
permissions.defaultModekullanılır; auto değerini proje ayar dosyalarına yazarsan geçerli olmaz, kullanıcı düzeyindeki dosyaya yazman gerekir. - Tek tek kural ekle.
/permissionskomutu izin kurallarını (allow, ask, deny) gösterir ve eklemene izin verir. Kurallar önce deny, sonra ask, sonra allow sırasıyla değerlendirilir; ilk eşleşen sonucu belirler.
Belirli bir modda başlatmak için terminal komutları:
claude --permission-mode plan
claude --permission-mode acceptEdits
Kimsenin onay veremediği bir betik ya da CI için (Don't ask), dokümandaki örnek:
claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"
Auto mod nasıl çalışır
Auto, ellerin çekildiği moddur. Claude kendi başına çalışır, ama her eylem çalışmadan önce ayrı bir sınıflandırıcı model tarafından incelenir. Sınıflandırıcı niyeti korur: senin istediğinin ötesine geçen hamleleri yakalamaya bakar.
Dokümana göre varsayılan olarak engellediği işlerden bazıları:
- Kod indirip doğrudan çalıştırmak (
curl | bashgibi) - Hassas veriyi dış adreslere göndermek
- Üretim ortamına dağıtım (production deploy) ve veri tabanı geçişleri
- Oturumdan önce var olan dosyaları geri döndürülemez biçimde silmek
- Zorla itme (force push)
- Kaydedilmemiş değişiklikleri çöpe atacağı varsayılan
git reset --hard,git clean -fdgibi komutlar
Kursa göre yerel düzenlemeler, kilit dosyandan (lock file) bağımlılık kurmak, salt okunur istekler ve kendi dalına itme ise sorunsuz geçer. Auto mod, Claude Code dokümanındaki uyarıya göre izin istemlerini azaltır ama güvenliği garanti etmez: genel yönüne güvendiğin işlerde kullan, hassas işlemlerde gözden geçirmenin yerine koyma.
Sınıflandırıcı niyete bakar, doğruluğa bakmaz. Kursa göre kimlik doğrulamayı yeniden yazdırırsan ve Claude bozuk bir doğrulama yazarsa sınıflandırıcı onu geçirir, çünkü bozuk olmak tehlikeli olmak demek değildir. Bu yüzden auto modu, testlerini çalıştıran bir durdurma kancasıyla (stop hook) birlikte kullanmayı öneriyor: auto mod eylemi çalışmadan önce niyeti, kanca iş bitince doğruluğu denetler. Kancalar ayrı bir konu; şimdilik "testleri sen de çalıştır" demek yeterli.
Auto her hesap ve modelde açık olmayabilir. Doküman, desteklenen bir model gerektiğini ve kurumunun bunu kapatabileceğini söylüyor. Kursa göre auto modun korkulukları gelişmeye devam ediyor; güncel engelleme ve izin listeleri için dokümana bak.
Hangi işte hangi mod
- Hassas ya da tanımadığın kod: Manual. Her eylemi görürsün.
- Kodu yineliyorsun, sonra bakacaksın: Accept edits.
- Değiştirmeden önce anlamak istiyorsun: Plan.
- Genel yönüne güvendiğin uzun iş: Auto, yanında test.
- Kimsenin onay veremediği boru hattı, zamanlanmış iş, gece toplu işi: Don't ask. Onay bekleyip takılmak yerine, normalde soracak şeyler otomatik reddedilir ve hat ilerler.
- Hiçbir denetim istemiyorsun: Bypass permissions, yalnız yalıtılmış kapsayıcı ya da sanal makinede.
Hazır prompt
Plan modundayken, değişiklik yaptırmadan önce kapsamı görmek için:
Şu işi yapmadan önce hangi dosyalara dokunacağını ve hangi komutları çalıştıracağını listele: [yapılacak iş]. Henüz hiçbir şeyi değiştirme ve komut çalıştırma, yalnız listeyi ver.
Auto ya da Accept edits modunda, iş bitince doğruluğu kanıtlatmak için:
İşi bitirdiğinde testleri çalıştır ve komutu ile çıktısını bana göster. Geçmeyen bir şey varsa nedenini yaz, "çalışıyor" demekle yetinme.
Sık yapılan hata
- Bypass permissions'ı kendi bilgisayarında açmak. Bu mod izinleri ve güvenlik denetimlerini kapatır. Doküman yalnız yalıtılmış ortamlarda (kapsayıcı, sanal makine, internetsiz geliştirme kapsayıcısı) kullanmanı söylüyor.
- Auto'yu "güvenli" sanmak. Doküman bunun güvenliği garanti etmediğini yazıyor. Sınıflandırıcı kodun işe yaradığını doğrulamaz; testi sen iste.
- Accept edits'in yalnız düzenleme yaptığını sanmak. Bu mod çalışma klasörünün içinde
rm,rmdir,mv,cp,sedgibi komutları da sormadan çalıştırır. Üstelik kabuk komutlarıyla yapılan değişiklikler kontrol noktalarıyla geri alınamaz (bkz. 3.10); önemli işten önce git ile kayıt altına al. - "Yes, and don't ask again" seçeneğini düşünmeden seçmek. Dokümana göre bir Bash komutu için bu seçenek kuralı kalıcı olarak, o depodaki sonraki oturumlar için de kaydeder.
- Hiçbir modun garanti etmediği şeylere güvenmek. Dokümana göre bazı yollara yazmalar (Claude'un kendi yapılandırması gibi korumalı yollar) bypass modu (ve bypass'ın kullanılabildiği terminal oturumlarındaki plan modu) dışında hiçbir modda otomatik onaylanmaz; deny kuralları ise bypass dahil her modda engeller.
Video
Video: yakında.
Kaynak
- Anthropic Academy, Claude Code in action: Permission modes (altı mod, Shift+Tab döngüsü, auto modun sınıflandırıcısı, stop hook, Don't ask, Bypass permissions)
- Claude Code dokümanı: Choose a permission mode (mod tablosu, durum çubuğu metinleri, geçiş, başlangıç modu, auto modun engellediği işler, dontAsk, bypassPermissions, korumalı yollar)
- Claude Code dokümanı: Configure permissions (onay istemi seçenekleri,
/permissions, deny, ask, allow sırası) - Claude Code dokümanı: Commands (
/plan,/permissions,/diff)
Son doğrulama: 2026-10-21