Menjalankan Claude Code di VPS

Menjalankan Claude Code di server alih-alih di laptop memberi Anda tiga hal. Ia tetap bekerja saat laptop Anda ditutup. Ia bertahan saat koneksi putus. Dan ia menaruh agen di mesin yang bisa Anda buang, bukan di mesin yang menyimpan kunci SSH dan profil browser Anda. Panduan ini membahas setup yang butuh sekitar lima belas menit di server Debian atau Ubuntu yang baru. Langkah yang sama berlaku di Alpine dan Fedora dengan sedikit perubahan.

Anda butuh paket Claude yang mencakup Claude Code: Pro, Max, Team, atau Enterprise, atau akun Console. Paket gratis claude.ai tidak mencakupnya. Masuk dengan langganan Anda, dan tidak ada kunci API yang perlu dikelola serta tidak ada biaya pemakaian tambahan.

1. Pilih server

Persyaratan sistem Anthropic menyebut RAM 4 GB atau lebih dan prosesor x64 atau ARM64. Sistem Linux yang didukung adalah Ubuntu 20.04+, Debian 10+, dan Alpine 3.19+. Dalam praktiknya, toolchain proyek Anda lebih menentukan daripada CLI-nya:

• 4 GB: minimum yang terdokumentasi, cukup untuk satu sesi di proyek sederhana.
• 8 GB: jika Anda mem-build sesuatu yang cukup besar (bundler, test suite, satu atau dua container) atau menjalankan beberapa sesi sekaligus.
• 16 GB: jika Anda menjalankan beberapa agen secara paralel, atau database di sampingnya.

Hetzner, DigitalOcean, Scaleway, OVH, Vultr, dan lainnya semuanya bisa, begitu juga mesin lama di bawah meja Anda. Pilih region yang dekat jika Anda akan mengetik di terminalnya. Instance ARM biasanya paling murah per gigabyte, dan Claude Code berjalan native di sana. Panduan VPS terbaik untuk agen coding kami membandingkan penyedia dan ukurannya.

2. Buat user non-root

Banyak image VPS membuat Anda login sebagai root. Jangan jalankan agen sebagai root. Itu mengubah kesalahan apa pun menjadi kesalahan di seluruh sistem. Claude Code juga menolak start dalam mode bypass-permissions sebagai root, jadi cepat atau lambat Anda tetap butuh user biasa. Di Debian atau Ubuntu:

adduser dev
usermod -aG sudo dev
rsync --archive --chown=dev:dev ~/.ssh /home/dev

Di Fedora, grup admin-nya adalah wheel, bukan sudo. Di Alpine, pasang sudo atau doas terlebih dahulu. Baris terakhir menyalin kunci yang sedang Anda pakai untuk login, sehingga Anda bisa tersambung kembali sebagai dev sebelum mengunci apa pun. Uji dari terminal kedua sebelum menutup yang pertama. Terkunci dari VPS baru adalah pengalaman klasik yang sebaiknya dilewati.

3. Kunci SSH dan pengamanan

Jika Anda masih login dengan kata sandi, ganti ke kunci dulu. Buat kunci di komputer Anda dengan ssh-keygen -t ed25519, lalu salin ke server dengan ssh-copy-id dev@your-server. Setelah login dengan kunci berhasil, edit /etc/ssh/sshd_config:

PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes

Lalu restart SSH: sudo systemctl restart ssh di Debian dan Ubuntu. Di Fedora nama service-nya sshd, jadi jalankan sudo systemctl restart sshd. Untuk keamanan lebih, tambahkan fail2ban dan firewall yang hanya mengizinkan SSH. Jika mesinnya sama sekali tidak perlu berada di internet publik, taruh di jaringan Tailscale. Ponsel Anda bergabung ke jaringan yang sama dan menjangkaunya secara langsung.

Dari ponsel: aplikasi SSH bisa membuat kunci di perangkat dan menampilkan bagian publiknya untuk ditempel ke ~/.ssh/authorized_keys. Maude melakukan ini untuk Anda: tombol "Set up key login" membuat kunci lewat koneksi yang sudah Anda pakai untuk masuk. Tombol itu memasang bagian publiknya, menguji kunci baru, dan menyimpan bagian privatnya hanya di keychain ponsel.

4. Pasang Claude Code

Anthropic sekarang merekomendasikan installer native, yang tidak butuh Node.js. Jalankan sebagai user biasa, bukan dengan sudo:

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor

Installer menaruh launcher di ~/.local/bin/claude dan memperbarui dirinya di latar belakang. claude doctor memeriksa instalasi dan pengaturan Anda tanpa memulai sesi. Beberapa alternatif, semuanya dari dokumentasi setup:

• Repositori apt, dnf, dan apk yang ditandatangani jika Anda lebih suka package manager sistem yang mengelolanya. Ini tidak update otomatis; Anda meng-upgrade bersama sistem lainnya.
• npm masih bisa dipakai (npm install -g @anthropic-ai/claude-code, Node.js 22 atau lebih baru). Hasilnya binary native yang sama. Anthropic memperingatkan agar tidak memakai sudo npm install -g.
• Alpine butuh bash, curl, libgcc, libstdc++, dan ripgrep, plus USE_BUILTIN_RIPGREP=0 di pengaturan Anda.

Jika panduan lama menyuruh Anda memasang Node dulu, langkah itu sekarang bisa dilewati.

5. Login tanpa browser

Jalankan claude (atau claude auth login) dan ikuti petunjuknya. VPS tidak punya browser, jadi Anda membuka URL login di perangkat lain. Claude Code memungkinkan Anda menekan c untuk menyalinnya. Masuk di sana. Saat browser tidak bisa menjangkau callback lokal Claude Code, yang normal lewat SSH, browser akan menampilkan kode. Tempel kode itu di baris Paste code here if prompted dan login selesai di server.

Kredensialnya disimpan di ~/.claude/.credentials.json dengan mode 0600. Perlakukan server itu sesuai: siapa pun yang punya shell sebagai user tersebut bisa memakai langganan Claude Anda. Untuk skrip dan CI, ada juga claude setup-token, yang mencetak token berlaku satu tahun untuk Anda set sebagai CLAUDE_CODE_OAUTH_TOKEN. Menurut dokumentasi autentikasi, token itu hanya bisa membuat request model dan tidak bisa memulai sesi Remote Control.

6. Jaga tetap hidup

Apa pun yang Anda jalankan di foreground sesi SSH akan mati bersama koneksinya. Solusi biasanya adalah tmux:

sudo apt install tmux
tmux new -s work
# start claude, then detach with Ctrl-B then D
tmux attach -t work

Anda bisa detach, kehilangan sinyal, tersambung lagi berjam-jam kemudian dan attach kembali, dan sesinya utuh. Namun tmux tidak bertahan setelah reboot. Setelah reboot, claude --continue melanjutkan percakapan terakhir di direktori itu. Panduan kami tentang menjaga Claude Code tetap berjalan setelah laptop ditutup membahas opsi lainnya, termasuk systemd dan daemon sesi.

7. Server yang sama, lebih banyak agen

Server yang menjalankan Claude Code bisa menjalankan agen coding lain di sampingnya. Masing-masing terpasang di direktori home Anda dan menyimpan login sendiri, jadi tidak saling mengganggu. Sisakan RAM untuk setiap agen yang berjalan bersamaan.

Sumber: autentikasi Codex, dokumentasi OpenCode, dokumentasi Grok Build, pemasangan Antigravity CLI, dicek Oktober 2026. Codex dan Antigravity punya panduan sendiri: Codex CLI di VPS dan Antigravity CLI di server. Gemini CLI tidak lagi menjadi opsi untuk akun Google pribadi, dan Antigravity CLI adalah penggantinya dari Google.

8. Akses dari ponsel

Ada tiga cara, dari yang paling manual sampai yang paling sedikit usaha:

Aplikasi SSH dan tmux. Termius, Blink, atau klien lain, tersambung ke sesi tmux Anda. Gratis dan lengkap, tetapi Anda mengendalikan terminal layar penuh dengan keyboard virtual. Begini perbandingannya.

Remote Control. Jalankan claude remote-control di dalam tmux dan buka sesinya dari tab Code di aplikasi Claude. Fitur ini termasuk dalam Pro, Max, Team, dan Enterprise. Dokumentasi Anthropic menyarankan tmux atau screen persis untuk kasus ini. Hanya berlaku untuk Claude, dan permintaan izin yang muncul di sesi dikirim ke ponsel untuk Anda jawab. Aplikasi tidak bisa mengalihkan sesi ke Auto atau Bypass permissions.

Maude. Maude mengerjakan langkah 4 dan 6 untuk Anda, dan langkah 5 pindah ke ponsel Anda. Anda menambahkan server dengan alamatnya, dengan menempel perintah ssh …, atau dengan memindai kode QR dari curl -fsSL https://maude.pilotdev.fr/setup | sh. Jika Anda login sebagai root, sebuah tombol membuatkan user non-root dari langkah 2. Maude lalu memasang daemon-nya sendiri lewat SSH dan memasang setiap agen pada versi yang sudah kami uji dan kunci. Anda masuk ke Claude, Codex, atau agen lainnya dari ponsel. Sesi tetap berjalan di server saat aplikasi ditutup, dan server yang menghubungi relay Maude, jadi tetap berfungsi di balik NAT tanpa port terbuka.

9. Tentukan izin

Sekarang pertanyaan menariknya: seberapa banyak Anda membiarkannya bekerja tanpa pengawasan? Server yang bisa Anda bangun ulang adalah tempat yang tepat untuk melonggarkan izin, asalkan Anda memang memperlakukannya sebagai sekali pakai. Mode auto Claude Code, di mana classifier menyetujui aksi yang aman, menutup sebagian besar celahnya. Bypass penuh punya aturannya sendiri, termasuk larangan root dari langkah 2. Semuanya dibahas di halaman tersendiri: menjalankan Claude Code dengan izin penuh secara aman.

Jalankan dari ponsel

Setelah server siap, Claude Code di ponsel Anda menjelaskan cara Maude mengendalikannya. Jika Claude bukan satu-satunya agen Anda, mulailah dari ringkasan agen.

Pertanyaan yang sering diajukan

Apa yang berubah

• 1 Oktober 2026 — Pemasangan beralih ke installer native Anthropic (Node.js tidak lagi diperlukan); panduan RAM disesuaikan dengan minimum terdokumentasi 4 GB; alur login headless dengan menempel kode dan setup-token ditambahkan; bagian baru tentang menjalankan Codex, OpenCode, Grok Build, dan Antigravity di server yang sama.
• 25 Juli 2026 — Pertama kali diterbitkan.