Self-Hosted Runner Claude Code: Sesi Cloud di Mesin Anda

Keberatan yang paling sering saya dengar terhadap sesi coding di cloud bukan soal modelnya. Melainkan bahwa repository-nya harus keluar dari gedung, dan bagi banyak tim itu menutup diskusi sebelum dimulai. Self-hosted environment adalah jawaban untuk keberatan spesifik itu, dan bentuk jawabannya layak dipahami dengan tepat, karena ia menyelesaikan lebih sedikit dari harapan orang dan lebih banyak dari dugaan mereka.

Tulisan ini membahas arsitektur tiga bagiannya, jalur jaringan yang menjadikannya cerita keamanan yang sungguh kuat, aturan siklus hidup runner yang menentukan ukuran armada Anda, dan daftar pengecualian yang menentukan apakah Anda bisa memakainya sama sekali — dan bagian terakhir itu yang perlu dibaca lebih dulu, karena beberapa pengecualiannya bersifat menggugurkan.

Tiga bagian, dan hanya satu yang Anda jalankan

Kosakatanya penting di sini karena dokumentasinya memakainya secara konsisten dan konsepnya tidak memetakan intuisi CI dengan rapi:

• Environment adalah tujuan bernama yang bisa disasar sesi cloud, dibuat di admin settings claude.ai, mengelompokkan sekumpulan runner. Di field API dan nama metrik, ia muncul sebagai pool.
• Runner adalah proses berumur panjang yang Anda deploy di host dalam jaringan Anda. Ia mendaftar ke environment, menerima token, lalu melakukan polling untuk sesi — gagasan yang sama dengan self-hosted CI runner.
• Session adalah satu tugas Claude Code yang dimulai seorang developer, berjalan sebagai proses anak yang dipanggil runner.

Ketika seorang developer memulai sesi cloud, picker-nya menampilkan environment milik Anthropic bersama milik Anda. Pilih milik Anda dan control plane menempatkan sesi tersebut di antrean environment Anda, tempat sebuah runner mengambilnya, meng-clone repository, dan memulai pekerjaannya. Control plane tetap berada di Anthropic sepanjang proses — orkestrasi sesi, antrean, dan antarmuka claude.ai bukan hal yang Anda self-host.

Semuanya keluar, tidak ada yang masuk

Inilah bagian yang membuat tinjauan keamanan jadi lurus. Runner dan sesinya membuat beberapa jenis koneksi keluar dan sama sekali tidak membutuhkan konektivitas masuk. Itu percakapan yang jauh lebih mudah daripada self-hosted CI runner yang butuh endpoint webhook, dan layak Anda kedepankan saat membawa ini ke tim jaringan.

# Every connection is OUTBOUND. Anthropic never connects
# into your network — there is no inbound port to open.

  your network
  ├─ runner ──────────► api.anthropic.com   (poll queue, post events)
  │                                          the poll IS the heartbeat
  ├─ runner ──────────► your git host        (clone / push, HTTPS or SSH)
  ├─ session child ───► api.anthropic.com   (event stream + inference)
  └─ session child ───► your internal services, databases, registries

# Corporate egress proxies are supported: the runner and the
# autoscaling orchestrator honour HTTPS_PROXY and NO_PROXY, and
# sessions inherit them. Session streaming is server-sent events
# over HTTPS, so a proxy in the path MUST NOT buffer responses.

Satu runner, satu pengguna, dan efeknya pada ukuran armada

Inilah aturan yang menentukan perencanaan kapasitas Anda, dan ia tidak kentara dari luar. Satu runner melayani satu pengguna pada satu waktu: sesi pertama yang diambilnya mengunci runner itu ke akun pengguna tersebut, dan ia lalu hanya menjalankan sesi milik akun itu sampai batas kapasitasnya. Tujuannya isolasi — kode yang di-checkout tidak pernah bercampur antarpengguna, tanpa runner harus membersihkan disk di antara mereka.

# A runner serves ONE USER AT A TIME. The first session it
# claims locks it to that user's account, so checked-out code
# never mixes between users. That single rule sets your fleet
# size: minimum runners = users active at once.

--capacity <N>            # concurrent sessions for the locked account

--drain-grace-sec 0       # DEFAULT: exit as soon as active sessions
                          # finish, so your orchestrator restarts it
                          # with a fresh disk, ready for any account
--drain-grace-sec 300     # keep polling the locked account for 5 min

--retire-at <epoch-secs>  # for hosts destroyed at a known wall-clock
                          # time with NO signal — spot reclamation, a
                          # sandbox lifetime cap. Set it a few minutes
                          # before the kill.

# Without --retire-at, a signal-less host kill is indistinguishable
# from a crash: the control plane records a lost worker rather than
# a clean release, and the session requeues elsewhere.

Konsekuensinya, ukuran armada minimum Anda adalah jumlah pengguna yang diperkirakan aktif bersamaan, bukan jumlah sesi bersamaan. Lima developer yang masing-masing menjalankan satu sesi butuh lima runner; satu developer yang menjalankan lima sesi butuh satu runner dengan kapasitas lima. Membalik pemahaman ini adalah cara tercepat menyediakan kapasitas kurang untuk sebuah pilot lalu menyimpulkan fiturnya lambat.

Siklus hidup sesi, dan apa yang terjadi saat sebuah host mati

Mengetahui mekanika lease-nya mengubah sebagian besar proses debug runner menjadi aritmetika:

1. Runner dengan kapasitas kosong mengambil sesi tersebut dan memegang lease atasnya.
2. Ia meng-clone repository ke working directory-nya lalu memunculkan proses anak Claude Code.
3. Proses anak itu mengalirkan event kembali lewat HTTPS sementara runner terus melakukan polling — tiap polling menyegarkan lease sekaligus berfungsi sebagai heartbeat.
4. Kalau runner berhenti melakukan polling sekitar 60 detik, server mengantrekan ulang sesi itu untuk runner lain.

Apa yang tinggal bersama Anda, dan apa yang tidak

Presisi di sini adalah selisih antara tinjauan keamanan yang lolos dan yang mandek. Batasnya nyata tetapi tidak total, dan melebih-lebihkannya adalah cara tercepat kehilangan kredibilitas di hadapan peninjau yang membaca dokumentasinya.

Di mana tiap hal sebenarnya berada:

Pengecualian yang perlu diperiksa sebelum merencanakan apa pun

Baca daftar ini lebih dulu. Beberapa entri bersifat menghentikan, dan salah satunya menggugurkan satu kelas deployment enterprise:

• Public beta hanya untuk paket Team dan Enterprise, mati secara default, dan seorang Owner harus mengaktifkannya di halaman admin cloud environments — yang itu sendiri mensyaratkan Claude Code on the web aktif untuk organisasi tersebut.
• Tidak tersedia untuk organisasi dengan Zero Data Retention aktif.
• Inference memakai Anthropic API dan tidak bisa dialihkan lewat Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry, maupun LLM gateway. Kalau seluruh alasan Anda self-hosting adalah menjaga inference di kontrak cloud Anda, ini fitur yang keliru.
• Sesi meng-checkout repository dari GitHub, dan sesi Claude Tag, Claude Security, serta Code Review belum diarahkan ke self-hosted environment.

Kapan self-hosting sepadan dengan beban operasionalnya

Sebagian besar tim lebih terlayani oleh environment milik Anthropic, yang tidak butuh infrastruktur untuk dijalankan atau dirawat. Self-hosting berarti Anda membangun dan merawat image runner, mengoperasikan armadanya, dan mengendalikan jaringannya — kepemilikan operasional yang nyata dan permanen, ditukar dengan tiga hal: sesi yang bisa menjangkau layanan internal tanpa mengeksposnya ke publik, image runner dengan compiler dan CLI internal Anda sudah terpasang, serta checkout yang tetap di mesin yang Anda kendalikan.

Kalau tim Anda sama sekali tidak memakai sesi cloud, tidak ada yang perlu dikonfigurasi di sini — sesi terminal dan IDE selalu berjalan di mesin developer sendiri. Dan kalau yang sebenarnya Anda inginkan adalah menjalankan Claude Code di mesin Anda yang selalu menyala lalu mengemudikannya dari perangkat lain, itu Remote Control, yang tersedia juga di Pro dan Max dan tidak membutuhkan semua ini.

Self-hosted environment adalah jawaban yang berbentuk baik untuk satu pertanyaan sempit: bisakah sesi cloud berjalan di tempat kode kami sudah berada. Ia menjawabnya dengan meyakinkan, lewat model jaringan serba keluar yang lolos tinjauan keamanan. Ia tidak menjawab di mana inference terjadi, ia tidak bekerja di bawah Zero Data Retention, dan ia membawa biaya berkelanjutan berupa armada yang kini Anda operasikan. Putuskan dulu apakah pertanyaan sempit itu memang pertanyaan Anda sebelum membangun apa pun.