Langsung ke konten utama
Remote Control tersedia di semua paket. Di Tim dan Enterprise, Remote Control dimatikan secara default sampai admin mengaktifkan toggle Remote Control di pengaturan admin Claude Code.
Remote Control menghubungkan claude.ai/code atau aplikasi Claude untuk iOS dan Android ke sesi Claude Code yang berjalan di mesin Anda. Mulai tugas di meja Anda, kemudian lanjutkan dari ponsel Anda di sofa atau browser di komputer lain. Ketika Anda memulai sesi Remote Control di mesin Anda, Claude terus berjalan secara lokal sepanjang waktu, jadi tidak ada yang pindah ke cloud. Dengan Remote Control Anda dapat:
  • Gunakan lingkungan lokal penuh Anda dari jarak jauh: sistem file, MCP servers, alat, dan konfigurasi proyek Anda tetap tersedia
  • Bekerja dari kedua permukaan sekaligus: percakapan tetap tersinkronisasi di semua perangkat yang terhubung, sehingga Anda dapat mengirim pesan dari terminal, browser, dan ponsel Anda secara bergantian
  • Bertahan dari gangguan: jika laptop Anda tidur atau jaringan Anda terputus, sesi akan terhubung kembali secara otomatis ketika mesin Anda kembali online
Tidak seperti Claude Code di web, yang berjalan di infrastruktur cloud, sesi Remote Control berjalan langsung di mesin Anda dan berinteraksi dengan sistem file lokal Anda. Antarmuka web dan mobile hanyalah jendela ke sesi lokal tersebut.
Remote Control memerlukan Claude Code v2.1.51 atau lebih baru. Periksa versi Anda dengan claude --version.
Halaman ini mencakup pengaturan, cara memulai dan terhubung ke sesi, dan bagaimana Remote Control dibandingkan dengan Claude Code di web.

​
Persyaratan

Sebelum menggunakan Remote Control, konfirmasi bahwa lingkungan Anda memenuhi kondisi berikut:
  • Langganan: tersedia di paket Pro, Max, Tim, dan Enterprise. Kunci API tidak didukung. Di Tim dan Enterprise, admin harus terlebih dahulu mengaktifkan toggle Remote Control di pengaturan admin Claude Code.
  • Autentikasi: jalankan claude dan gunakan /login untuk masuk melalui claude.ai jika Anda belum melakukannya.
  • Kepercayaan ruang kerja: jalankan claude di direktori proyek Anda setidaknya sekali untuk menerima dialog kepercayaan ruang kerja.

​
Mulai sesi Remote Control

Anda dapat memulai sesi Remote Control dari CLI atau ekstensi VS Code. CLI menawarkan tiga mode invokasi; VS Code menggunakan perintah /remote-control.
Navigasikan ke direktori proyek Anda dan jalankan:
claude remote-control
Proses tetap berjalan di terminal Anda dalam mode server, menunggu koneksi jarak jauh. Ini menampilkan URL sesi yang dapat Anda gunakan untuk terhubung dari perangkat lain, dan Anda dapat menekan spacebar untuk menampilkan kode QR untuk akses cepat dari ponsel Anda. Saat sesi jarak jauh aktif, terminal menampilkan status koneksi dan aktivitas alat.Bendera yang tersedia:
BenderaDeskripsi
--name "My Project"Tetapkan judul sesi khusus yang terlihat dalam daftar sesi di claude.ai/code.
--remote-control-session-name-prefix <prefix>Awalan untuk nama sesi yang dibuat secara otomatis ketika tidak ada nama eksplisit yang ditetapkan. Default adalah nama mesin Anda, menghasilkan nama seperti myhost-graceful-unicorn. Atur CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX untuk efek yang sama.
--spawn <mode>Bagaimana server membuat sesi.
• same-dir (default): semua sesi berbagi direktori kerja saat ini, sehingga dapat bertentangan jika mengedit file yang sama.
• worktree: setiap sesi sesuai permintaan mendapatkan git worktree miliknya sendiri. Memerlukan repositori git.
• session: mode sesi tunggal. Melayani tepat satu sesi dan menolak koneksi tambahan. Atur saat startup saja.
Tekan w saat runtime untuk beralih antara same-dir dan worktree.
--capacity <N>Jumlah maksimum sesi bersamaan. Default adalah 32. Tidak dapat digunakan dengan --spawn=session.
--verboseTampilkan log koneksi dan sesi terperinci.
--sandbox / --no-sandboxAktifkan atau nonaktifkan sandboxing untuk isolasi sistem file dan jaringan. Dimatikan secara default.

​
Terhubung dari perangkat lain

Setelah sesi Remote Control aktif, Anda memiliki beberapa cara untuk terhubung dari perangkat lain:
  • Buka URL sesi di browser apa pun untuk langsung ke sesi di claude.ai/code.
  • Pindai kode QR yang ditampilkan bersama URL sesi untuk membukanya langsung di aplikasi Claude. Dengan claude remote-control, tekan spacebar untuk beralih tampilan kode QR.
  • Buka claude.ai/code atau aplikasi Claude dan temukan sesi berdasarkan nama dalam daftar sesi. Sesi Remote Control menampilkan ikon komputer dengan titik status hijau saat online.
Judul sesi jarak jauh dipilih dalam urutan ini:
  1. Nama yang Anda berikan ke --name, --remote-control, atau /remote-control
  2. Judul yang Anda tetapkan dengan /rename
  3. Pesan bermakna terakhir dalam riwayat percakapan yang ada
  4. Nama yang dibuat secara otomatis seperti myhost-graceful-unicorn, di mana myhost adalah nama mesin Anda atau awalan yang Anda tetapkan dengan --remote-control-session-name-prefix
Jika Anda tidak menetapkan nama eksplisit, judul akan diperbarui untuk mencerminkan prompt Anda setelah Anda mengirimnya. Jika lingkungan sudah memiliki sesi aktif, Anda akan ditanya apakah akan melanjutkannya atau memulai yang baru. Jika Anda belum memiliki aplikasi Claude, gunakan perintah /mobile di dalam Claude Code untuk menampilkan kode QR unduhan untuk iOS atau Android.

​
Aktifkan Remote Control untuk semua sesi

Secara default, Remote Control hanya diaktifkan ketika Anda secara eksplisit menjalankan claude remote-control, claude --remote-control, atau /remote-control. Untuk mengaktifkannya secara otomatis untuk setiap sesi interaktif, jalankan /config di dalam Claude Code dan atur Enable Remote Control for all sessions ke true. Atur kembali ke false untuk menonaktifkan. Dengan pengaturan ini aktif, setiap proses Claude Code interaktif mendaftarkan satu sesi jarak jauh. Jika Anda menjalankan beberapa instance, masing-masing mendapatkan lingkungan dan sesi sendiri. Untuk menjalankan beberapa sesi bersamaan dari satu proses, gunakan mode server sebagai gantinya.

​
Koneksi dan keamanan

Sesi Claude Code lokal Anda membuat permintaan HTTPS keluar saja dan tidak pernah membuka port masuk di mesin Anda. Ketika Anda memulai Remote Control, sesi tersebut mendaftarkan dengan API Anthropic dan polling untuk pekerjaan. Ketika Anda terhubung dari perangkat lain, server merutekan pesan antara klien web atau mobile dan sesi lokal Anda melalui koneksi streaming. Semua lalu lintas berjalan melalui API Anthropic melalui TLS, keamanan transportasi yang sama seperti sesi Claude Code apa pun. Koneksi menggunakan beberapa kredensial berumur pendek, masing-masing dibatasi untuk satu tujuan dan kedaluwarsa secara independen.

​
Remote Control vs Claude Code di web

Remote Control dan Claude Code di web keduanya menggunakan antarmuka claude.ai/code. Perbedaan utamanya adalah di mana sesi berjalan: Remote Control dieksekusi di mesin Anda, sehingga MCP servers lokal, alat, dan konfigurasi proyek Anda tetap tersedia. Claude Code di web dieksekusi di infrastruktur cloud yang dikelola Anthropic. Gunakan Remote Control ketika Anda sedang dalam pekerjaan lokal dan ingin terus melanjutkan dari perangkat lain. Gunakan Claude Code di web ketika Anda ingin memulai tugas tanpa pengaturan lokal apa pun, bekerja pada repo yang tidak Anda miliki klonnya, atau menjalankan beberapa tugas secara paralel.

​
Notifikasi push mobile

Ketika Remote Control aktif, Claude dapat mengirim notifikasi push ke ponsel Anda. Claude memutuskan kapan harus push. Biasanya mengirim satu ketika tugas yang berjalan lama selesai atau ketika memerlukan keputusan dari Anda untuk melanjutkan. Anda juga dapat meminta push dalam prompt Anda, misalnya notify me when the tests finish. Selain toggle on/off di bawah, tidak ada konfigurasi per-event.
Notifikasi push mobile memerlukan Claude Code v2.1.110 atau lebih baru.
Untuk menyiapkan notifikasi push mobile:
1

Instal aplikasi Claude mobile

Unduh aplikasi Claude untuk iOS atau Android.
2

Masuk dengan akun Claude Code Anda

Gunakan akun dan organisasi yang sama yang Anda gunakan untuk Claude Code di terminal.
3

Izinkan notifikasi

Terima prompt izin notifikasi dari sistem operasi.
4

Aktifkan push di Claude Code

Di terminal Anda, jalankan /config dan aktifkan Push when Claude decides.
Jika notifikasi tidak tiba:
  • Jika /config menunjukkan No mobile registered, buka aplikasi Claude di ponsel Anda sehingga dapat menyegarkan token push-nya. Peringatan hilang saat Remote Control terhubung berikutnya.
  • Di iOS, Focus modes dan notification summaries dapat menekan atau menunda push. Periksa Settings → Notifications → Claude.
  • Di Android, optimasi baterai yang agresif dapat menunda pengiriman. Kecualikan aplikasi Claude dari optimasi baterai di pengaturan sistem.

​
Keterbatasan

  • Satu sesi jarak jauh per proses interaktif: di luar mode server, setiap instance Claude Code mendukung satu sesi jarak jauh pada satu waktu. Gunakan mode server untuk menjalankan beberapa sesi bersamaan dari satu proses.
  • Proses lokal harus tetap berjalan: Remote Control berjalan sebagai proses lokal. Jika Anda menutup terminal, keluar dari VS Code, atau menghentikan proses claude, sesi berakhir.
  • Pemadaman jaringan yang diperpanjang: jika mesin Anda aktif tetapi tidak dapat menjangkau jaringan selama lebih dari kira-kira 10 menit, sesi habis waktu dan proses keluar. Jalankan claude remote-control lagi untuk memulai sesi baru.
  • Ultraplan memutuskan Remote Control: memulai sesi ultraplan memutuskan sesi Remote Control aktif apa pun karena kedua fitur menempati antarmuka claude.ai/code dan hanya satu yang dapat terhubung pada satu waktu.

​
Pemecahan masalah

​
”Remote Control memerlukan langganan claude.ai”

Anda tidak diautentikasi dengan akun claude.ai. Jalankan claude auth login dan pilih opsi claude.ai. Jika ANTHROPIC_API_KEY diatur di lingkungan Anda, batalkan pengaturannya terlebih dahulu.

​
”Remote Control memerlukan token login dengan cakupan penuh”

Anda diautentikasi dengan token berumur panjang dari claude setup-token atau variabel lingkungan CLAUDE_CODE_OAUTH_TOKEN. Token ini terbatas pada inference-only dan tidak dapat membuat sesi Remote Control. Jalankan claude auth login untuk autentikasi dengan token sesi cakupan penuh sebagai gantinya.

​
”Tidak dapat menentukan organisasi Anda untuk kelayakan Remote Control”

Informasi akun cache Anda sudah usang atau tidak lengkap. Jalankan claude auth login untuk menyegarkannya.

​
”Remote Control belum diaktifkan untuk akun Anda”

Pemeriksaan kelayakan dapat gagal dengan variabel lingkungan tertentu yang ada:
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC atau DISABLE_TELEMETRY: batalkan pengaturannya dan coba lagi.
  • CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX, atau CLAUDE_CODE_USE_FOUNDRY: Remote Control memerlukan autentikasi claude.ai dan tidak bekerja dengan penyedia pihak ketiga.
Jika tidak ada yang diatur, jalankan /logout kemudian /login untuk menyegarkan.

​
”Remote Control dinonaktifkan oleh kebijakan organisasi Anda”

Kesalahan ini memiliki tiga penyebab yang berbeda. Jalankan /status terlebih dahulu untuk melihat metode login dan langganan mana yang Anda gunakan.
  • Anda diautentikasi dengan kunci API atau akun Console: Remote Control memerlukan OAuth claude.ai. Jalankan /login dan pilih opsi claude.ai. Jika ANTHROPIC_API_KEY diatur di lingkungan Anda, batalkan pengaturannya.
  • Admin Tim atau Enterprise Anda belum mengaktifkannya: Remote Control dimatikan secara default di paket ini. Admin dapat mengaktifkannya di claude.ai/admin-settings/claude-code dengan mengaktifkan toggle Remote Control. Ini adalah pengaturan organisasi sisi server, bukan kunci pengaturan yang dikelola.
  • Toggle admin berwarna abu-abu: organisasi Anda memiliki konfigurasi retensi data atau kepatuhan yang tidak kompatibel dengan Remote Control. Ini tidak dapat diubah dari panel admin. Hubungi dukungan Anthropic untuk membahas opsi.

​
”Remote credentials fetch failed”

Claude Code tidak dapat memperoleh kredensial berumur pendek dari API Anthropic untuk membuat koneksi. Jalankan kembali dengan --verbose untuk melihat kesalahan lengkapnya: 
claude remote-control --verbose
Penyebab umum:
  • Tidak masuk: jalankan claude dan gunakan /login untuk autentikasi dengan akun claude.ai Anda. Autentikasi kunci API tidak didukung untuk Remote Control.
  • Masalah jaringan atau proxy: firewall atau proxy dapat memblokir permintaan HTTPS keluar. Remote Control memerlukan akses ke API Anthropic di port 443.
  • Pembuatan sesi gagal: jika Anda juga melihat Session creation failed — see debug log, kegagalan terjadi lebih awal dalam pengaturan. Periksa bahwa langganan Anda aktif.

​
Pilih pendekatan yang tepat

Claude Code offers several ways to work when you’re not at your terminal. They differ in what triggers the work, where Claude runs, and how much you need to set up.
TriggerClaude runs onSetupBest for
DispatchMessage a task from the Claude mobile appYour machine (Desktop)Pair the mobile app with DesktopDelegating work while you’re away, minimal setup
Remote ControlDrive a running session from claude.ai/code or the Claude mobile appYour machine (CLI or VS Code)Run claude remote-controlSteering in-progress work from another device
ChannelsPush events from a chat app like Telegram or Discord, or your own serverYour machine (CLI)Install a channel plugin or build your ownReacting to external events like CI failures or chat messages
SlackMention @Claude in a team channelAnthropic cloudInstall the Slack app with Claude Code on the web enabledPRs and reviews from team chat
Scheduled tasksSet a scheduleCLI, Desktop, or cloudPick a frequencyRecurring automation like daily reviews

​
Sumber daya terkait

  • Claude Code di web: jalankan sesi di lingkungan cloud yang dikelola Anthropic alih-alih di mesin Anda
  • Ultraplan: luncurkan sesi perencanaan cloud dari terminal Anda dan tinjau rencana di browser Anda
  • Channels: teruskan Telegram, Discord, atau iMessage ke sesi sehingga Claude bereaksi terhadap pesan saat Anda pergi
  • Dispatch: kirim pesan tugas dari ponsel Anda dan dapat menjalankan sesi Desktop untuk menanganinya
  • Autentikasi: atur /login dan kelola kredensial untuk claude.ai
  • Referensi CLI: daftar lengkap bendera dan perintah termasuk claude remote-control
  • Keamanan: bagaimana sesi Remote Control sesuai dengan model keamanan Claude Code
  • Penggunaan data: data apa yang mengalir melalui API Anthropic selama sesi lokal dan jarak jauh