Chrome

Claude Code, Chrome tarayıcı entegrasyonu sayesinde CLI veya VS Code eklentisi üzerinden web tarayıcısını kontrol etmenize olanak tanır. Bu entegrasyon, kod yazma, test etme ve hata ayıklama iş akışlarını tek bir ortamda birleştirir.

Yetenekler (Capabilities)

Chrome bağlantısı etkinleştirildiğinde, aşağıdaki işlemleri tek bir iş akışında zincirleyebilirsiniz:

• Canlı hata ayıklama (Live debugging): Konsol hatalarını ve DOM durumunu doğrudan okuyun, ardından hataya neden olan kodu düzeltin.
• Tasarım doğrulama (Design verification): Bir Figma taslağından UI oluşturun, ardından tarayıcıda açarak doğruluğunu kontrol edin.
• Web uygulaması testi (Web app testing): Form doğrulamayı test edin, görsel regresyonları kontrol edin veya kullanıcı akışlarını doğrulayın.
• Kimlik doğrulamalı web uygulamaları (Authenticated web apps): API bağlayıcılarına ihtiyaç duymadan Google Docs, Gmail, Notion veya oturum açtığınız herhangi bir uygulamayla etkileşime geçin.
• Veri çıkarma (Data extraction): Web sayfalarından yapılandırılmış bilgileri çekin ve yerel olarak kaydedin.
• Görev otomasyonu (Task automation): Veri girişi, form doldurma veya çoklu site iş akışları gibi tekrarlayan tarayıcı görevlerini otomatikleştirin.
• Oturum kaydı (Session recording): Tarayıcı etkileşimlerini GIF olarak kaydedin ve belgeleyin veya paylaşın.

Ön koşullar (Prerequisites)

Chrome entegrasyonunu kullanmak için aşağıdakilere ihtiyacınız vardır:

• Google Chrome veya Microsoft Edge tarayıcısı
• Chrome Web Mağazası'ndan edinilebilen Claude in Chrome eklentisi (sürüm 1.0.36 veya üzeri)
• Claude Code sürüm 2.0.73 veya üzeri
• Doğrudan bir Anthropic planı (Pro, Max, Team veya Enterprise)

Not: Chrome entegrasyonu, Amazon Bedrock, Google Cloud Vertex AI veya Microsoft Foundry gibi üçüncü taraf sağlayıcılar üzerinden kullanılamaz. Claude'a 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.

CLI'da başlarken (Get started in the CLI)

1. Claude Code'u Chrome ile başlatın:

   claude --chrome
   

   Mevcut bir oturum içinden /chrome komutunu çalıştırarak da Chrome'u etkinleştirebilirsiniz.

2. Claude'dan tarayıcıyı kullanmasını isteyin:

   code.claude.com/docs adresine git, arama kutusuna tıkla, "hooks" yaz ve hangi sonuçların çıktığını söyle.
   

Bağlantı durumunu kontrol etmek, izinleri yönetmek, eklentiyi yeniden bağlamak veya bağlı tarayıcıyı seçmek için istediğiniz zaman /chrome komutunu kullanabilirsiniz. Birden fazla tarayıcı bağlıysa, Claude bir tarayıcı eylemi başladığında hangisini kullanacağınızı sorar.

Chrome'u varsayılan olarak etkinleştirme (Enable Chrome by default)

Her oturumda --chrome bayrağını kullanmaktan kaçınmak için /chrome komutunu çalıştırın ve "Enabled by default" seçeneğini seçin. VS Code eklentisinde, Chrome eklentisi yüklü olduğu sürece Chrome her zaman kullanılabilir; ek bir bayrak gerekmez.

Uyarı: Chrome'u varsayılan olarak etkinleştirmek, tarayıcı araçları her zaman yüklü olduğu için bağlam kullanımını (context usage) artırır. Bağlam tüketiminde artış fark ederseniz, bu ayarı devre dışı bırakın ve --chrome bayrağını yalnızca ihtiyaç duyduğunuzda kullanın.

Site izinlerini yönetme (Manage site permissions)

Site düzeyindeki izinler, Chrome eklentisinden devralınır. Claude'un hangi sitelerde gezinebileceğini, tıklayabileceğini ve yazı yazabileceğini kontrol etmek için izinleri Chrome eklentisi ayarlarından yönetin.

Plan modunda tarayıcı araçları (Browser tools in plan mode)

Plan modunda, yalnızca sayfayı veya tarayıcı durumunu okuyan tarayıcı araç çağrıları izin istemi olmadan çalışır; durumu değiştiren çağrılar ise onay ister.

• Salt okunur çağrılar: read_page, get_page_text, find, konsol mesajlarını veya ağ isteklerini okuma, ekran görüntüsü alma.
• Durum değiştiren çağrılar: tıklamalar, yazma, gezinme, sekme ve pencere yönetimi, GIF kaydı.

v2.1.199 itibarıyla, tabs_context_mcp üzerinde createIfEmpty, konsol ve ağ okuyucularında clear veya ekran görüntüsünde save_to_disk gibi durum değiştiren bir girdi bayrağı ayarlayan salt okunur bir çağrı da onay ister. Bir browser_batch çağrısı, yalnızca içindeki her eylem salt okunur olduğunda istemsiz çalışır.

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

Kullanılabilir tarayıcı araçlarının tam listesini görmek için /mcp komutunu çalıştırın ve claude-in-chrome seçeneğini seçin.

Yerel bir web uygulamasını test etme (Test a local web application)

Az önce giriş formu doğrulamasını güncelledim. localhost:3000'i açıp formu geçersiz verilerle göndermeyi dener misin? Hata mesajlarının doğru görünüp görünmediğini kontrol et.

Konsol günlükleriyle hata ayıklama (Debug with console logs)

Dashboard sayfasını aç ve sayfa yüklendiğinde konsolda herhangi bir hata olup olmadığını kontrol et.

Form doldurmayı otomatikleştirme (Automate form filling)

contacts.csv dosyasında müşteri bağlantılarının olduğu bir elektronik tablom var. Her satır için crm.example.com adresine git, "Add Contact" butonuna tıkla ve ad, e-posta, telefon alanlarını doldur.

Google Docs'ta içerik taslağı oluşturma (Draft content in Google Docs)

Son commit'lere dayanarak bir proje güncellemesi yaz ve bunu docs.google.com/document/d/abc123 adresindeki Google Doc'uma ekle.

Web sayfalarından veri çıkarma (Extract data from web pages)

Ürün listeleme sayfasına git ve her bir ürün için ad, fiyat ve stok durumunu çıkar. Sonuçları CSV dosyası olarak kaydet.

Çoklu site iş akışlarını çalıştırma (Run multi-site workflows)

Yarınki toplantılarım için takvimimi kontrol et. Ardından, harici katılımcısı olan her toplantı için, katılımcının şirket web sitesine bak ve ne yaptıklarına dair bir not ekle.

Demo GIF kaydetme (Record a demo GIF)

Ödeme akışının nasıl tamamlanacağını gösteren bir GIF kaydet: ürünü sepete eklemekten onay sayfasına kadar.

Sorun giderme (Troubleshooting)

Eklenti algılanmadı (Extension not detected)

• Chrome eklentisinin chrome://extensions sayfasında yüklü ve etkin olduğunu doğrulayın.
• Claude Code'un güncel olduğunu claude --version komutuyla kontrol edin.
• Chrome'un çalıştığından emin olun.
• /chrome komutunu çalıştırın ve "Reconnect extension" seçeneğini seçin.
• Sorun devam ederse hem Claude Code'u hem de Chrome'u yeniden başlatın.

Chrome entegrasyonunu ilk kez etkinleştirdiğinizde, Claude Code bir yerel mesajlaşma ana bilgisayar yapılandırma dosyası yükler. Chrome bu dosyayı başlangıçta okur, bu nedenle eklenti ilk denemede algılanmazsa yeni yapılandırmayı almak için Chrome'u yeniden başlatın.

v2.1.199 itibarıyla, Claude Code yalnızca ilk kurulumda eklentiyi bağlamanız için bir tarayıcı sekmesi açar. Daha sonraki oturumlarda (örneğin, Claude Code yapıları veya yapılandırma dizinleri değiştirildikten sonra) yapılandırma dosyasını yeniden yazsa bile bu sekmeyi yeniden açmaz.

Bağlantı hala başarısız olursa, ana bilgisayar yapılandırma dosyasının varlığını kontrol edin:

Chrome için:

• macOS: ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Linux: ~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Windows: Windows Kayıt Defteri'nde HKCU\Software\Google\Chrome\NativeMessagingHosts\ yolunu kontrol edin.

Edge için:

• macOS: ~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Linux: ~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
• Windows: Windows Kayıt Defteri'nde HKCU\Software\Microsoft\Edge\NativeMessagingHosts\ yolunu kontrol edin.

Tarayıcı yanıt vermiyor (Browser not responding)

• Sayfayı bir modal diyalog (alert, confirm, prompt) engelliyor olabilir. JavaScript diyalogları tarayıcı olaylarını bloke eder ve Claude'un komut almasını engeller. Diyaloğu manuel olarak kapatın, ardından Claude'a devam etmesini söyleyin.
• Claude'dan yeni bir sekme oluşturmasını ve tekrar denemesini isteyin.
• Chrome eklentisini chrome://extensions sayfasından devre dışı bırakıp yeniden etkinleştirin.

Uzun oturumlarda bağlantı kopması (Connection drops during long sessions)

Chrome eklentisinin servis çalışanı, uzun süreli oturumlarda boşta kalabilir ve bu da bağlantıyı koparabilir. Tarayıcı araçları bir süre hareketsizlikten sonra çalışmayı durdurursa, /chrome komutunu çalıştırın ve "Reconnect extension" seçeneğini seçin.

Windows'a özgü sorunlar (Windows-specific issues)

• Adlandırılmış kanal çakışmaları (EADDRINUSE): Başka bir işlem aynı adlandırılmış kanalı kullanıyorsa Claude Code'u yeniden başlatın. Chrome'u kullanıyor olabilecek diğer Claude Code oturumlarını kapatın.
• Yerel mesajlaşma ana bilgisayar hataları: Yerel mesajlaşma ana bilgisayarı başlangıçta çökerse, ana bilgisayar yapılandırmasını yeniden oluşturmak için Claude Code'u yeniden yüklemeyi deneyin.

Yaygın hata mesajları (Common error messages)

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

• Computer use: Bir görev tarayıcıda yapılamadığında yerel macOS uygulamalarını kontrol edin.
• Use Claude Code in VS Code: VS Code eklentisinde tarayıcı otomasyonu.
• CLI reference: --chrome dahil komut satırı bayrakları.
• Common workflows: Claude Code'u kullanmanın daha fazla yolu.
• Data and privacy: Claude Code'un verilerinizi nasıl işlediği.
• Getting started with Claude in Chrome: Kısayollar, zamanlama ve izinler dahil Chrome eklentisinin tam dokümantasyonu.

Örnek kullanım senaryosu

Bir geliştirici, yerel geliştirme ortamında çalışan bir e-ticaret uygulamasının ödeme sayfasını test etmek istiyor.

1. Oturumu başlatma: Geliştirici, terminalde claude --chrome komutunu çalıştırır.
2. Görevi tanımlama: Geliştirici, Claude'a şu komutu verir: "localhost:3000/checkout adresine git. Sepete bir ürün ekle, ardından 'Siparişi Tamamla' butonuna tıkla. Konsolda herhangi bir hata olup olmadığını kontrol et ve bana raporla."
3. Tarayıcı etkileşimi: Claude, Chrome'da yeni bir sekme açar, belirtilen URL'ye gider. Sayfada bir "Sepete Ekle" butonu bulur, tıklar. Ardından "Siparişi Tamamla" butonunu bulur ve tıklar.
4. Hata ayıklama: Claude, tarayıcı konsolunu okur. Konsolda Uncaught TypeError: Cannot read properties of undefined (reading 'total') şeklinde bir JavaScript hatası olduğunu tespit eder.
5. Raporlama ve düzeltme: Claude, terminale hatayı ve hatanın oluştuğu satır numarasını yazdırır. Geliştirici, hatayı düzeltmek için Claude'dan ilgili kaynak kod dosyasını açmasını ve hatayı düzeltmesini ister. Claude, kodu analiz eder, total değişkeninin tanımlanmadığı bir senaryoyu tespit eder ve gerekli düzeltmeyi uygular.
6. Doğrulama: Geliştirici, düzeltmeden sonra testi tekrarlaması için Claude'a aynı komutu verir. Bu sefer ödeme işlemi başarıyla tamamlanır ve konsolda hata görülmez.