Cara install Claude Code CLI dari situs resmi

Apa itu Claude Code, dan mengapa digunakan di terminal?#

Terminal membuat hampir semua orang yang mulai melakukan vibe coding tanpa latar belakang pengembangan perangkat lunak merasa takut. Tampilannya seperti jendela hitam dari film hacker, tetapi sebenarnya hanyalah baris tempat Anda mengetik perintah. Claude Code membutuhkan terminal agar dapat membuka file Anda, mengubahnya, dan menjalankan pemeriksaan sendiri saat Anda menjelaskan tugas dengan kata-kata.

Anthropic menjelaskan produk ini sebagai berikut.

Perbedaannya dengan obrolan yang biasa Anda gunakan sederhana. Di browser, Anda menyalin kode secara manual bolak-balik antara jendela dan editor. Claude Code masuk ke folder proyek itu sendiri, membaca file yang diperlukan, membuat perubahan, dan menunjukkan apa yang diubahnya. Anda tetap menjadi pihak yang memutuskan dan menyetujui; alat ini melakukan pekerjaan mekanis untuk Anda.

Jika Anda benar-benar tidak ingin menggunakan terminal, Anthropic memiliki aplikasi desktop dengan jendela biasa dan versi web di claude.ai/code yang berjalan langsung di browser. Namun, pilihan yang paling kuat dan fleksibel adalah versi terminal, dan itulah yang dibahas dalam seluruh artikel ini.

Cara install Claude Code di terminal: situs resmi dan program yang diunduh#

Kebingungan pertama bagi pemula adalah mencari tahu di mana situs resmi Claude Code dan apa yang harus diklik untuk mengunduhnya. Berikut tabel semua alamat resmi Anthropic, agar Anda tidak perlu menebak-nebak.

Anda tidak mengunduh installer dari situs seperti saat mengunduh program biasa, bertentangan dengan yang diperkirakan banyak orang. Anda menginstalnya dengan perintah terminal, yang kemudian mengunduh versi yang tepat untuk sistem Anda. Artikel ini menyediakan perintah yang tepat untuk Mac, Windows, dan Linux.

Satu jebakan umum adalah namanya: orang sering salah mengejanya menjadi clode code, clade code, слод код, atau clode design. Nama produknya adalah Claude Code, dengan au. Ingatlah hal ini saat mencari situs resminya: domain dengan ejaan yang mirip dimiliki pihak lain.

Nama paket npm yang tepat juga perlu diketahui. Paket kanonisnya adalah @anthropic-ai/claude-code, dengan awalan @anthropic-ai/. Anthropic sendiri memiliki nama singkat claude-code tanpa awalan—tautan resmi mereka menuju paket yang sama. Aturan sederhananya: penerbitnya harus Anthropic, dan nama yang digunakan untuk instalasi harus memakai awalan tersebut.

Yang dibutuhkan untuk menginstalnya: persyaratan komputer#

Persyaratan Claude Code tidak berat: server Anthropic melakukan pekerjaan utama; komputer Anda hanya mengirim permintaan dan menerima respons.

Catatan khusus tentang Node.js, karena paling banyak dikelilingi mitos. Installer native—yang direkomendasikan langsung oleh Anthropic—sama sekali tidak membutuhkan Node.js: installer ini dipasang sebagai satu file mandiri. Node.js hanya diperlukan jika Anda menginstal Claude Code melalui npm, dan dalam hal itu Anda memerlukan versi 22 atau yang lebih baru. Artikel lama menyebut “Node 18 ke atas”—itu sudah kedaluwarsa; jadikan 22+ sebagai acuan.

Anda memerlukan terminal untuk versi utama. Jika Anda tidak ingin menggunakannya, instal aplikasi desktop dengan jendela biasa atau gunakan versi web di claude.ai/code. Versi terminal tetap memiliki fitur yang lebih lengkap, jadi bagian selanjutnya dalam artikel ini menjelaskan cara menginstal versi tersebut.

Menginstal Claude Code ibarat mendapatkan sebuah alat. Namun, dengan sendirinya, alat ini sering berhalusinasi: melupakan proyek Anda, mengarang sesuatu, dan kehilangan alur di tengah tugas. Kombinasi tiga hal membuatnya andal: klona AI, Second Brain, dan rekayasa konteks. Ketiganya adalah pilar yang mencegah AI berhalusinasi.

Bagaimana cara install Claude Code di Mac?#

Buka Terminal (tersedia di setiap Mac: tekan Cmd+Space di Spotlight, lalu ketik “Terminal”) dan tempelkan satu baris ini:

curl -fsSL https://claude.ai/install.sh | bash

Perintah ini mengunduh installer dari alamat resmi Anthropic dan menginstal Claude Code. Node.js tidak diperlukan. Metode native juga praktis karena pembaruannya.

Jika Anda sudah menggunakan Homebrew, ada pilihan kedua:

brew install --cask claude-code

Perbedaan di antara keduanya adalah cara pembaruan dilakukan: installer native memperbarui dirinya sendiri, sedangkan Homebrew tidak—Anda harus memperbaruinya secara manual dengan perintah brew upgrade claude-code. Programnya sendiri sama, jadi pilih metode yang biasa Anda gunakan. Jika tidak yakin, gunakan metode pertama.

Bagaimana cara install Claude Code di Windows?#

Pertama, cari tahu Anda sedang berada di mana. Windows memiliki dua shell, dan masing-masing memiliki perintah sendiri. Buka jendela dan lihat awal prompt: PS C:\> berarti PowerShell, sedangkan C:\> tanpa PS berarti Command Prompt (CMD).

Untuk PowerShell (cara termudah membukanya adalah dengan mengeklik kanan tombol Start dan memilih “Terminal”):

irm https://claude.ai/install.ps1 | iex

Untuk Command Prompt (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Ada pilihan ketiga, menggunakan pengelola paket bawaan WinGet:

winget install Anthropic.ClaudeCode

Jika Anda sudah memiliki lingkungan WSL yang berfungsi (Linux di dalam Windows), instal Claude Code langsung di WSL menggunakan perintah yang sama seperti di Linux. Ada persoalan khusus WSL yang berkaitan dengan Node, dan akan saya bahas di bagian kesalahan umum di bawah.

Bagaimana cara install Claude Code di Linux?#

Metode dasar untuk semua distribusi populer menggunakan installer mandiri yang sama:

curl -fsSL https://claude.ai/install.sh | bash

Node.js tidak diperlukan; programnya hadir sebagai satu file dan setelah itu memperbarui dirinya sendiri.

Jika Anda terbiasa menginstal program hanya melalui pengelola paket sistem, Anda dapat menambahkan repositori resmi Anthropic: apt untuk Debian dan Ubuntu, dnf untuk Fedora dan RHEL, serta apk untuk Alpine. Repositori tersebut ditandatangani dengan kunci dan menyediakan kanal stable dan latest. Cara ini berlebihan untuk pemula, jadi detailnya saya serahkan kepada dokumentasi di bagian sumber dan secara default merekomendasikan perintah di atas.

Ada satu kendala yang mungkin terjadi di server murah. Jika memori kosong di mesin sangat sedikit, instalasi mungkin berhenti dengan kata Killed (kode 137)—sistem menghentikan proses karena kehabisan memori. Solusinya adalah menambahkan file swap: Claude Code memerlukan sekitar 512 MB memori kosong untuk diinstal.

Bagaimana cara meluncurkan Claude Code untuk pertama kali?#

Peluncuran pertama memerlukan beberapa menit. Berikut prosesnya.

1. Buka folder proyek

   Di terminal, gunakan perintah cd path-to-project untuk membuka folder yang ingin Anda kerjakan, lalu ketik claude.

2. Masuk ke akun

   Browser akan terbuka dengan jendela masuk. Jika tidak terbuka otomatis, tekan c untuk menyalin tautan lalu tempelkan secara manual di browser. Jika browser menampilkan kode (ini dapat terjadi di WSL dan server jarak jauh), tempelkan kode tersebut kembali ke terminal.

3. Tunggu konfirmasi

   Setelah Anda masuk, terminal akan menampilkan Login successful dan meminta Anda menekan Enter.

4. Ajukan pertanyaan pertama

   Tanyakan sesuatu yang sederhana tentang proyek, seperti “apa fungsi proyek ini?” Claude akan membaca file dan menjawab.

5. Setujui perubahan pertama

   Saat Anda memintanya mengubah sesuatu, Claude akan menunjukkan perubahan yang diusulkan dan meminta konfirmasi. Anda dapat mengganti mode akses dengan Shift+Tab.

Sebaiknya langsung pelajari beberapa perintah dasar di dalam sesi: /help menampilkan daftar perintah, /clear menghapus riwayat percakapan, dan /exit keluar (menekan Ctrl+D dua kali juga melakukan hal yang sama). Claude akan menampilkan semua ini sendiri jika Anda mengetik /help.

Masuk dengan langganan atau kunci API: mana yang sebaiknya dipilih?#

Inilah pertanyaan pertama yang muncul saat masuk.

Ada dua cara untuk masuk, dan perbedaannya terletak pada cara pembayaran.

Untuk masuk dengan langganan, cukup gunakan akun Claude.ai Anda. Untuk masuk dengan kunci API, dapatkan kunci dari Claude Console (platform.claude.com); biaya akan dipotong dari saldo prabayar saat Anda bekerja. Atur kunci tersebut dalam variabel lingkungan ANTHROPIC_API_KEY, dan Claude Code tidak akan membuka browser setiap kali.

Anda dapat berganti akun dalam sesi dengan /login dan keluar dengan /logout.

Namun, Claude Code tidak akan diluncurkan tanpa akses berbayar. Jika Anda belum memiliki akun, cari tahu terlebih dahulu alamat email mana yang digunakan untuk mendaftar: Anda tidak dapat mengubahnya nanti.

Bagaimana cara memeriksa apakah instalasi berhasil?#

Ada tiga perintah yang perlu diketahui sejak awal.

Pertama, periksa versinya:

claude --version

Instalasi yang berfungsi akan memberikan respons berupa angka dalam format X.Y.Z (Claude Code). Angka pastinya berubah dari versi ke versi; yang penting adalah perintah tersebut mengembalikan nomor versi. Respons “command not found” berarti ada masalah lain—akan dibahas di bagian berikutnya.

Kedua, diagnostik jika terjadi masalah.

Ketiga, /status di dalam sesi: perintah ini menunjukkan cara Anda masuk, email atau organisasi yang tertaut, dan apakah akses Anda telah kedaluwarsa. Sementara itu, claude update langsung menerapkan pembaruan terbaru alih-alih menunggu pembaruan di latar belakang.

Mengapa perintah claude tidak ditemukan setelah instalasi?#

Ini keluhan paling umum dari pemula, dan kedengarannya lebih menakutkan daripada kenyataannya. Terminal tidak mencari perintah di seluruh komputer; terminal hanya memeriksa folder yang tercantum di PATH. Claude Code menempatkan dirinya di ~/.local/bin/claude (di Mac dan Linux) atau %USERPROFILE%\\.local\\bin\\claude.exe (di Windows), dan jika folder itu tidak ada di PATH, terminal tidak dapat melihat program tersebut.

Di Mac dan Linux, tambahkan folder itu ke daftar. Buka file pengaturan shell Anda (~/.zshrc untuk Zsh, ~/.bashrc untuk Bash) dan tambahkan baris ini di bagian akhir:

export PATH="$HOME/.local/bin:$PATH"

Lalu tutup dan buka kembali terminal (atau jalankan source ~/.zshrc). Setelah itu, perintah claude akan ditemukan.

Kesalahan umum saat instalasi dan peluncuran pertama#

Mari kita bahas satu per satu; semuanya berasal dari panduan pemecahan masalah resmi Anthropic.

1. Node lama saat menginstal melalui npm. Paket @anthropic-ai/claude-code memerlukan Node.js 22 atau yang lebih baru. Di Windows, npm mungkin gagal dengan pesan bahwa skrip dinonaktifkan—kebijakan PowerShell memblokir eksekusinya. Di WSL, kesalahan yang umum adalah exec: node: not found: WSL menggunakan Node Windows, bukan Node Linux. Jika npm menyulitkan Anda, beralihlah ke installer native; installer itu tidak memerlukan Node.
2. Installer yang salah untuk shell. 'irm' is not recognized berarti Anda menempelkan perintah PowerShell ke Command Prompt. The token '&&' is not a valid statement separator berarti Anda melakukan sebaliknya dan menjalankan perintah CMD di PowerShell. A parameter cannot be found that matches parameter name 'fsSL' berarti Anda menjalankan perintah Mac/Linux di PowerShell. Periksa awal prompt: PS C:\ adalah PowerShell, sedangkan C:\ adalah CMD.
3. Kunci API lama menimpa langganan. Jika langganan Anda aktif tetapi kunci lama masih tersetel di lingkungan, Anda akan melihat API Error: 400 ... This organization has been disabled. Kunci tersebut diprioritaskan daripada masuk dengan langganan. Hapus dengan unset ANTHROPIC_API_KEY (di PowerShell, gunakan Remove-Item Env:ANTHROPIC_API_KEY), periksa ~/.zshrc dan ~/.bashrc, lalu ketik /status.
4. Memori tidak cukup di server yang lemah. Instalasi berhenti dengan kata Killed dan kode 137—artinya RAM tidak cukup. Anda memerlukan sekitar 512 MB ruang kosong; menambahkan swap akan mengatasinya.
5. Installer mengembalikan hal lain. Kesalahan syntax error near unexpected token '<' atau rujukan ke <!DOCTYPE html> berarti URL instalasi mengembalikan halaman web, bukan skrip instalasi—biasanya karena wilayah Anda, firewall perusahaan, atau gangguan sementara. Coba metode lain (Homebrew, WinGet) atau coba lagi dalam beberapa menit.

Untuk setiap kesalahan ini, langkah pertama tetap sama: jalankan claude doctor. Perintah ini akan menunjukkan apa yang rusak dan menyarankan tempat untuk memeriksanya.

Ada satu detail diagnostik: 403 tanpa keterangan lain selama instalasi juga dapat disebabkan oleh firewall atau proksi perusahaan. Jadi, jika Anda berada di jaringan kantor, periksa terlebih dahulu apakah jaringan tersebut memblokir akses.

Apa yang harus dilakukan setelah instalasi: langkah pertama#

Instalasi hanyalah permulaan. Pekerjaan sebenarnya dimulai sesudahnya, dan hal pertama yang ditemui orang adalah soal ingatan. Model bahasa tidak mengingat Anda di antara percakapan: dalam obrolan baru, model hanya mengetahui hal-hal yang Anda masukkan ke konteksnya.

Jadi, langkah nyata pertama setelah instalasi adalah membuat file CLAUDE.md di direktori utama proyek Anda. File teks ini berisi aturan dan konteks proyek yang dibaca Claude Code setiap kali diluncurkan. Jelaskan sekali saja apa yang Anda kerjakan, bagaimana proyek disusun, dan apa yang penting—maka Anda tidak perlu mengulanginya di setiap percakapan.

Saya menjelaskan cara menyusun file itu dan menyesuaikan Claude dalam panduan terpisah: cara menyesuaikan Claude. Saya juga menyusun peta umum alat vibe coding untuk 2026.

Apa lagi yang sering ditanyakan?#

Kerangka kerja vibe coding lengkap: klona AI + Second Brain + Rekayasa konteks.