- Ketika Anda mengetik
/clear, Claude Code menutup grup, termasuk halaman yang terbuka, kecuali pekerjaan yang bertahan dari clear masih berjalan - Ketika Anda beralih sesi dengan perintah seperti
/resume, keluar dari Claude Code, atau menjalankan/clearsementara pekerjaan yang bertahan masih berjalan, Claude Code menutup grup hanya jika grup tersebut tidak berisi apa pun selain tab baru kosong, sehingga halaman yang mungkin masih Anda baca tetap terbuka
Integrasi Chrome bekerja dengan Google Chrome dan Microsoft Edge. Claude Code juga mendeteksi ekstensi dan menyiapkan koneksi di browser berbasis Chromium lainnya, termasuk Brave, Arc, Vivaldi, dan Opera. Integrasi Chrome tidak didukung di Windows Subsystem for Linux (WSL).
Kemampuan
Dengan Chrome terhubung, Anda dapat menggabungkan tindakan browser dengan tugas coding dalam satu alur kerja:- Live debugging: baca kesalahan console dan status DOM secara langsung, kemudian perbaiki kode yang menyebabkannya
- Verifikasi desain: bangun UI dari mock Figma, kemudian buka di browser untuk memverifikasi kecocokannya
- Pengujian aplikasi web: uji validasi formulir, periksa regresi visual, atau verifikasi alur pengguna
- Aplikasi web terautentikasi: berinteraksi dengan Google Docs, Gmail, Notion, atau aplikasi apa pun yang Anda masuki tanpa konektor API
- Ekstraksi data: tarik informasi terstruktur dari halaman web dan simpan secara lokal
- Otomasi tugas: otomatisasi tugas browser berulang seperti entri data, pengisian formulir, atau alur kerja multi-situs
- Unggah file: lampirkan file dari mesin Anda ke bidang unggah di halaman web
- Perekaman sesi: rekam interaksi browser sebagai GIF untuk mendokumentasikan atau berbagi apa yang terjadi
Prasyarat
Sebelum menggunakan Claude Code dengan Chrome, Anda memerlukan:- Google Chrome, Microsoft Edge, atau browser berbasis Chromium lainnya seperti Brave, Arc, Vivaldi, atau Opera
- Ekstensi Claude in Chrome versi 1.0.36 atau lebih tinggi, tersedia di Chrome Web Store
- Claude Code
- Paket Anthropic langsung (Pro, Max, Ultra, Team, atau Enterprise)
/login. Jika Anda melakukan autentikasi dengan kunci API atau token jangka panjang dari claude setup-token, Claude Code membuat integrasi Chrome tetap mati, bahkan ketika Anda melewatkan --chrome. Ekstensi browser tidak dapat melakukan autentikasi dengan kredensial tersebut.
Integrasi Chrome tidak tersedia melalui penyedia pihak ketiga seperti Amazon Bedrock, Google Cloud’s Agent Platform, atau Microsoft Foundry. Jika Anda mengakses Claude secara eksklusif melalui penyedia pihak ketiga, Anda memerlukan akun claude.ai terpisah untuk menggunakan fitur ini.
Mulai di CLI
1
Luncurkan Claude Code dengan Chrome
Mulai Claude Code dengan flag Pertama kali Anda meluncurkan dengan Chrome, Claude Code menampilkan dialog sekali pakai yang memperkenalkan integrasi dan menjelaskan cara kerja izin situs. Tekan Enter untuk melanjutkan.Untuk mengaktifkan Chrome untuk sesi mendatang tanpa flag, lihat Aktifkan Chrome secara default.
--chrome:2
Minta Claude menggunakan browser
Contoh ini menavigasi ke halaman, berinteraksi dengannya, dan melaporkan apa yang ditemukannya, semuanya dari terminal atau editor Anda:Jika Claude Code meminta izin sebelum tindakan browser, setujui. Dialog dimulai dengan
Claude in Chrome wants to dan menawarkan opsi untuk mengizinkan semua tindakan di situs tersebut untuk sesi ini. Claude membuka tab baru dan memulai tugas./chrome kapan saja untuk memeriksa status koneksi, mengelola izin, menghubungkan kembali ekstensi, atau memilih browser yang terhubung mana yang akan digunakan. Integrasi berfungsi ketika panel status menampilkan “Status: Enabled” dan “Extension: Installed”.
Jika lebih dari satu browser terhubung, Anda memilih yang mana Claude gunakan. Ketika tindakan browser dimulai sebelum Anda memilih, Claude meminta Anda untuk memilih satu. Untuk beralih browser nanti, jalankan /chrome dan pilih Select browser…. Claude terus menggunakan pilihan Anda bahkan ketika browser lain terhubung.
Untuk VS Code, lihat otomasi browser di VS Code.
Instal ekstensi ketika Claude meminta
Ketika Claude membutuhkan browser Anda dalam sesi interaktif dan Claude Code tidak mendeteksi ekstensi, Claude Code menampilkan prompt instalasi berjudul “Claude wants to use your browser”. Claude Code meminta paling banyak sekali per sesi. Prompt menawarkan tiga pilihan:- Install extension: membuka halaman instalasi ekstensi di browser Anda dan memulai setup terpandu. Claude Code menunggu instalasi, menghubungkan ekstensi, dan mengaktifkan tool browser dalam sesi yang sama. Ketika koneksi siap, pilih “Continue with browser tools” dan Claude melanjutkan tugas di browser Anda. Anda dapat meninggalkan setup dengan memilih “Continue without browser tools” dan menyelesaikannya nanti dengan
/chrome. - Not now: melanjutkan tugas tanpa tool browser. Claude Code dapat meminta lagi dalam sesi yang lebih baru.
- Don’t ask again: menghentikan prompt di sesi mendatang. Anda masih dapat menyiapkan integrasi kapan saja dengan
/chrome.
- Jika organisasi Anda memblokir server MCP
claude-in-chromedengan pengaturan terkeloladeniedMcpServers, Claude Code tidak menampilkan prompt instalasi. - Jika organisasi Anda menerapkan file
managed-mcp.jsontanpa mengizinkan Claude in Chrome bersama set terkelola, Claude Code tidak menampilkan prompt instalasi.
Aktifkan Chrome secara default
Untuk menghubungkan Chrome tanpa meneruskan--chrome setiap kali, jalankan /chrome dalam sesi CLI dan pilih Enabled by default. Di ekstensi VS Code, ketik /chrome di kotak prompt dan nyalakan sakelar Enabled by default. Keduanya berbagi satu pengaturan, sehingga menyalakannya di salah satu tempat akan menyalakannya untuk CLI dan VS Code sekaligus.
Dengan pengaturan ini aktif dan Claude Code v2.1.287 atau yang lebih baru, setiap sesi VS Code terhubung ke browser Anda saat dimulai, sehingga Claude dapat menggunakannya sebelum Anda mengetik @browser. Pada versi sebelumnya, atau dengan pengaturan ini nonaktif, sesi VS Code terhubung ketika Anda mengetik @browser.
Claude Code dimulai secara normal ketika Chrome tidak berjalan.
Mengaktifkan Chrome secara default meningkatkan penggunaan konteks karena tool browser dan instruksinya selalu dimuat. Jika Anda melihat peningkatan konsumsi konteks, matikan pengaturan ini dan hubungkan hanya saat diperlukan, dengan
--chrome di CLI atau dengan mengetik @browser di kotak prompt VS Code.Jawab dialog saat memulai
Jika dialog “Claude in Chrome extension detected” muncul saat Anda memulaiclaude, jawaban Anda mengubah pengaturan Enabled by default:
- Yes, use my browser: menyalakan pengaturan ini dan menghubungkan sesi ini
- No, keep browser tools off, atau Esc: mematikan pengaturan ini, dan Claude Code berhenti menawarkan untuk menyiapkan Chrome
/chrome.
Kelola izin situs
Izin tingkat situs diwarisi dari ekstensi Chrome. Kelola izin di pengaturan ekstensi Chrome untuk mengontrol situs mana yang dapat dijelajahi, diklik, dan diketik oleh Claude. Dalam auto mode, ketika pengklasifikasi auto mode itu sendiri menyetujui panggilan browser ke situs, ekstensi melewati pemeriksaan per-situsnya sendiri untuk panggilan itu, kecuali aturan izin Anda menolak situs apa pun ke Claude in Chrome.Dialog izin dalam sesi VS Code
Dalam sesi VS Code, ketika Claude Code meminta konfirmasi sebelum tindakan browser, dialog izin muncul sebagai kartu di panel chat. Ketika tindakan tersebut menargetkan situs yang belum Anda izinkan, kartu tersebut juga menawarkan untuk mengizinkan situs itu. Dalam sesi yang terhubung ke browser Anda saat dimulai karena Enabled by default aktif, Claude Code meminta konfirmasi Anda sebelum tindakan browser di situs yang belum Anda izinkan, dalam mode izin Manual, Edit automatically, Auto, dan Bypass permissions. Dalam mode izin Auto dan Bypass permissions, hal ini berlaku hingga Anda mengetik@browser dalam sesi tersebut.
Tool browser dalam plan mode
Dalam plan mode, dialog izin muncul sebelum Claude merekam GIF atau membuka tab baru. Dalam sesi CLI interaktif, jika mode bypass permissions tersedia dan pengambilan feature-flag dimatikan, panggilan ini berjalan tanpa dialog izin. Panggilantabs_context_mcp juga meminta izin ketika menetapkan createIfEmpty, dan begitu juga panggilan browser_batch yang mencakup salah satu tindakan ini.
Contoh alur kerja
Contoh-contoh ini menunjukkan cara umum untuk menggabungkan tindakan browser dengan tugas coding. Jalankan/mcp, pilih claude-in-chrome, kemudian pilih View tools untuk melihat daftar lengkap alat browser yang tersedia.
Uji aplikasi web lokal
Saat mengembangkan aplikasi web, minta Claude untuk memverifikasi perubahan Anda berfungsi dengan benar:Debug dengan console logs
Claude dapat membaca output console untuk membantu mendiagnosis masalah. Beri tahu Claude pola apa yang harus dicari daripada meminta semua output console, karena log dapat sangat panjang:Otomatisasi pengisian formulir
Percepat tugas entri data berulang:Unggah file ke halaman web
Claude dapat melampirkan file dari mesin Anda ke bidang unggah di halaman. Claude Code membaca file dan mengirim isinya ke browser, sehingga unggahan berfungsi di sesi lokal dan jarak jauh. Contoh ini melampirkan file log ke formulir:- Izin: Claude dapat mengunggah file hanya ketika sesi diizinkan untuk membacanya, jadi aturan izin yang menolak akses
Readke file juga memblokir pengunggahannya. - Ukuran: satu unggahan dapat mencakup hingga 10 MB file secara total.
- Hard links: Claude menolak file yang memiliki beberapa hard link, yang umum terjadi di dalam toko pengelola paket seperti
node_modules. Salin file dan unggah salinannya. - Nama kredensial: Claude menolak file yang nama atau foldernya merupakan tempat kredensial biasanya disimpan, seperti
.env, file.pematau.key, atau apa pun di bawah.ssh. Memerlukan Claude Code v2.1.293 atau lebih baru.
Buat draf konten di Google Docs
Gunakan Claude untuk menulis langsung di dokumen Anda tanpa penyiapan API:Ekstrak data dari halaman web
Tarik informasi terstruktur dari situs web:Jalankan alur kerja multi-situs
Koordinasikan tugas di berbagai situs web:Rekam GIF demo
Buat rekaman alur interaksi browser yang dapat dibagikan:Simpan tangkapan layar ke disk
Minta Claude untuk menyimpan tangkapan layar sebagai file:Troubleshooting
Ekstensi tidak terdeteksi
Jika Claude Code tidak dapat mendeteksi ekstensi Chrome:- Verifikasi ekstensi Chrome diinstal dan diaktifkan di
chrome://extensions - Verifikasi Claude Code terbaru dengan menjalankan
claude --version - Periksa bahwa Chrome sedang berjalan
- Jalankan
/chromedan pilih “Reconnect extension” untuk membangun kembali koneksi - Jika masalah berlanjut, restart Claude Code dan Chrome
- 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: periksa
HKCU\Software\Google\Chrome\NativeMessagingHosts\di Windows Registry
- 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: periksa
HKCU\Software\Microsoft\Edge\NativeMessagingHosts\di Windows Registry
~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/, dan di Windows setiap peramban memiliki kunci registri sendiri, seperti HKCU\Software\BraveSoftware\Brave-Browser\NativeMessagingHosts\.
Pengaturan proyek tidak dapat mengaktifkan Chrome
Peringatan ini di terminal Anda berarti proyek tempat Anda bekerja mencoba mengaktifkan integrasi Chrome, dan Claude Code tidak mengizinkannya:.claude/settings.json atau .claude/settings.local.json proyek menetapkan CLAUDE_CODE_ENABLE_CFC ke 1 di blok env-nya untuk mengaktifkan integrasi Chrome. Claude Code tidak menerapkan pengaturan tersebut, sehingga integrasi Chrome nonaktif dalam sesi ini dan Claude tidak memiliki tool browser.
Claude Code melewati pengaturan tersebut karena file-file itu disimpan di direktori proyek, dan repositori yang Anda checkout tidak boleh dapat menghubungkan Claude ke browser Anda.
Anda dapat terus bekerja seperti biasa. Jika Anda menginginkan tool browser, atau ingin peringatan tersebut hilang, lakukan salah satu dari berikut ini:
- Untuk mendapatkan tool browser sekarang: keluar dan mulai lagi dengan
claude --chromedi shell Anda. - Untuk mendapatkan tool browser di sesi berikutnya: jalankan
/chromedi prompt Claude Code dan pilih Enabled by default. Ini berlaku untuk sesi yang Anda mulai setelahnya, bukan sesi yang sedang berjalan. - Untuk menghentikan peringatan tanpa tool browser: hapus baris
CLAUDE_CODE_ENABLE_CFCdari file pengaturan proyek.
Browser tidak merespons
Jika perintah browser Claude berhenti bekerja:- Periksa apakah dialog modal (alert, confirm, prompt) memblokir halaman. Dialog JavaScript memblokir peristiwa browser dan mencegah Claude menerima perintah. Tutup dialog secara manual, kemudian beri tahu Claude untuk melanjutkan.
- Minta Claude membuat tab baru dan coba lagi
- Restart ekstensi Chrome dengan menonaktifkan dan mengaktifkannya kembali di
chrome://extensions
Koneksi terputus selama sesi panjang
Service worker ekstensi Chrome dapat menjadi idle selama sesi yang diperpanjang, yang memutus koneksi. Jika alat browser berhenti bekerja setelah periode inaktivitas, jalankan/chrome dan pilih “Reconnect extension”.
Saat Anda menjalankan /chrome, periksa baris Status-nya. Jika tertulis “Not connected”, koneksi sesi yang sedang berjalan ke Chrome telah gagal. Pilih “Reconnect extension” untuk memulai ulang koneksi tersebut. Setelah koneksi berhasil, halaman reconnect ekstensi terbuka di Chrome. Sebelum v2.1.290, “Reconnect extension” hanya membuka halaman tersebut dan tidak memulai ulang koneksi yang gagal, jadi jika tool browser tidak kembali pada versi sebelumnya, perbarui Claude Code.
Ekstensi masuk ke organisasi yang berbeda
Jika Anda tergabung dalam lebih dari satu organisasi claude.ai, ekstensi harus masuk ke organisasi yang sama dengan Claude Code. Jika keduanya berbeda, tool browser Claude mengembalikan “Browser extension is not connected”, bahkan ketika keduanya menggunakan akun claude.ai yang sama. Untuk melihat organisasi mana yang digunakan Claude Code, jalankan/status di prompt Claude Code dan baca baris Organization.
Untuk mengubah organisasi ekstensi, keluar di pengaturan ekstensi, lalu masuk kembali dan pilih organisasi yang ditampilkan oleh /status.
Masalah khusus Windows
Di Windows, Anda mungkin mengalami:- Konflik named pipe (EADDRINUSE): jika proses lain menggunakan named pipe yang sama, restart Claude Code. Tutup sesi Claude Code lain apa pun yang mungkin menggunakan Chrome.
- Kesalahan host messaging asli: jika host messaging asli mogok saat startup, coba instal ulang Claude Code untuk membuat ulang konfigurasi host.
- Halaman setup gagal dibuka: perbarui Claude Code. Sebelum v2.1.211, tab browser yang meminta Anda untuk menghubungkan ekstensi dapat gagal dibuka di Windows.
Pesan kesalahan umum
Ini adalah kesalahan yang paling sering dihadapi dan cara menyelesaikannya:Lihat juga
- Computer use: kontrol aplikasi macOS asli ketika tugas tidak dapat dilakukan di browser
- Gunakan Claude Code di VS Code: otomasi browser di ekstensi VS Code
- Referensi CLI: flag baris perintah termasuk
--chrome - Alur kerja umum: lebih banyak cara untuk menggunakan Claude Code
- Data dan privasi: bagaimana Claude Code menangani data Anda
- Memulai dengan Claude in Chrome: dokumentasi lengkap untuk ekstensi Chrome, termasuk pintasan keyboard, penjadwalan, dan izin