Claude Code Seri Tutorial 5: Bagaimana Cara Menginstal Claude Code?

Cara Menginstal Claude Code

Instalasi Claude Code tidak memiliki antarmuka grafis seperti "Berikutnya"; semuanya dilakukan di baris perintah. Jika Anda terbiasa menggunakan npm, seluruh proses tidak akan lebih dari dua menit.

Prasyarat

Sebelum memulai, pastikan Anda memiliki hal-hal berikut:

Node.js 18 atau lebih baru
Cara memeriksa: jalankan node -v di terminal. Jika versinya di bawah 18, upgrade menggunakan nvm, fnm, atau langsung dari nodejs.org.
Akun Anthropic
Alamat pendaftaran: https://console.anthropic.com. Akun akan menyediakan API Key yang diperlukan setelah instalasi. Pendaftaran gratis, biaya aktual dihitung berdasarkan penggunaan.
Jaringan dapat mengakses endpoint API Anthropic
Domain bawaan adalah api.anthropic.com. Jika lingkungan perlu mengonfigurasi proxy, pastikan untuk mengatur HTTP_PROXY atau HTTPS_PROXY di terminal.

Metode Instalasi 1: Instalasi Global npm

Ini adalah cara yang paling umum; sekali instal, bisa digunakan di mana saja.

npm install -g @anthropic-ai/claude-code

Setelah selesai, jalankan claude --version. Jika nomor versi muncul, instalasi berhasil. Setelah instalasi global, perintah claude dapat dipanggil langsung dari direktori mana pun.

Jika mengalami kesalahan izin (sering terjadi di direktori /usr/local/lib macOS), ada dua cara penanganan:

Gunakan sudo untuk menginstal (praktis tapi kontroversial dari segi keamanan).
Konfigurasikan npm untuk menggunakan direktori pengguna, hindari sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Kemudian tambahkan ~/.npm-global/bin ke PATH, dan buka ulang terminal.

Metode Instalasi 2: npx Sekali Pakai

Jika Anda tidak ingin menginstal apa pun secara global, atau hanya ingin mencoba sementara, npx lebih langsung.

npx @anthropic-ai/claude-code

npx akan mengunduh paket terbaru secara sementara, menjalankannya, dan tidak meninggalkan perintah global. Setiap kali digunakan akan memeriksa pembaruan, sehingga selalu dalam versi terbaru. Kekurangannya adalah sedikit lebih lambat (harus mengunduh setiap kali) dan tidak cocok untuk dipanggil sering dalam skrip otomatis.

Cocok untuk: pengalaman pertama, penggunaan sementara di mesin orang lain, atau penggunaan sesekali.

Verifikasi Apakah Dapat Berjalan Normal

Setelah instalasi, jangan terburu-buru melakukan otentikasi. Jalankan satu perintah sederhana untuk melihat apakah alat dapat berjalan:

claude --help

Jika informasi bantuan muncul, berarti file biner berfungsi. Langkah selanjutnya adalah menghubungkan akun Anda, yang akan dibahas nanti.

Dua metode instalasi menghasilkan entitas yang sama; otentikasi dan penggunaan selanjutnya sepenuhnya identik. Pilih yang menurut Anda nyaman.

Pertanyaan Umum

Versi Node terlalu rendah
Di bawah 18 akan langsung error, bukan peringatan. Upgrade Node adalah solusi paling langsung.
Waktu jaringan habis
Baik saat npm mengunduh paket maupun saat menghubungkan API, bisa terhalang oleh proxy atau firewall. Pastikan curl https://api.anthropic.com dapat diakses sebelum melanjutkan.
Menggunakan cmd asli di Windows
Meskipun secara teoritis bisa, disarankan menggunakan Git Bash, WSL2, atau Windows Terminal untuk menghindari masalah aneh dengan escape path.