​
Persyaratan sistem

  • Sistem Operasi: macOS 10.15+, Ubuntu 20.04+/Debian 10+, atau Windows melalui WSL
  • Perangkat Keras: RAM 4GB minimum
  • Perangkat Lunak:
    • Node.js 18+
    • git 2.23+ (opsional)
    • GitHub atau GitLab CLI untuk alur kerja PR (opsional)
  • Jaringan: Koneksi internet diperlukan untuk autentikasi dan pemrosesan AI
  • Lokasi: Hanya tersedia di negara yang didukung

​
Instal dan autentikasi

1

Instal Claude Code

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

Navigasi ke proyek Anda

cd your-project-directory
3

Mulai Claude Code

claude
4

Selesaikan autentikasi

Claude Code menawarkan beberapa opsi autentikasi:

  1. Anthropic Console: Opsi default. Terhubung melalui Anthropic Console dan selesaikan proses OAuth. Memerlukan penagihan aktif di console.anthropic.com.
  2. Claude App (dengan paket Pro atau Max): Berlangganan paket Pro atau Max Claude untuk langganan terpadu yang mencakup Claude Code dan antarmuka web. Dapatkan nilai lebih pada titik harga yang sama sambil mengelola akun Anda di satu tempat. Masuk dengan akun Claude.ai Anda. Selama peluncuran, pilih opsi yang sesuai dengan jenis langganan Anda.
  3. Platform enterprise: Konfigurasi Claude Code untuk menggunakan Amazon Bedrock atau Google Vertex AI untuk deployment enterprise dengan infrastruktur cloud yang sudah ada.

​
Inisialisasi proyek Anda

Untuk pengguna pertama kali, kami merekomendasikan:

1

Mulai Claude Code

claude
2

Jalankan perintah sederhana

> summarize this project
3

Buat panduan proyek CLAUDE.md

/init
4

Commit file CLAUDE.md yang dihasilkan

Minta Claude untuk commit file CLAUDE.md yang dihasilkan ke repositori Anda.

​
Pemecahan masalah

​
Pemecahan masalah instalasi WSL

Saat ini, Claude Code tidak berjalan langsung di Windows, dan sebagai gantinya memerlukan WSL.

Anda mungkin mengalami masalah berikut di WSL:

Masalah deteksi OS/platform: Jika Anda menerima error selama instalasi, WSL mungkin menggunakan npm Windows. Coba:

  • Jalankan npm config set os linux sebelum instalasi
  • Instal dengan npm install -g @anthropic-ai/claude-code --force --no-os-check (JANGAN gunakan sudo)

Error Node tidak ditemukan: Jika Anda melihat exec: node: not found saat menjalankan claude, lingkungan WSL Anda mungkin menggunakan instalasi Node.js Windows. Anda dapat mengonfirmasi ini dengan which npm dan which node, yang seharusnya menunjuk ke path Linux yang dimulai dengan /usr/ bukan /mnt/c/. Untuk memperbaiki ini, coba instal Node melalui package manager distribusi Linux Anda atau melalui nvm.

​
Optimalkan pengaturan terminal Anda

Claude Code bekerja paling baik ketika terminal Anda dikonfigurasi dengan benar. Ikuti panduan ini untuk mengoptimalkan pengalaman Anda.

Shell yang didukung:

  • Bash
  • Zsh
  • Fish

​
Tema dan tampilan

Claude tidak dapat mengontrol tema terminal Anda. Itu ditangani oleh aplikasi terminal Anda. Anda dapat mencocokkan tema Claude Code dengan terminal Anda selama onboarding atau kapan saja melalui perintah /config

​
Jeda baris

Anda memiliki beberapa opsi untuk memasukkan jeda baris ke Claude Code:

  • Quick escape: Ketik \ diikuti Enter untuk membuat baris baru
  • Pintasan keyboard: Tekan Option+Enter (Meta+Enter) dengan konfigurasi yang tepat

Untuk mengatur Option+Enter di terminal Anda:

Untuk Mac Terminal.app:

  1. Buka Settings → Profiles → Keyboard
  2. Centang “Use Option as Meta Key”

Untuk iTerm2 dan terminal VSCode:

  1. Buka Settings → Profiles → Keys
  2. Di bawah General, atur Left/Right Option key ke “Esc+”

Tip untuk pengguna iTerm2 dan VSCode: Jalankan /terminal-setup dalam Claude Code untuk secara otomatis mengkonfigurasi Shift+Enter sebagai alternatif yang lebih intuitif.

​
Pengaturan notifikasi

Jangan pernah melewatkan saat Claude menyelesaikan tugas dengan konfigurasi notifikasi yang tepat:

​
Notifikasi bell terminal

Aktifkan alert suara saat tugas selesai:

claude config set --global preferredNotifChannel terminal_bell

Untuk pengguna macOS: Jangan lupa untuk mengaktifkan izin notifikasi di System Settings → Notifications → [Aplikasi Terminal Anda].

​
Notifikasi sistem iTerm 2

Untuk alert iTerm 2 saat tugas selesai:

  1. Buka iTerm 2 Preferences
  2. Navigasi ke Profiles → Terminal
  3. Aktifkan “Silence bell” dan Filter Alerts → “Send escape sequence-generated alerts”
  4. Atur delay notifikasi yang Anda inginkan

Perhatikan bahwa notifikasi ini khusus untuk iTerm 2 dan tidak tersedia di Terminal macOS default.

​
Menangani input besar

Saat bekerja dengan kode ekstensif atau instruksi panjang:

  • Hindari paste langsung: Claude Code mungkin kesulitan dengan konten paste yang sangat panjang
  • Gunakan alur kerja berbasis file: Tulis konten ke file dan minta Claude untuk membacanya
  • Waspadai keterbatasan VS Code: Terminal VS Code sangat rentan memotong paste panjang

​
Mode Vim

Claude Code mendukung subset keybinding Vim yang dapat diaktifkan dengan /vim atau dikonfigurasi melalui /config.

Subset yang didukung meliputi:

  • Perpindahan mode: Esc (ke NORMAL), i/I, a/A, o/O (ke INSERT)
  • Navigasi: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Editing: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (repeat)