Claude Code Remote Control: Kendalikan Sesi Lokal Jarak Jauh

Saya memulai satu migrasi panjang di laptop, menutup layarnya, lalu menghabiskan satu jam berikutnya di dalam bus sambil menonton sesi yang sama menyisir file dari ponsel — sempat menyetujui dua permission prompt di jalan. Tidak ada bagian dari run itu yang pindah ke cloud. Laptop tetap mengerjakan setiap byte-nya; ponsel hanya layar.

Perbedaan itulah inti fiturnya, dan mencampuradukkannya dengan Claude Code on the web membuat Anda salah pilih alat di kedua arah. Tulisan ini membahas tiga cara memulai sesi Remote Control, flag yang penting di server mode, model keamanannya, daftar konfigurasi yang secara diam-diam membuatnya tidak tersedia, dan apa yang benar-benar bisa dilakukan dari ponsel setelah terhubung.

Ia jendela ke proses lokal, bukan sesi cloud

Saat Anda menyalakan Remote Control, Claude tetap berjalan lokal sepanjang waktu. Filesystem, MCP server, tool, dan konfigurasi proyek Anda semuanya tetap tersedia, dan mengetik tanda at di ponsel akan melengkapi path file dari proyek lokal Anda. Claude Code on the web justru kebalikannya: ia berjalan di infrastruktur cloud, yang tepat untuk repo yang belum Anda clone, dan tidak berguna untuk pekerjaan yang sudah terbuka di meja Anda.

Konsekuensinya, proses lokal itu menanggung beban. Tutup terminal, keluar dari editor, atau hentikan prosesnya dengan cara lain, dan sesinya jadi offline dalam hitungan detik. Untuk menjaga satu sesi tetap hidup di mesin remote setelah Anda memutus SSH, jalankan di dalam tmux atau screen — ini cara paling umum orang kehilangan sesi yang mereka kira tahan lama.

Tiga jalan masuk, dan hanya satu yang melayani lebih dari satu sesi

Server mode adalah yang paling layak dipelajari serius. Ia menahan satu proses di terminal Anda menunggu koneksi, mencetak session URL, dan menampilkan QR code saat Anda menekan spasi. Kapasitas defaultnya 32 sesi bersamaan, dan mode spawn menentukan apakah sesi-sesi itu berebut working directory yang sama atau masing-masing mendapat git worktree sendiri.

# Server mode — one process serving many sessions. Stays in
# your terminal, prints a session URL, spacebar shows a QR code.
claude remote-control --name "Porto rebuild" --capacity 8

#   --spawn same-dir   all sessions share the cwd (default)
#   --spawn worktree   each on-demand session gets its own git worktree
#   --spawn session    serve exactly ONE session, reject the rest
#   press w at runtime to toggle same-dir <-> worktree

# Interactive: a normal session you can also drive remotely.
claude --remote-control "Porto rebuild"     # or --rc

# Already mid-session? Carries the conversation history over.
/remote-control Porto rebuild               # or /rc

# Bring back sessions after Ctrl+C, for about four hours:
claude remote-control                       # all of them
claude remote-control --continue            # just the one it started with
claude remote-control --session-id abc123   # one by id

Dua mode lainnya hanya melayani satu sesi remote per proses. Menghentikan server dengan Ctrl+C tidak mengarsipkan sesinya — Anda punya sekitar empat jam untuk memanggilnya kembali dari direktori yang sama, setelah itu Anda mulai dari awal. Sesi yang dimulai lewat flag interaktif atau slash command dipanggil kembali lewat jalur resume percakapan biasa.

Auto-connect, dan asimetri yang membuatnya aman

Remote Control hanya aktif kalau Anda memintanya, kecuali auto-connect dinyalakan. Anda bisa mengubahnya di config, di setelan Desktop, di command menu VS Code, atau lewat sebuah settings key — dan settings key itu berperilaku berbeda tergantung file mana yang memuatnya, secara sengaja.

// ~/.claude/settings.json — connect every interactive session
// automatically. Note the deliberate asymmetry below.
{
  "remoteControlAtStartup": true
}

// In .claude/settings.json or .claude/settings.local.json,
// Claude Code honours a FALSE and ignores a TRUE — so a
// checked-in repo file can turn Remote Control OFF for a
// repository but can never turn it ON for everyone who
// clones it. The asymmetry is the whole security property.

// To remove the capability entirely:
{
  "disableRemoteControl": true
}

Model keamanannya, dinyatakan lugas

Sesi lokal Anda hanya membuat request HTTPS keluar dan tidak pernah membuka port masuk di mesin Anda. Ia mendaftar ke Anthropic API lalu melakukan polling untuk pekerjaan; ketika Anda terhubung dari perangkat lain, server meneruskan pesan antara klien web atau mobile dan sesi lokal Anda lewat koneksi streaming. Semuanya berjalan di atas TLS dengan transport yang sama seperti sesi Claude Code lain, memakai beberapa kredensial berumur pendek yang masing-masing terikat satu tujuan dan kedaluwarsa sendiri-sendiri.

Organisasi di paket Team dan Enterprise bisa melangkah lebih jauh dengan Trusted Devices, saat ini masih beta dan mati sampai seorang Owner mengaktifkannya. Fitur itu mengikat akses Remote Control ke perangkat terdaftar dan sign-in yang usianya tidak lebih dari delapan belas jam, disegarkan dengan Face ID, Touch ID, Windows Hello, atau passkey. Pemeriksaan biometrik berjalan di perangkat lewat sistem operasi atau browser, dan Anthropic hanya menyimpan public key perangkat serta metadata dasar — bukan data sidik jari atau wajah.

Konfigurasi yang membuatnya diam-diam tidak tersedia

Di sinilah saya kehilangan satu sore. Remote Control tidak tersedia di Bedrock, Google Cloud Agent Platform, atau Microsoft Foundry, ia butuh autentikasi langganan alih-alih API key, dan ia menolak jika Anda mengarahkan base URL ke selain Anthropic API — termasuk LLM gateway atau proxy Anda sendiri. Yang kurang kentara, empat environment variable privasi masing-masing mematikan evaluasi feature flag yang menjadi sandaran ketersediaannya, jadi sesi yang menyetel salah satunya gagal dengan cara yang terlihat seperti bug alih-alih kebijakan.

# Remote Control silently refuses in more configurations
# than people expect. Each of these is a hard "not available":

ANTHROPIC_BASE_URL=https://gateway.internal   # any host that is
                                              # not api.anthropic.com

# Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry
# An enterprise Claude apps gateway sign-in
# API keys — subscription auth only (Pro, Max, Team, Enterprise)

# And these four each disable the feature-flag evaluation that
# Remote Control availability depends on:
DISABLE_TELEMETRY=1
DO_NOT_TRACK=1
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
DISABLE_GROWTHBOOK=1

# Unset them wherever they are set — shell OR the env block of
# a settings.json file — or the failure looks like a bug.

Apa yang sebenarnya bisa dilakukan dari ponsel

Setelah terhubung, perangkat menampilkan percakapan sebagaimana terjadi, termasuk progres compaction dan titik di mana percakapan dipadatkan. Anda bisa melampirkan foto dan file, yang dilihat Claude langsung atau diunduh ke mesin Anda lalu diberikan sebagai referensi file. Command terbagi tiga kelompok, dan mengetahui yang mana menghemat banyak ketikan ke ponsel yang tidak akan menjawab:

• Command yang keluarannya teks berfungsi di mana saja — compact, clear, context, usage, recap, reload-plugins, dan exit.
• Model, effort, fast, color, dan rename berfungsi kalau Anda mengirim nilainya sebagai argumen, karena ponsel tidak punya picker atau slider untuk dibuka.
• Command yang khusus terminal seperti plugin dan resume tidak pernah bekerja dari jarak jauh, dengan atau tanpa argumen.

Memilih antara Remote Control dan Claude Code on the web

Kedua permukaan itu memakai antarmuka claude.ai yang sama, dan justru karena itulah orang salah memilih. Satu-satunya pertanyaan yang penting adalah di mana sesinya berjalan, dan sisanya mengikuti dari situ.

Empat pertanyaan yang menuntaskannya:

Pakai Remote Control ketika pekerjaannya sudah lokal dan Anda ingin terus mengemudikannya dari tempat lain; pakai web ketika Anda ingin memulai sesuatu tanpa persiapan lokal sama sekali. Aturan yang sekarang saya pegang: jalankan apa pun yang mungkin ingin saya tinggalkan berjalan di dalam tmux, karena satu-satunya kegagalan yang tidak bisa dipulihkan fitur ini adalah jendela terminal yang saya tutup tanpa berpikir.