Claude Code di Chrome: Otomasi Browser dari Terminal

Pertama kali saya meminta Claude memeriksa sebuah form di server lokal saya, ia membuka tab, mengisi form itu dengan data tidak valid, membaca pesan error validasinya dari halaman, lalu memberi tahu mana dari tiga pesan itu yang keliru. Lalu saya memintanya memeriksa sesuatu di aplikasi web tempat saya sudah masuk, dan ia langsung bisa — karena itu browser saya, dengan sesi saya, bukan browser headless yang harus diautentikasi terpisah.

Itulah keseluruhan desainnya sekaligus keseluruhan hal yang perlu dipikirkan. Tulisan ini membahas apa arti berbagi keadaan browser, cara menyambungkannya dan berapa ongkos konteks kalau dinyalakan permanen, pembagian plan mode antara membaca dan bertindak, batasan unggah file, konfigurasi autentikasi yang diam-diam mematikan fiturnya, dan dua kegagalan yang pasti Anda temui pada sesi panjang.

Ini browser Anda, dengan sesi Anda

Claude membuka tab baru untuk tugas browser di jendela Chrome yang terlihat, secara real time, dan berbagi keadaan login browser Anda. Itulah sebabnya ia bisa menulis draf di Google Doc, membaca Notion Anda, atau mengklik dashboard internal tanpa connector API dan tanpa kredensial yang dikonfigurasi di mana pun. Ketika ia menemui halaman login atau CAPTCHA, ia berhenti dan meminta Anda menangani bagian itu secara manual.

Tab yang dibukanya dikumpulkan ke dalam tab group Chrome yang terikat pada sesi Anda, dan nasib group itu saat sesi berakhir bergantung pada cara berakhirnya. Membersihkan percakapan menutup group beserta halaman yang terbuka, kecuali masih ada pekerjaan yang bertahan melewati pembersihan itu. Berpindah sesi, keluar, atau membersihkan saat pekerjaan semacam itu berjalan hanya menutup group bila isinya tak lebih dari tab baru yang kosong — jadi halaman yang mungkin masih Anda baca tetap terbuka.

Menyambungkan, dan ongkos menyalakannya permanen

Satu flag memulai sesi dengan browser terpasang, dan satu perintah mengurus selebihnya — status, permission, penyambungan ulang, dan memilih browser ketika lebih dari satu tersambung. Permission per situs diwarisi dari ekstensi Chrome alih-alih dikonfigurasi di Claude Code, jadi membatasi situs mana yang boleh Claude jelajahi, klik, dan ketik terjadi di setelan ekstensinya sendiri.

# Launch with the browser attached.
claude --chrome

/chrome     # status, permissions, reconnect, pick a browser
            # Working when the panel shows:
            #   Status: Enabled
            #   Extension: Installed
            # "Enabled by default" removes the need for the flag

# Enabling by default increases context usage, because the
# browser tools are then always loaded. If your context budget
# gets tighter, turn it off and use the flag when you need it.

# Requires the Claude in Chrome extension 1.0.36 or later, and
# a direct Anthropic plan. Works in Chrome, Edge, and detected
# in Brave, Arc, Vivaldi and Opera. NOT supported under WSL.

Plan mode membagi berdasarkan efek samping

Perilaku plan mode di sini digambar lebih cermat daripada yang disadari kebanyakan orang, dan ia model yang bagus untuk bagaimana mode read-only seharusnya memperlakukan tool yang bisa melakukan keduanya. Membaca halaman tidak menagih apa pun dan tidak memunculkan prompt; mengubah apa pun memunculkan prompt. Bagian menariknya ada di pengecualiannya, ketika sebuah panggilan yang normalnya read-only berubah jadi mengubah keadaan karena satu flag input.

# In plan mode the split is by side effect, not by tool.

# Runs with NO permission prompt:
    read_page          get_page_text      find
    reading console messages
    reading network requests
    taking a screenshot

# Prompts for approval:
    clicks             typing             navigation
    tab and window management
    recording a GIF

# The catch: an otherwise read-only call ALSO prompts when it
# sets a state-changing flag —
#     createIfEmpty on the tabs context call
#     clear on the console and network readers
#     save_to_disk on a screenshot
#
# A batch call runs without a prompt only when EVERY action
# inside it is read-only.

Untuk apa ia benar-benar bagus

Nilainya bukan otomasi browser itu sendiri — ada perkakas yang lebih baik kalau otomasi saja yang Anda inginkan. Nilainya adalah merangkai aksi browser dengan tugas coding dalam satu alur, tanpa berpindah konteks atau menulis test harness untuk sesuatu yang akan Anda lakukan sekali.

Empat bentuk yang terbayar:

Unggah file, dan tiga batasnya

Claude bisa melampirkan file dari mesin Anda ke kolom unggah di sebuah halaman — ia membaca filenya lalu mengirim isinya ke browser, jadi ini juga bekerja di sesi remote. Ada tiga batasan, dan yang ketiga paling sering menjegal:

• Permission ikut berlaku: Claude hanya bisa mengunggah file yang boleh dibaca sesinya, jadi deny rule untuk pembacaan juga memblokir pengunggahannya.
• Satu unggahan bisa memuat total sampai 10 MB file.
• File dengan lebih dari satu hard link ditolak, dan itu lazim di dalam penyimpanan package manager. Salin filenya lalu unggah salinannya.

Di mana ia diam-diam tidak tersedia

Bagian ini layak dibaca sebelum Anda menyimpulkan ada yang rusak, karena tidak satu pun menghasilkan error yang menjelaskan dirinya. Benang merahnya adalah autentikasi: ekstensi browser tidak bisa melakukan autentikasi dengan API key atau token berumur panjang, jadi sesi yang memakai salah satunya menahan integrasi itu tetap mati bahkan ketika Anda memintanya secara eksplisit.

# Configurations where Chrome integration is off, and the
# reason is authentication rather than anything you configured.

# An API key, or a long-lived token from claude setup-token:
#   Claude Code keeps Chrome integration OFF even when you pass
#   --chrome, because the browser extension cannot authenticate
#   with those credentials. (Before v2.1.216 these sessions
#   could enable it, and every connection failed with a 403.)

# Third-party providers — Bedrock, Google Cloud's Agent
# Platform, Microsoft Foundry:
#   not available. If you reach Claude only through one of
#   those, you need a separate claude.ai account for this.

# Windows Subsystem for Linux:
#   not supported at all.

# Organisation policy:
#   a deniedMcpServers entry for claude-in-chrome suppresses
#   even the install prompt.

Dua kegagalan yang benar-benar akan Anda temui

Menyingkirkan masalah instalasi pertama, sesi panjang gagal dengan sedikit cara yang bisa diprediksi:

• Service worker ekstensinya menganggur selama sesi yang panjang dan koneksinya putus. Sambungkan ulang lewat perintah chrome; tidak ada yang hilang.
• Dialog JavaScript — alert, confirm, atau prompt — memblokir halaman dan mencegah Claude menerima perintah sama sekali. Tutup manual lalu suruh Claude melanjutkan.
• Pada pengaktifan pertama, Claude Code memasang file konfigurasi native messaging host yang dibaca Chrome saat startup, jadi kalau ekstensinya tidak terdeteksi pada percobaan pertama, mulai ulang Chrome.
• Claude Code membuka tab penyambungan hanya pada instalasi pertama itu — ia tidak membukanya lagi ketika sesi berikutnya menulis ulang konfigurasinya, misalnya setelah berpindah build atau direktori konfigurasi.

Perlakukan ini sebagai browser yang sedang dikemudikan seorang kolega sementara Anda menonton, karena secara fungsional memang begitu: sesi Anda, login Anda, tab Anda, di jendela yang bisa Anda lihat. Kerangka itu dengan sendirinya membuat dua kebiasaan penting jadi benar — Anda meninjau rekaman sebelum membagikannya, dan Anda membiarkannya mati secara default alih-alih selalu termuat, lalu menyalakannya untuk tugas yang memang membutuhkannya. Keduanya murah, dan keduanya makin penting seiring Anda merasa fitur ini makin berguna.