Claude Browser Use Aracını Üretime Alma Rehberi

Claude'un tarayıcıyı kontrol eden ajanlarını üretime almak isteyen geliştiriciler için 19 Ağustos 2026 önemli bir eşik oldu: computer use aracı beta etiketini kaldırıp computer_toolset_20260801 adını aldı, aynı gün de tamamen yeni bir araç olan browser_toolset_20260801 yayınlandı. İkisi de Claude API'de kullanılabilir ve artık beta header gerektirmiyor. Bu rehberde Claude browser use aracının computer use'dan farkını, yeni araç yüzeyini ve production'a alırken dikkat etmen gereken güvenlik/bütçe kurallarını, resmi Anthropic dokümanlarına dayanarak anlatıyorum. Amaç, tek bir toolset'i "daha iyi" ilan etmek değil; hangi görevde hangi aracın gerçekten doğru seçim olduğunu, kaynağa dayalı somut ayrımlarla göstermek.

💡 Pro Tip: Görev tamamen web sayfaları içinde kalıyorsa veya sayfa içeriği JavaScript ile üretiliyorsa browser use'u seç; görev tarayıcı dışına, tüm masaüstüne taşıyorsa computer use'a geç — ikisini aynı ajanda birlikte kullanmak da mümkün.

İçindekiler

• Computer use GA oldu, ne değişti
• Yeni browser toolset'in yüzeyi
• Erişilebilirlik ağacı vs ekran görüntüsü: maliyet farkı
• Hangi aracı ne zaman seçmeli
• Form, sekme ve dosya yükleme akışları
• Batch action ile tur sayısını düşürmek
• Prompt injection ve izin sınırları
• Üretim kontrol listesi: sandbox, log, bütçe
• SSS
• Claude browser use aracı computer use'dan nasıl farklı?
• Tarayıcı ajanı erişilebilirlik ağacını neden piksel yerine kullanır?
• browser_toolset_20260801 nasıl etkinleştirilir?
• Tarayıcı ajanını üretimde güvenli çalıştırmanın kuralları neler?
• Eski computer_20251124 aracını kullanmaya devam edebilir miyim?
• İki toolset'i aynı ajanda birlikte kullanabilir miyim?
• Sonuç
• Kaynaklar

Computer use GA oldu, ne değişti

19 Ağustos 2026'da Anthropic, computer use aracını Claude API'de beta'dan çıkardı ve araç computer_toolset_20260801 adını aldı. Bu değişiklikle birlikte isteğe artık beta header eklemen gerekmiyor; aracı Messages API isteğinin tools dizisine tek bir {"type": "computer_toolset_20260801"} girdisi olarak eklemen yeterli. Bu tek girdi, Claude'a screenshot, left_click, type, zoom gibi 17 üye araç kazandırıyor. zoom üye aracı varsayılan olarak açık geliyor ve her üye araç configs üzerinden ayrı ayrı yapılandırılabiliyor.

Aynı gün Files API ve Agent Skills (Skills API, /v1/skills) da beta'dan çıktı — üçü birlikte aynı GA dalgasının parçası. Computer use, resmi dokümanın desteklenen model listesine göre claude-fable-5-1, claude-mythos-5-1, claude-fable-5, claude-mythos-5, claude-opus-5-5, claude-opus-5, claude-sonnet-5 ve claude-opus-4-8 modellerinde kullanılabiliyor, ancak şu an Claude Managed Agents'ta desteklenmiyor. 22 Eylül 2026'da yayınlanan Opus 5.5 için ise geçiş zorunlu hale geldi: bu modelde computer use artık computer_toolset_20260801 toolset'ini gerektiriyor ve eski computer_20251124 aracı Claude API ve Google Cloud'da 400 hatası döndürüyor (Amazon Bedrock'ta eski araç hâlâ çalışıyor).

Beta header'ın kalkması küçük bir detay gibi görünse de üretim kodunda gerçek bir sadeleştirme: artık isteğe özel bir başlık eklemeyi unutup unutmadığını kontrol eden bir adım daha az. configs üzerinden üye araç bazlı yapılandırma da benzer şekilde pratik bir kazanım — örneğin zoom aracını varsayılan açık bırakıp yalnızca belirli bir üye aracı devre dışı bırakmak istersen, bunu tüm toolset'i yeniden tanımlamadan yapabiliyorsun. Bu, önceki beta sürümüne göre yapılandırmayı isteğe daha ince taneli hâle getiriyor.

1{
2  "model": "claude-opus-5",
3  "max_tokens": 1024,
4  "tools": [{ "type": "computer_toolset_20260801" }],
5  "messages": [
6    {
7      "role": "user",
8      "content": "Ayarlar sayfasını aç ve bildirim tercihini kapat."
9    }
10  ]
11}

Yeni browser toolset'in yüzeyi

Aynı gün, computer use'un yeniden adlandırılmış hâli değil, tamamen ayrı bir client toolset olarak browser_toolset_20260801 yayınlandı. Önemli bir terminoloji notu: bu araç Anthropic'in barındırdığı bir tarayıcı değil, uygulamanın kendi barındırdığı bir tarayıcıyı sürüyor — resmi tanım "a client toolset for driving a browser that your application hosts" şeklinde.

Tek bir browser_toolset_20260801 girdisi, Claude'a varsayılan olarak navigate, read_page, left_click, screenshot gibi 27 üye araç kazandırıyor; isteğe bağlı olarak açabileceğin 4 araç daha var. Yüzey, ekran görüntüsü + tıklama kontrolünün üzerine element referansları, form girişi, sekme yönetimi, indirme raporlama ve opsiyonel (etkinleştirilmesi gereken) dosya yükleme ekliyor. Bu araç da computer use ile aynı gün GA oldu ve 20 Ağustos 2026'da Google Cloud'da Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Sonnet 5 ve Claude Opus 4.8 için kullanılabilir hâle geldi.

Burada altını çizmek istediğim nokta şu: browser use, computer use'un "web'e özelleşmiş küçük hâli" değil, kendi başına 27+4 üye araçla gelen ayrı bir yüzey. İki toolset'i aynı tools dizisine birlikte eklemek de mümkün — resmi computer use dokümanı, sayfa içinde kalan görevler için browser use aracının aynı istekte tanımlanabileceğini açıkça söylüyor; seçim tamamen görev bazlı. Bu da mimari tarafta şunu getiriyor: ajanını tasarlarken "hangi görev hangi toolset'e gidecek" kararını sistem promptunda ya da orkestrasyon katmanında baştan netleştirmen, ikisini karıştırıp gereksiz yere geniş bir izin yüzeyi açmaktan daha sağlıklı bir yol.

1{
2  "model": "claude-sonnet-5",
3  "max_tokens": 1024,
4  "tools": [{ "type": "browser_toolset_20260801" }],
5  "messages": [
6    {
7      "role": "user",
8      "content": "Dokümantasyon sayfasındaki başlangıç rehberini aç."
9    }
10  ]
11}

Erişilebilirlik ağacı vs ekran görüntüsü: maliyet farkı

Computer use tüm masaüstünü yalnızca ekran görüntüsü ve koordinatlarla yönetir. Browser use ise sayfayı iki katmanlı okur: hem yapısal olarak (erişilebilirlik ağacı, elementler, formlar, sekmeler) hem de ekran görüntüsü ve viewport koordinatlarıyla — resmi doküman bunu "Claude works with the page both through its structure ... and through screenshots and viewport coordinates" diye özetliyor.

Pratikte fark read_page çağrısında görünüyor: bu çağrı sayfadaki etkileşimli elemanları link "Documentation" [ref_1] gibi metinsel referanslarla döndürüyor. Claude bir sonraki turda hedefi ekran görüntüsünde görsel olarak aramak zorunda kalmadan doğrudan ref_2'yi tıklayabiliyor. Yapısal referanslar, hedefi ekran görüntüsünde arama adımını ortadan kaldırır; resmi browser use dokümanının ifadesiyle tipik bir sayfanın ağaç okuması çoğu zaman bir ekran görüntüsünden daha az girdi tokeni tüketir — yani hem daha ucuz hem daha deterministik bir yol.

Bu deterministik doğa, hata ayıklama açısından da fark yaratıyor. Computer use'ta bir tıklama yanlış koordinata düşerse, bunun nedeni genelde ekran görüntüsünün yanlış yorumlanmasıdır ve hatayı ayıklamak için görsel çıktıyı adım adım incelemen gerekir. Browser use'ta ise read_page çıktısı zaten metin olduğu için, bir ref_N'in yanlış elemente işaret ettiğini logdan doğrudan okuyabiliyorsun — ekran görüntüsüne bakmadan da hangi elementin nasıl adlandırıldığını görebilirsin. Bu, özellikle CI ortamında (görsel çıktı olmadan) ajan davranışını test etmeyi kolaylaştıran pratik bir yan etki.

1{
2  "type": "tool_result",
3  "tool_use_id": "toolu_01UvHU5cDyTZ2vXKf5wCkPqR",
4  "toolset_name": "browser",
5  "content": [
6    {
7      "type": "text",
8      "text": "link \"Documentation\" [ref_1]\nlink \"Getting started\" [ref_2]"
9    }
10  ]
11}

Hangi aracı ne zaman seçmeli

Resmi browser use dokümanı seçim kriterini net bir cümleyle veriyor: "Choose browser use when the task stays inside webpages and means acting on them, or when pages build their content with JavaScript. When a task needs a whole desktop, use the computer use tool, which works through screenshots and coordinates alone." Yani karar tek bir soruya indirgeniyor: görev tarayıcı sekmesinin dışına mı çıkıyor?

Bir form doldurma, bir SaaS panelinde ayar değiştirme, bir dokümantasyon sitesinde gezinme gibi görevlerin tamamı tarayıcı içinde kalıyorsa browser use'un yapısal okuma avantajından faydalanırsın. Ama ajanın bir masaüstü uygulamasını açması, dosya yöneticisiyle etkileşmesi veya tarayıcı dışı bir pencereyle iş yapması gerekiyorsa computer use'a ihtiyacın var — çünkü browser use yalnızca uygulamanın kendi barındırdığı tarayıcı içinde çalışıyor, ekranın geri kalanını göremiyor. İkisini aynı ajanda, farklı adımlarda art arda kullanmak da mümkün; tek toolset'e kilitlenmek zorunda değilsin.

Form, sekme ve dosya yükleme akışları

Browser use'un 27 varsayılan üye aracı arasında form doldurma, sekme yönetimi ve indirme raporlama standart olarak geliyor; varsayılan kapalı gelen dört üye araç ise javascript_exec, file_upload, read_console ve read_network — yani projende açıkça etkinleştirmen gereken yetenekler. Bu ayrım, üretim entegrasyonunda hangi izinleri varsayılan açık bırakıp hangilerini bilinçli olarak açman gerektiğini planlarken önemli: resmi browser use dokümanı güvenlik maddelerinde "ihtiyacın olmadıkça javascript_exec ve file_upload'ı kapalı bırak" diyor — bu da Anthropic'in genel "minimum ayrıcalık" yaklaşımıyla örtüşüyor.

Pratikte bu, entegrasyonu üç aşamalı düşünmeni kolaylaştırıyor. İlk aşamada yalnızca okuma ve gezinme (navigate, read_page, screenshot) açık — ajan siteyi keşfedebiliyor ama hiçbir şeyi değiştiremiyor. İkinci aşamada form doldurma ve tıklama ekleniyor; ajan artık etkileşime geçebiliyor ama hâlâ dosya gönderemiyor. Üçüncü aşamada, yalnızca gerçekten ihtiyaç varsa, opsiyonel dosya yükleme aracını açıyorsun. Bu kademeli açılış, her aşamada gözlemleyebileceğin, geri alabileceğin bir izin yüzeyi bırakıyor — tek seferde her şeyi açıp sonra sorun çıkınca kısıtlamaya çalışmaktan daha güvenli bir yol.

Batch action ile tur sayısını düşürmek

Hem computer use hem browser use aynı mekanizmayı paylaşıyor: "batch action". Resmi tanım şöyle: Claude kısa bir eylem dizisini (örneğin tıkla, yaz, sonra ekran görüntüsü al) planlayıp bunları tek bir yanıtta birlikte döndürebiliyor. Bu, paralel tool use ile aynı yanıt şeklini kullanıyor; tek fark, blokların eşzamanlı değil sırayla çalıştırılması. Pratik sonucu: her tek adımdan sonra modele geri dönüp yeni bir istek göndermek yerine, bir dizi eylemi tek turda yürütebiliyorsun — bu da API turu sayısını azaltıyor.

Bunun neden önemli olduğunu somutlaştırmak gerekirse: bir giriş formunu dolduran bir ajanı düşün. Batch action olmadan bu görev genelde "kullanıcı adı alanına tıkla" → yanıt bekle → "yaz" → yanıt bekle → "şifre alanına tıkla" → yanıt bekle → "yaz" → yanıt bekle → "gönder'e tıkla" şeklinde beş-altı ayrı tura yayılır. Batch action ile aynı dizi tek bir yanıtta planlanıp sırayla yürütülebiliyor; modelin her adımdan sonra yeniden düşünmesine gerek kalmıyor. Bu, hem gecikmeyi hem de tur başına ödenen sabit maliyeti (sistem promptu, araç tanımları gibi tekrar eden bağlam) azaltan bir tasarım kararı — ama sırayla çalıştığı için, bir önceki adımın sonucuna göre dallanma gerektiren görevlerde (örneğin "eğer hata mesajı çıkarsa farklı bir alanı doldur") batch action'ı olduğu gibi kullanmak yerine, dallanma noktasında yeniden Claude'a dönmek gerekiyor.

1{
2  "role": "assistant",
3  "content": [
4    {
5      "type": "tool_use",
6      "id": "toolu_01D7FLrfh4GYq7yT1ULFeyMV",
7      "name": "left_click",
8      "toolset_name": "browser",
9      "input": { "target": { "type": "ref", "ref": "ref_3" } }
10    },
11    {
12      "type": "tool_use",
13      "id": "toolu_01Ez4kLb1nQ2vXo8sJ9pWm3c",
14      "name": "type",
15      "toolset_name": "browser",
16      "input": { "text": "install" }
17    },
18    {
19      "type": "tool_use",
20      "id": "toolu_01FkP8rTz6uYh2mNq4LsXw7v",
21      "name": "key",
22      "toolset_name": "browser",
23      "input": { "text": "Enter" }
24    }
25  ]
26}

Prompt injection ve izin sınırları

Anthropic'in computer use dokümanı net bir uyarı taşıyor: "In some circumstances, Claude will follow commands found in content even when they conflict with your instructions." Buna karşı otomatik sınıflandırıcılar, ekran görüntüsü gibi araç çıktılarını tarayıp olası prompt injection girişimlerini işaretliyor. Browser use tarafında da benzer bir çerçeve var: sayfadan gelen her şey güvenilmez girdi (untrusted input) sayılıyor ve Claude'un attığı eylemlerin gerçek dünyada etkisi olabiliyor — yani bir sayfadaki gizli bir talimat, ajanı senin niyetinin dışına çıkarabilir.

Bu riske karşı Anthropic'in computer/browser use en iyi pratikler yazısı genel bir çerçeve öneriyor: ajanın yetkisini işin gerektirdiği kadarıyla sınırlamak (indirme gerekmiyorsa dosya indirme izni vermemek), ekran görüntüleri dahil tüm eylem dizisini loglamak ve form gönderme, satın alma, mesaj gönderme, veri değiştirme gibi geri alınamaz eylemlerden önce ajanı duraklatıp kullanıcı onayı istemek. Browser use dokümanı buna çalışma ortamı koşulunu ekliyor: tarayıcıyı ve executor'ı minimum ayrıcalıklı, kimlik bilgisi taşımayan temiz bir profille ayrı bir container veya sanal makinede çalıştırmak.

Sınıflandırıcıların rolünü de doğru yerine oturtmak gerekiyor: bunlar bir güvenlik ağı, ama tek başlarına yeterli değil. Araç çıktılarını (ekran görüntüsü, sayfa metni) tarayıp şüpheli talimat kalıplarını işaretliyorlar, fakat nihai karar hâlâ senin uygulamanın izin modelinde. Bir e-ticaret sayfasındaki gizli bir metin "sepeti onayla ve öde" gibi bir talimat içeriyorsa, sınıflandırıcı bunu işaretleyebilir — ama gerçek güvenlik, ödeme adımının zaten insan onayı gerektiren bir eylem olarak tanımlanmış olmasından geliyor. Bu yüzden prompt injection savunmasını tek bir katmana (yalnızca sınıflandırıcıya ya da yalnızca sistem promptuna) bırakmamak, kontrol listesindeki izin sınırlarıyla birlikte düşünmek gerekiyor.

Üretim kontrol listesi: sandbox, log, bütçe

Anthropic'in resmi computer use dokümanı, üretime almadan önce uygulanması gereken somut önlemleri listeliyor: özel, minimum ayrıcalıklı bir sanal makine veya container kullanmak; modele hesap girişi gibi hassas veriye erişim vermemek; internet erişimini bir domain allowlist ile sınırlamak; ve anlamlı gerçek dünya sonuçları doğurabilecek kararlarda (satın alma, hesap değişikliği gibi) bir insandan onay istemek.

Bunlara ek olarak iki operasyonel gerçeği hesaba katman gerekiyor: (1) her iki toolset de şu an Claude Managed Agents'ta desteklenmiyor, yani kurumsal "agent" dağıtım hattını bu iki araç üzerinden kuracaksan kendi orkestrasyon katmanını yazman gerekiyor; (2) bütçe tarafında Sonnet 5 fiyatı 10 Ağustos 2026'dan beri kalıcı olarak $2 / $10 per MTok'ta sabit (planlanan $3/$15 artışı iptal edildi). Her iki toolset de normal token fiyatlandırmasına tabidir.

Managed Agents desteğinin olmaması, özellikle kurumsal ekipler için pratik bir sonuç doğuruyor: şu an bu iki toolset'i kullanan bir ajanı, Anthropic'in yönetilen agent altyapısına devretmek yerine kendi API entegrasyonunda tutman gerekiyor. Bu, log toplama, yeniden deneme mantığı ve rate-limit yönetimi gibi sorumlulukların senin uygulamanda kalması demek. Loglama tarafında minimum bar şu olmalı: her tool_use/tool_result çifti (özellikle ekran görüntüleri ve read_page çıktıları) ayrı ayrı saklanmalı ki bir incident sonrası ajanın hangi sayfayı gördüğünü ve hangi eylemi neden seçtiğini geriye dönük inceleyebilesin. Bütçe izlemede de benzer bir disiplin işe yarıyor: batch action'ların tur sayısını düşürmesi toplam maliyeti azaltsa da, her ekran görüntüsü hâlâ görsel token tüketiyor — bu yüzden üretimde toplam maliyeti "tur başına" değil "tamamlanan görev başına" ölçmek daha gerçekçi bir bütçe sinyali veriyor.

SSS

Claude browser use aracı computer use'dan nasıl farklı?

Browser use, uygulamanın kendi barındırdığı bir tarayıcı içinde çalışır ve sayfayı erişilebilirlik ağacı (elementler, form alanları, sekmeler) üzerinden okur; computer use ise tüm masaüstünü yalnızca ekran görüntüsü ve koordinatlarla yönetir. Görev tamamen web sayfaları içinde kalıyorsa veya sayfa içeriği JavaScript ile üretiliyorsa browser use tercih edilir; görev tarayıcı, masaüstü uygulaması ve yerel arayüz arasında geçiş gerektiriyorsa computer use kullanılır.

Tarayıcı ajanı erişilebilirlik ağacını neden piksel yerine kullanır?

Erişilebilirlik ağacı elementlere doğrudan referans (ref_N) verir; bu da modelin piksel koordinatı tahmin etmek yerine "bu elemente tıkla" demesini sağlar. Resmi dokümana göre bu yaklaşım ekran görüntüsünü tamamen devre dışı bırakmıyor, ikisini birlikte kullanıyor — yapısal referans ile görsel doğrulamayı birleştiriyor.

browser_toolset_20260801 nasıl etkinleştirilir?

Messages API isteğinin tools dizisine, name alanı olmadan yalnızca tipi browser_toolset_20260801 olan tek bir giriş eklenir. Bu, Claude'a varsayılan 27 üye araç (navigate, read_page, left_click, screenshot vb.) kazandırır, 4 tanesi ise opsiyonel olarak açılır. Araç hem Claude API'de hem 20 Ağustos 2026'dan itibaren Google Cloud'da kullanılabilir; GA olduğu için beta header gerekmez.

Tarayıcı ajanını üretimde güvenli çalıştırmanın kuralları neler?

Resmi dokümantasyon açıkça uyarıyor: sayfanın sunduğu her şey güvenilmez girdi sayılmalı ve Claude'un attığı eylemlerin gerçek etkileri olabilir. Buna karşı izole ortam kullanmak, hassas veriye erişim vermemek, internet erişimini allowlist ile sınırlamak ve gerçek dünya sonucu doğuran kararlarda insan onayı istemek gerekiyor; satın alma, form gönderme ve veri değiştirme gibi geri alınamaz eylemlerden önce ise kullanıcı onayı zorunlu kılınmalı.

Eski computer_20251124 aracını kullanmaya devam edebilir miyim?

Claude API ve Google Cloud üzerinde Opus 5.5 ile artık hayır — bu model computer use için computer_toolset_20260801 toolset'ini gerektiriyor ve eski computer_20251124 aracı 400 hatası döndürüyor. Amazon Bedrock üzerinde eski araç şu an hâlâ çalışıyor, ama bu bir geçiş penceresi olarak görülmeli, kalıcı bir çözüm olarak değil.

İki toolset'i aynı ajanda birlikte kullanabilir miyim?

Evet, resmi computer use dokümanı, sayfa içinde kalan görevler için browser use aracının aynı istekte tanımlanabileceğini açıkça söylüyor. Seçim kriteri görev bazlı: görev tarayıcı sayfaları içinde kalıyorsa browser use, tüm masaüstüne taşıyorsa computer use tercih edilir. Farklı adımlarda farklı toolset kullanan bir ajan kurmak mümkün; önemli olan hangi adımda hangi aracın gerçekten ihtiyaç duyulduğunu net tanımlamak.

Sonuç

19 Ağustos 2026, Claude'un tarayıcı ve masaüstü otomasyonu için bir dönüm noktası oldu: computer use GA'ya geçerken, ondan tamamen bağımsız yeni bir araç olan browser use de doğdu. Özetle taşıman gereken üç karar var: (1) görevin kapsamına göre computer use mi browser use mı — ya da ikisi birlikte mi — kullanacağını seç; (2) izin yüzeyini kademeli aç, dosya yükleme gibi yan etkisi yüksek yetenekleri en sona bırak; (3) sandbox, allowlist ve insan onayı gibi resmi güvenlik önlemlerini üretime almadan önce eksiksiz uygula, çünkü her iki araç da Managed Agents'ın sağladığı hazır güvenlik katmanından şu an yoksun.

Claude Computer Use API rehberimde beta dönemindeki piksel/mouse tabanlı yaklaşımı detaylandırmıştım; bu yazı onun GA sonrası devamı niteliğinde. Ajan mimarini kurarken batch action'ı agentic AI tool use rehberimdeki planner loop desenleriyle birlikte düşünebilir, çok araçlı entegrasyonlarda MCP rehberine bakabilirsin. Model tarafında hangi Claude sürümünü seçeceğine karar verirken Claude Fable 5.1 yenilikleri yazısı ve maliyet optimizasyonu için prompt caching rehberi faydalı olacaktır. Üretime almadan önce yukarıdaki kontrol listesini ve güvenlik sınırlarını mutlaka gözden geçir.

Kaynaklar

• Claude API Release Notes — computer use/browser use GA (19 Ağu), Google Cloud dağıtımı (20 Ağu), Opus 5.5 geçiş zorunluluğu (22 Eyl) ve Sonnet 5 fiyat sabitlenmesi (10 Ağu) resmi kayıtları.
• Computer Use Tool dokümanı — 17 üye araç, batch action tanımı, Managed Agents kısıtı ve güvenlik önerileri.
• Browser Use Tool dokümanı — 27+4 üye araç, erişilebilirlik ağacı yaklaşımı ve element referans mekanizması.
• Digital Applied: Browser Use Tool GA — computer use ile browser use'un rename olmadığının bağımsız teyidi.
• Anthropic: Best practices for computer and browser use — çözünürlük/ölçekleme, effort ayarı, prompt injection sınıflandırıcıları ve bağlam yönetimi pratikleri; yazı Claude 4.6 ailesi ile Opus 4.7'ye göre yazılmış ve computer_20251124 sürümünü kullanıyor.