Yaniti Okumak

claude -p ciktisini jq '.result' ile yonlendirip cevabinizi aliyorsunuz. Is tamam — ta ki otomasyonunuz sessizce bir izin reddini kacirana, bir butce asimini gormezden gelene veya konusmayi devam ettirmek icin ihtiyac duydugunuz session_id’yi kaybedene kadar. result alani buzda yalnizca goruen kisim.

Bu bolum, --output-format json uzerine otomasyon kurarken tam olarak neyi cikaracaginizi, neyi loglayacaginizi ve nelere dikkat edeceginizi bilmeniz icin JSON zarfindaki her alani inceliyor.

Ust Duzey Alanlar

Islevleri, anlamlari ve ne zaman onemli olduklariyla birlikte karsilasacaginiz her alan.

Her --output-format json yaniti ayni ust duzey anahtar setini dondurur. Bazilari her script icin zorunludur; digerl yalnizca butce uygulamasi veya izin denetimi gibi belirli senaryolarda onem kazanir.

result Alani

result alani her zaman Claude’un son metin yanitini iceren bir string’dir. Bu, cagri sirasinda ne olursa olsun gecerlidir — Claude birden fazla arac cagirsa, dosya okusa, kod yazsa ve birden fazla tur boyunca bash komutlari calistirsa bile result tek bir string’e sikilmis son metin ciktisidir.

stop_reason degeri "end_turn" ise yanit tamamdir. "max_tokens" ise Claude cikti token limitine ulasti ve yanit kesildi. Bu alani kontrol ederek kesilmeyi tespit edebilir ve devam icin oturumu devam ettirip ettirmemeye karar verebilirsiniz:

# Check for truncation and resume if needed
RESPONSE=$(claude -p "Write a long essay" --output-format json)
STOP=$(echo "$RESPONSE" | jq -r '.stop_reason')
SESSION=$(echo "$RESPONSE" | jq -r '.session_id')

if [ "$STOP" = "max_tokens" ]; then
  claude -p "Continue" --resume "$SESSION" --output-format json
fi

Kullanim ve Maliyet Alanlari

Zarf iki duzey token muhasebes icerir: duz toplam icin usage ve model bazinda ayrintı icin modelUsage.

usage Nesnesi

"usage": {
    "input_tokens": 3,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 15635,
    "output_tokens": 6,
    "server_tool_use": {
        "web_search_requests": 0,
        "web_fetch_requests": 0
    },
    "service_tier": "standard",
    "cache_creation": {
        "ephemeral_1h_input_tokens": 0,
        "ephemeral_5m_input_tokens": 0
    }
}

input_tokens sayisi yalnizca API’ye gonderilen onbellege alinmamis tokenlari yansitir. cache_read_input_tokens sayisi istem onbelleginden sunulan token sayisini gosterir — bunlar onemli olcude daha ucuzdur. Ilk cagrinizda sistem istemi onbellege alinirken cache_creation_input_tokens degerinin yukseldigi gorulur; sonraki cagrilarda cache_read_input_tokens devreye girer.

server_tool_use alt nesnesi web arama ve web getirme gibi yerlesik sunucu tarafi araclarini izler. service_tier alani istegi hangi API katmaninin isledigini onaylar — genellikle "standard".

modelUsage Nesnesi

"modelUsage": {
    "claude-opus-4-6": {
        "inputTokens": 3,
        "outputTokens": 6,
        "cacheReadInputTokens": 15635,
        "cacheCreationInputTokens": 0,
        "costUSD": 0.0079825,
        "contextWindow": 200000,
        "maxOutputTokens": 32000
    }
}

Bu nesne model ID’sine gore anahtarlanmistir ve --fallback-model kullandiginizda zorunlu hale gelir. Claude farkli bir modele geri donerse burada iki girdi gorursunuz — her model icin birer tane — her biri kendi token sayilari ve maliyetiyle. contextWindow ve maxOutputTokens alanlari modelin limitlerini gosterir ve istemlerinizin pencereye sigdigini dogrulamak icin kullanislidir.

Hata Yonetimi

Hatalar iki alanin birlikte calismasi ile ortaya cikar: is_error ve subtype. Basarili bir yanit her zaman is_error: false ve subtype: "success" degerlerine sahiptir. Bir seyler ters gittiginde desen degisir.

En yaygin hata alt tipi, --max-budget-usd ile belirlediginiz butce limitini asan cagrilarda tetiklenen "error_max_budget_usd"’dir. Bu durumda result alani normal bir yanit yerine hata mesajini icerir:

# Set a budget to see the error envelope when exceeded
$ claude -p "Write a detailed essay" --max-budget-usd 0.05 --output-format json

{
    "type": "result",
    "subtype": "error_max_budget_usd",
    "is_error": true,
    "result": "Budget exceeded: the request cost more than the allowed $0.05",
    "total_cost_usd": 0.05,
    "session_id": "..."
}

Savunma deseni basittir — result’a erismeden once her zaman is_error’u kontrol edin:

const data = JSON.parse(output);
if (data.is_error) {
    console.error(`Error (${data.subtype}): ${data.result}`);
    process.exit(1);
}
// Safe to use data.result here

permission_denials dizisi, arac kullanimi senaryolari icin hata yonetimini tamamlar. Claude, izin sisteminin engelledigi bir araci kullanmaya calistiginda, arac adi bu dizide gorulur. Cagrinin kendisi yine de basarili olabilir (is_error: false ile), ancak Claude’un yaniti reddedilen eylemi gerceklestiremedigini yansitir. Plan modu is akislarinda bu diziyi kontrol etmek kritiktir — Claude’un ne yapmak istedigini ancak izin verilmedigini size soyler.

Tam Aciklamali Zarf