Tekan / ke atas
Modul Setup

Panduan Install Claude Code

Ikuti langkah demi langkah untuk memasang dan menyediakan Claude Code di komputer anda. Sesuai untuk Windows dan macOS.

5
Langkah Utama
~10 min
Masa Pemasangan
2 OS
Windows & Mac
⚙
1. Keperluan Sistem (Pre-requisites)
Pastikan komputer anda memenuhi syarat minima ini

i Node.js versi 18 atau lebih baru

Claude Code berjalan di atas Node.js. Anda perlukan versi 18 ke atas (versi LTS terkini amat disarankan).

Tip: Nak tahu versi Node.js semasa? Buka terminal dan taip node --version. Jika tiada, anda perlu muat turun dan pasang Node.js.

ii Git

Git digunakan oleh Claude Code untuk berinteraksi dengan repositori kod. Muat turun dari git-scm.com atau gunakan git --version untuk semak.

iii VS Code (Optional tetapi disarankan)

Visual Studio Code adalah editor kod yang sangat sesuai digunakan bersama Claude Code. Muat turun dari code.visualstudio.com.

iv Terminal / Command Prompt

Anda akan banyak menggunakan terminal. Di Windows guna PowerShell atau Command Prompt. Di Mac guna Terminal (cari di Applications > Utilities).

⌧
2. Langkah Pemasangan
Pilih sistem operasi anda untuk panduan yang sesuai

1 Muat Turun Node.js

Pergi ke nodejs.org dan klik butang hijau "LTS" untuk muat turun versi stabil terkini untuk Windows.

Penting: Pilih versi LTS (Long Term Support), bukan versi Current. Versi LTS lebih stabil.

2 Pasang Node.js

Buka file .msi yang telah dimuat turun. Ikut langkah berikut:

  • Klik Next pada welcome screen
  • Tandakan "I accept the terms" dan klik Next
  • Biarkan destinasi pemasangan seperti default
  • Pastikan "Add to PATH" dipilih — ini penting!
  • Klik Install dan tunggu selesai
Selesai: Buka PowerShell atau Command Prompt baru untuk langkah seterusnya.

3 Verify Node.js Installation

Buka terminal (PowerShell / Command Prompt) dan taip:

node --version

Anda sepatutnya nampak output seperti:

v18.20.4 # atau v20.x / v22.x
Tip: Nombor versi mesti 18 atau lebih tinggi. Jika lower, muat turun versi terbaru.

4 Install Claude Code

Dalam terminal yang sama, jalankan arahan ini:

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

Flag -g bermaksud "global" — ia membolehkan claude command diakses dari mana-mana folder.

Nota: Proses ini mungkin mengambil masa 30-60 saat bergantung pada kelajuan internet anda.

5 Verify Claude Code Installation

Selepas selesai, verify dengan arahan:

$ claude --version

Output sepatutnya menunjukkan versi Claude Code:

0.x.y # Contoh: 0.4.0 atau lebih baru
Tahniah! Claude Code sudah dipasang pada Windows anda!

1 Muat Turun Node.js

Pergi ke nodejs.org dan klik butang hijau "LTS" untuk muat turun versi stabil terkini untuk macOS.

Penting: Pilih versi LTS (Long Term Support), bukan versi Current. Pilih pakej .pkg untuk Mac.

2 Pasang Node.js

Buka file .pkg yang telah dimuat turun. Ikut langkah berikut:

  • Klik Continue pada welcome screen
  • Klik Continue pada license agreement
  • Klik Install dan masukkan password Mac anda
  • Tunggu proses pemasangan selesai
  • Klik Close

3 Verify Node.js Installation

Buka Terminal (Applications > Utilities > Terminal) dan taip:

node --version

Anda sepatutnya nampak output seperti:

v18.20.4 # atau v20.x / v22.x
Tip: Nombor versi mesti 18 atau lebih tinggi. Jika lower, muat turun versi terbaru.

4 Install Claude Code

Dalam terminal yang sama, jalankan arahan ini:

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

Flag -g bermaksud "global" — ia membolehkan claude command diakses dari mana-mana folder.

Nota Mac: Jika anda nampak ralat "EACCES" atau permission denied, lihat bahagian Troubleshooting di bawah.

5 Verify Claude Code Installation

Selepas selesai, verify dengan arahan:

$ claude --version

Output sepatutnya menunjukkan versi Claude Code:

0.x.y # Contoh: 0.4.0 atau lebih baru
Tahniah! Claude Code sudah dipasang pada Mac anda!
▶
3. First Run — Jalankan Claude Code
Cara memulakan Claude Code untuk kali pertama

Langkah 1: Buka Terminal

Buka terminal pilihan anda:

  • Windows: PowerShell atau Command Prompt
  • Mac: Terminal atau iTerm2

Langkah 2: Navigasi ke Folder Projek

Guna cd untuk pergi ke folder projek anda (atau buat folder baru):

$ cd Desktop/latihan-vibe-coding $ mkdir -p projek-pertama $ cd projek-pertama

Langkah 3: Mulakan Claude Code

Dalam folder projek, taip:

$ claude

Claude Code akan memulakan proses authentication.

Langkah 4: Proses Authentication

Pada kali pertama, anda akan dibawa ke pelayar web untuk log masuk ke akaun Anthropic:

  • Pelayar akan terbuka secara automatik
  • Log masuk dengan akaun Google atau email anda
  • Klik "Approve" untuk membenarkan Claude Code
  • Kembali ke terminal — Claude Code sedia digunakan!
Tip: Jika pelayar tidak terbuka automatik, terminal akan menunjukkan URL yang perlu anda buka manual.
Ralat Biasa: "Authentication failed" — lihat bahagian Troubleshooting untuk penyelesaian.
✓
4. Verify Installation — Checklist
Semak semuanya berfungsi dengan betul

Semak dengan checklist ini:

  • node -v node --version menunjukkan v18 atau lebih tinggi
  • npm -v npm --version menunjukkan versi npm terkini
  • git -v git --version menunjukkan versi Git
  • where claude [Windows] where claude menunjukkan path ke claude
  • which claude [Mac] which claude menunjukkan path ke claude
  • claude -v claude --version menunjukkan versi Claude Code
  • claude claude (dalam folder projek) berjaya login dan muncul CLI
Semua hijau? Anda sudah bersedia untuk mula menggunakan Claude Code!
⚠
5. Troubleshooting — Masalah & Penyelesaian
Klik pada masalah untuk melihat penyelesaian
!
"command not found: claude"
Claude Code tidak dikenali sebagai command
▼

Sebab: npm global bin tidak berada dalam PATH sistem.

Windows:

  • Pastikan anda tutup dan buka semula terminal selepas install
  • Guna npm config get prefix untuk check folder npm global
  • Tambah folder tersebut ke PATH: Settings > System > Environment Variables

Mac:

  • Tambah ke PATH: export PATH="$HOME/.npm-global/bin:$PATH"
  • Masukkan dalam ~/.zshrc atau ~/.bash_profile
# Fix sementara (Mac): export PATH="$HOME/.npm-global/bin:$PATH" claude --version
!
Node.js version terlalu lama
node --version menunjukkan v16 atau lebih rendah
▼

Sebab: Claude Code memerlukan Node.js v18+.

Penyelesaian:

  • Muat turun versi terkini dari nodejs.org
  • Alternatif: guna nvm (Node Version Manager) untuk upgrade

Windows — Install nvm:

Mac — Install nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash nvm install --lts nvm use --lts
!
Permission issues (Mac — EACCES)
Ralat "EACCES" atau "permission denied" semasa npm install -g
▼

Sebab: npm cuba tulis ke folder yang perlukan root access.

Penyelesaian terbaik — konfigurasi npm prefix:

mkdir ~/.npm-global npm config set prefix ~/.npm-global

Kemudian tambah ke ~/.zshrc atau ~/.bash_profile:

export PATH=~/.npm-global/bin:$PATH

Jalankan semula: source ~/.zshrc dan cuba install semula.

Elakkan: Jangan guna sudo npm install -g. Ini boleh menyebabkan isu permission yang lain.
!
Authentication failed
Gagal log masuk atau "Authentication failed" semasa first run
▼

Sebab: Masalah dengan proses OAuth / log masuk.

Penyelesaian:

  • Pastikan anda mempunyai sambungan internet yang stabil
  • Jika pelayar tidak terbuka, salin URL yang diberi dalam terminal ke pelayar manual
  • Pastikan pop-up tidak disekat oleh pelayar
  • Cuba claude logout dahulu, kemudian claude semula
  • Reset Claude Code: padam folder ~/.claude (Mac) atau %USERPROFILE%\.claude (Windows)
# Logout dan cuba semula: claude logout claude
!
Terminal restart needed
"claude" tidak jalan walaupun sudah npm install -g
▼

Sebab: Terminal masih menggunakan PATH session yang lama.

Penyelesaian:

  • Tutup terminal sepenuhnya dan buka baru
  • Atau refresh environment variables dengan:
    # PowerShell (Windows): $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
  • Atau restart VS Code jika guna terminal dalam VS Code
Tip: Walaupun command di atas refresh PATH, cara paling mudah adalah tutup dan buka semula terminal.
➜
6. Langkah Seterusnya
Teruskan pembelajaran anda
💻

Install Codex

Plugin untuk VS Code — integrasi AI dalam editor

 🏠

Portal Utama

Kembali ke portal utama modul pembelajaran

 📚

Modul Pelajar

Fasa 1: Pengenalan kepada Vibe Coding