Biarkan Claude menggunakan komputer Anda dari CLI

Aktifkan computer use di Claude Code CLI sehingga Claude dapat membuka aplikasi, mengklik, mengetik, dan melihat layar Anda di macOS. Uji aplikasi native, debug masalah visual, dan otomatisasi alat GUI-only tanpa meninggalkan terminal Anda.

Computer use adalah research preview di macOS yang memerlukan paket Pro atau Max. Tidak tersedia di paket Team atau Enterprise. Memerlukan Claude Code v2.1.85 atau lebih baru dan sesi interaktif, jadi tidak tersedia dalam mode non-interaktif dengan flag -p.

Computer use memungkinkan Claude membuka aplikasi, mengontrol layar Anda, dan bekerja di mesin Anda seperti yang Anda lakukan. Dari CLI, Claude dapat mengompilasi aplikasi Swift, meluncurkannya, mengklik setiap tombol, dan mengambil screenshot hasilnya, semuanya dalam percakapan yang sama di mana Claude menulis kodenya.

Halaman ini mencakup cara kerja computer use di CLI. Untuk aplikasi Desktop, lihat computer use di Desktop.

​

Apa yang dapat Anda lakukan dengan computer use

Computer use menangani tugas yang memerlukan GUI: apa pun yang biasanya harus Anda tinggalkan terminal dan lakukan dengan tangan.

• Bangun dan validasi aplikasi native: minta Claude untuk membangun aplikasi menu bar macOS. Claude menulis Swift, mengompilasinya, meluncurkannya, dan mengklik setiap kontrol untuk memverifikasi bahwa itu berfungsi sebelum Anda pernah membukanya.
• Pengujian UI end-to-end: arahkan Claude ke aplikasi Electron lokal dan katakan “uji alur onboarding.” Claude membuka aplikasi, mengklik melalui pendaftaran, dan mengambil screenshot setiap langkah. Tidak ada konfigurasi Playwright, tidak ada test harness.
• Debug masalah visual dan tata letak: beri tahu Claude “modal terpotong di jendela kecil.” Claude mengubah ukuran jendela, mereproduksi bug, mengambil screenshot, menambal CSS, dan memverifikasi perbaikan. Claude melihat apa yang Anda lihat.
• Jalankan alat GUI-only: berinteraksi dengan alat desain, panel kontrol hardware, iOS Simulator, atau aplikasi proprietary yang tidak memiliki CLI atau API.

​

Kapan computer use berlaku

Claude memiliki beberapa cara untuk berinteraksi dengan aplikasi atau layanan. Computer use adalah yang paling luas dan paling lambat, jadi Claude mencoba alat yang paling presisi terlebih dahulu:

• Jika Anda memiliki MCP server untuk layanan tersebut, Claude menggunakannya.
• Jika tugasnya adalah perintah shell, Claude menggunakan Bash.
• Jika tugasnya adalah pekerjaan browser dan Anda memiliki Claude di Chrome yang diatur, Claude menggunakannya.
• Jika tidak ada yang berlaku, Claude menggunakan computer use.

Kontrol layar dicadangkan untuk hal-hal yang tidak dapat dijangkau oleh yang lain: aplikasi native, simulator, dan alat tanpa API.

​

Aktifkan computer use

Computer use tersedia sebagai MCP server bawaan yang disebut computer-use. Ini dimatikan secara default sampai Anda mengaktifkannya.

1. Buka menu MCP

   Dalam sesi Claude Code interaktif, jalankan:

   /mcp
   

   Temukan computer-use dalam daftar server. Ini ditampilkan sebagai disabled.

2. Aktifkan server

   Pilih computer-use dan pilih Enable. Pengaturan bertahan per proyek, jadi Anda hanya melakukan ini sekali untuk setiap proyek di mana Anda ingin computer use.

3. Berikan izin macOS

   Pertama kali Claude mencoba menggunakan komputer Anda, Anda akan melihat prompt untuk memberikan dua izin macOS:

   • Accessibility: memungkinkan Claude mengklik, mengetik, dan menggulir
   • Screen Recording: memungkinkan Claude melihat apa yang ada di layar Anda

   Prompt mencakup tautan untuk membuka pane System Settings yang relevan. Berikan keduanya, kemudian pilih Try again dalam prompt. macOS mungkin memerlukan Anda untuk memulai ulang Claude Code setelah memberikan Screen Recording.

Setelah setup, minta Claude untuk melakukan sesuatu yang memerlukan GUI:

Build the app target, launch it, and click through each tab to make
sure nothing crashes. Screenshot any error states you find.

​

Setujui aplikasi per sesi

Mengaktifkan server computer-use tidak memberikan Claude akses ke setiap aplikasi di mesin Anda. Pertama kali Claude memerlukan aplikasi tertentu dalam sesi, prompt muncul di terminal Anda menampilkan:

• Aplikasi mana yang ingin Claude kontrol
• Izin tambahan apa pun yang diminta, seperti akses clipboard
• Berapa banyak aplikasi lain yang akan disembunyikan saat Claude bekerja

Pilih Allow for this session atau Deny. Persetujuan berlaku untuk sesi saat ini. Anda dapat menyetujui beberapa aplikasi sekaligus ketika Claude memintanya bersama-sama.

Aplikasi dengan jangkauan luas menampilkan peringatan tambahan dalam prompt sehingga Anda tahu apa yang disetujui mereka:

Peringatan	Berlaku untuk
Setara dengan akses shell	Terminal, iTerm, VS Code, Warp, dan terminal serta IDE lainnya
Dapat membaca atau menulis file apa pun	Finder
Dapat mengubah pengaturan sistem	System Settings

Aplikasi ini tidak diblokir. Peringatan memungkinkan Anda memutuskan apakah tugas tersebut memerlukan tingkat akses itu.

Tingkat kontrol Claude juga bervariasi menurut kategori aplikasi: browser dan platform perdagangan adalah view-only, terminal dan IDE adalah click-only, dan semuanya mendapatkan kontrol penuh. Lihat app permissions di Desktop untuk rincian tier lengkap.

​

Bagaimana Claude bekerja di layar Anda

Memahami alurnya membantu Anda mengantisipasi apa yang akan Claude lakukan dan cara untuk campur tangan.

​

Satu sesi pada satu waktu

Computer use menahan kunci machine-wide saat aktif. Jika sesi Claude Code lain sudah menggunakan komputer Anda, upaya baru gagal dengan pesan yang memberi tahu Anda sesi mana yang menahan kunci. Selesaikan atau keluar dari sesi itu terlebih dahulu.

​

Aplikasi disembunyikan saat Claude bekerja

Ketika Claude mulai mengontrol layar Anda, aplikasi terlihat lainnya disembunyikan sehingga Claude berinteraksi hanya dengan aplikasi yang disetujui. Jendela terminal Anda tetap terlihat dan dikecualikan dari screenshot, sehingga Anda dapat menonton sesi dan Claude tidak pernah melihat output-nya sendiri.

Ketika Claude menyelesaikan giliran, aplikasi yang disembunyikan dipulihkan secara otomatis.

​

Hentikan kapan saja

Ketika Claude memperoleh kunci, notifikasi macOS muncul: “Claude is using your computer · press Esc to stop.” Tekan Esc di mana saja untuk membatalkan tindakan saat ini segera, atau tekan Ctrl+C di terminal. Bagaimanapun, Claude melepaskan kunci, menampilkan kembali aplikasi Anda, dan mengembalikan kontrol kepada Anda.

Notifikasi kedua muncul ketika Claude selesai.

​

Keamanan dan batas kepercayaan

Tidak seperti alat Bash yang di-sandbox, computer use berjalan di desktop aktual Anda dengan akses ke aplikasi yang Anda setujui. Claude memeriksa setiap tindakan dan menandai potensi prompt injection dari konten on-screen, tetapi batas kepercayaan berbeda. Lihat panduan keamanan computer use untuk praktik terbaik.

Guardrail bawaan mengurangi risiko tanpa memerlukan konfigurasi:

• Persetujuan per-aplikasi: Claude hanya dapat mengontrol aplikasi yang telah Anda setujui dalam sesi saat ini.
• Peringatan sentinel: aplikasi yang memberikan akses shell, filesystem, atau pengaturan sistem ditandai sebelum Anda menyetujuinya.
• Terminal dikecualikan dari screenshot: Claude tidak pernah melihat jendela terminal Anda, jadi prompt on-screen dalam sesi Anda tidak dapat umpan balik ke model.
• Escape global: tombol Esc membatalkan computer use dari mana saja, dan penekanan tombol dikonsumsi sehingga prompt injection tidak dapat menggunakannya untuk menutup dialog.
• File kunci: hanya satu sesi yang dapat mengontrol mesin Anda pada satu waktu.

​

Contoh alur kerja

Contoh-contoh ini menunjukkan cara umum untuk menggabungkan computer use dengan tugas coding.

​

Validasi build native

Setelah membuat perubahan pada aplikasi macOS atau iOS, minta Claude untuk mengompilasi dan memverifikasi dalam satu lintasan:

Build the MenuBarStats target, launch it, open the preferences window,
and verify the interval slider updates the label. Screenshot the
preferences window when you're done.

Claude menjalankan xcodebuild, meluncurkan aplikasi, berinteraksi dengan UI, dan melaporkan apa yang ditemukannya.

​

Reproduksi bug tata letak

Ketika bug visual hanya muncul pada ukuran jendela tertentu, biarkan Claude menemukannya:

The settings modal clips its footer on narrow windows. Resize the app
window down until you can reproduce it, screenshot the clipped state,
then check the CSS for the modal container.

Claude mengubah ukuran jendela, menangkap status yang rusak, dan membaca stylesheet yang relevan.

​

Uji alur simulator

Jalankan iOS Simulator tanpa menulis XCTest:

Open the iOS Simulator, launch the app, tap through the onboarding
screens, and tell me if any screen takes more than a second to load.

Claude mengontrol simulator dengan cara yang sama seperti Anda dengan mouse.

​

Perbedaan dari aplikasi Desktop

Permukaan CLI dan Desktop berbagi mesin computer use yang sama. Beberapa kontrol khusus Desktop belum ada di CLI:

Fitur	Desktop	CLI
Enable	Toggle di Settings > General (di bawah Desktop app)	Aktifkan computer-use di /mcp
Daftar aplikasi yang ditolak	Dapat dikonfigurasi di Settings	Belum tersedia
Toggle auto-unhide	Opsional	Selalu aktif
Integrasi Dispatch	Sesi yang dispawn Dispatch dapat menggunakan computer use	Tidak berlaku

​

Troubleshooting

​

”Computer use is in use by another Claude session”

Sesi Claude Code lain menahan kunci. Selesaikan tugas dalam sesi itu atau keluar darinya. Jika sesi lain mogok, kunci dilepaskan secara otomatis ketika Claude mendeteksi proses tidak lagi berjalan.

​

Prompt izin macOS terus muncul kembali

macOS kadang-kadang memerlukan restart dari proses yang meminta setelah Anda memberikan Screen Recording. Keluar dari Claude Code sepenuhnya dan mulai sesi baru. Jika prompt terus berlanjut, buka System Settings > Privacy & Security > Screen Recording dan konfirmasi aplikasi terminal Anda terdaftar dan diaktifkan.

​

computer-use tidak muncul di /mcp

Server hanya muncul pada setup yang memenuhi syarat. Periksa bahwa:

• Anda berada di macOS. Computer use tidak tersedia di Linux atau Windows.
• Anda menjalankan Claude Code v2.1.85 atau lebih baru. Jalankan claude --version untuk memeriksa.
• Anda berada di paket Pro atau Max. Jalankan /status untuk mengonfirmasi langganan Anda.
• Anda diautentikasi melalui claude.ai. Computer use tidak tersedia dengan penyedia pihak ketiga seperti Amazon Bedrock, Google Cloud Vertex AI, atau Microsoft Foundry. Jika Anda mengakses Claude secara eksklusif melalui penyedia pihak ketiga, Anda memerlukan akun claude.ai terpisah untuk menggunakan fitur ini.
• Anda berada dalam sesi interaktif. Computer use tidak tersedia dalam mode non-interaktif dengan flag -p.

​

Lihat juga

• Computer use di Desktop: kemampuan yang sama dengan halaman pengaturan grafis
• Claude di Chrome: otomasi browser untuk tugas berbasis web
• MCP: hubungkan Claude ke alat dan API terstruktur
• Sandboxing: bagaimana alat Bash Claude mengisolasi akses filesystem dan jaringan
• Panduan keamanan computer use: praktik terbaik untuk computer use yang aman