Lanjutkan sesi lokal dari perangkat apa pun dengan Remote Control
Lanjutkan sesi Claude Code lokal dari ponsel, tablet, atau browser apa pun menggunakan Remote Control. Bekerja dengan claude.ai/code dan aplikasi Claude mobile.
Remote Control sedang dalam pratinjau penelitian dan 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, dan mengetik
@melengkapi otomatis jalur file dari proyek lokal Anda - 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
claudedan gunakan/loginuntuk masuk melalui claude.ai jika Anda belum melakukannya. - Kepercayaan ruang kerja: jalankan
claudedi 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:
| Bendera | Deskripsi |
|---|---|
--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. |
--verbose |
Tampilkan log koneksi dan sesi terperinci. |
--sandbox / --no-sandbox |
Aktifkan atau nonaktifkan sandboxing untuk isolasi sistem file dan jaringan. Dimatikan secara default. |
Untuk memulai sesi Claude Code interaktif normal dengan Remote Control diaktifkan, gunakan bendera --remote-control (atau --rc):
claude --remote-control
Secara opsional berikan nama untuk sesi:
claude --remote-control "My Project"
Ini memberi Anda sesi interaktif penuh di terminal Anda yang juga dapat Anda kontrol dari claude.ai atau aplikasi Claude. Tidak seperti claude remote-control (mode server), Anda dapat mengetik pesan secara lokal sementara sesi juga tersedia dari jarak jauh.
Jika Anda sudah dalam sesi Claude Code dan ingin melanjutkannya dari jarak jauh, gunakan perintah /remote-control (atau /rc):
/remote-control
Berikan nama sebagai argumen untuk menetapkan judul sesi khusus:
/remote-control My Project
Ini memulai sesi Remote Control yang membawa riwayat percakapan saat ini dan menampilkan URL sesi dan kode QR yang dapat Anda gunakan untuk terhubung dari perangkat lain. Bendera --verbose, --sandbox, dan --no-sandbox tidak tersedia dengan perintah ini.
Di ekstensi VS Code Claude Code, ketik /remote-control atau /rc di kotak prompt, atau buka menu perintah dengan / dan pilihnya. Memerlukan Claude Code v2.1.79 atau lebih baru.
/remote-control
Spanduk muncul di atas kotak prompt yang menunjukkan status koneksi. Setelah terhubung, klik Open in browser di spanduk untuk langsung ke sesi, atau temukan di daftar sesi di claude.ai/code. URL sesi juga diposting dalam percakapan.
Untuk memutuskan sambungan, klik ikon tutup di spanduk atau jalankan /remote-control lagi.
Tidak seperti CLI, perintah VS Code tidak menerima argumen nama atau menampilkan kode QR. Judul sesi berasal dari riwayat percakapan Anda atau prompt pertama.
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. Di aplikasi mobile Claude, ketuk Code dalam navigasi untuk mencapai daftar sesi. Sesi Remote Control menampilkan ikon komputer dengan titik status hijau saat online.
Judul sesi jarak jauh dipilih dalam urutan ini:
- Nama yang Anda berikan ke
--name,--remote-control, atau/remote-control - Judul yang Anda tetapkan dengan
/rename - Pesan bermakna terakhir dalam riwayat percakapan yang ada
- Nama yang dibuat secara otomatis seperti
myhost-graceful-unicorn, di manamyhostadalah 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. Di aplikasi Desktop, Anda juga dapat mengalihkan ini dari Settings → Claude Code → Enable remote control by default.
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:
Masuk dengan akun Claude Code Anda
Gunakan akun dan organisasi yang sama yang Anda gunakan untuk Claude Code di terminal.
Izinkan notifikasi
Terima prompt izin notifikasi dari sistem operasi.
Aktifkan push di Claude Code
Di terminal Anda, jalankan /config dan aktifkan Push when Claude decides.
Jika notifikasi tidak tiba:
- Jika
/configmenunjukkan 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-controllagi 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.
- Beberapa perintah hanya lokal: perintah yang membuka pemilih interaktif di terminal, seperti
/mcp,/plugin, atau/resume, hanya bekerja dari CLI lokal. Perintah yang menghasilkan output teks, termasuk/compact,/clear,/context,/usage,/exit,/usage-credits,/recap, dan/reload-plugins, bekerja dari mobile dan web.
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_TRAFFICatauDISABLE_TELEMETRY: batalkan pengaturannya dan coba lagi.CLAUDE_CODE_USE_BEDROCK,CLAUDE_CODE_USE_VERTEX, atauCLAUDE_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 empat 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
/logindan pilih opsi claude.ai. JikaANTHROPIC_API_KEYdiatur 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. Toggle ini adalah pengaturan organisasi sisi server.
- 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.
- Kesalahan menyebutkan
disableRemoteControl: administrator IT Anda telah menonaktifkan Remote Control di perangkat ini melalui pengaturan yang dikelola, terlepas dari toggle organisasi-lebar.
"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
claudedan gunakan/loginuntuk 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.
| Trigger | Claude runs on | Setup | Best for | |
|---|---|---|---|---|
| Dispatch | Message a task from the Claude mobile app | Your machine (Desktop) | Pair the mobile app with Desktop | Delegating work while you're away, minimal setup |
| Remote Control | Drive a running session from claude.ai/code or the Claude mobile app | Your machine (CLI or VS Code) | Run claude remote-control |
Steering in-progress work from another device |
| Channels | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | Install a channel plugin or build your own | Reacting to external events like CI failures or chat messages |
| Slack | Mention @Claude in a team channel |
Anthropic cloud | Install the Slack app with Claude Code on the web enabled | PRs and reviews from team chat |
| Scheduled tasks | Set a schedule | CLI, Desktop, or cloud | Pick a frequency | Recurring 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
/logindan 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