Ringkasan Singkat: Menginstal Claude Code di Windows memerlukan penyiapan WSL2 (Windows Subsystem for Linux), menginstal Ubuntu, dan menjalankan skrip instalasi sederhana. Proses ini memungkinkan pengguna Windows untuk mengakses asisten pengkodean AI Anthropic melalui terminal mereka. Biner Windows asli tersedia, namun WSL2 masih merupakan praktik terbaik untuk instalasi Windows.
Claude Code adalah asisten pengkodean bertenaga AI yang beroperasi langsung di terminal, membantu pengembang membangun fitur, memperbaiki bug, dan mengotomatiskan tugas pengembangan. Namun, ada kendala bagi pengguna Windows.
Claude Code tersedia sebagai file eksekusi asli Windows dan dapat diinstal melalui npm atau unduhan biner langsung tanpa WSL2. Namun, ini memerlukan Windows Subsystem for Linux (WSL2), dan metode instalasi resmi masih bergantung pada WSL2.
Berikut cara membuatnya berfungsi di Windows 11 atau Windows 10.
Persyaratan Sistem
Sebelum memulai instalasi, verifikasi mesin Windows memenuhi persyaratan ini:
- Windows 10 1809+ atau Windows Server 2019+
- Windows 11 (versi apa pun)
- Setidaknya 4GB RAM tersedia
- Hak administratif pada sistem
- Koneksi internet untuk mengunduh WSL2 dan Ubuntu
Instalasi memerlukan ruang disk untuk WSL2, Ubuntu, dan Claude Code.
Langkah 1: Aktifkan Windows Subsystem for Linux
WSL2 menyediakan lingkungan Linux langsung di dalam Windows. Ini adalah fondasi yang memungkinkan Claude Code berfungsi.
Buka PowerShell sebagai Administrator. Klik kanan tombol Mulai dan pilih "Windows PowerShell (Admin)" atau "Terminal (Admin)" di Windows 11.
Jalankan perintah ini:
wsl --install
Perintah ini mengaktifkan fitur Windows yang diperlukan dan menginstal Ubuntu sebagai distribusi Linux default. Sistem kemungkinan akan meminta untuk memulai ulang.
Setelah memulai ulang, WSL2 menyelesaikan penyiapan secara otomatis. Ubuntu diluncurkan dan meminta nama pengguna dan kata sandi. Kredensial ini hanya untuk lingkungan Linux—tidak perlu cocok dengan kredensial Windows.
Langkah 2: Verifikasi Instalasi WSL2
Setelah sistem memulai ulang dan Ubuntu menyelesaikan penyiapan awal, verifikasi WSL2 berjalan dengan benar.
Buka terminal Ubuntu (cari "Ubuntu" di menu Mulai) dan jalankan:
wsl --version
Ini menampilkan informasi versi WSL. Cari "WSL version: 2.x.x" pada output.
Jika perintah menampilkan WSL1, tingkatkan ke WSL2 dengan:
wsl --set-default-version 2
Langkah 3: Instal Claude Code
Sekarang untuk instalasi Claude Code yang sebenarnya. Dokumentasi resmi menyediakan skrip instalasi satu baris.
Di terminal Ubuntu, jalankan:
curl -fsSL claude.ai/install.sh | bash
Skrip mengunduh biner Claude Code, mengatur izin yang diperlukan, dan menambahkannya ke PATH sistem. Durasi instalasi bervariasi tergantung kecepatan internet dan spesifikasi sistem.
Menurut dokumentasi resmi Claude Code, penginstal secara otomatis mendeteksi arsitektur sistem dan mengunduh versi biner yang sesuai.
Masalah Instalasi Umum
Beberapa pengguna Windows melaporkan melihat "command not found: claude" setelah instalasi. Ini biasanya terjadi karena variabel PATH belum diperbarui.
Tutup dan buka kembali terminal Ubuntu, lalu coba lagi. Jika masalah berlanjut, konfigurasi jalur ini mungkin membantu sebagai solusi sementara tidak resmi:
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Langkah 4: Otentikasi Claude Code
Claude Code memerlukan otentikasi dengan akun Anthropic sebelum digunakan.
Jalankan perintah ini:
claude
Terminal menampilkan URL dan meminta otentikasi. Prosesnya sedikit berbeda untuk pengguna individu versus akun tim:
| Jenis Akun | Metode Otentikasi | Apa yang Diperlukan |
|---|---|---|
| Individu | Kunci API Pribadi | Akun Anthropic dengan akses API |
| Tim/Organisasi | Token Organisasi | Token otentikasi yang disediakan admin |
Buka URL yang disediakan di browser, masuk ke akun Anthropic, dan izinkan Claude Code. Terminal mengonfirmasi otentikasi berhasil.
Bekerja dengan Proyek Windows di WSL2
Di sinilah segalanya menjadi rumit. Sistem file Windows dan sistem file WSL2 terpisah.
File Windows dapat diakses dari WSL2 di /mnt/c/ (untuk drive C:), /mnt/d/ (untuk drive D:), dan seterusnya. Namun, ada biaya kinerja. Diskusi komunitas menunjukkan perbedaan kinerja antara direktori yang dipasang Windows dan direktori WSL2 asli.
Untuk kinerja terbaik, salin file proyek ke direktori home WSL2:
cp -r /mnt/c/Users/NamaAnda/Projects/proyek-anda ~/projects/proyek-anda
Imbalannya? Integrasi IDE menjadi lebih kompleks. Visual Studio Code menangani ini dengan baik dengan ekstensi Remote-WSL-nya, tetapi IDE lain mungkin kesulitan.
Menguji Instalasi
Verifikasi Claude Code berfungsi dengan benar dengan pengujian sederhana.
Navigasi ke direktori proyek (atau buat folder pengujian):
mkdir ~/claude-test
cd ~/claude-test
claude "buat skrip Python hello world sederhana"
Claude Code seharusnya merespons, membuat file, dan menampilkan kode. Ini mengonfirmasi instalasi berhasil.
Berhenti Membayar Lebih, Klaim Kredit AI yang Tersedia Terlebih Dahulu
Menginstal Claude Code di Windows biasanya cepat. Biaya sebenarnya muncul kemudian ketika pengembang mulai menguji prompt, menjalankan skrip, dan mengintegrasikan model ke dalam aplikasi. Fase eksperimen tersebut dapat menghasilkan banyak panggilan API, dan banyak tim baru menyadari biayanya setelah mereka mulai membangun.
Sebelum menghabiskan uang untuk penggunaan, ada baiknya memeriksa apakah Anda memenuhi syarat untuk kredit AI atau program mitra. Get AI Perks mengumpulkan peluang ini di satu tempat, mencantumkan kredit dan diskon dari penyedia AI, platform cloud, dan alat pengembang, bersama dengan instruksi sederhana tentang cara mengklaimnya.
Sebelum Anda menjalankan proyek Claude Code pertama Anda, periksa Get AI Perks dan klaim kredit AI yang dapat menutupi biaya pengembangan Anda.
Pertanyaan yang Sering Diajukan
Bisakah Claude Code berjalan secara native di Windows tanpa WSL2?
Ya, tetapi WSL2 masih tetap menjadi metode instalasi terbaik untuk Windows.
Apakah Claude Code bekerja dengan Windows Terminal?
Ya. Windows Terminal dapat membuka tab Ubuntu, memungkinkan akses ke Claude Code tanpa beralih ke jendela Ubuntu terpisah. Di Windows Terminal, klik panah dropdown dan pilih Ubuntu dari daftar profil.
Apakah alat pengembangan Windows saya yang ada akan berfungsi dengan Claude Code?
Tergantung pada alatnya. Visual Studio Code terintegrasi dengan baik melalui ekstensi Remote-WSL. IDE JetBrains dan alat lainnya mungkin memerlukan konfigurasi tambahan. Dokumentasi resmi menyebutkan VS Code dan JetBrains sebagai platform yang didukung.
Bagaimana cara memperbarui Claude Code di Windows?
Claude Code diperbarui secara otomatis secara default. Untuk memperbarui secara manual, jalankan `claude update` di terminal Ubuntu. Fitur pembaruan otomatis dapat dinonaktifkan melalui file konfigurasi jika diperlukan untuk lingkungan perusahaan.
Apa perbedaan antara Claude Code dan Claude API?
Claude Code adalah asisten pengkodean berbasis terminal yang menjalankan perintah dan mengedit file. Claude API menyediakan akses terprogram ke model bahasa Claude untuk membangun aplikasi kustom. Keduanya melayani tujuan yang berbeda dan memerlukan proses penyiapan yang berbeda.
Bisakah saya menggunakan Claude Code dengan proyek .NET di Windows?
Ya, tetapi dengan peringatan. Diskusi komunitas menunjukkan bahwa dukungan .NET SDK di WSL2 berfungsi, tetapi memerlukan penginstalan versi Linux dari .NET SDK di dalam Ubuntu. .NET yang diinstal di Windows tidak akan dapat diakses dari WSL2.
Berapa biaya Claude Code?
Harga tergantung pada penggunaan dan jenis akun. Periksa situs web resmi Anthropic untuk tingkatan harga dan paket tim saat ini, karena biaya bervariasi berdasarkan konsumsi API dan persyaratan organisasi.
Langkah Selanjutnya Setelah Instalasi
Dengan Claude Code terinstal, mulailah menjelajahi kemampuannya. Dokumentasi quickstart merekomendasikan untuk memulai dengan tugas-tugas sederhana seperti penjelasan kode sebelum beralih ke operasi yang lebih kompleks.
Coba perintah berikut untuk membiasakan diri:
- claude "jelaskan fungsi ini" -- Dapatkan penjelasan kode
- claude commit -- Hasilkan pesan commit Git
- claude -c -- Lanjutkan percakapan terakhir
Dokumentasi resmi menyediakan panduan terperinci untuk integrasi IDE, instalasi plugin, dan opsi konfigurasi lanjutan. Untuk tim, pengaturan yang dikelola server dan pelacakan analitik menawarkan kontrol tambahan atas penerapan Claude Code.
Penyiapan WSL2 mungkin tampak seperti langkah tambahan dibandingkan dengan aplikasi Windows asli, tetapi saat ini ini adalah satu-satunya cara untuk menjalankan Claude Code di Windows. Berita baiknya? Setelah dikonfigurasi, ini berjalan dengan lancar dan terintegrasi dengan sebagian besar alur kerja pengembangan.
