Claude Code'da Chrome Entegrasyonu: Tarayıcı Otomasyonu ve Canlı Debug Rehberi

Bir web uygulamasında Claude Code'a "login formunun doğrulamasını düzelt" dediğinizde kodu yazar, testleri çalıştırır, ama işin en can alıcı kısmı olan "tarayıcıda gerçekten çalışıyor mu?" sorusu size kalır: sekmeyi açarsınız, formu yanlış doldurursunuz, console'a bakarsınız, hatayı kopyalayıp terminale yapıştırırsınız. Chrome entegrasyonu bu döngüyü kapatıyor. Claude Code, Claude in Chrome tarayıcı eklentisi üzerinden gerçek tarayıcınızı kullanabiliyor: sayfayı açıyor, formu dolduruyor, console hatalarını okuyor, ekran görüntüsü alıyor, hatta yaptıklarını GIF olarak kaydediyor. Bu yazıda resmi dokümantasyona dayanarak özelliğin nasıl çalıştığını, ön koşullarını, --chrome bayrağı ve /chrome komutunu, izin modelini, dosya yükleme ve kayıt gibi yeteneklerin sınırlarını ve sorun giderme adımlarını anlatıyorum. Entegrasyon perde arkasında bir MCP sunucusu olarak çalıştığı için MCP rehberine göz atmış olmanız bazı kavramları daha hızlı oturtmanızı sağlar.

Chrome Entegrasyonu Nedir, Nasıl Çalışır?

Resmi tanıma göre Claude Code, Claude in Chrome tarayıcı eklentisiyle entegre olarak size CLI'dan ya da VS Code eklentisinden tarayıcı otomasyonu yetenekleri sunar. Fikir basit: kodu yazdıktan sonra bağlam değiştirmeden aynı konuşma içinde tarayıcıda test ve debug yaparsınız.

Çalışma biçiminin birkaç önemli ayrıntısı var:

• Gerçek tarayıcınızı kullanır. Claude, tarayıcı görevleri için yeni sekmeler açar ve tarayıcınızın oturum açma durumunu paylaşır; yani zaten giriş yaptığınız her siteye erişebilir. Headless bir tarayıcı ya da ayrı bir profil söz konusu değildir.
• Her şey gözünüzün önünde olur. Tarayıcı eylemleri görünür bir Chrome penceresinde gerçek zamanlı olarak çalışır. Claude'un ne yaptığını izleyebilirsiniz.
• Giriş ve CAPTCHA'da durur. Claude bir giriş sayfası ya da CAPTCHA ile karşılaştığında durur ve bunu sizin elle halletmenizi ister.
• Sekmeler gruplanır. Eklenti, Claude'un açtığı sekmeleri oturumunuza bağlı bir Chrome sekme grubunda toplar.

Sekme grubunun kapanma davranışı, oturumun nasıl bittiğine göre değişiyor. Yerel oturumlarda /clear yazdığınızda Claude Code grubu açık sayfalarla birlikte kapatır; tek istisna, clear'dan sonra da devam eden bir işin hâlâ çalışıyor olmasıdır. /resume gibi bir komutla oturum değiştirdiğinizde, Claude Code'dan çıktığınızda ya da devam eden bir iş varken /clear çalıştırdığınızda ise grup yalnızca içinde boş yeni sekmelerden başka bir şey yoksa kapatılır; hâlâ okuyor olabileceğiniz sayfalar açık kalır. CHANGELOG'a göre bu davranış zamanla oturdu: 2.1.221 sürümünde Claude'un artık ihtiyaç duymadığı sekmeleri kapatması, 2.1.239'da ise /clear'ın sekme grubunu kapatması eklendi.

Teknik olarak entegrasyon, claude-in-chrome adlı bir MCP sunucusu üzerinden yürür. Bu ayrıntı iki yerde karşınıza çıkar: tarayıcı araçlarının tam listesini /mcp menüsünden claude-in-chrome sunucusunu seçip View tools diyerek görürsünüz ve organizasyonunuz bu sunucuyu deniedMcpServers yönetilen ayarıyla engelleyebilir.

Chrome ile Neler Yapabilirsiniz?

Resmi dokümantasyon Chrome bağlıyken tarayıcı eylemlerini kodlama görevleriyle tek bir iş akışında zincirleyebileceğinizi söylüyor ve şu kullanım alanlarını sıralıyor:

Yetenek	Ne yapar
Canlı debug	Console hatalarını ve DOM durumunu doğrudan okur, ardından bunlara neden olan kodu düzeltir
Tasarım doğrulama	Bir Figma taslağından arayüzü kurar, sonra tarayıcıda açıp eşleşip eşleşmediğini kontrol eder
Web uygulaması testi	Form doğrulamasını test eder, görsel gerilemeleri kontrol eder, kullanıcı akışlarını doğrular
Kimlik doğrulamalı uygulamalar	API bağlayıcısı olmadan Google Docs, Gmail, Notion gibi giriş yaptığınız uygulamalarla etkileşir
Veri çıkarma	Web sayfalarından yapılandırılmış bilgi çekip yerel dosyaya kaydeder
Görev otomasyonu	Veri girişi, form doldurma ve çok siteli iş akışları gibi tekrarlayan işleri otomatikleştirir
Dosya yükleme	Makinenizdeki dosyaları web sayfalarındaki yükleme alanlarına ekler
Oturum kaydı	Tarayıcı etkileşimlerini belgelemek ya da paylaşmak için GIF olarak kaydeder

Bu listeye bakarken şunu akılda tutmakta fayda var: özellik yalnızca "kendi uygulamamı test edeyim" senaryosuna sıkışmış değil. Tarayıcınızın oturumlarını paylaştığı için Claude, hiçbir API anahtarı ya da MCP bağlayıcısı kurmadan giriş yaptığınız SaaS araçlarıyla çalışabiliyor. Bu güçlü ama dikkat isteyen bir yetenek; izin modeline aşağıda ayrıca değineceğim.

Ön Koşullar: Hangi Plan, Hangi Tarayıcı, Hangi Giriş?

Başlamadan önce dört şeye ihtiyacınız var:

• Tarayıcı: Google Chrome, Microsoft Edge ya da Brave, Arc, Vivaldi, Opera gibi başka bir Chromium tabanlı tarayıcı. Dokümantasyon entegrasyonun Chrome ve Edge ile çalıştığını, diğer Chromium tabanlı tarayıcılarda da eklentiyi algılayıp bağlantıyı kurduğunu söylüyor.
• Eklenti: Chrome Web Store'daki Claude in Chrome eklentisinin 1.0.36 veya üstü sürümü.
• Claude Code: güncel bir kurulum (claude --version ile kontrol edin).
• Plan: doğrudan bir Anthropic planı: Pro, Max, Team ya da Enterprise.

İki kısıt özellikle önemli. Birincisi, entegrasyon WSL (Windows Subsystem for Linux) içinde desteklenmiyor. Windows'ta kullanacaksanız Claude Code'u doğrudan Windows'ta çalıştırmanız gerekiyor. İkincisi, kimlik doğrulama yöntemi: Chrome entegrasyonu /login ile giriş yapmanızı gerektiriyor. Bir API anahtarıyla ya da claude setup-token ile ürettiğiniz uzun ömürlü bir token ile kimlik doğruluyorsanız, tarayıcı eklentisi bu kimlik bilgileriyle doğrulama yapamadığı için Claude Code --chrome geçseniz bile entegrasyonu kapalı tutar. Dokümantasyon, v2.1.216 öncesinde bu oturumların entegrasyonu açabildiğini ama eklentiye her bağlantı denemesinin 403 hatasıyla başarısız olduğunu belirtiyor; yani eski sürümlerde gördüğünüz gizemli 403'lerin nedeni büyük olasılıkla buydu.

Üçüncü parti sağlayıcılar için de net bir sınır var: Chrome entegrasyonu Amazon Bedrock, Google Cloud Agent Platform ya da Microsoft Foundry üzerinden kullanılamıyor. Claude'a yalnızca bu sağlayıcılardan erişiyorsanız özellik için ayrı bir claude.ai hesabına ihtiyacınız var. Team ve Enterprise organizasyonlarında ayrıca yöneticinin kararı geçerli: CHANGELOG'daki 2.1.260 notuna göre Claude in Chrome artık organizasyonun ilgili yönetici ayarını izliyor; bir yönetici özelliği kapattığında --chrome, /chrome ve tarayıcı araçları kullanılamaz oluyor.

CLI'da Başlangıç: --chrome Bayrağı ve /chrome Komutu

Kurulum iki adımdan ibaret. Önce Claude Code'u --chrome bayrağıyla başlatın:

claude --chrome

Chrome ile ilk açılışta Claude Code, entegrasyonu tanıtan ve site izinlerinin nasıl çalıştığını açıklayan tek seferlik bir diyalog gösterir; Enter'a basıp devam edersiniz. Ardından Claude'a tarayıcıyı kullanmasını söylemek yeterli. Dokümantasyonun kendi örneği, bir sayfaya gidip etkileşime giren ve bulduğunu raporlayan şu istem:

Go to code.claude.com/docs, click on the search box,
type "hooks", and tell me what results appear

Claude Code bir tarayıcı eyleminden önce izin isterse onaylayın. Diyalog "Claude in Chrome wants to" ifadesiyle başlar ve o site için oturum boyunca tüm eylemlere izin verme seçeneği sunar. Onayladığınızda Claude yeni bir sekme açıp göreve başlar.

Oturum içinde istediğiniz an /chrome yazarak bağlantı durumunu kontrol edebilir, izinleri yönetebilir, eklentiyi yeniden bağlayabilir ya da birden fazla tarayıcı bağlıysa hangisinin kullanılacağını seçebilirsiniz. Entegrasyonun çalıştığını, durum panelinde "Status: Enabled" ve "Extension: Installed" yazmasından anlarsınız.

Bayrakların tam listesi şöyle:

Bayrak / komut	Görevi
claude --chrome	Bu oturum için web otomasyonu ve test amaçlı Chrome entegrasyonunu açar
claude --no-chrome	Bu oturum için Chrome entegrasyonunu kapatır (varsayılan olarak açıksa işe yarar)
/chrome	Durum, izinler, yeniden bağlanma, tarayıcı seçimi ve "Enabled by default" ayarı
/mcp → claude-in-chrome → View tools	Kullanılabilir tarayıcı araçlarının tam listesi

Birden fazla tarayıcı bağlıysa

Hem Chrome hem Edge'de eklenti kuruluysa hangisinin kullanılacağını siz seçersiniz. Bir tarayıcı eylemi siz seçim yapmadan başlarsa Claude size sorar. Daha sonra değiştirmek için /chrome çalıştırıp Select browser… seçeneğini kullanırsınız; Claude başka bir tarayıcı bağlansa bile seçiminizi korur. Bu seçim özelliği CHANGELOG'a göre 2.1.154 sürümüyle geldi.

Eklenti kurulu değilse: "Claude wants to use your browser"

Etkileşimli bir oturumda Claude tarayıcınıza ihtiyaç duyar ve Claude Code eklentiyi algılamazsa, "Claude wants to use your browser" başlıklı bir kurulum istemi görürsünüz. Claude Code bunu oturum başına en fazla bir kez sorar ve üç seçenek sunar:

• Install extension: tarayıcıda eklenti kurulum sayfasını açar ve rehberli kurulumu başlatır. Claude Code kurulumu bekler, eklentiyi bağlar ve aynı oturumda tarayıcı araçlarını etkinleştirir. Bağlantı hazır olduğunda "Continue with browser tools" seçerek göreve tarayıcıda devam edersiniz; "Continue without browser tools" ile kurulumu bırakıp daha sonra /chrome ile tamamlayabilirsiniz.
• Not now: göreve tarayıcı araçları olmadan devam eder; Claude Code sonraki bir oturumda yeniden sorabilir.
• Don't ask again: gelecekteki oturumlarda istemi durdurur. Entegrasyonu yine de istediğiniz zaman /chrome ile kurabilirsiniz.

Organizasyonunuz claude-in-chrome MCP sunucusunu deniedMcpServers yönetilen ayarıyla engelliyorsa bu kurulum istemi hiç gösterilmez.

Chrome'u varsayılan olarak açmak

Her oturumda --chrome yazmak istemiyorsanız /chrome çalıştırıp "Enabled by default" seçeneğini işaretleyin. Chrome çalışmıyorken Claude Code normal başlar; dokümantasyon v2.1.211 öncesinde entegrasyon açık ama Chrome kapalıyken açılışın takılabildiğini not ediyor. Burada bir maliyet uyarısı var: varsayılan olarak açmak, tarayıcı araçları her zaman yüklendiği için context kullanımını artırır. Context tüketiminde artış fark ederseniz bu ayarı kapatıp yalnızca gerektiğinde --chrome kullanmanız öneriliyor. Araçların yüklenme maliyeti tarafında CHANGELOG'daki 2.1.172 notu da ilginç: tarayıcı araçları artık araç başına ayrı çağrı yerine tek bir toplu çağrıyla yükleniyor.

VS Code'da Chrome: @browser ile Tarayıcı Görevleri

VS Code eklentisinde Chrome, eklenti kuruluysa ek bayrak olmadan kullanılabilir. İstem kutusuna @browser yazıp Claude'un ne yapmasını istediğinizi eklersiniz:

@browser go to localhost:3000 and check the console for errors

Ek olarak ek menüsünden (attachment menu) yeni sekme açma ya da sayfa içeriğini okuma gibi belirli tarayıcı araçlarını doğrudan seçebilirsiniz. Burada da aynı kural geçerli: Claude yeni sekmeler açar ve tarayıcınızın oturum açma durumunu paylaşır. VS Code için de eklentinin 1.0.36 veya üstü sürümü gerekiyor.

İzin Modeli: Site İzinleri, Plan Modu ve Claude Code'un Kendi Kontrolleri

Tarayıcınıza erişim veren bir özellikte izin modeli en kritik bölüm. Üç katman var:

• Site düzeyi izinler eklentiden miras alınır. Claude'un hangi sitelerde gezinebileceğini, tıklayabileceğini ve yazabileceğini Chrome eklentisinin kendi ayarlarından yönetirsiniz.
• Eylem düzeyi onaylar Claude Code'dan geçer. CHANGELOG'daki 2.1.251 notuna göre tarayıcı eylemleri artık her zaman Claude Code'un izin kontrollerinden geçiyor; telemetri kapalı oturumlarda daha önce eklentinin kendi istemleri kullanılıyordu. Yani izin kuralları rehberinde anlattığım izin modları tarayıcı araçları için de geçerli.
• Organizasyon düzeyi: yönetici ayarı ve deniedMcpServers ile claude-in-chrome engeli.

Plan modunda tarayıcı araçları

Plan modunda Claude, GIF kaydetmeden, yeni sekme açmadan ya da bir kısayol (shortcut) çalıştırmadan önce izin istemi gösterir. Oturumunuzda bypass permissions modu kullanılabiliyorsa ve feature-flag çekme kapalıysa bu çağrılar istem olmadan çalışır. İki ayrıntı daha var: createIfEmpty ayarlanmış bir tabs_context_mcp çağrısı da istem gösterir, bu eylemlerden herhangi birini içeren bir browser_batch çağrısı da. Bu ayrım 2.1.199 sürümünde düzeltilmiş: plan modu durum değiştiren tarayıcı araç çağrılarında istem göstermiyordu; artık salt okunur browser_batch çağrıları otomatik olarak izinli, durum değiştirenler ise soruluyor.

Pratik sonuç şu: "önce planla, sonra uygula" akışında Claude'un tarayıcıda sayfa okumasına izin verirken sekme açma, kayıt gibi yan etkili işlemleri denetim altında tutabilirsiniz.

Örnek İş Akışları

Dokümantasyonun örnekleri, tarayıcı eylemlerini kodlama göreviyle birleştirmenin tipik yollarını gösteriyor. Aşağıdaki istemlerin tümü resmi sayfadan; Türkçe açıklamalarını ekledim.

Yerel web uygulamasını test etmek

I just updated the login form validation. Can you open localhost:3000,
try submitting the form with invalid data, and check if the error
messages appear correctly?

Claude yerel sunucunuza gider, formla etkileşir ve gözlemlediğini raporlar. Kodu yazdıran istem ile bu istem aynı oturumda olduğundan Claude hangi doğrulama kuralını değiştirdiğini bilir ve tam o senaryoyu dener.

Console loglarıyla debug

Open the dashboard page and check the console for any errors when
the page loads.

Dokümantasyonun burada verdiği tavsiye önemli: loglar çok ayrıntılı olabileceğinden tüm console çıktısını istemek yerine Claude'a hangi kalıpları arayacağını söyleyin. Claude console mesajlarını okur ve belirli kalıplara ya da hata türlerine göre filtreleyebilir. CHANGELOG'daki 2.1.268 notu da bu tarafı iyileştirmiş: uzun sayfa okumaları artık dosyaya kaydedilip geri okunmak yerine satır içinde kalıyor.

Form doldurmayı otomatikleştirmek

I have a spreadsheet of customer contacts in contacts.csv. For each row,
go to the CRM at crm.example.com, click "Add Contact", and fill in the
name, email, and phone fields.

Claude yerel dosyanızı okur, web arayüzünde gezinir ve her kayıt için veriyi girer. Bu, "CRM'in API'si yok ama giriş yaptığım bir web arayüzü var" durumları için doğrudan bir çözüm.

Web sayfalarına dosya yüklemek

Open the bug tracker at bugs.example.com, create a new issue,
and attach logs/session.log to it

Claude makinenizdeki dosyaları bir sayfadaki yükleme alanına ekleyebilir. Claude Code dosyayı okuyup içeriğini tarayıcıya gönderdiği için yüklemeler hem yerel hem uzak oturumlarda çalışır; özellik Claude Code v2.1.211 ve sonrasını gerektiriyor. Üç kısıt var:

• İzinler: Claude bir dosyayı yalnızca oturumun onu okumasına izin verildiğinde yükleyebilir. Bir dosyaya Read erişimini reddeden izin kuralları onu yüklemeyi de engeller.
• Boyut: tek bir yükleme toplamda en fazla 10 MB dosya içerebilir.
• Hard link'ler: Claude birden fazla hard link'i olan dosyaları reddeder; bu durum node_modules gibi paket yöneticisi depolarında yaygındır. Dosyayı kopyalayıp kopyayı yükleyin.

Google Docs'ta içerik taslağı yazmak

Draft a project update based on the recent commits and add it to my
Google Doc at docs.google.com/document/d/abc123

Claude belgeyi açar, editöre tıklar ve içeriği yazar. Herhangi bir API kurulumu gerekmez; Gmail, Notion, Sheets gibi giriş yaptığınız her web uygulamasında aynı şekilde çalışır.

Web sayfalarından veri çıkarmak

Go to the product listings page and extract the name, price, and
availability for each item. Save the results as a CSV file.

Claude sayfaya gider, içeriği okur ve veriyi yapılandırılmış bir biçimde derler. Aynı oturumda hem tarayıcı hem de dosya yazma araçları olduğu için sonuç doğrudan diskinize iner.

Çok siteli iş akışları

Check my calendar for meetings tomorrow, then for each meeting with
an external attendee, look up their company website and add a note
about what they do.

Claude bilgi toplamak ve iş akışını tamamlamak için sekmeler arasında çalışır.

Demo GIF'i kaydetmek

Record a GIF showing how to complete the checkout flow, from adding
an item to the cart through to the confirmation page.

Claude etkileşim dizisini kaydeder ve GIF dosyası olarak kaydeder. Dokümantasyonun uyarısını atlamayın: kayıt, giriş yapılmış sayfalardaki hesap ayrıntıları dahil tarayıcıda görünen her şeyi yakalar; ekibinizin dışında paylaşmadan önce gözden geçirin.

Ekran görüntüsünü diske kaydetmek

Take a screenshot of the checkout page and save it to disk

Claude görüntüyü diske kaydeder ve dosya yolunu bildirir. v2.1.211 öncesinde ekran görüntüsü aracının save_to_disk seçeneği dosya yazmıyordu; eski bir sürümde "kaydettim" deyip dosya bulamıyorsanız nedeni bu.

Uçtan Uca Bir Senaryo: Form Hatasını Tarayıcıda Yakalayıp Düzeltmek

Yukarıdaki parçaları tek bir akışta birleştirelim. Bir React uygulamasında kayıt formunun e-posta alanı bazı geçerli adresleri reddediyor olsun. Terminalde projeye girip Chrome ile başlıyorsunuz:

cd my-app
npm run dev &
claude --chrome

İlk istem, sorunu tarayıcıda gözlemletmek:

Open localhost:3000/signup, try the email "ayse+test@example.com"
and tell me what error the form shows. Also check the console for
any warnings that contain "validation".

Claude yeni bir sekme açar (ilk seferde "Claude in Chrome wants to" diyaloğunu onaylarsınız; localhost için oturum boyunca izin vermek mantıklı), formu doldurur, gördüğü hata metnini ve filtrelediği console satırlarını raporlar. İkinci istem, düzeltme:

The regex rejects plus signs in the local part. Fix the validator in
src/utils/validateEmail.ts, then reload the signup page and try the
same address again to confirm it is accepted.

Burada entegrasyonun asıl değeri ortaya çıkıyor: Claude kodu düzenler, sayfayı yeniler, aynı adresi yeniden dener ve sonucu size doğrulanmış olarak getirir. Siz hiçbir noktada sekme değiştirmediniz. Son adım olarak dokümantasyonu güncellemek için bir kayıt isteyebilirsiniz:

Record a GIF of the signup flow with the fixed validation and save a
screenshot of the success state to disk.

Bu akışı gözetimsiz çalıştırmayı düşünüyorsanız iki noktaya dikkat edin. Plan modu ve izin ayarları tarayıcı araçları için de geçerli; hangi eylemlerin istem göstereceğini yukarıdaki bölümde anlattım. Ayrıca agent view yazısında anlattığım arka plan oturumları için CHANGELOG'daki 2.1.169 notu, --chrome gibi bayrakların oturum uyku/uyanma döngüsünde korunduğunu söylüyor.

Chrome Entegrasyonu ve Computer Use: Hangisini Ne Zaman?

Claude Code'un ekranınızla etkileşen bir ikinci özelliği daha var: computer use. İkisini karıştırmamak gerekiyor. Computer use, macOS'te Pro ve Max planlarıyla sınırlı bir research preview; Claude'un uygulamaları açmasını, tıklamasını, yazmasını ve ekranı görmesini sağlıyor, /mcp menüsünden computer-use sunucusunu etkinleştirerek açılıyor ve -p ile etkileşimsiz modda kullanılamıyor. Chrome entegrasyonu ise yalnızca tarayıcıyı kontrol ediyor ama Windows dahil daha geniş bir platform ve plan yelpazesinde çalışıyor.

Resmi computer use sayfası, Claude'un en hassas aracı önce denediğini söyleyerek net bir öncelik sırası veriyor:

1. Servis için bir MCP sunucunuz varsa Claude onu kullanır.
2. Görev bir kabuk komutuysa Bash'i kullanır.
3. Görev tarayıcı işiyse ve Claude in Chrome kuruluysa onu kullanır.
4. Hiçbiri uymuyorsa computer use'a başvurur.

Yani ekran kontrolü, başka hiçbir şeyin ulaşamadığı yerler için ayrılmış: yerel uygulamalar, iOS Simulator gibi simülatörler ve API'si olmayan araçlar. Web uygulaması test ediyorsanız doğru araç Chrome entegrasyonu; Swift ile yazılmış bir menü çubuğu uygulamasını tıklatıp doğrulatacaksanız computer use.

Özellik	Chrome entegrasyonu	Computer use (CLI)
Kapsam	Tarayıcı sekmeleri	Onayladığınız yerel uygulamalar, ekran
Platform	Chrome/Edge ve Chromium tabanlılar; WSL hariç	Yalnızca macOS
Plan	Pro, Max, Team, Enterprise	Pro, Max (research preview)
Açma yolu	--chrome ya da /chrome → Enabled by default	/mcp → computer-use → Enable
Üçüncü parti sağlayıcılar	Kullanılamaz	Kullanılamaz

Sorun Giderme

Eklenti algılanmıyor

Claude Code Chrome eklentisini algılayamıyorsa dokümantasyonun sıraladığı adımlar şunlar:

1. chrome://extensions adresinden eklentinin kurulu ve etkin olduğunu doğrulayın.
2. claude --version ile Claude Code'un güncel olduğunu kontrol edin.
3. Chrome'un çalıştığından emin olun.
4. /chrome çalıştırıp "Reconnect extension" seçerek bağlantıyı yeniden kurun.
5. Sorun sürerse hem Claude Code'u hem Chrome'u yeniden başlatın.

Arka plandaki mekanizmayı bilmek çoğu sorunu açıklıyor: Chrome entegrasyonunu ilk etkinleştirdiğinizde Claude Code bir native messaging host yapılandırma dosyası kurar. Chrome bu dosyayı açılışta okur; bu yüzden ilk denemede eklenti algılanmazsa yeni yapılandırmayı alması için Chrome'u yeniden başlatın. Claude Code, eklentiyi bağlamanızı isteyen tarayıcı sekmesini yalnızca o ilk kurulumda açar; daha sonraki bir oturum (örneğin build ya da config dizini değiştirdikten sonra) dosyayı yeniden yazdığında sekmeyi tekrar açmaz. Bağlantı hâlâ kurulamıyorsa host yapılandırma dosyasının varlığını kontrol edin:

Tarayıcı / platform	Konum
Chrome, macOS	~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
Chrome, Linux	~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
Chrome, Windows	Kayıt defterinde HKCU\Software\Google\Chrome\NativeMessagingHosts\
Edge, macOS	~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
Edge, Linux	~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
Edge, Windows	Kayıt defterinde HKCU\Software\Microsoft\Edge\NativeMessagingHosts\

Diğer Chromium tabanlı tarayıcılar aynı dosyayı tarayıcının adını taşıyan kendi yapılandırma dizininden okur; örneğin Brave macOS'te ~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/ dizinini, Windows'ta ise HKCU\Software\BraveSoftware\Brave-Browser\NativeMessagingHosts\ gibi kendi kayıt defteri anahtarını kullanır.

Tarayıcı yanıt vermiyor

Claude'un tarayıcı komutları çalışmayı bırakırsa önce sayfayı bir modal diyaloğun (alert, confirm, prompt) engelleyip engellemediğine bakın; JavaScript diyalogları tarayıcı olaylarını bloke eder ve Claude'un komut almasını önler. Diyaloğu elle kapatıp Claude'a devam etmesini söyleyin. Sonra Claude'dan yeni bir sekme açıp yeniden denemesini isteyin; olmazsa chrome://extensions'dan eklentiyi kapatıp açarak yeniden başlatın.

Uzun oturumlarda bağlantı kopuyor

Chrome eklentisinin service worker'ı uzun oturumlarda boşta kalabilir ve bu bağlantıyı koparır. Bir süre işlem yapılmadıktan sonra tarayıcı araçları çalışmıyorsa /chrome çalıştırıp "Reconnect extension" seçin.

Windows'a özgü sorunlar

• Named pipe çakışması (EADDRINUSE): başka bir süreç aynı named pipe'ı kullanıyorsa Claude Code'u yeniden başlatın ve Chrome kullanıyor olabilecek diğer Claude Code oturumlarını kapatın.
• Native messaging host hataları: host açılışta çöküyorsa yapılandırmayı yeniden üretmek için Claude Code'u yeniden kurmayı deneyin.
• Kurulum sayfaları açılmıyor: Claude Code'u güncelleyin; v2.1.211 öncesinde eklentiyi bağlamanızı isteyen sekme Windows'ta açılamayabiliyordu.

Sık karşılaşılan hata mesajları

Hata	Neden	Çözüm
"Browser extension is not connected"	Native messaging host eklentiye ulaşamıyor ya da organizasyonunuzun IP allowlist'i bridge.claudeusercontent.com bağlantısını reddediyor	Chrome ve Claude Code'u yeniden başlatıp /chrome ile yeniden bağlanın; IP allowlist kullanıyorsanız kurumsal ağ yapılandırması dokümantasyonuna bakın
/chrome "Not detected" gösteriyor	Eklenti kurulu değil ya da devre dışı	chrome://extensions'dan kurun ya da etkinleştirin
"No tab available"	Claude sekme hazır olmadan işlem yapmaya çalıştı	Claude'dan yeni sekme açıp yeniden denemesini isteyin
"Receiving end does not exist"	Eklentinin service worker'ı boşta kaldı	/chrome → "Reconnect extension"

CHANGELOG'da bu tabloya eklenebilecek iki düzeltme daha var: 2.1.178 sürümünde OAuth token'ının Claude Code girişinden farklı bir hesaba ait olması durumunda bağlantının sessizce başarısız olması, 2.1.243'te ise otomatik güncellemenin kurulumda kullanılan sürümü temizlemesi sonucu bağlantının kopması düzeltilmiş; native host artık kararlı claude başlatıcısı üzerinden çalışıyor. Güncel bir sürüm kullanmak bu sınıftaki sorunların çoğunu baştan eler.

Sürüm Geçmişi: Beta'dan Genel Kullanıma

Özelliğin nereden geldiğini bilmek, eski kaynaklardaki bilgileri yorumlarken işe yarar. CHANGELOG'a göre kilometre taşları:

• 2.0.72: Claude in Chrome (Beta) eklendi; Chrome eklentisiyle tarayıcıyı doğrudan Claude Code'dan kontrol etme.
• 2.1.154: /chrome → "Select browser…" ile bağlı tarayıcılar arasında seçim.
• 2.1.172: tarayıcı araçları tek toplu çağrıyla yükleniyor.
• 2.1.198: Claude in Chrome genel kullanıma açıldı (GA).
• 2.1.199: plan modunda durum değiştiren tarayıcı çağrıları için istem; salt okunur browser_batch otomatik izinli.
• 2.1.211: dosya yükleme düzeltmeleri ve yol doğrulaması, save_to_disk düzeltmesi, Chrome kapalıyken açılış takılmasının giderilmesi, Windows kurulum sayfası düzeltmesi.
• 2.1.221 / 2.1.239: gereksiz sekmelerin kapatılması ve /clear ile sekme grubunun kapanması.
• 2.1.251: tarayıcı eylemleri her zaman Claude Code'un izin kontrollerinden geçiyor.
• 2.1.260: organizasyonun Claude in Chrome yönetici ayarına uyum.
• 2.1.268: uzun sayfa okumaları satır içinde kalıyor.

Sıkça Sorulan Sorular

Claude Code Chrome entegrasyonu hangi tarayıcılarda çalışır?

Google Chrome ve Microsoft Edge ile çalışır; Brave, Arc, Vivaldi ve Opera gibi diğer Chromium tabanlı tarayıcılarda da Claude Code eklentiyi algılayıp bağlantıyı kurar. WSL içinde desteklenmez. Her durumda eklentinin 1.0.36 veya üstü sürümü gerekir.

API anahtarıyla giriş yaptığımda --chrome neden çalışmıyor?

Entegrasyon /login ile claude.ai girişi ve doğrudan bir Anthropic planı ister. API anahtarı ya da claude setup-token ile üretilmiş token kullanıyorsanız eklenti bu kimlik bilgileriyle doğrulama yapamadığından Claude Code entegrasyonu kapalı tutar; v2.1.216 öncesinde ise her bağlantı 403 ile başarısız oluyordu. Bedrock, Google Cloud Agent Platform ve Foundry üzerinden de kullanılamaz.

Chrome'u her oturumda --chrome yazmadan açık tutabilir miyim?

Evet, /chrome → "Enabled by default". Chrome kapalıysa Claude Code normal başlar. Tarayıcı araçları her oturumda yüklendiği için context kullanımı artar; artış fark ederseniz ayarı kapatıp yalnızca gerektiğinde bayrağı kullanın. VS Code'da ek bayrak gerekmez.

Claude tarayıcıda giriş sayfası ya da CAPTCHA ile karşılaşırsa ne olur?

Zaten giriş yaptığınız sitelere tarayıcınızın oturum durumunu paylaştığı için doğrudan erişir. Bir giriş sayfası ya da CAPTCHA gördüğünde durur ve bunu sizin elle halletmenizi ister.

Dosya yüklemenin sınırları nelerdir?

v2.1.211 ve sonrasında çalışır. Yalnızca oturumun okuma izni olan dosyalar yüklenebilir, tek yükleme toplam 10 MB ile sınırlıdır ve birden fazla hard link'i olan dosyalar reddedilir; böyle bir dosyayı kopyalayıp kopyayı yükleyin.

Chrome entegrasyonu ile computer use arasındaki fark nedir?

Chrome entegrasyonu yalnızca tarayıcıyı kontrol eder ve Pro, Max, Team, Enterprise planlarında çalışır. Computer use macOS'te Pro ve Max ile sınırlı bir research preview'dur, yerel uygulamaları ve ekranı kontrol eder, -p modunda kullanılamaz. Claude önce MCP'yi, sonra Bash'i, sonra Chrome'u, en son computer use'u dener.

Özet

Chrome entegrasyonu, Claude Code'un "kodu yaz, sonra tarayıcıda sen kontrol et" döngüsünü tek bir konuşmaya indiriyor. Claude in Chrome eklentisi (1.0.36+), doğrudan bir Anthropic planı ve /login ile giriş yeterli; claude --chrome ile başlıyor, /chrome ile durumu, izinleri ve varsayılanı yönetiyorsunuz. Claude gerçek tarayıcınızı görünür bir pencerede kullanıyor, giriş ve CAPTCHA'da duruyor, sekmeleri oturuma bağlı bir grupta topluyor. Console debug, form testi, veri çıkarma, 10 MB'a kadar dosya yükleme, GIF kaydı ve ekran görüntüsü gibi yetenekler; site izinleri, Claude Code'un kendi izin kontrolleri ve organizasyon politikası olmak üzere üç katmanlı bir izin modeliyle çevrili. WSL desteklenmiyor, üçüncü parti sağlayıcılarda özellik yok ve "Enabled by default" seçeneği context maliyeti getiriyor. Sorunların çoğu native messaging host dosyası, boşta kalan service worker ya da eski sürümlerden kaynaklanıyor ve /chrome → "Reconnect extension" ile güncel sürüm ikilisi büyük kısmını çözüyor. Entegrasyonun altında yatan MCP mekanizmasını anlamak için MCP rehberine, tarayıcı eylemlerinin geçtiği izin modlarını doğru ayarlamak için izin kuralları rehberine, Chrome'lu oturumları arka planda çalıştırmak için de agent view rehberine göz atabilirsiniz.