Ringkasan Singkat: Claude Code dapat diinstal melalui penginstal asli di macOS, Windows, dan Linux dari situs web resmi Claude Code. Pengguna Windows harus menginstal WSL2 terlebih dahulu sebelum menjalankan Claude Code. Setelah instalasi, otentikasi dengan akun Claude Anda ketika Claude Code membuka jendela peramban agar Anda dapat masuk pada peluncuran pertama untuk mulai membuat kode dengan bantuan AI langsung dari terminal atau aplikasi desktop Anda.
Claude Code mewakili dorongan Anthropic ke dalam alat pengembangan AI yang agentik. Asisten baris perintah ini membaca basis kode, mengedit file, menjalankan perintah, dan terintegrasi dengan alur kerja pengembangan.
Namun, proses instalasinya tidak selalu mudah. Platform yang berbeda memerlukan pendekatan yang berbeda. Windows memerlukan penyiapan tambahan. Dan dokumentasi, meskipun komprehensif, dapat membuat pemula kewalahan.
Panduan ini mengatasi kompleksitas tersebut. Panduan ini mencakup persyaratan sistem, langkah-langkah instalasi spesifik platform, otentikasi, dan verifikasi—semua yang diperlukan untuk menjalankan Claude Code dengan benar.
Persyaratan Sistem Sebelum Instalasi
Menurut dokumentasi resmi Claude Code, alat ini mendukung macOS, Windows, dan Linux. Namun, setiap platform memiliki prasyarat khusus.
Untuk macOS, persyaratannya minimal. Sistem memerlukan macOS 13.0 atau lebih baru. Chip Intel dan Apple Silicon berfungsi dengan baik.
Windows menghadirkan lebih banyak kompleksitas. Sistem operasi harus Windows 10 Build 19041 atau lebih baru, atau Windows 11. Namun, inilah intinya—Claude Code tidak berjalan secara native di Windows.
Windows Subsystem for Linux 2 (WSL2) wajib ada. Ini menciptakan lingkungan Linux di mana Claude Code benar-benar beroperasi. Tanpa WSL2, instalasi akan gagal.
Pengguna Linux memerlukan distribusi 64-bit. Dokumentasi resmi mengonfirmasi dukungan untuk Ubuntu, Debian, Fedora, dan distribusi utama lainnya. Alpine Linux dan sistem berbasis musl memerlukan konfigurasi tambahan.
Semua platform memerlukan koneksi internet yang stabil selama instalasi. Ukuran unduhan bervariasi tetapi biasanya berkisar antara 50MB hingga 500MB tergantung pada apa yang sudah terinstal.
| Platform | Versi Minimum | Persyaratan Khusus |
|---|---|---|
| macOS | 13.0 | Tidak ada |
| Windows | 10 Build 19041 atau 11 | Diperlukan WSL2 |
| Linux | Distribusi 64-bit | Lebih disukai berbasis glibc |
Menginstal Claude Code di macOS
Proses instalasi macOS menggunakan penginstal native. Ini adalah jalur termudah di antara semua platform.
Pertama, unduh penginstal dari situs web resmi Claude Code. Halaman unduhan secara otomatis mendeteksi macOS dan menawarkan paket yang sesuai.
Buka file .dmg yang diunduh. Seret aplikasi Claude Code ke folder Applications. Instalasi macOS standar—tidak ada yang tidak biasa di sini.
Beberapa pengguna mengalami prompt keamanan saat pertama kali meluncurkan. macOS memblokir aplikasi dari pengembang yang tidak teridentifikasi secara default. Klik kanan aplikasi Claude Code dan pilih "Buka" untuk melewati peringatan satu kali ini.
Alat baris perintah terinstal secara otomatis bersama dengan aplikasi desktop. Buka Terminal dan ketik claude --version untuk memverifikasi. Jika nomor versi muncul, instalasi berhasil.
Memverifikasi Instalasi macOS
Jalankan perintah-perintah berikut untuk mengonfirmasi semuanya berfungsi:
| claude --version claude --help |
Kedua perintah harus mengembalikan output tanpa kesalahan. Perintah versi menampilkan versi Claude Code yang terinstal. Perintah bantuan menampilkan opsi dan perintah yang tersedia.
Membuat direktori pengujian membantu memverifikasi fungsionalitas penuh. Navigasi ke folder proyek dan jalankan claude untuk memulai sesi interaktif. Alat ini harus menginisialisasi dan meminta otentikasi jika belum masuk.
Instalasi Windows dengan WSL2
Instalasi Windows memerlukan beberapa langkah. Prosesnya lebih lama daripada macOS tetapi tetap dapat dikelola.
WSL2 harus diinstal terlebih dahulu. Buka PowerShell sebagai Administrator dan jalankan:
| wsl --install |
Perintah ini menginstal WSL2 dan Ubuntu secara default. Sistem akan memerlukan restart. Setelah booting ulang, Ubuntu diluncurkan secara otomatis untuk menyelesaikan penyiapan awal.
Buat nama pengguna dan kata sandi Unix saat diminta. Kredensial ini terpisah dari kredensial login Windows.
Setelah WSL2 berjalan, proses instalasi Linux berlaku. Buka terminal Ubuntu (diinstal dengan WSL2) dan unduh penginstal Claude Code untuk Linux.
Menginstal Claude Code di WSL2
Menurut dokumentasi resmi, perintah instalasi mengunduh dan menjalankan penginstal native:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Skrip ini menangani dependensi secara otomatis. Ini menginstal Node.js jika diperlukan, menyiapkan biner Claude Code, dan mengonfigurasi variabel PATH.
Instalasi memakan waktu beberapa menit. Bilah kemajuan dan pesan status menunjukkan apa yang terjadi. Setelah selesai, tutup dan buka kembali terminal untuk menyegarkan variabel lingkungan.
Menguji instalasi mengikuti proses yang sama seperti macOS. Jalankan claude --version untuk memverifikasi.
Proses Instalasi Linux
Pengguna Linux memiliki jalur instalasi yang paling mudah. Penginstal native bekerja langsung tanpa lapisan tambahan seperti WSL2.
Unduh dan jalankan skrip instalasi:
| curl -fsSL claude.ai/install.sh | bash |
Ini mengunduh biner Claude Code, menginstal dependensi, dan mengonfigurasi lingkungan shell. Skrip mendeteksi distribusi dan menyesuaikan sesuai kebutuhan.
Untuk sistem berbasis Ubuntu dan Debian, skrip mengonfigurasi instalasi. Dokumentasi resmi mengonfirmasi dukungan untuk Ubuntu 20.04+, Debian 10+, dan distribusi lainnya.
Pertimbangan Alpine Linux
Alpine Linux dan distribusi berbasis musl memerlukan langkah tambahan. Dokumentasi resmi mencatat sistem ini memerlukan konfigurasi manual.
Penginstal standar mungkin gagal di Alpine. Alih-alih, unduh biner yang kompatibel dengan musl langsung dari halaman rilis. Ekstrak ke direktori di PATH sistem, biasanya /usr/local/bin.
Atur izin eksekusi:
| chmod +x /usr/local/bin/claude |
Pengguna Alpine harus memverifikasi kompatibilitas sebelum melanjutkan. Beberapa fitur mungkin tidak berfungsi identik dengan distribusi berbasis glibc.
Otentikasi dan Penyiapan Akun
Setelah menginstal Claude Code, jalankan claude di terminal Anda. Pada peluncuran pertama, Claude Code membuka jendela peramban agar Anda dapat masuk.
Ini membuka halaman otentikasi Claude. Masuk dengan akun Claude yang sudah ada atau buat yang baru.
Peramban akan menampilkan kode otorisasi. Salin kode ini dan kembali ke terminal. Tempel kode saat diminta.
Otentikasi yang berhasil menyimpan kredensial secara lokal. Sesi mendatang tidak akan memerlukan login kecuali kredensial kedaluwarsa atau dihapus secara manual.
Otentikasi Tim dan Perusahaan
Menurut dokumentasi otentikasi resmi, tim yang menggunakan Claude untuk Tim atau Perusahaan memiliki opsi tambahan. Organisasi dapat mengonfigurasi single sign-on (SSO) atau otentikasi penyedia cloud.
Penyiapan SSO memerlukan konfigurasi administrator. Pengembang individu kemudian akan mengotentikasi melalui penyedia identitas organisasi mereka daripada akun Claude pribadi.
Otentikasi penyedia cloud berfungsi untuk penerapan AWS, Google Cloud, dan Azure. Metode ini menggunakan kredensial cloud yang ada daripada akun Claude terpisah.
| Metode Otentikasi | Kasus Penggunaan | Kompleksitas Penyiapan |
|---|---|---|
| Akun Pribadi | Pengembang individu | Mudah |
| SSO Tim/Perusahaan | Organisasi | Memerlukan admin |
| Penyedia Cloud | Pengguna AWS/GCP/Azure | Sedang |
Instalasi Aplikasi Desktop
Claude Code menawarkan aplikasi baris perintah dan desktop. Aplikasi desktop menyediakan antarmuka grafis sambil mempertahankan fungsionalitas terminal penuh.
Unduh penginstal desktop dari situs web resmi Claude. Halaman ini menawarkan versi macOS, Windows, dan Windows ARM64. Pilih versi yang sesuai untuk sistem.
Instalasi macOS mengikuti proses .dmg yang sama seperti yang dijelaskan sebelumnya. Pengguna Windows dapat mengunduh aplikasi desktop untuk antarmuka grafis tanpa memerlukan penyiapan WSL2.
Aplikasi desktop menyertakan akses terminal terintegrasi. Ini dapat meluncurkan sesi Claude Code tanpa beralih ke aplikasi terminal eksternal.
Salah satu keuntungan aplikasi desktop adalah ketersediaan di latar belakang. Menurut halaman unduhan resmi, aplikasi "tetap siap di latar belakang" dan dapat diakses dari aplikasi apa pun tanpa mengganti jendela atau kehilangan fokus.
Gunakan Get AI Perks untuk Menemukan Kredit untuk Tumpukan Claude Code Anda
Instalasi adalah bagian yang mudah. Biaya sebenarnya biasanya berasal dari segala sesuatu di sekitarnya: infrastruktur, alat pendukung, dan layanan berbayar yang digunakan selama penyiapan dan pengujian. Get AI Perks dapat membantu dengan mencantumkan kredit startup dan diskon di satu tempat, beserta panduan cara menerapkannya.
Dengan Get AI Perks, Anda dapat:
- Menemukan kredit untuk alat cloud dan terkait AI
- Memeriksa kondisi keuntungan sebelum mendaftar
- Menghindari membuang waktu untuk penawaran yang mungkin tidak Anda penuhi syaratnya
- Menurunkan biaya untuk menyiapkan sistem Anda
Kunjungi Get AI Perks untuk melihat apakah penawaran yang tersedia cocok dengan alat yang Anda rencanakan untuk digunakan dengan Claude Code.
Ekstensi IDE dan Integrasi
Selain instalasi mandiri, Claude Code terintegrasi dengan lingkungan pengembangan populer. Ekstensi ada untuk Visual Studio Code dan IDE JetBrains.
Ekstensi VS Code diinstal melalui marketplace. Cari "Claude Code" di panel Ekstensi dan klik Instal. Ekstensi ini memerlukan alat baris perintah untuk diinstal terlebih dahulu.
Beberapa pengguna melaporkan masalah dengan file ekstensi VS Code yang dibundel. Jika instalasi otomatis gagal dengan kesalahan "End of central directory record signature not found", file .vsix yang dibundel mungkin rusak.
Solusinya melibatkan penginstalan ekstensi secara manual dari marketplace VS Code daripada mengandalkan versi yang dibundel oleh CLI. Ini memisahkan kedua komponen dan mencegah konflik instalasi.
Integrasi JetBrains bekerja dengan cara yang sama. Instal plugin dari marketplace JetBrains di dalam IntelliJ IDEA, PyCharm, WebStorm, atau produk JetBrains lainnya.
Memverifikasi Keberhasilan Instalasi
Verifikasi yang tepat memastikan Claude Code berfungsi dengan benar sebelum memulai tugas pengembangan yang sebenarnya.
Pemeriksaan dasar memverifikasi ketersediaan perintah:
| claude --help claude --version |
Perintah-perintah ini harus dijalankan tanpa kesalahan. Perintah bantuan mencantumkan opsi yang tersedia. Perintah versi menampilkan rilis yang terinstal.
Pengujian fungsional memerlukan memulai sesi. Buat direktori pengujian:
| mkdir test-project cd test-project claude |
Ini menginisialisasi sesi Claude Code interaktif. Alat ini harus menganalisis direktori (kosong dalam kasus ini) dan menampilkan prompt.
Coba perintah dasar dalam sesi. Ketik help untuk melihat tindakan yang tersedia. Minta tugas sederhana seperti "buat file README" atau "jelaskan apa yang bisa Anda lakukan."
Respons yang berhasil menunjukkan instalasi yang tepat. Jika terjadi kesalahan, biasanya terkait dengan otentikasi, konektivitas jaringan, atau dependensi yang hilang.
Manajemen Pembaruan dan Versi
Claude Code diperbarui secara otomatis secara default. Dokumentasi resmi menjelaskan bahwa alat ini memeriksa versi baru dan menginstalnya tanpa campur tangan pengguna.
Perilaku pembaruan dapat dikonfigurasi melalui pengaturan Claude Code. Dokumentasi resmi mencakup konfigurasi saluran rilis dan opsi pembaruan manual.
Pembaruan manual memerlukan menjalankan skrip instalasi lagi. Perintah yang sama yang digunakan untuk instalasi awal menarik versi terbaru:
| curl -fsSL claude.ai/install.sh | bash |
Memasang versi tertentu dimungkinkan untuk tujuan pengujian atau kompatibilitas. Dokumentasi penyiapan lanjutan mencakup penyesuaian versi dan konfigurasi saluran rilis.
Saluran rilis meliputi stabil, beta, dan nightly. Stabil direkomendasikan untuk pekerjaan produksi. Saluran beta dan nightly memberikan akses awal ke fitur-fitur baru tetapi mungkin mengandung bug.
Masalah Instalasi Umum
Beberapa masalah sering muncul dalam diskusi komunitas tentang instalasi Claude Code.
Konfigurasi PATH menyebabkan banyak masalah. Jika perintah claude tidak ditemukan setelah instalasi, direktori biner tidak ada dalam PATH sistem.
Di macOS dan Linux, menambahkan direktori ke PATH biasanya melibatkan pengeditan ~/.bashrc, ~/.zshrc, atau file konfigurasi shell serupa. Skrip instalasi biasanya menangani ini secara otomatis, tetapi verifikasi manual membantu pemecahan masalah.
Pengguna Windows di WSL2 mungkin perlu menutup dan membuka kembali terminal setelah instalasi. Variabel lingkungan tidak diperbarui di sesi yang ada.
Pembatasan jaringan memblokir beberapa instalasi. Firewall perusahaan atau server proxy dapat mencegah pengunduhan penginstal atau koneksi ke server otentikasi.
Konfigurasi proxy memerlukan variabel lingkungan:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
Kesalahan izin terjadi saat menginstal ke direktori yang dilindungi. Penginstal memerlukan akses tulis ke /usr/local/bin atau lokasi yang setara. Menjalankan dengan sudo menyelesaikan ini tetapi harus dihindari kecuali diperlukan.
Pertanyaan yang Sering Diajukan
Bisakah Claude Code berjalan tanpa koneksi internet?
Tidak. Claude Code memerlukan konektivitas internet untuk berfungsi. Alat ini mengirimkan kode dan kueri ke server Anthropic untuk diproses. Caching lokal mungkin memungkinkan beberapa operasi berfungsi sementara secara offline, tetapi fungsionalitas penuh memerlukan koneksi aktif.
Apakah Claude Code berfungsi dengan alat pengkodean AI yang sudah ada?
Ya. Claude Code dapat berjalan bersama GitHub Copilot, Cursor, atau alat pengembangan AI lainnya. Mereka beroperasi secara independen dan tidak bertentangan. Namun, menggunakan beberapa asisten AI secara bersamaan dapat menciptakan kebingungan tentang alat mana yang menangani tugas mana.
Apakah WSL2 diperlukan untuk semua fitur Windows?
Alat baris perintah memerlukan WSL2 di Windows. Namun, aplikasi desktop berjalan secara native di Windows tanpa WSL2. Aplikasi desktop menyediakan fungsionalitas serupa melalui antarmuka grafis daripada interaksi baris perintah murni.
Berapa biaya penggunaan Claude Code?
Harga bervariasi berdasarkan penggunaan dan tingkatan langganan. Periksa situs web resmi Claude untuk harga saat ini, karena biaya dan struktur paket berubah seiring waktu. Beberapa fitur memerlukan langganan Claude Pro atau Perusahaan.
Bisakah Claude Code mengedit file di luar direktori proyek?
Secara default, Claude Code membatasi akses file ke direktori proyek saat ini demi keamanan. Pengaturan konfigurasi dapat memperluas izin, tetapi melakukannya memerlukan otorisasi eksplisit. Dokumentasi sandboxing mencakup manajemen izin secara rinci.
Apa perbedaan antara Claude Code dan Claude API?
Claude Code adalah alat pengembangan untuk bantuan pengodean interaktif. Claude API menyediakan akses terprogram untuk membangun aplikasi yang menggunakan kemampuan AI Claude. Keduanya melayani tujuan yang berbeda—satu untuk pengembang yang menulis kode, yang lain untuk aplikasi yang mengintegrasikan fitur AI.
Apakah mencopot pemasangan menghapus semua data Claude Code?
Mencopot pemasangan menghapus biner aplikasi tetapi dapat meninggalkan file konfigurasi dan data yang di-cache. Penghapusan lengkap memerlukan penghapusan manual direktori ~/.claude di macOS dan Linux, atau lokasi AppData yang setara di Windows.
Memulai Setelah Instalasi
Dengan Claude Code terinstal dan terverifikasi, langkah selanjutnya adalah memahami cara menggunakannya secara efektif.
Dokumentasi quickstart merekomendasikan untuk memulai dengan tugas-tugas sederhana. Navigasi ke proyek yang sudah ada dan jalankan claude untuk memulai sesi interaktif.
Minta Claude untuk menjelaskan struktur proyek. Minta ringkasan tentang apa yang dilakukan basis kode. Kueri eksplorasi ini membantu memahami bagaimana alat ini menafsirkan kode.
Coba buat perubahan kecil. Minta Claude untuk menambahkan komentar ke fungsi, membuat file pengujian sederhana, atau memfaktorkan ulang blok kode dasar. Tugas-tugas ini menunjukkan kemampuan pengeditan tanpa risiko.
Integrasi Git berfungsi secara otomatis jika proyek menggunakan kontrol versi. Claude Code dapat membuat komit, menjelaskan perbedaan, dan menyarankan perbaikan berdasarkan perubahan.
Dokumentasi resmi menyertakan contoh alur kerja untuk tugas pengembangan umum. Ini mencakup perbaikan bug, implementasi fitur, tinjauan kode, dan pengujian otomatis.
Claude Code adalah alat yang terus berkembang. Instalasi hanyalah fondasinya. Memahami kemampuannya, keterbatasannya, dan praktik terbaik memerlukan eksperimen dan latihan.
Siap menginstal Claude Code? Unduh penginstal yang sesuai untuk platform Anda dari situs web resmi dan ikuti langkah-langkah yang diuraikan dalam panduan ini. Otentikasi dengan akun Claude Anda, verifikasi instalasi berfungsi dengan benar, dan mulailah menjelajahi pengembangan yang dibantu AI.
