Computer Use beta

Computer Use (preview) — Claude'un CLI Üzerinden Bilgisayarınızı Kullanması

Claude Code CLI'da computer use özelliğini etkinleştirerek Claude'un macOS üzerinde uygulamaları açmasını, tıklamasını, yazı yazmasını ve ekranınızı görmesini sağlayabilirsiniz. Bu sayede native uygulamaları test edebilir, görsel hataları debug edebilir ve GUI tabanlı araçları terminalden çıkmadan otomatize edebilirsiniz.

Not: Computer use, macOS üzerinde Pro veya Max planı gerektiren bir araştırma önizlemesidir (research preview). Team veya Enterprise planlarında kullanılamaz. Claude Code v2.1.85 veya üzeri sürüm ve interaktif bir oturum gerektirir; -p bayrağı ile non-interactive modda çalışmaz.

Computer use ile neler yapabilirsiniz? (What you can do with computer use)

Computer use, GUI gerektiren görevleri üstlenir — normalde terminalden çıkıp elle yapmanız gereken her şey:

• Native uygulamaları derleyip doğrulama: Claude'a bir macOS menü çubuğu uygulaması yapmasını söyleyin. Swift kodunu yazar, derler, uygulamayı başlatır ve her kontrolü tıklayarak çalıştığını doğrular.
• Uçtan uca UI testi: Claude'u yerel bir Electron uygulamasına yönlendirip "onboarding akışını test et" deyin. Uygulamayı açar, kaydolma adımlarını tıklar ve her adımın ekran görüntüsünü alır. Playwright yapılandırması veya test altyapısı gerekmez.
• Görsel ve düzen hatalarını debug etme: "Modal küçük pencerelerde kırpılıyor" deyin. Claude pencereyi yeniden boyutlandırır, hatayı yeniden üretir, ekran görüntüsünü alır, CSS'i düzeltir ve düzeltmeyi doğrular.
• GUI tabanlı araçları yönetme: Tasarım araçları, donanım kontrol panelleri, iOS Simulator veya CLI'si/API'si olmayan özel uygulamalarla etkileşim kurabilirsiniz.

Computer use ne zaman devreye girer? (When computer use applies)

Claude'un bir uygulama veya hizmetle etkileşime geçmek için birkaç yolu vardır. Computer use en geniş kapsamlı ve en yavaş yöntemdir, bu nedenle Claude önce en hassas aracı kullanmaya çalışır:

1. Hizmet için bir MCP sunucusu varsa → Claude onu kullanır.
2. Görev bir shell komutuysa → Claude Bash kullanır.
3. Görev tarayıcı işiyse ve Claude in Chrome kuruluysa → Claude onu kullanır.
4. Bunların hiçbiri uygulanmıyorsa → Claude computer use kullanır.

Ekran kontrolü, yalnızca başka hiçbir şeyin erişemediği şeyler için ayrılmıştır: native uygulamalar, simülatörler ve API'si olmayan araçlar.

Computer use'u etkinleştirme (Enable computer use)

Computer use, computer-use adlı yerleşik bir MCP sunucusu olarak kullanılabilir. Varsayılan olarak kapalıdır.

1. MCP menüsünü açın

Interaktif bir Claude Code oturumunda şu komutu çalıştırın:

/mcp

Sunucu listesinde computer-use'i bulun. Devre dışı (disabled) olarak görünür.

2. Sunucuyu etkinleştirin

computer-use'i seçin ve Enable'a tıklayın. Bu ayar proje bazında kalıcıdır; computer use'u istediğiniz her proje için yalnızca bir kez yapmanız gerekir.

3. macOS izinlerini verin

Claude bilgisayarınızı ilk kez kullanmaya çalıştığında, iki macOS izni vermeniz istenir:

• Accessibility (Erişilebilirlik): Claude'un tıklamasına, yazı yazmasına ve kaydırmasına izin verir.
• Screen Recording (Ekran Kaydı): Claude'un ekranınızda ne olduğunu görmesini sağlar.

İzin istemi, ilgili Sistem Ayarları bölmesini açmak için bağlantılar içerir. Her iki izni de verin, ardından istemde Try again'i seçin. macOS, Ekran Kaydı iznini verdikten sonra Claude Code'u yeniden başlatmanızı gerektirebilir.

Kurulumdan sonra Claude'dan GUI gerektiren bir şey yapmasını isteyin:

"Uygulama hedefini derle, başlat ve her sekmeyi tıkla, hiçbir şeyin çökmediğinden emin ol. Bulduğun hata durumlarının ekran görüntüsünü al."

Oturum başına uygulamaları onaylama (Approve apps per session)

computer-use sunucusunu etkinleştirmek, Claude'a makinenizdeki her uygulamaya erişim izni vermez. Claude'un bir oturumda belirli bir uygulamaya ihtiyacı olduğunda, terminalinizde şunları gösteren bir istem belirir:

• Claude'un kontrol etmek istediği uygulamalar
• İstenen ek izinler (örneğin pano erişimi)
• Claude çalışırken kaç uygulamanın gizleneceği

Allow for this session veya Deny seçeneğini kullanın. Onaylar yalnızca mevcut oturum için geçerlidir. Claude birden fazla uygulamayı birlikte talep ettiğinde hepsini tek seferde onaylayabilirsiniz.

Geniş kapsamlı uygulamalar, onaylamadan önce ek bir uyarı gösterir:

Bu uygulamalar engellenmez. Uyarı, görevin bu erişim düzeyini hak edip etmediğine karar vermenizi sağlar.

Claude'un kontrol düzeyi uygulama kategorisine göre değişir: tarayıcılar ve ticaret platformları salt görüntüleme, terminaller ve IDE'ler yalnızca tıklama, diğer her şey tam kontrol alır.

Claude ekranınızda nasıl çalışır? (How Claude works on your screen)

Akışı anlamak, Claude'un ne yapacağını tahmin etmenize ve nasıl müdahale edeceğinizi bilmenize yardımcı olur.

Her seferinde bir oturum (One session at a time)

Computer use, etkinken makine çapında bir kilit (lock) tutar. Başka bir Claude Code oturumu zaten bilgisayarınızı kullanıyorsa, yeni denemeler hangi oturumun kilidi tuttuğunu belirten bir mesajla başarısız olur. Önce o oturumu bitirin veya çıkın.

Claude çalışırken uygulamalar gizlenir (Apps are hidden while Claude works)

Claude ekranınızı kontrol etmeye başladığında, diğer görünür uygulamalar gizlenir, böylece Claude yalnızca onaylanmış uygulamalarla etkileşime girer. Terminal pencereniz görünür kalır ve ekran görüntülerinden hariç tutulur, böylece oturumu izleyebilirsiniz ve Claude kendi çıktısını asla görmez. Claude sırasını bitirdiğinde gizlenen uygulamalar otomatik olarak geri yüklenir.

Ekran görüntüleri otomatik olarak küçültülür (Screenshots are downscaled automatically)

Claude Code, her ekran görüntüsünü modele göndermeden önce otomatik olarak küçültür. Retina veya diğer yüksek çözünürlüklü ekranlarda ekran çözünürlüğünüzü düşürmeniz veya pencereleri yeniden boyutlandırmanız gerekmez. 16 inç MacBook Pro'da native Retina çözünürlüğünde 3456×2234 olarak yakalanan görüntü, en-boy oranı korunarak yaklaşık 1372×887'ye küçültülür. Hedef boyutu değiştirmek için bir ayar yoktur. Küçültme sonrası ekrandaki metin veya kontroller Claude'un okuyamayacağı kadar küçükse, ekran çözünürlüğünüzü değiştirmek yerine uygulama içinde boyutlarını artırın.

İstediğiniz zaman durdurun (Stop at any time)

Claude kilidi aldığında, bir macOS bildirimi görünür: "Claude is using your computer · press Esc to stop." Mevcut eylemi hemen durdurmak için herhangi bir yerde Esc tuşuna basın veya terminalde Ctrl+C'ye basın. Her iki durumda da Claude kilidi serbest bırakır, uygulamalarınızı gösterir ve kontrolü size geri verir. Claude işini bitirdiğinde ikinci bir bildirim görünür.

Güvenlik ve güven sınırı (Safety and the trust boundary)

Sandbox'lanmış Bash aracının aksine, computer use gerçek masaüstünüzde, onayladığınız uygulamalara erişimle çalışır. Claude her eylemi kontrol eder ve ekrandaki içerikten kaynaklanan olası prompt injection'ları işaretler, ancak güven sınırı farklıdır.

Yerleşik güvenlik önlemleri yapılandırma gerektirmeden riski azaltır:

• Uygulama başına onay: Claude yalnızca mevcut oturumda onayladığınız uygulamaları kontrol edebilir.
• Sentinel uyarıları: Shell, dosya sistemi veya sistem ayarları erişimi sağlayan uygulamalar, onaylamadan önce işaretlenir.
• Terminal ekran görüntülerden hariç tutulur: Claude terminal pencerenizi asla görmez, böylece oturumunuzdaki ekran istemleri modele geri beslenemez.
• Global kaçış: Esc tuşu computer use'u her yerden durdurur ve tuş basımı tüketilir, böylece prompt injection bunu diyalogları kapatmak için kullanamaz.
• Kilit dosyası: Makinenizi aynı anda yalnızca bir oturum kontrol edebilir.

Örnek iş akışları (Example workflows)

Native bir derlemeyi doğrulama (Validate a native build)

Bir macOS veya iOS uygulamasında değişiklik yaptıktan sonra Claude'un tek seferde derleyip doğrulamasını sağlayın:

"MenuBarStats hedefini derle, başlat, tercihler penceresini aç ve aralık kaydırıcısının etiketi güncellediğini doğrula. İşin bittiğinde tercihler penceresinin ekran görüntüsünü al."

Claude xcodebuild'i çalıştırır, uygulamayı başlatır, UI ile etkileşime girer ve bulduklarını raporlar.

Düzen hatasını yeniden üretme (Reproduce a layout bug)

Görsel bir hata yalnızca belirli pencere boyutlarında ortaya çıktığında, Claude'un bulmasını sağlayın:

"Ayarlar modalı dar pencerelerde altbilgisini kırpıyor. Uygulama penceresini hatayı yeniden üretebileceğin kadar küçült, kırpılmış durumun ekran görüntüsünü al, ardından modal konteynerinin CSS'ini kontrol et."

Claude pencereyi yeniden boyutlandırır, bozuk durumu yakalar ve ilgili stil sayfalarını okur.

Simülatör akışını test etme (Test a simulator flow)

iOS Simulator'ü XCTest yazmadan yönetin:

"iOS Simulator'ü aç, uygulamayı başlat, onboarding ekranlarını tıkla ve bana herhangi bir ekranın yüklenmesinin bir saniyeden uzun sürüp sürmediğini söyle."

Claude simülatörü fareyle yaptığınız gibi kontrol eder.

Masaüstü uygulamasından farklar (Differences from the Desktop app)

CLI ve Masaüstü yüzeyleri aynı computer use motorunu paylaşır, ancak bazı farklılıklar vardır:

Sorun giderme (Troubleshooting)

"Computer use is in use by another Claude session"

Başka bir Claude Code oturumu kilidi tutuyor. O oturumdaki görevi bitirin veya oturumdan çıkın. Diğer oturum çöktüyse, Claude işlemin artık çalışmadığını algıladığında kilit otomatik olarak serbest bırakılır.

macOS izin istemi sürekli yeniden görünüyor

macOS bazen Ekran Kaydı iznini verdikten sonra istekte bulunan işlemin yeniden başlatılmasını gerektirir. Claude Code'u tamamen kapatın ve yeni bir oturum başlatın. İstem devam ederse, Sistem Ayarları > Gizlilik ve Güvenlik > Ekran Kaydı'nı açın ve terminal uygulamanızın listelendiğini ve etkinleştirildiğini doğrulayın.

computer-use /mcp içinde görünmüyor

Sunucu yalnızca uygun kurulumlarda görünür. Şunları kontrol edin:

• macOS kullanıyor musunuz? Computer use CLI'da Linux veya Windows'ta kullanılamaz. Windows'ta Masaüstü uygulamasındaki computer use'u kullanın.
• Claude Code sürümü: claude --version ile v2.1.85 veya üzerini çalıştırdığınızdan emin olun.
• Planınız: Pro veya Max planında mısınız? /status ile aboneliğinizi kontrol edin.
• Kimlik doğrulama: claude.ai üzerinden kimlik doğrulaması yapmış olmalısınız. Computer use, Amazon Bedrock, Google Cloud Vertex AI veya Microsoft Foundry gibi üçüncü taraf sağlayıcılarla kullanılamaz. Yalnızca üçüncü taraf bir sağlayıcı üzerinden erişiyorsanız, bu özelliği kullanmak için ayrı bir claude.ai hesabına ihtiyacınız vardır.
• Interaktif oturum: Computer use, -p bayrağı ile non-interactive modda kullanılamaz.

Ayrıca bakınız (See also)

• Computer use in Desktop — aynı yetenek, grafiksel ayarlar sayfasıyla
• Claude in Chrome — web tabanlı görevler için tarayıcı otomasyonu
• MCP — Claude'u yapılandırılmış araçlara ve API'lere bağlama
• Sandboxing — Claude'un Bash aracının dosya sistemi ve ağ erişimini nasıl izole ettiği
• Computer use safety guide — güvenli computer use için en iyi uygulamalar

Örnek kullanım senaryosu

Senaryo: Bir macOS menü çubuğu uygulaması geliştiriyorsunuz ve yaptığınız değişikliklerin doğru çalıştığını doğrulamak istiyorsunuz. Uygulama, kullanıcının pil seviyesini gösteren bir menü çubuğu ikonu ve tercihler penceresinde bir yenileme aralığı kaydırıcısı içeriyor.

Adımlar:

1. MCP sunucusunu etkinleştirin:

   # Claude Code oturumunda
   /mcp
   

   computer-use'i bulun ve Enable seçeneğini seçin.

2. macOS izinlerini verin: İlk kullanımda çıkan Accessibility ve Screen Recording izin istemlerini onaylayın. Gerekirse Claude Code'u yeniden başlatın.

3. Claude'a görevi tanımlayın:

   "Projemdeki MenuBarStats hedefini derle, uygulamayı başlat, menü çubuğu ikonunun göründüğünü doğrula, ardından tercihler penceresini aç. Kaydırıcıyı 30 saniyeye getir ve etiketin '30 saniye' olarak güncellendiğini kontrol et. Son olarak tercihler penceresinin ekran görüntüsünü al."

4. Claude'un çalışmasını izleyin: Terminaliniz açık kalırken Claude:

   • xcodebuild ile uygulamayı derler
   • Derlenen uygulamayı başlatır
   • Menü çubuğu ikonunu kontrol eder
   • Tercihler penceresini açar (⌘, kısayoluyla)
   • Kaydırıcıyı 30 saniyeye sürükler
   • Etiketin güncellendiğini ekran görüntüsüyle doğrular
   • Size sonuçları ve ekran görüntüsünü gösterir

5. Gerektiğinde müdahale edin: Claude beklemediğiniz bir uygulamayı açmak isterse, terminaldeki onay istemini değerlendirin. Yanlış bir şey yaparsa Esc tuşuna basarak hemen durdurun.

6. Sonuçları değerlendirin: Claude size derlemenin başarılı olup olmadığını, UI etkileşimlerinin sonuçlarını ve tercihler penceresinin ekran görüntüsünü sunar. Hata varsa, Claude hatayı ve ekran görüntüsünü raporlar.