Claude Code 2.1.316, subagent'ların parent oturumdan daha düşük bir effort seviyesinde çalışmasına izin veriyor

Subagent'lar artık oturumun effort seviyesini devralmıyor

Claude Code 2.1.316, başka hiçbir şey bir seviye belirtmediğinde subagent'ların hangi effort seviyesinde çalışacağını belirleyen CLAUDE_CODE_SUBAGENT_EFFORT adlı bir ortam değişkeni getiriyor. Şimdiye kadar, kendi effort ayarı olmayan bir subagent oturumun seviyesini devralıyordu; dolayısıyla yüksek efora sabitlenmiş bir oturum, salt okunur keşif agent'lerini bile tam akıl yürütme derinliğinde görevlendiriyordu. Changelog kaydının tarihi 31 Ekim 2026 ve Gabriel Anhaia'nın dev.to yazısına göre bu konudaki tek resmi açıklama hâlâ bu — ortam değişkeni referansı değişkeni henüz listelemiş değil.

Yeni değişken öncelik zincirinde nerede duruyor

Effort, uyarlanabilir akıl yürütmeyi kontrol eder: düşük seviyeler basit görevler için daha hızlı ve daha ucuzdur, yüksek seviyeler ise daha derin analiz sağlar. Seviyeler modele göre low, medium, high, xhigh ve max şeklinde ilerler ve hiçbir şey belirlenmediğinde Opus 5.5, Sonnet 5.5 ve Haiku 5.5 varsayılan olarak medium kullanır. Thinking token'ları output token olarak faturalandırılır, dolayısıyla effort doğrudan faturaya yansır.

Birkaç mekanizma zaten bir subagent için effort belirtiyor ve hepsi yeni değişkenden daha yüksek öncelikli. Subagent'in frontmatter'ındaki effort alanı oturum seviyesini geçersiz kılar; Claude'un spawn sırasında geçtiği effort parametresi — v2.1.292'den beri mevcut — frontmatter'ı geçersiz kılar; CLAUDE_CODE_EFFORT_LEVEL ise ikisini de geçer. CLAUDE_CODE_SUBAGENT_EFFORT yalnızca bunlardan hiçbiri uygulanmadığında bir şey belirler. Anhaia pratik sonucu şöyle özetliyor: shell'inizde CLAUDE_CODE_EFFORT_LEVEL tanımlarsanız, yeni değişkenin belirleyecek bir şeyi kalmaz.

Explore, hedeflenen iş yükü

En net yararlanıcı yerleşik Explore subagent'i. Salt okunur; dosya keşfi, kod arama ve kod tabanı incelemesi için kullanılıyor; ana konuşmanın modelinde çalışıyor ve belgelenmiş bir effort seviyesi taşımıyor — yani Claude spawn sırasında bir seviye geçirmediği sürece, yeni değişkenin tam kapsadığı durum bu. Effort ve model ayrı kumandalardır: yalnızca CLAUDE_CODE_SUBAGENT_MODEL ayarlamak, Explore ve Plan'ın hangi modelde çalıştığını değiştirmez.

Tasarrufun ölçülmesi ve tuzaklar

dev.to yazısı bir karşılaştırmayı adım adım anlatıyor: iki git worktree, aynı salt okunur arama görevi, her iki çalışmada da sabitlenmiş model ve oturum effort'u ve yalnızca birinde CLAUDE_CODE_SUBAGENT_EFFORT=low ayarı. Headless JSON çıktısı, subagent isteklerini de içeren total_cost_usd değerini raporluyor; ancak bu rakamlar liste fiyatından token sayılarından üretilen istemci tarafı tahminleri. Abonelik planlarında dolar tutarı ödediğiniz şey değil; token sayıları, hangi çalışmanın limitlerinizden daha fazlasını tükettiğinin yararlı sinyalidir.

Transkript muhasebesi dikkat gerektirir. Subagent transkriptleri agent başına ~/.claude/projects/{project}/{sessionId}/subagents/ altına düşer ve birden fazla content block içeren tek bir API yanıtı, aynı message id'yi paylaşan ve aynı kullanım sayılarını tekrarlayan birkaç assistant girdisi olarak yazılır. Bir maintainer, #87303 numaralı issue'da tüketicilerin her message id'yi bir kez sayması gerektiğini doğruladı; raporlama örneği, naif şekilde toplandığında cache yazımlarını 1.92 kat fazla saymış. Transkriptlerdeki adım başına output token rakamları placeholder'dır, dolayısıyla output toplamları çalışmanın JSON'undan alınmalıdır.

Fan-out bunların üzerine gürültü ekler: Claude kaç Explore agent'i başlatacağına ve her birinin ne kadar titiz olacağına — quick, medium veya very thorough — kendisi karar verir; bu yüzden aynı prompt çalıştırmalar arasında farklı davranabilir. Yazının tavsiyesi her tarafı üç kez çalıştırmak, önce hangisinin gideceğini dönüşümlü belirlemek ve medianları karşılaştırmak. Bilinmeye değer bir koruma var: v2.1.302'den beri headless çalışmaları hiçbir şey ayarlamadığında Manual izin modunda başlar, dolayısıyla onay gerektiren her çağrı onaylayacak kimse olmadığından reddedilir — bu da salt okunur bir karşılaştırmaya uygundur.

Neden önemli

Subagent fan-out'u harcamayı katlar. Birkaç Explore agent'i başlatan yüksek eforlu bir oturum, nadiren derin akıl yürütme gerektiren işler için her birinde yüksek efor fiyatları ödüyordu ve her thinking token output olarak faturalandırılıyor. Yeni değişken ikisini birbirinden ayırıyor: pahılı akıl yürütmeyi getirdiği yere, parent oturumda tutun ve izciyi ucuza gönderin. Bu, onu agent kullanıcılarının oturumun kendisini zayıflatmadan kullanabildiği az sayıdaki doğrudan maliyet ve gecikme kumandasından biri yapıyor. Açık soru belgelerme — değişken resmi referansta görünene kadar davranışı tek bir changelog satırına ve etrafındaki effort kurallarına dayanıyor.