Hampir semua tutorial Claude Code berhenti di satu baris npm install, lalu menganggap pekerjaan selesai. Masalahnya, terminal yang sudah berhasil login belum tentu sanggup menyelesaikan tugas pertama. Saya menulis ini karena dua hal itu sering tertukar, dan orang akhirnya menginstal ulang berkali-kali untuk persoalan yang sama sekali bukan soal instalasi.
Urutan di bawah ini persis seperti yang saya kerjakan setiap kali menyiapkan mesin baru: cek dulu, baru pasang, login, lalu pastikan jalur ke API benar-benar mulus sebelum mengandalkannya untuk kerja nyata.
Dua hasil yang sering dikira satu
"Berhasil dipasang" dan "berhasil dijalankan" bukan hal yang sama. Yang pertama cuma soal lingkungan lokal dan perintah yang benar. Yang kedua ikut bergantung pada ruas jaringan antara mesin Anda dan API Anthropic.
Akibatnya jelas di lapangan. Seseorang melihat CLI bisa login, mengetik prompt, lalu menunggu jawaban yang tak kunjung datang, lalu menyimpulkan "instalasinya rusak" dan mengulang dari awal. Padahal rute yang lambat tidak akan sembuh meski dipasang ulang seratus kali. Begitu Anda memisahkan dua kemungkinan ini sejak awal, penelusuran masalah jadi jauh lebih cepat.
Soal sistem operasi pengaruhnya kecil. Di macOS dan Linux Anda bekerja langsung di terminal bawaan. Di Windows, banyak pengembang menjalankan Claude Code di dalam WSL supaya perilaku perkakas baris perintah konsisten dengan Linux. Selebihnya, empat langkah intinya identik: periksa, pasang, login, stabilkan koneksi. Dan langkah terakhir itulah yang biasanya menentukan rasa keseluruhannya.
Periksa lingkungan sebelum mengetik apa pun
Claude Code jalan di macOS, Linux, dan Windows. Paket npm-nya menuntut Node.js versi 18 ke atas. Kalau Anda mulai dari nol, ambil Node.js 22 LTS saja, itu kombinasi yang sudah banyak dipakai dan jarang bikin masalah.
Satu perintah untuk memastikan:
node --versionharus menampilkan 18 atau lebih tinggi. Kalau angkanya di bawah itu, semua langkah berikutnya percuma.- Anda butuh akun berbayar yang memenuhi syarat. CLI ini tidak ikut dalam paket web gratis, jadi konfirmasikan dulu sebelum repot memasang.
Sebagian besar kegagalan instalasi yang saya temui ujung-ujungnya cuma versi Node yang tidak cocok, bukan hal yang rumit. Membereskannya di awal menghemat banyak waktu di belakang.
npm atau installer native, mana untuk Anda
Ada dua jalur resmi, dan keduanya sah.
Installer native tidak butuh dependensi apa pun dan memperbarui dirinya sendiri di latar. Untuk satu workstation, ini jalur paling ringkas.
Jalur npm lewat npm install -g @anthropic-ai/claude-code cocok kalau Anda memang sudah mengelola toolchain Node sehari-hari. Satu aturan yang tidak boleh dilanggar: jangan awali perintah npm dengan sudo. Kalau muncul galat izin, jangan dipaksa pasang sebagai root. Pakai manajer versi Node seperti nvm supaya paket global mendarat di ruang pengguna, dan galatnya hilang dengan sendirinya.
Login, lalu buktikan sampai ujung
Jalankan claude dan selesaikan alur login yang diminta. Setelah itu jangan langsung percaya bahwa semua beres, buktikan dulu.
- Jalankan
claude --versionuntuk memastikan binernya benar-benar terpasang. - Di dalam sesi, ketik
/doctor. Perintah ini menangkap masalah konfigurasi sebelum sempat mengganggu. - Kirim prompt paling sepele yang bisa Anda pikirkan, misalnya minta daftar berkas di direktori ini, lalu perhatikan apakah balasannya datang dengan wajar.
Kalau pulang-pergi itu selesai bersih, instalasi Anda solid. Tapi kalau Anda bisa login dan justru permintaan nyata pertama yang menggantung, instalasinya sebenarnya tidak salah. Bagian berikutnya ditulis persis untuk kasus itu.
Langkah jaringan yang nyaris selalu dilewatkan
Run pertama sebuah agent melibatkan banyak pulang-pergi ke API. Satu hop yang macet sudah cukup membuat seluruh sesi terasa membeku, padahal CLI-nya sehat dan login-nya sempurna.
Cek patokannya sederhana: ping satu kali ke host API. Kalau Anda jauh secara geografis dan angka latensinya tinggi serta tidak stabil, di situlah hambatannya, bukan di kode atau di akun. Mengarahkan lalu lintas lewat rute yang dioptimalkan untuk koneksi pengembang akan membuat run pertama selesai seperti seharusnya. NasaCode menyediakan node latensi rendah untuk keperluan ini, sehingga mesin yang baru dipasang berperilaku sama entah server-nya sebelah Anda atau terpisah satu benua.
Empat metode berdampingan
| Metode | Dependensi | Pembaruan | Paling pas untuk | Catatan |
|---|---|---|---|---|
| Installer native | Tidak ada | Otomatis di latar | Satu workstation, mulai paling cepat | Pilihan default |
| npm global | Node.js 18+ | Pasang ulang manual | Sudah punya toolchain Node | Tanpa sudo |
| Manajer versi (nvm) | nvm dan sejenis | Manual, terisolasi | Beberapa versi Node sekaligus | Paling bersih saat kena galat izin |
| Salah satu di atas plus rute NasaCode | Mengikuti metode dasar | Mengikuti metode dasar | Jaringan jauh atau tidak stabil | Menjaga run pertama tetap jalan |
Beberapa pertanyaan yang sering muncul
Apakah Claude Code bisa dipakai dengan akun gratis?
Tidak. Anda perlu paket berbayar yang memenuhi syarat atau akses konsol. Pastikan status akun sebelum memasang supaya tidak terhenti di layar login.
npm saya gagal dengan galat izin, kenapa?
Biasanya karena perintah dijalankan dengan hak tinggi atau memasang ke Node milik sistem. Pasang ulang lewat manajer versi, paket global akan mendarat di ruang pengguna dan galatnya hilang.
Sudah terpasang dan bisa login, tapi perintah pertama diam saja.
Instalasinya tidak bermasalah, koneksinya yang bermasalah. Ukur latensi ke host API. Kalau tinggi, rute jaringan Anda penyebabnya, dan rute yang dioptimalkan membuat run agent selesai.
Untuk pemula sebaiknya pilih yang mana?
Mulai dari installer native, gesekannya paling kecil. Pindah ke npm atau manajer versi hanya kalau ada alasan konkret, misalnya Anda memang mengelola beberapa versi Node.
Instalasi Claude Code yang benar itu empat langkah, bukan satu baris perintah: konfirmasi syaratnya, pasang dengan metode yang cocok, login lalu uji dengan prompt sepele, dan rapikan rute ke API sebelum benar-benar mengandalkannya. Lewatkan yang terakhir, dan instalasi paling sempurna pun bisa terasa rusak di tugas nyata pertama.
Kalau Anda memang ingin sesi pertama langsung enak, pasang klien NasaCode berbarengan dengan Claude Code, supaya koneksinya stabil sejak run pertama dan seterusnya.
