Sharkly'de Claude Sonnet 5.5 Ajanları Nasıl Çalıştırılır?

Anthropic, 28 Eylül'de Claude Sonnet 5.5'i milyon girdi token'ı başına 2 dolar ve milyon çıktı token'ı başına 10 dolar fiyatla kullanıma sundu; bu, Sonnet 5 ile aynı liste fiyatı ve Opus 5.5'in yarısı anlamına geliyor. Anthropic'in açıklamasına göre model, Sonnet 5'ten %30'un üzerinde daha hızlı çalışıyor ve görev başına maliyeti %30'a kadar düşürüyor. Birden fazla kodlama ajanı çalıştıran bir ekip için asıl haber, günlük Agent'lara atayacağınız modelin Anthropic'in lansman tablosundaki çoğu satırda artık amiral gemisi modelin sadece birkaç puan gerisinde yer almasıdır.

Bunu panoya taşımak ise kulağa geldiği kadar kendiliğinden gerçekleşmiyor. Claude Code'un default modeli Pro, Max, Team, Enterprise ve Anthropic API'de Opus 5.5'e yönlendirilir; dolayısıyla Claude Code çalıştıran bir Computer, biri değiştirene kadar amiral gemisi modelde kalır. sonnet takma adı yalnızca Anthropic API üzerinde Sonnet 5.5 anlamına gelir; Bedrock, Google Cloud ve Microsoft Foundry üzerinde ise hâlâ Sonnet 4.5'e karşılık gelir. "Sonnet'e geçtik" diyen bir ekip, üç farklı Computer üzerinde üç farklı modelle baş başa kalabilir ve hangi çalıştırmanın hangi modeli kullandığını anlamanın hiçbir yolu olmayabilir. Bu rehber en küçük ve en işlevsel adımı ele alıyor: bir Computer, bir Agent, gerçek bir Task ve ardından Opus 5.5'in fiyatının hakkını hâlâ nerede verdiğine dair bir karar.

Özetle

Computer üzerindeki Claude Code'u v2.1.284 veya daha yeni bir sürüme güncelleyin, sonnet takma adı yerine tam kimlik olan claude-sonnet-5-5 değerini sabitleyin ve Claude Code Runtime durumu Available olarak görünene kadar yeniden tarayın. Sonnet 5.5'in erken onay isteme alışkanlığını ve talep edilmeyen eklemelerini önleyecek Agent talimatları yazın, çalışma dizinini Temporary olarak tutun, zaman aşımını kapsamı net işlere göre ayarlayın ve tek bir Task atayın. Bir Crew içinde rutin üyeleri Sonnet 5.5'e verin, Opus 5.5'i ise lider ve incelemeci olarak tutun. Agent'lar araştırır, yürütür, test eder ve raporlar. İnsanlar ise yönü belirler, yetki verir ve sonucu onaylar.

Model ayarı nerede bulunur?

Sharkly model seçimi yapmaz. Agents dokümantasyonu bunu açıkça belirtir: “Agent, Runtime'ın varsayılan modelini takip eder. Belirli bir model adı vadetmez veya göstermez. Modelleri Agent üzerinden değil, Runtime veya Computer araç yapılandırmasından değiştirin.” Aynı sayfada, Agent'ın herhangi bir model seçici veya düşünme derinliği denetimi sunmadığı da eklenmektedir.

Bu durum Sonnet 5.5 için oldukça önemlidir; çünkü efor düzeyi, bu modelin davranışının en çok değiştiği alandır ve efor da modelin bulunduğu yerde yaşar: Computer üzerindeki Claude Code'da. Agent işin nasıl yürütüleceğini tanımlar, Computer ana makineyi sağlar, Runtime (burada Claude Code) oturumu yürütür ve Task ise ortak kayıt olarak kalır.

1. Adım: Computer üzerindeki Claude Code'a Sonnet 5.5'i tanımlayın

Claude Code model yapılandırma belgelerine göre Sonnet 5.5 için Claude Code v2.1.284 veya daha yeni bir sürüm gerekir. Bunu Computer üzerinde güncelleyin ve ücretli bir planla veya erişimi olan bir API anahtarıyla giriş yapın; Claude Code, Claude Free üzerinde bulunmaz (bir sohbet lisansının neleri çalıştırıp neleri çalıştıramayacağı hakkında). Ardından ilgili ana makinede standart bir terminal açıp claude --model claude-sonnet-5-5 komutunu çalıştırın. Bir oturum başlıyorsa Sharkly bunu kullanabilir.

Takma adı değil, tam kimliği sabitleyin. Claude Code'da sonnet ifadesinin bugün karşılık geldiği modeller şunlardır:

Modelin küresel bölgeler arası profili olan global.anthropic.claude-sonnet-5-5 üzerinden çalıştığı Bedrock hariç, her yerde kimlik claude-sonnet-5-5 şeklindedir. opusplan da bu takma ad sorununu devralır: planlamayı Opus üzerinde yapar ve yürütmeyi sonnet o an neye karşılık geliyorsa onun üzerinde gerçekleştirir.

Ardından bu seçimi kalıcı hâle getirin: Yerel servisin başlattığı her çalıştırmanın varsayılan Opus 5.5 yerine Sonnet 5.5'i kullanması için modeli o Computer üzerindeki Claude Code yapılandırmasında ayarlayın ve terminal kontrolünü tekrarlayın.

Sharkly'ye geri dönüp Computer ayrıntılarını açın ve yeniden tarama veya bağlantı testi eylemini çalıştırın. Claude Code Runtime durumunun Available olarak görünmesi gerekir. Bir Computer'ın yalnızca çevrim içi görünmesi, yerel servisinin sinyal gönderdiği anlamına gelir; bir çalıştırmanın başlayabileceğini belirten şey ise Runtime durumudur.

2. Adım: Agent'ı Sonnet 5.5'in davranış biçimine göre yapılandırın

Agents bölümünü açın, New Agent seçeneğine tıklayın ve Computer ile Claude Code Runtime'ı seçin. Anthropic'in Sonnet 5.5 prompt mühendisliği kılavuzu, doğrudan bir inceleme kuyruğuna takılabilecek alışkanlıkları açıklar.

Hangi modeli satın aldığınızı efor düzeyi belirler. Claude Code, Sonnet 5.5'i varsayılan olarak medium efor düzeyinde çalıştırır ve burada düşünme modu kapatılamaz. Lansmanda öne çıkarılan rakamların çoğu max düzeyinde ölçülmüştü. Anthropic'in grafiklerine göre Sonnet 5.5, CursorBench 4.0 testinde medium düzeyinde %39,2, max düzeyinde ise %55,5 başarı gösteriyor; görev başına tahmini maliyetler ise sırasıyla 0,70 dolar ve 9,67 dolar. Bunlar doğru ya da yanlış bir ayar değil, tamamen farklı bütçelerdir. Kılavuz, iyi tanımlanmış görevlerdeki otonom kodlama için medium düzeyini önerirken, xhigh ve max düzeylerinin yalnızca ölçülebilir kazanımlar için saklanmasını tavsiye ediyor.

Erken onay isteme eğilimindedir. Düşük ve orta efor düzeylerinde Sonnet 5.5, uzun süren otonom görevlerde durup kullanıcıya danışma eğilimi gösterir. Sharkly'de bu danışma adımı Task'a bir yorum olarak döner; Task kullanıcı yanıtı bekleniyor durumuna geçer ve biri yanıtlayana kadar birinin Gelen Kutusu'nda bekler. Agent'a belirttiği varsayımlar üzerinden ilerlemesini söyleyin. Düşük eforda ayrıca testleri çalıştırmadan kodun tamamlandığını bildirebilir, bu nedenle kontrolleri zorunlu kılın.

İstenmeyen şeyler ekler. Kılavuz, her efor düzeyinde talep edilmemiş testlerin, dokümantasyonların ve küçük dosyaların eklenebileceğini; xhigh ve max düzeylerinde ise fazladan inceleme turları veya incelemeci alt ajanlar oluşturulabileceğini belirtiyor. Anthropic'in lansman dipnotu bunun maliyetini ortaya koyuyor: Sonnet 5.5, FrontierCode testinde max düzeyinde xhigh düzeyine kıyasla daha düşük puan aldı; çünkü Claude Code'un çok sayıda alt ajana yayılan kod inceleme yeteneğini daha sık çalıştırdı ve Cognition'ın incelediği iki senaryoda bu durum zaman aşımına veya görev kapsamı dışındaki düzenlemelere yol açtı. Bir incelemeci için bu, Task'ın kapsamı dışında düzenlemeler içeren daha büyük bir diff anlamına gelir.

Zaman aşımı ve dizin yönetimi. Anthropic, Sonnet 5.5'i “kapsamı iyi belirlenmiş günlük görevler” için konumlandırıyor; bu nedenle Task başına zaman aşımını buna göre belirleyin ve bir çalıştırma sınıra takıldığında süreyi artırmadan önce Task'ı parçalara bölün. Çalışma dizinini Temporary olarak tutun: Her Task yalıtılmış bir dizin alır ve depo tabanlı çalıştırmalar yeni bir worktree hazırlar, böylece paralel çalıştırmalar birbirinin üzerine yazamaz. Computer gerçek bir iş yükünü kaldırana kadar eşzamanlılığı varsayılan değerinde, yani Computer sınırının %50'sinde bırakın.

Uyarlayabileceğiniz talimatlar:

Read the Task description and recent comments before editing.
Keep changes limited to the requested behavior. Do not add tests,
docs, or new files unless the Task asks for them; list any you
think are missing in your report instead.
Do not stop to ask whether to continue. When a detail is ambiguous,
proceed with a stated assumption and record it in your report.
Ask only when different interpretations would materially change
the result.
Run the closest relevant checks before reporting done, and report
failures without hiding them.
Do not start extra review rounds or reviewer subagents.
If a safeguard notice or refusal appears, say so in your report.
Stop and ask before anything destructive or outside the attached
repositories.

3. Adım: Tek bir Task atayın, ardından iki kademeli bir Crew kurun

Kabul kriteri net olan bir Task seçin, Assignee olarak Agent'ı belirleyin ve atanan işlerin beklediği Backlog'dan çıkarıp çalışmaya hazır bir duruma taşıyın. Çalıştırma sırasıyla queued, dispatched ve running aşamalarından geçer ve Executions sekmesinden günlük akışı izlenebilir.

Bu ilk Task'ı tek bir Agent üzerinde tutun. Bir Crew, tek bir lider Agent tarafından koordine edilen İnsanlar ve Agent'lardan oluşan yeniden kullanılabilir bir gruptur ve liderin bir hedefi yorumlayıp birden fazla üyenin sonucunu tek bir Task'ta birleştirmesi gerektiğinde asıl değerini gösterir. Kapsamı sınırlı bir hata düzeltmesi için tek bir Agent en doğru tercihtir.

Bir Crew içerisindeki görev dağılımı Anthropic'in kendi konumlandırmasıyla örtüşür. Opus 5.5'in “karmaşık ve ucu açık işlerde açıkça daha güçlü kalmaya devam etmesi”, tam olarak liderin görevini tanımlar: planlama, görev dağıtımı ve inceleme. Üyelerin yapacağı işler ise Sonnet 5.5'in konumlandırıldığı türden, kapsamı iyi tanımlanmış işlerdir; lansman sayfasında görüşlerine yer verilen erken dönem test kullanıcılarından biri de aynı dağılımdan bahsederek Opus 5.5'in kurduğu mimariyi Sonnet 5.5'in uyguladığını belirtiyor.

Modelin dokümantasyonda belirtilen yeri Computer'ın araç yapılandırması olduğundan, en pratik iki kademeli kurulum iki Computer ile yapılır: biri lider için Claude Code'un varsayılan Opus 5.5 ayarını korur, diğeri ise üyeler için claude-sonnet-5-5 modeline sabitlenir. Bu ikisi arasındaki sınırın nereye çekileceği, netleştirilmeye değer bir yönlendirme kuralıdır; Sonnet 5.5 mi Opus 5.5 mi yazısı bu konuyu adım adım ele alırken, Sonnet 5.5 ile GPT-6 Sol karşılaştırması aynı fiyattaki diğer Runtime seçeneğini inceler. Model kullanımı bu araçlarda yapılandırılmış abonelikler veya API anahtarları üzerinden sürdürülür; bu nedenle söz konusu ücretler Sharkly faturanıza değil, doğrudan sağlayıcınızın faturasına yansır.

Panoda neler değişiyor?

Daha hızlı çalıştırmalar yine aynı incelemecilerin önüne gelir. Aynı bütçeyle günde daha fazla işin tamamlanması, fazladan inceleme mesaisi sağlamaz ve modelin testler ile dokümanlar ekleme alışkanlığı her bir diff'i daha da büyütür. Planlamanızı model fiyatına göre değil, inceleme kapasitesine göre yapın.

Bayrak eklenen bir çalıştırma aslında Sonnet 5.5 çalıştırması olmayabilir. Bu, siber güvenlik önlemlerine sahip ilk Sonnet modelidir. Anthropic, daha yüksek riskli siber görevlerin "görünür şekilde Sonnet 5'e geri döneceğini" belirtiyor ve sistem kartı zararsız güvenlik çalışmalarında bile daha fazla ret yanıtı alınabileceği konusunda uyarıyor. Oturumda görünür olan bir durum panoda görünmez: Sharkly bir model adı görüntülemez; dolayısıyla Agent bunu açıkça yazmadığı sürece Task üzerinde hangi modelin yanıt verdiğini gösteren hiçbir şey yer almaz. Yukarıdaki talimatlarda bunun özellikle istenmesinin nedeni de budur.

Akıl yürütme, onu üreten modelde kalır. Sonnet 5.5, Opus 5.5'in düşünme bloklarını okuyamaz; başka hiçbir model de Sonnet 5.5'inkileri okuyamaz ve okunamayan bloklar herhangi bir hata vermeden yoksayılır. Tek bir Claude Code oturumunda bile ikisi arasında geçiş yapmak görünür metni korurken arkasındaki akıl yürütmeyi kaybettirir. Bir Crew içindeki Agent'lar arasında ise akıl yürütme hiçbir zaman aktarılmaz: İncelemeci, yalnızca üyenin Task üzerine yazdığı içeriği görür. Model devirlerinde akıl yürütme kaybı bu sorunun çözümünü ele alırken, devir şablonları bu sürece somut bir çerçeve kazandırır.

Model bu hafta değişti. Görev atamaları, bağlam, ilerleme durumu, engelleyiciler, sonuçlar ve insan incelemesi ise ekibin görebileceği yerde kalmaya devam etti. Bu yapıyı worktree'ler ile manuel olarak kurabilir veya iş akışını yönetmek için Sharkly'yi kullanabilirsiniz.