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 server Remote Control khusus, memulai sesi interaktif dengan Remote Control diaktifkan, atau menghubungkan sesi yang sudah berjalan.
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.
--spawn <mode>Bagaimana sesi bersamaan dibuat. Tekan w saat runtime untuk beralih.
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.
--capacity <N>Jumlah maksimum sesi bersamaan. Default adalah 32.
--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. Baik claude remote-control maupun /remote-control menampilkan URL ini di terminal.
  • 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. Prompt pertama 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 dengan --spawn 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.

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 dengan --spawn untuk menjalankan beberapa sesi bersamaan dari satu proses.
  • Terminal harus tetap terbuka: Remote Control berjalan sebagai proses lokal. Jika Anda menutup terminal atau menghentikan proses claude, sesi berakhir. Jalankan claude remote-control lagi untuk memulai yang baru.
  • 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.

Pemecahan masalah

”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
  • Channels: teruskan Telegram atau Discord 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