Cara Menginstal Claude Code: Panduan Mac, Windows & Linux

Ringkasan: Claude Code terinstal sebagai paket npm dalam waktu kurang dari 5 menit di Mac, Windows, atau Linux. Anda memerlukan Node.js 18+ dan akses FreeClaude aktif. Panduan ini mencakup instalasi untuk setiap platform, pengaturan pasca-instalasi, sesi pertama Anda, perintah penting, dan pemecahan masalah umum.

Apa itu Claude Code?

Claude Code adalah asisten pengkodean AI berbasis terminal dari Anthropic — dan secara kategoris berbeda dari alat AI berbasis browser atau plugin IDE. Alih-alih menempelkan potongan kode ke jendela obrolan dan menerapkan perubahan secara manual, Claude Code beroperasi langsung di terminal Anda dengan akses penuh ke sistem file, perintah shell, dan alat pengembangan Anda.

Ini berarti Claude Code dapat:

• Membaca seluruh struktur proyek Anda dan memahaminya sebelum membuat perubahan
• Membuat, memodifikasi, dan menghapus file langsung di mesin Anda
• Menjalankan rangkaian uji Anda, melihat kegagalan, dan memperbaikinya secara otomatis
• Menjalankan perintah git, alat build, dan perintah shell apa pun
• Membuat perubahan terkoordinasi di lusinan file dalam satu sesi
• Membuat komit dengan pesan bermakna yang menjelaskan alasan di balik perubahan

Bagi pengembang profesional, ini mengubah AI dari pembantu salin-tempel menjadi mitra pengembangan otonom yang sesungguhnya.

Prasyarat

Sebelum menginstal Claude Code, pastikan Anda memiliki hal-hal berikut:

Jika Anda belum memiliki akses FreeClaude aktif, kunjungi freeclaude.io dan selesaikan referral pertama Anda untuk membuka unduhan.

Instalasi macOS

Langkah 1: Instal Node.js (jika diperlukan)

Buka Terminal (tekan Cmd + Space, ketik "Terminal", tekan Enter). Periksa apakah Node.js sudah terinstal:

node --version

Jika Anda melihat versi di bawah 18.x atau melihat "command not found", instal Node.js menggunakan fnm (Fast Node Manager):

curl -fsSL https://fnm.vercel.app/install | bash

Tutup dan buka kembali Terminal, lalu jalankan:

fnm install --lts

Langkah 2: Instal Claude Code

Dengan Node.js siap, instal Claude Code secara global via npm:

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

Langkah 3: Autentikasi

Jalankan claude di terminal Anda. Pada peluncuran pertama, Anda akan diminta untuk mengautentikasi dengan kredensial FreeClaude Anda. Ikuti instruksi di layar — biasanya jendela browser terbuka untuk autentikasi OAuth.

Apple Silicon (M1/M2/M3/M4) vs Intel

Metode instalasi npm berfungsi identik di kedua arsitektur — npm mendeteksi chip Anda dan menginstal biner yang benar secara otomatis.

Instalasi Windows

Langkah 1: Instal Node.js

Buka PowerShell sebagai Administrator (klik kanan tombol Start, pilih "Windows PowerShell (Admin)"). Periksa Node.js: node --version

Jika belum terinstal, gunakan winget:

winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements

Tutup PowerShell sepenuhnya dan buka kembali sebagai Administrator. Verifikasi: node --version

Langkah 2: Instal Claude Code

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

Jika Anda mengalami kesalahan kebijakan eksekusi PowerShell, jalankan ini terlebih dahulu:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Langkah 3: Rekomendasi Terminal Windows

Untuk pengalaman Claude Code terbaik di Windows, gunakan Windows Terminal (tersedia gratis dari Microsoft Store) dengan PowerShell 7. WSL (Windows Subsystem for Linux) juga berfungsi dengan baik.

Instalasi Linux

Ubuntu/Debian

Periksa versi Node.js: node --version

Jika di bawah 18 atau tidak ada, instal via NodeSource:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

Kemudian instal Claude Code: sudo npm install -g @anthropic-ai/claude-code

Fedora/RHEL/CentOS

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo dnf install -y nodejs
sudo npm install -g @anthropic-ai/claude-code

Arch Linux

sudo pacman -S nodejs npm
sudo npm install -g @anthropic-ai/claude-code

Pengaturan Pasca-Instalasi

Setelah menginstal, selesaikan langkah-langkah ini sebelum sesi pengkodean pertama Anda:

1. Buka jendela terminal baru — Ini penting. Entri PATH baru yang ditambahkan oleh instalasi npm hanya berlaku pada sesi terminal baru.
2. Verifikasi instalasi — Ketik claude --version dan konfirmasi nomor versi muncul.
3. Jalankan autentikasi awal — Ketik claude dan ikuti petunjuk autentikasi. Ini menghubungkan Claude Code ke akun FreeClaude Anda.
4. Konfigurasi git (jika belum dilakukan) — git config --global user.name "Nama Anda" dan git config --global user.email "anda@contoh.com"

Sesi Claude Code Pertama Anda

Navigasikan ke proyek yang sedang Anda kerjakan dan mulai Claude Code:

cd ~/proyek-saya
claude

Untuk sesi pertama Anda, coba prompt pengantar ini:

• "Baca proyek ini dan berikan ringkasan arsitektur, komponen utama, dan masalah apa pun yang Anda perhatikan"
• "Tunjukkan cakupan uji dan identifikasi area tanpa uji"
• "Temukan komentar TODO atau pernyataan console.log yang tertinggal dalam kode"
• "Dependensi apa yang sudah usang dan pembaruan mana yang aman untuk diterapkan?"

Referensi Perintah Penting

Konfigurasi dan Kustomisasi

Claude Code membaca file CLAUDE.md dari root proyek Anda jika ada. File ini bertindak sebagai set instruksi persisten yang dimuat Claude Code di awal setiap sesi dalam proyek tersebut. Anda dapat menggunakannya untuk menentukan:

• Konvensi proyek, pola penamaan, dan preferensi gaya kode
• Persyaratan pengujian dan ekspektasi cakupan
• Prosedur deployment dan catatan infrastruktur
• Jalur file yang tidak boleh dimodifikasi

Jalankan /init di proyek apa pun untuk meminta Claude Code menghasilkan CLAUDE.md awal secara otomatis.

Pemecahan Masalah

"command not found: claude"

Tutup dan buka kembali terminal Anda. Jika masalah berlanjut, periksa direktori bin global npm ada di PATH Anda:

npm config get prefix

Tambahkan jalur output dengan /bin yang ditambahkan ke profil shell Anda (~/.zshrc, ~/.bashrc, atau yang setara).

"Authentication failed" atau "Unauthorized"

Periksa dashboard FreeClaude Anda untuk mengonfirmasi timer akses Anda aktif. Jika timer telah kedaluwarsa, undang teman lain untuk memperpanjangnya. Jika timer aktif tetapi autentikasi masih gagal, coba jalankan claude logout diikuti claude login.

Respons lambat atau timeout

Claude Code memerlukan koneksi internet yang stabil untuk berkomunikasi dengan server Anthropic. Periksa kualitas koneksi Anda.

Kesalahan izin saat menginstal di Mac/Linux

Hindari menggunakan sudo npm install -g karena dapat menyebabkan masalah izin. Sebagai gantinya, konfigurasikan npm untuk menggunakan direktori yang dapat ditulis pengguna:

mkdir ~/.npm-global
npm config set prefix ~/.npm-global
Kemudian tambahkan export PATH=~/.npm-global/bin:$PATH ke profil shell Anda.

Pertanyaan yang Sering Diajukan

Apakah Claude Code bekerja secara offline?

Tidak. Claude Code mengirim konteks kode Anda ke server Anthropic untuk pemrosesan AI. Koneksi internet yang stabil diperlukan sepanjang semua sesi.

Apakah kode saya dikirim ke Anthropic saat menggunakan Claude Code?

Ya. Konten file yang dibaca Claude Code dikirim ke API Anthropic untuk diproses. Kebijakan privasi Anthropic berlaku. Jangan gunakan Claude Code pada file yang berisi rahasia, kredensial, atau informasi sensitif tanpa meninjau kebijakan penanganan data Anthropic.

Versi Node.js apa yang diperlukan Claude Code?

Node.js 18.0 atau lebih tinggi diperlukan. Node.js 20 LTS atau Node.js 22 LTS direkomendasikan untuk pengalaman terbaik.

Bagaimana cara memperbarui Claude Code?

Jalankan npm update -g @anthropic-ai/claude-code untuk memperbarui ke versi terbaru.

Butuh Bantuan?

Jika Anda mengalami masalah instalasi atau penggunaan yang tidak tercakup di sini, hubungi tim dukungan kami melalui bot Telegram FreeClaude. Atau kunjungi panduan memulai kami jika Anda perlu bantuan mengaktifkan akun FreeClaude Anda terlebih dahulu.