Çoğu geçiş kılavuzu size kodunuzda neyin bozulduğunu anlatır. Bu kılavuz ise komut istemlerinizde neyin bozulduğunu anlatıyor.
Claude Opus 5, 24 Temmuz 2026'da piyasaya sürüldü ve Anthropic bununla birlikte özel bir komut istemi kılavuzu yayınladı. Bu kılavuz, dikkat etmeye değer bir şeyi belgeliyor: Opus 4.8'i daha iyi hale getiren bazı talimatlar Opus 5'i kötüleştiriyor. Üstelik ince bir şekilde kötüleşmiyor. Ölçülebilir derecede daha pahalı, ölçülebilir derecede daha ayrıntılı ve bir durumda tamamen bozuk.
Nedeni basit. Opus 5, daha önce istemeniz gereken birçok şeyi zaten kendi başına yapıyor. Eski komut isteminiz yine de bunu istediğinde, talimat modelin zaten sahip olduğu davranışla birleşiyor. Doğruluğu iki katına çıkarmak yerine, iki kat doğrulama geçişi elde ediyorsunuz.
Bu kılavuz, belgelenmiş her bir davranış değişikliğini, bugün sistem komut isteminize ekleyebileceğiniz kopyala-yapıştır komut istemi parçacıklarıyla birlikte inceliyor. Ayrıca, düşünme devre dışı bırakıldığında ortaya çıkan iki hata modunu da ele alıyor; bu, Opus 5 komut isteminin düzgün görünen bir çıktı üretebildiği ve bir aracı döngüsünü sessizce bozduğu tek yerdir. Kod düzeyindeki değişiklikler üzerinde hala çalışıyorsanız, Opus 4.8'den Opus 5'e geçiş kılavuzu bunları ayrı olarak ele almaktadır. Ve bu davranışların gerçek istek ve yanıt yüklerinde nasıl değiştiğini izlemek isterseniz, Apidog, aynı komut istemini farklı ayarlarla göndermenin ve sonuçları karşılaştırmanın basit bir yoludur.
Tek satırlık özet
Opus 5, Opus 4.8'e göre daha fazla doğrulama yapar, daha fazla yazar, daha fazla yetki devreder ve kendini daha fazla açıklar. Opus 4.8 komut isteminiz, bir modeli bu davranışlara doğru itmek için ayarlanmıştı. Şimdi ise bunların ötesine geçiyor.
Yani iş çıkarma üzerine kurulu. Çoğunlukla talimatları siliyorsunuz, eklemiyorsunuz. Yaptığınız eklemeler ise kısıtlamalardır: daha kısa olun, kapsam içinde kalın, yardımcılar oluşturmayın.
1. Doğrulama talimatlarınızı silin
Bu, büyük olanı ve başlığın nedeni.
Anthropic, Opus 5'in kendi çalışmasını herhangi bir komut istemi olmaksızın doğruladığını belirtiyor. Yazdıklarını tekrar okur, aritmetiğini kontrol eder, bir testi yeniden çalıştırır ve bahsetmediğiniz uç durumu arar. Bu, herkesin Opus 4.8'e “yanıt vermeden önce çalışmanızı iki kez kontrol edin” veya “her adımı doğrulayın” gibi satırlarla manuel olarak girdiği davranışın aynısıydı.
Bu satırları ileri taşıdığınızda aşırı doğrulama elde edersiniz. Model, zaten çalıştıracağı doğrulama geçişlerini, artı sizin istediklerinizi çalıştırır ve bunun her bir jetonunu ödersiniz. Uzun aracı odaklı çalıştırmalarda bu, bir yuvarlama hatası değil, gerçek bir faturadır.
Çözüm bir silmedir. Sistem komut istemlerinizde bu kalıpları arayın ve kaldırın:
Yanıt vermeden önce çalışmanızı iki kez kontrol edin.
Bir sonraki adıma geçmeden önce her adımı doğrulayın.
Yanıtınızı hatalar için gözden geçirin, sonra düzeltin.
Muhakemenizi dikkatlice kontrol edin.
Çıktının doğru olduğundan emin olun, sonra geri döndürün.
Eğer açık bir doğrulama geçişi istediğiniz gerçekten yüksek riskli bir adımınız varsa, bunu küresel bir kural haline getirmek yerine o adıma özgü hale getirin:
Genel doğrulama geçişleri eklemeyin; zaten varsayılan olarak doğrularsınız.
Tek istisna: geçiş SQL'ini yazdıktan sonra, şema dökümüne karşı bir kez çalıştırın
ve herhangi bir uyuşmazlığı bildirin. Başka hiçbir şeyi yeniden doğrulamayın.
Bu yapı önemlidir. Opus 5 üzerinde küresel bir “her şeyi doğrula” talimatı maliyet çarpanıdır. Tek bir kapsamlı istisna ise bir kontroldür.
Bu geçiş boyunca API harcamanızı takip ediyorsanız, Opus 5 fiyatlandırma dökümündeki önbellek ve toplu işlem kolları bununla birleşir ve Claude API faturasını kesmeye yönelik kılavuzumuz genel kolları kapsar.
2. Açıkça özlülük için komut istemi kullanın, çünkü çaba bunu yapmayacaktır
Opus 5'in varsayılan yanıtları, Opus 4.8'inkinden daha uzun sürer. Yazılı teslimatları da öyle: bir belge istediğinizde ürettiği raporlar, özetler, tasarım belgeleri ve README'ler.
İnsanları şaşırtan kısım burası. `effort` parametresini düşürmek bunu düzeltmez. Çaba, modelin ne kadar düşündüğünü kontrol eder. Modelin ne kadar yazdığını kontrol etmez. `xhigh`dan `medium`'a düştüğünüzde, düşünme jetonlarını keserken görünür yanıt yaklaşık olarak aynı uzunlukta kalır. Çabayı bir ayrıntı kadranı olarak varsaydıysanız, faturanız beklediğiniz gibi değişmeyecektir. Opus 5 çaba parametresi kılavuzu, her seviyenin gerçekte neyi değiştirdiğini kapsar.
Uzunluk bir komut istemi sorunudur, bu yüzden bunu komut isteminde çözün. Modellerin cömertçe yorumladığı “kısa ol” demek yerine üst sınır konusunda spesifik olun:
Yanıt formatı: daha fazlasını istemediğim sürece en fazla 150 kelime.
Giriş yok, sorumun tekrarı yok, sonda özet yok.
Yanıtla başlayın, sonra gerekirse muhakemeyi ekleyin.
Yazılı teslimatlar için, sınırlamayı çıktıya koyun ve neyin çıkarılacağını belirtin:
Geçiş belgesini en fazla 800 kelime olacak şekilde yazın.
Dahil edin: kırıcı değişiklikleri, her biri için düzeltmeyi ve bir geri alma adımını.
Hariç bırakın: eski sistem hakkında arka plan, bir sözlük ve bir sonuç bölümü.
Bir bölüm payını aşarsa, adımları kesmeden önce örnekleri kesin.
Kod ağırlıklı işler için, eşdeğer kısıtlama kodla ilgili değil, yorumla ilgilidir:
Sadece farkı döndürün, başka hiçbir şeyi değil.
Değişiklik bariz değilse, neyi değiştirdiğinize dair bir açıklama yapmayın;
bu durumda, fark bloğunun üzerine tek bir cümle ekleyin.
3. Alt aracı yetki devrini sınırlayın
Opus 5, Opus 4.8'e göre alt aracılara daha kolay yetki devreder. Çok parçalı bir görev ve oluşturmayı destekleyen bir donanım verildiğinde, yayılır.
Bu genellikle doğru karardır. Aynı zamanda modelin sizin adınıza aldığı bir maliyet kararıdır ve her alt aracı kendi bağlamını ve kendi jeton faturasını taşır. Maliyet veya gecikmeye duyarlı iş yükleri için, modelin takdirine bırakmak yerine bir sayı koyun:
Bu görev için alt aracı oluşturmayın. Bunu bu konuşmada halledin.
Veya, yayılmanın gerçekten faydalı olduğu ancak sınırlandırılması gerektiği durumlarda:
En fazla 2 alt aracıya yetki devredebilirsiniz ve bu sadece paralel çalışabilecek bağımsız
dosya düzeyindeki işler için geçerlidir.
Araştırma, planlama ve nihai sentezi bu iş parçacığında kendiniz yapın.
Kaçınılması gereken model, kendi adına yetki devridir: tek bir dosyayı okumak için oluşturulan bir alt aracı veya ana iş parçacığının zaten bağlamına sahip olduğu bir kararı vermek için. Eğer alt aracılarla bilinçli olarak inşa ediyorsanız, Claude Kod alt aracılar oluşturma kılavuzumuz, bunları kapsamlandırmanın donanım tarafını kapsar.
4. Dar görevlerde kapsamı açıkça kısıtlayın
Opus 5 görev kapsamını genişletir. Başarısız olan bir testi düzeltmesini isterseniz, testin çağırdığı yardımcıyı yeniden düzenleyebilir, tür imzasını güncelleyebilir ve iki test durumu daha ekleyebilir. Bir değişkeni yeniden adlandırmasını isterseniz, çevredeki işlevi düzenleyebilir.
Bazen bu bir özelliktir. Dar, cerrahi bir görevde ise öyle değildir: istenmeyen bir yeniden düzenleme, bir inceleyici için daha büyük bir fark ve tek bir satır olması beklenen bir değişiklik için daha geniş bir etki alanı anlamına gelir.
Sınırı bir sınır olarak belirtin ve nelerin yasak olduğunu adlandırın:
Kapsam: yalnızca src/client/http.ts dosyasındaki yeniden deneme sayısı sabitini değiştirin.
Çevreleyen kodu yeniden düzenlemeyin, hiçbir şeyi yeniden adlandırmayın,
test eklemeyin, belgeleri güncellemeyin. Başka bir değişiklik gerektiğini
düşünüyorsanız, onu yapmak yerine durun ve bana bildirin.
Bu son madde faydalı yarıdır. O olmasaydı, modelin gerçek bir sorunu dile getirmek için onaylanmış bir yolu olmazdı, bu yüzden ya değişikliği yine de yapar ya da gözlemi düşürürdü. Onunla birlikte, işaretlenmiş bir endişe ve değişmemiş bir fark elde edersiniz.
5. Daha fazla düzeltme anlatımı bekleyin ve istemiyorsanız kapatın
Opus 5, düzeltmelerini Opus 4.8'den daha fazla anlatır. Yanıtın ortasında fikrini değiştirdiğinde size söyler: daha önceki bir yaklaşımın yanlış olduğunu işaretler, nedenini açıklar ve geçişi tanımlar.
Etkileşimli çalışmalar için bu faydalıdır. Yanıtın bir ayrıştırıcıyı, bir kullanıcı arayüzünü veya başka bir modeli beslediği bir işlem hattı için, bu anlatım bir yanıtı tutması gereken bir alanda oturan bir gürültüdür.
Talimat kısa:
Düzeltmeleri veya yaklaşım değişikliklerini anlatmayın.
Sadece nihai cevabı döndürün. Eğer düşüncenizi revize ettiyseniz, bu
revizyon yanıtta değil, muhakemenizde yer almalıdır.
Yanıtları yapılandırılmış depolamaya yönlendiriyorsanız, şeklin istenmek yerine uygulanması için bunu yapılandırılmış çıktılarla eşleştirin.
Düşünme devre dışı bırakıldığında ortaya çıkan hata modları
Yukarıdakilerin hepsi bir ayarlama sorunudur. Bu kısım ise bir doğruluk sorunudur.
Anthropic, `thinking: {type: "disabled"}` aracılığıyla düşünme devre dışı bırakıldığında Opus 5'te ara sıra ortaya çıkan iki yapıyı belgeliyor. Her ikisi de bir aracı yayınlamadan önce bilinmeye değerdir.
Araç çağrıları düz metin olarak yazılır. Model, bir araç çağrısı gibi görünen bir şey yayınlar, ancak yapılandırılmış bir `tool_use` bloğu olarak değil, yanıt gövdesinde metin olarak. Hiçbir şey yürütülmez. Tek aşamalı bir sohbette fark edersiniz. Aracı döngüsünde ise genellikle fark etmezsiniz: döngü bir araç çağrısı görmez, bu yüzden hiçbir eylemde bulunmaz ve sızan metin konuşma geçmişinde kalır. Daha sonraki aşamalar bu metni bir çağrı yapılmış gibi okur. Hata aşamalar boyunca birleşir ve çıktı yanlış göründüğünde neden birkaç aşama geriye dayanır.
Görünür çıktıda dahili XML etiketleri. `` gibi etiketler kullanıcının gördüğü yanıtta görünür. Kendi başına estetik olarak kötü, yanıtları HTML olarak işlerseniz veya yapı için ayrıştırırsanız daha da kötüdür.
Sezgisel olmayan kısım: komut isteminizde etiketleri adlandırmak sızıntıyı daha iyi değil, daha kötü yapar. "Asla `` etiketleri çıktısı verme" gibi bir talimat, jeton dizisini bağlama oturtur ve görünme olasılığını artırır. Bu talimatı yazmayın.
Anthropic'in kendi önerdiği hafifletme, hiç de bir komut istemi değildir. Bunun yerine, düşünmeyi etkin tutmak ve maliyeti daha düşük bir çaba seviyesiyle kontrol etmektir:
{
"model": "claude-opus-5",
"max_tokens": 4096,
"output_config": { "effort": "low" },
"messages": [
{ "role": "user", "content": "..." }
]
}
Bu, devre dışı bırakılmış düşünme yapıtları olmadan aralığın ucuz tarafını elde etmenizi sağlar. Ayrıca ilgili bir tuzağı da atlar: Opus 5'te, `thinking: {type: "disabled"}` ile `xhigh` veya `max` çabasını birleştirmek 400 hatası döndürür, çünkü düşünmeyi devre dışı bırakmak `high` çabayla sınırlıdır. Ayrıca, düşünmenin artık varsayılan olarak açık olduğunu unutmayın, bu nedenle `thinking` alanını basitçe atlayan bir istek, Opus 4.8'de olduğu gibi onsuz değil, uyarlanabilir düşünme ile çalışır.
Eğer düşünmeyi devre dışı bırakmak için katı bir gereksiniminiz varsa, bir komut istemi talimatı yerine döngünüze savunmacı bir kontrol ekleyin: metin gövdesi yürütülmemiş çağrı şeklinde bir dize içeren herhangi bir asistan dönüşünü geçmişe eklemeden önce reddedin. Bir hayalet çağrının kayda girmesine izin vermek yerine yüksek sesle hata verin.
Tahmin etmek yerine değişiklikleri test edin
Komut istemi değişikliklerini okuyarak değerlendirmek zordur. Buradaki davranışlar (yanıt uzunluğu, doğrulama geçişleri, alt aracı sayısı) jeton sayıları ve yük yapısı olarak ortaya çıkar; bu da çalışmanızı kontrol etmenin dürüst yolunun istekleri göndermek ve karşılaştırmak olduğu anlamına gelir.
Bu, hepsi bir arada bir API geliştirme ve test platformu olan Apidog'da kurulumu kolaydır:
- Anthropic Mesajlar uç noktasına
"model": "claude-opus-5"ile bir istek oluşturun ve API anahtarınızı gövdeye yapıştırmak yerine bir ortam değişkeni olarak saklayın. - Eski Opus 4.8 sistem komut isteminizi ve kırpılmış Opus 5 sürümünüzü aynı girişe karşı iki kayıtlı istek olarak kaydedin.
- Her yanıttaki
usagebloğunu karşılaştırın. Çıktı jetonları size özlülük kısıtlamasının uygulanıp uygulanmadığını söyler; girdi jetonları ve önbellek alanları ise komut istemi düzenlemelerinizin bir önbellek önekini bozup bozmadığını söyler. - Düşünme jetonlarının düşerken görünür uzunluğun korunduğunu kendiniz görmek için isteği çaba seviyeleri arasında çoğaltın.
- Araç çağrılarının metin olarak değil, yapılandırılmış
tool_useblokları olarak geldiğini doğrulamak için akış yanıtını inceleyin.
Beşinci adım, düz metin araç çağrısı hatasını üretime ulaşmadan önce yakalayan adımdır. Bunları yan yana çalıştırmak isterseniz Apidog'u indirin ve tam istek şekli için Opus 5 API kılavuzuna bakın.
Dürüst üst sınır
Açıkça söylemekte fayda var, çünkü komut istemi kılavuzları sanki ihtiyaç duyacağınız son modelmiş gibi okunmaya meyillidir: Opus 5, Claude yığınının zirvesi değildir. Fable 5, “en yetenekli geniş çapta yayınlanmış” unvanını korurken, Opus 5 siber güvenlik sömürüsü ve otonom biyoloji araştırmalarında hala Mythos 5'in gerisindedir. Anthropic her ikisini de kendi lansman yazısında belirtiyor. Doğru çerçeveleme, sınır fiyatının yarısına sınır sınıfı yetenek sunmak olup, üzerinde belirtilmiş bir üst sınır bulunmaktadır.
Lansman kıyaslama iddiaları (Frontier-Bench, ARC-AGI 3, OSWorld 2.0, CursorBench) tamamen Anthropic'in kendi rakamlarıdır ve 25 Temmuz 2026 itibarıyla bağımsız olarak tekrarlanmamıştır. Bunları satıcı tarafından bildirilen veriler olarak ele alın ve gerçekten kullandığınız komut istemleri üzerinde kendi değerlendirmelerinizi yapın.
Hepsini bir araya getirmek
Maliyet duyarlı bir aracı görev için kırpılmış bir Opus 5 sistem komut istemi kabaca şöyle görünür:
Doğrulama geçişleri eklemeyin; varsayılan olarak doğrularsınız.
Yanıtlar: en fazla 150 kelime, giriş yok, kapanış özeti yok.
Alt aracı oluşturmayın. Bunu tek bir iş parçacığında halledin.
Belirttiğim görevin kesinlikle içinde kalın. Başka bir değişiklik
gerekli görünürse, onu yapmak yerine durun ve bana bildirin.
Düzeltmeleri veya yaklaşım değişikliklerini anlatmayın.
Altı satır, beşi kısıtlama olan ve hiçbiri modelden daha fazla çaba sarf etmesini istemeyen. Değişim bu. Opus 4.8'de bir tabanı yükseltmek için komut istemi kullanıyordunuz. Opus 5'te bir tavan belirlemek için komut istemi kullanıyorsunuz.
Oradan başlayın, sonra seviyeler yeniden kalibre edildiği için 4.8 ayarlarınızı taşımak yerine kendi değerlendirmeleriniz üzerinde bir çaba taraması yapın. Parametre mekaniği için çaba parametresi kılavuzuna, düzenleyici tarafı iş akışı için Claude Kod'da Opus 5 kullanmaya ve tam model resmi için Claude Opus 5 nedir bölümüne bakın. Anthropic'in modeller genel bakışı mevcut özellik tablosunu içerir.
Sıkça Sorulan Sorular
"Çalışmanızı iki kez kontrol edin" ifadesini komut istemlerimden gerçekten silmeli miyim? Evet. Anthropic'in komut istemi kılavuzu, Opus 5'in herhangi bir komut istemi olmaksızın doğrulama yaptığını ve taşınan doğrulama talimatlarının aşırı doğrulamaya neden olduğunu belirtiyor. Küresel kuralı silin. Eğer belirli bir adım gerçekten açık bir kontrol gerektiriyorsa, talimatı yalnızca o adıma özgü hale getirin.
Opus 5 neden düşük çabada bile bu kadar ayrıntılı? Çünkü çaba, görünür çıktı uzunluğunu değil, düşünmeyi kontrol eder. Çabayı düşürmek muhakeme jetonlarını azaltırken yanıtlar yaklaşık olarak aynı uzunlukta kalır. Komut isteminin kendisine bir kelime veya format sınırı belirleyin.
Opus 5'in alt aracı oluşturmasını nasıl durdurabilirim? Doğrudan söyleyin: “Alt aracı oluşturmayın; bunu bu konuşmada halledin.” Eğer bazı yayılmalar faydalıysa, sayısal bir üst sınır belirleyin ve bunu bağımsız paralel çalışmalarla sınırlayın.
Çıktımda neden <thinking> etiketleri görüyorum? Bu yapı, düşünme devre dışı bırakıldığında ara sıra ortaya çıkar. Etiketleri adlandıran bir komut istemi talimatı eklemeyin, çünkü bu sızıntıyı daha olası hale getirir. Anthropic'in önerdiği çözüm, düşünmeyi etkin tutmak ve maliyeti kontrol etmek için daha düşük bir çaba seviyesi kullanmaktır.
Bir araç çağrısı düz metin olarak geri dönerse ne olur? Hiçbir şey yürütülmez ve sızan metin, daha sonraki dönüşlerin tamamlanmış bir eylem olarak değerlendirdiği konuşma geçmişinde kalır. Asistan dönüşlerini geçmişe eklemeden önce doğrulayın ve düşünmeyi devre dışı bırakmak yerine açık tutmayı tercih edin.