PRICINGBLOG
Language

Cara Deploy Aplikasi ke VPS Pakai Claude Code CLI (Panduan Pemula)

Tim Helipod
Published 11 min read

This article is written in Indonesian.

Deploy aplikasi ke VPS pertama kali biasanya penuh hambatan: perintah Linux yang belum hafal, Nginx yang tidak mau jalan, password database yang ditolak, atau port yang lupa dibuka. Semuanya bisa diatasi, tapi butuh waktu lama kalau harus mencari solusi satu per satu.

Claude Code bisa membantu di sini. Claude Code adalah asisten AI berbasis terminal: kamu menulis permintaan dalam bahasa biasa, lalu ia membaca file, menjalankan perintah, dan memperbaiki error langsung di server. Kalau Claude Code dipasang di dalam VPS, kamu bisa minta "pasang aplikasi ini sampai bisa dibuka lewat domain", dan ia mengerjakannya langkah demi langkah sambil meminta izin sebelum menjalankan perintah.

Panduan ini untuk VPS Linux (Ubuntu) dengan IP publik sendiri, misalnya VPS Helipod di Jakarta atau Singapura.

Daftar Isi#

  1. Apa Itu Claude Code dan Apakah Gratis?
  2. Yang Kamu Butuhkan
  3. Masuk ke VPS dan Buat User Baru
  4. Install Claude Code CLI di VPS
  5. Hubungkan ke Helipod AI Gateway
  6. Siapkan Kode Aplikasi di VPS
  7. Minta Claude Code Melakukan Deploy
  8. Panduan Menulis Prompt untuk Deploy
  9. Pasang Domain dan HTTPS
  10. Aturan Aman Memakai AI di Server
  11. Troubleshooting
  12. FAQ

1. Apa Itu Claude Code dan Apakah Gratis?#

Claude Code adalah aplikasi command line (CLI) yang menjalankan AI langsung di terminal. Bedanya dengan chatbot biasa: Claude Code bisa bertindak, bukan hanya menjawab. Ia bisa membuka file konfigurasi, menjalankan apt install, membaca log error, lalu mencoba perbaikan berikutnya.

Aplikasi Claude Code-nya sendiri gratis dipasang. Yang berbayar adalah model AI yang dipakai untuk berpikir. Secara bawaan Claude Code meminta akun berbayar dengan tagihan dalam dolar. Di panduan ini kita mengarahkannya ke Helipod AI Gateway, jadi modelnya dibayar per token dari saldo AI dalam Rupiah, mulai Rp5.000.

2. Yang Kamu Butuhkan#

  • VPS Linux Ubuntu 22.04 atau 24.04 dengan IP publik. Untuk aplikasi dengan database, pilih minimal RAM 2 GB. Kalau belum punya, lihat VPS Linux Helipod.
  • Akses SSH ke VPS (IP, user, password). Belum pernah SSH? Ikuti dulu cara akses VPS Linux via SSH.
  • Kode aplikasi kamu, idealnya di GitHub atau GitLab.
  • API key Helipod AI (diawali hel_ai_) dan saldo AI. Buat di menu AI Gateway → API keys di dashboard.
  • (Opsional) Domain, kalau aplikasi mau dibuka lewat nama domain, bukan IP.

Cek juga tab Firewall di halaman VPS kamu. Port 22 (SSH), 80 (HTTP), dan 443 (HTTPS) harus terbuka. Di VPS Helipod ketiganya sudah terbuka secara bawaan, tapi kalau kamu pernah mengubah aturannya, pastikan masih ada.

3. Masuk ke VPS dan Buat User Baru#

Login ke VPS dari terminal (PowerShell di Windows, Terminal di Mac):

ssh root@IP_VPS_KAMU

Jangan menjalankan Claude Code sebagai root. Buat user biasa yang boleh memakai sudo, supaya setiap perintah berbahaya tetap butuh konfirmasi:

adduser deploy
usermod -aG sudo deploy
su - deploy

Mulai dari sini, semua langkah dijalankan sebagai user deploy.

4. Install Claude Code CLI di VPS#

Pasang Claude Code dengan installer resmi:

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

Setelah selesai, muat ulang PATH lalu cek versinya:

source ~/.bashrc
claude --version

Kalau muncul nomor versi, Claude Code sudah terpasang. Kalau muncul claude: command not found, jalankan export PATH="$HOME/.local/bin:$PATH" lalu coba lagi.

5. Hubungkan ke Helipod AI Gateway#

Claude Code membaca alamat API dan API key dari file ~/.claude/settings.json. Buat file-nya:

mkdir -p ~/.claude
nano ~/.claude/settings.json

Isi dengan:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.helipod.io",
    "ANTHROPIC_AUTH_TOKEN": "hel_ai_xxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "glm-5.3",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4.1-flash"
  }
}

Simpan dengan Ctrl+O, Enter, lalu keluar dengan Ctrl+X. Kunci file supaya hanya user kamu yang bisa membacanya:

chmod 600 ~/.claude/settings.json

Catatan penting:

  • ANTHROPIC_BASE_URL diisi tanpa /v1 di belakang.
  • glm-5.3 adalah model utama yang kuat untuk pekerjaan banyak langkah seperti deploy. Model lain dan harganya ada di daftar harga AI Gateway.
  • Di dashboard, beri API key ini batas belanja bulanan, misalnya Rp100.000, supaya pemakaian tidak melewati rencana.

Langkahnya sama dengan memasang Claude Code di laptop. Kalau mau memakai Claude Code di Windows juga, ikuti panduan Claude Code di Windows.

6. Siapkan Kode Aplikasi di VPS#

Ambil kode aplikasi ke VPS. Dari GitHub:

sudo apt update && sudo apt install -y git
git clone https://github.com/username/nama-repo.git ~/app
cd ~/app

Untuk repository privat, buat deploy key atau personal access token di GitHub, jangan memakai password akun.

Kalau kode masih di laptop dan belum ada di GitHub, kirim dengan scp dari laptop:

scp -r ./folder-aplikasi deploy@IP_VPS_KAMU:~/app

7. Minta Claude Code Melakukan Deploy#

Jalankan Claude Code di folder aplikasi:

cd ~/app
claude

Cek dulu koneksinya dengan /status, pastikan alamat API-nya https://ai.helipod.io. Lalu tulis permintaan yang jelas. Semakin lengkap konteksnya, semakin sedikit tebakan yang dibuat AI. Contoh untuk aplikasi Node.js atau Laravel:

Ini server Ubuntu 24.04 kosong dengan IP publik sendiri. Tolong deploy aplikasi di folder ini sampai bisa dibuka dari browser lewat http://IP_VPS.

- Baca dulu README dan file konfigurasi untuk tahu aplikasi ini butuh apa.
- Pasang dependensi yang dibutuhkan (runtime, database, Nginx).
- Buat database dan user database baru dengan password acak, simpan di file .env, jangan tampilkan password di layar.
- Jalankan aplikasi sebagai service yang otomatis hidup lagi setelah reboot (systemd atau pm2).
- Pasang Nginx sebagai reverse proxy di port 80.
- Jelaskan setiap langkah sebelum menjalankannya, dan tanyakan dulu sebelum menghapus atau menimpa file.

Untuk aplikasi dengan installer interaktif, misalnya aplikasi ERP yang meminta host, port, nama database, user, dan password PostgreSQL, sebutkan juga:

Aplikasi ini butuh PostgreSQL. Installer-nya meminta nama database, user, dan password. Siapkan PostgreSQL lokal, buat user dan database yang cocok, lalu pastikan login dengan password tersebut berhasil sebelum menjalankan installer.

Selama bekerja, Claude Code akan menampilkan setiap perintah dan meminta persetujuan. Baca sebentar sebelum menekan Yes. Kalau ada error, kamu tidak perlu menyalin log ke mesin pencari: Claude Code membaca error-nya sendiri, menjelaskan penyebabnya, lalu mengusulkan perbaikan.

Setelah selesai, buka http://IP_VPS_KAMU di browser. Kalau halaman aplikasi muncul, deploy berhasil.

8. Panduan Menulis Prompt untuk Deploy#

Hasil kerja Claude Code sangat bergantung pada prompt yang kamu tulis. Prompt yang samar seperti "deploy aplikasi ini" membuat AI menebak banyak hal: versi runtime, jenis database, port, sampai cara menjalankan aplikasi. Prompt yang baik menjawab pertanyaan-pertanyaan itu dari awal.

Lima hal yang selalu ditulis di prompt#

  1. Kondisi server. Sistem operasi, apakah server masih kosong atau sudah ada aplikasi lain, dan apakah sudah ada domain.
  2. Aplikasi apa. Bahasa dan framework (Laravel, Node.js, Django, Next.js), plus database yang dipakai.
  3. Hasil akhir yang diinginkan. Misalnya "bisa dibuka lewat http://IP_VPS" atau "lewat https://domain".
  4. Batasan. Hal yang tidak boleh dilakukan, misalnya tidak boleh menghapus data lama, tidak boleh mengubah aplikasi lain, atau port tertentu sudah dipakai.
  5. Cara kerja. Minta Claude Code menjelaskan rencana dulu, lalu meminta persetujuan sebelum perintah yang mengubah atau menghapus sesuatu.

Template prompt deploy#

Salin template ini, lalu ganti bagian dalam kurung siku:

Konteks:
- Server: Ubuntu [24.04], [kosong / sudah ada aplikasi lain di port ...]
- Aplikasi: [framework, misalnya Laravel 11 / Node.js 22 / Django 5]
- Database: [PostgreSQL / MySQL / tidak ada]
- Domain: [belum ada / aplikasi.contoh.id sudah mengarah ke IP server]

Tujuan:
Deploy aplikasi di folder ini sampai bisa dibuka lewat [http://IP_VPS / https://domain].

Batasan:
- Jangan hapus atau timpa file di luar folder ini tanpa bertanya.
- Simpan semua password dan secret di file .env, jangan tampilkan di layar.
- [batasan lain]

Cara kerja:
1. Baca README dan file konfigurasi, lalu tulis rencana langkah demi langkah.
2. Tunggu persetujuan saya sebelum mulai.
3. Setelah selesai, tulis ringkasan: apa yang dipasang, lokasi konfigurasi, dan perintah untuk restart aplikasi.

Langkah "tulis rencana dulu" penting. Kamu bisa mengoreksi rencana yang keliru sebelum ada perubahan di server, dan ringkasan di akhir berguna sebagai catatan kalau suatu hari harus memperbaiki sendiri.

Prompt siap pakai untuk pekerjaan sehari-hari#

Memperbaiki error

Aplikasi menampilkan error 502 Bad Gateway. Cari penyebabnya dari log Nginx dan log aplikasi, jelaskan penyebabnya, lalu usulkan perbaikan sebelum menjalankannya.

Update setelah ada perubahan kode

Saya baru push perubahan ke branch main. Tarik perubahan terbaru, pasang dependensi baru kalau ada, jalankan migrasi database kalau ada, lalu restart aplikasi. Hentikan dan tanya saya kalau migrasi akan menghapus data.

Cek kondisi server

Cek kondisi server: pemakaian RAM, disk, dan CPU, status service aplikasi, Nginx, dan database, serta apakah sertifikat HTTPS akan kedaluwarsa dalam 30 hari. Jangan ubah apa pun, cukup laporkan.

Backup database

Buat backup database aplikasi ke folder ~/backups dengan nama file berisi tanggal, lalu jadwalkan backup otomatis setiap hari jam 02.00 dan hapus backup yang lebih lama dari 7 hari.

Kesalahan prompt yang sering terjadi#

  • Terlalu singkat. "Deploy dong" memaksa AI menebak. Tambahkan konteks dari lima poin di atas.
  • Menempelkan secret. Jangan menulis password database atau token di prompt. Minta AI membuatnya dan menyimpannya di .env.
  • Meminta semuanya sekaligus. Untuk aplikasi besar, pecah menjadi beberapa permintaan: siapkan server dulu, lalu database, lalu aplikasi, lalu domain dan HTTPS. Error lebih mudah dilacak.
  • Langsung menyetujui semua perintah. Kalau ada perintah yang tidak kamu pahami, tanyakan dulu: "jelaskan perintah ini sebelum dijalankan".

9. Pasang Domain dan HTTPS#

Kalau punya domain, arahkan dulu record A domain ke IP VPS di pengaturan DNS. Domain yang dibeli di Helipod bisa diatur di menu Domain → DNS. Tunggu beberapa menit sampai DNS aktif, lalu minta Claude Code:

Domain aplikasi.contoh.id sudah mengarah ke IP server ini. Ubah konfigurasi Nginx untuk domain tersebut dan pasang sertifikat HTTPS gratis dengan certbot, termasuk perpanjangan otomatis.

Setelah itu aplikasi bisa dibuka lewat https://aplikasi.contoh.id. Link inilah yang bisa kamu kirim ke dosen, klien, atau tim.

10. Aturan Aman Memakai AI di Server#

Claude Code bekerja dengan hak akses user kamu di server sungguhan, jadi ikuti aturan berikut:

  • Jangan jalankan sebagai root, dan jangan memakai mode yang melewati persetujuan perintah.
  • Baca perintah sebelum menyetujui, terutama rm, chmod -R, DROP DATABASE, atau perubahan firewall.
  • Jangan menempelkan password atau token di chat. Minta Claude Code membuat password acak dan menyimpannya di file .env.
  • Buat snapshot atau backup sebelum perubahan besar, supaya bisa kembali kalau ada yang salah.
  • Batasi biaya dengan batas belanja bulanan di API key, dan tutup sesi dengan /exit kalau sudah selesai.

11. Troubleshooting#

Halaman tidak bisa dibuka dari browser Cek tab Firewall di dashboard, pastikan port 80 dan 443 terbuka. Lalu minta Claude Code: "cek kenapa port 80 tidak bisa diakses dari luar". Ia akan memeriksa Nginx, service aplikasi, dan firewall di dalam server (ufw).

password authentication failed for user ... di PostgreSQL Artinya user atau password database tidak cocok dengan yang dipakai aplikasi. Minta Claude Code: "buat ulang user PostgreSQL ini dengan password baru dan samakan dengan konfigurasi aplikasi, lalu tes login dengan psql".

Error 401 atau Claude Code meminta login Anthropic Isi ~/.claude/settings.json belum terbaca atau API key salah. Cek isinya dengan cat ~/.claude/settings.json dan pastikan format JSON valid.

Error 402 Saldo AI habis atau batas belanja bulanan key tercapai. Isi saldo AI di menu AI Gateway.

Aplikasi mati setelah VPS restart Aplikasi belum dijalankan sebagai service. Minta Claude Code: "jadikan aplikasi ini service systemd yang otomatis jalan saat boot".

12. FAQ#

Apakah ini memakai model Claude buatan Anthropic? Tidak. Yang dipakai adalah aplikasi Claude Code, sedangkan modelnya dari katalog Helipod AI Gateway seperti GLM, DeepSeek, dan Kimi.

Berapa biaya AI untuk satu kali deploy? Tergantung ukuran aplikasi dan berapa banyak error yang harus diperbaiki. Pemakaian dihitung per token dan tercatat di menu AI Gateway → Usage, lengkap dengan biaya dalam Rupiah. Batas belanja bulanan di API key menjaga pengeluaran tetap terkendali.

Apakah harus bisa Linux? Tidak harus mahir, tapi tetap baca setiap perintah sebelum menyetujuinya. Anggap Claude Code sebagai rekan yang menjelaskan sambil mengerjakan, sehingga kamu ikut belajar.

Bisa dipakai untuk aplikasi apa saja? Bisa untuk aplikasi web umum seperti Node.js, Laravel, Django, Next.js, WordPress, sampai aplikasi dengan installer sendiri seperti ERP. Panduan umum tentang jenis-jenis deploy ada di cara deploy website.

Bagaimana kalau tidak mau mengurus server sama sekali? Pakai container di Helipod: hubungkan repository GitHub, dan aplikasi di-build serta di-deploy otomatis tanpa mengurus Nginx atau SSL.


Siap mencoba? Siapkan VPS Ubuntu, buat API key di menu AI Gateway, isi saldo AI mulai Rp5.000, lalu biarkan Claude Code membantu deploy aplikasi pertamamu. Daftar model dan harga ada di helipod.io/ai-gateway.

Blog

Related articles

View all

Ready to try Helipod?

Deploy your app now. Free, no credit card required.
WhatsApp