Claude Code 2.1.302 headless varsayılanları değiştirdi: izin modu ve fork subagent'lar

İki varsayılan değişti

Anthropic, Claude Code 2.1.302'yi 16 Ekim'de etiketledi. Sürümle ilgili bir dev.to yazısına göre, changelog'un yaklaşık 60 satırının çoğu düzeltme; ancak ikisi, bir script seçimi belirtmediğinde headless çalıştırmanın ne yaptığını değiştiriyor: bir claude -p veya Agent SDK oturumunun başladığı izin modu ve Claude'un sohbeti subagent'lara fork edip edemeyeceği. Changelog takipçisi gradually.ai aynı sürümü aynı iki değişiklikle listeliyor. İki kayıt da breaking olarak işaretlenmemiş, ama sabitlenmemiş her script yeni davranışı otomatik olarak devralıyor.

İzin modu Manual'e geri dönüyor

Bu sürümden önce, feature flag'lerini getiremeyen — örneğin Bedrock, Google Cloud'un Agent Platform'u veya Microsoft Foundry gibi üçüncü taraf bir sağlayıcıda ya da telemetry kapatılmışken — bir -p veya Agent SDK oturumu, v2.1.285'ten itibaren auto modunda başlıyordu; yani eylemleri bir kişi değil, bir classifier model onaylıyordu. Sürüm 2.1.302 bu oturumları CLI'nin Manual modu dediği varsayılana geri taşıyor. Taze bir kurulum da üçüncü bir tetikleyici; dev.to yazarı, bunun Anthropic API'de bile CI'ya ulaşabileceğine dikkat çekiyor: her işin başında Claude Code'u kuran, kayıtlı yapılandırması olmayan bir runner, her seferinde ilk çalıştırma gibi görünüyor.

Manual modunda okumalar sormadan geçiyor, ama düzenlemelerin ve shell komutlarının çoğu onay istiyor. Headless çalıştırmada onay verecek kimse yok — Anthropic'in kendi headless dokümantasyonu böyle isteklerin reddedildiğini belirtiyor. Pratikteki etkisi şu: dosyaları düzenlemek için yerleşik varsayılana güvenen bir iş artık diff olmadan tamamlanabilir; redler hata olarak yükseltilmek yerine sessizce kaydedilir.

Fork subagent'lar varsayılan olarak açık

Bir fork subagent, sıfırdan başlamak yerine o ana kadarki tüm sohbeti devralır; parent'ın system prompt'unu, araçlarını ve modelini paylaşır ve yalnızca nihai sonucu geri döner. 2.1.302'ye kadar bu davranış yalnızca terminalde varsayılandı. Artık claude -p, Agent SDK, masaüstü uygulaması ve VS Code'da varsayılan olarak açık; claude mcp serve bunu hiç sunmuyor.

dev.to yazısı, fork'ların kendisinin ötesindeki sonuçları vurguluyor. Fork modu etkinken Claude Code, Claude'un doğurduğu her subagent'ı — fork olsun ya da olmasın — arka planda çalıştırıyor ve Agent aracının run_in_background parametresini kaldırıyor. Arka plan subagent'ları, fork'lar hariç, ön plandakilerden daha küçük bir yerleşik araç seti alıyor; ve bir -p çalıştırması, çıktıları nihai sonuca dahil edildiği için, bitmelerine kadar açık kalıyor.

Eski davranış nasıl korunur

İzinler için modu açıkça belirtin. Müdahalesiz işler --permission-mode auto ile birlikte --permission-prompts none geçebilir; bu, Claude'un kimsenin onaylayamayacağı istekleri yeniden denemesini durdurur (prompts bayrağı v2.1.259 veya sonrasını gerektirir). Anthropic'in dokümanları, bulut sağlayıcılarında auto modunun yalnızca belirli modellerle çalıştığını — Sonnet 5 veya sonrası, Opus 4.7 veya sonrası, Haiku 5.5 ve Fable modelleri — aksi halde oturumun Manual'e geri düştüğünü belirtiyor. Kilitli pipeline'lar, onay isteyecek her şeyi reddeden dontAsk kullanabilir ve işin gerçekten ihtiyaç duyduğu araçlar için --allowedTools girdileriyle eşleştirebilir. Ayar dosyalarında permissions.defaultMode ayarlamak da işe yarar.

Sessiz redleri yakalamak için stream'i okuyun: --output-format stream-json ile nihai sonuç mesajı bunları permission_denials altında listeler. Fork'ları kapatmak için o iş için CLAUDE_CODE_FORK_SUBAGENT=0 ortam değişkenini ayarlayın. Fork modunu tutup Claude'un fork doğurmasını durdurmak için izinlerin deny listesine bir Agent(fork) girdisi ekleyin.

Küçük değişiklikler

dev.to yazısı sürümdeki birkaç davranışsal satırı daha işaret ediyor: prompt ve agent hook'ları artık bir olaydan aynı anda en fazla 12 tane çalıştırıyor; CLAUDE_CODE_AUTO_MODE_MODEL, istemci tarafı auto-mode classifier'ının modelini seçiyor; Read aracı 128 MB üzeri görüntü kaynaklarını belleğe yüklemek yerine reddediyor; ve bağımsız Claude Design ürünü, Anthropic'in migration makalesine göre 14 Aralık 2026'da kapanıyor, sonrasında genel proje bağlantıları çalışmayı durduruyor.

Bir uyarı: 18 Ekim itibarıyla Anthropic'in permission-modes ve subagents dokümantasyon sayfaları hâlâ eski varsayılanları anlatıyordu; yani release notes daha güncel kaynak. dev.to yazarı ayrıca davranışı Bedrock üzerinde doğrudan doğrulamadığını — çözümlemenin release notes'lara ve dokümanlara dayandığını belirtiyor.

Neden önemli

Bu sessiz bir CI kırılması. İki değişiklik de breaking etiketi taşımıyor, ama izin modunu hiç sabitlememiş bir headless iş, her düzenlemenin reddedildiği çalıştırmalar döndürmeye başlayabilir — yüksek sesle değil, sessizce başarısız olarak. Fork varsayılanı, hiç talep etmeyen pipeline'lara arka plan yürütmeyi, bazı subagent'lar için azaltılmış araç setini ve daha uzun süren -p oturumlarını ekliyor. İki düzeltme de tek satırlık bayraklar; ama yalnızca varsayılanların değiştiğini bilen ekipler için.