Ringkasan Singkat: Claude Code CLI diinstal melalui satu perintah yang mengunduh dan mengonfigurasi alat secara otomatis. Di macOS dan Linux, gunakan skrip shell resmi dari dokumentasi Anthropic, sementara pengguna Windows menjalankan perintah PowerShell atau WSL. Setelah instalasi, otentikasi dengan kunci API Anda untuk mulai menggunakan asisten pengodean AI Claude di terminal Anda.
Claude Code adalah alat pengodean agentik yang hidup di terminal Anda dan memahami seluruh basis kode Anda. Menurut dokumentasi resmi Claude Code, alat ini dapat membaca file, mengeksekusi perintah, mengedit kode, dan berintegrasi dengan alat pengembangan melalui percakapan bahasa alami.
Namun, memulai membutuhkan instalasi yang tepat. Berikut adalah semua yang diperlukan untuk menginstal Claude Code CLI dan mengonfigurasinya dengan benar.
Persyaratan Sistem Sebelum Instalasi
Sebelum menginstal Claude Code, verifikasi sistem memenuhi persyaratan dasar. Menurut dokumentasi penyiapan lanjutan resmi, hapus kalimat ini sepenuhnya.
Periksa instalasi Node.js dengan membuka terminal dan menjalankan:
| node –version |
Jika Node.js tidak terinstal atau versinya di bawah 18, unduh dari situs web resmi Node.js. Versi Long-Term Support (LTS) berfungsi sempurna untuk Claude Code.
Selain Node.js, sistem memerlukan persyaratan dasar: macOS 13.0 atau lebih tinggi untuk pengguna Mac, Windows 10 atau lebih tinggi untuk sistem Windows, dan sebagian besar distribusi Linux modern berfungsi tanpa masalah. Akun Claude dari Anthropic juga diperlukan untuk otentikasi setelah instalasi.
Menginstal Claude Code di macOS dan Linux
Proses instalasi untuk macOS dan Linux menggunakan satu perintah shell yang menangani semuanya secara otomatis. Metode ini didokumentasikan dalam panduan cepat resmi Claude Code.
Buka Terminal dan jalankan skrip instalasi:
| curl -fsSL claude.ai/install.sh | bash |
Skrip mengunduh biner Claude Code, menempatkannya di direktori yang benar, dan mengonfigurasi PATH secara otomatis. Seluruh proses biasanya selesai dalam waktu kurang dari satu menit.
Untuk pengguna macOS yang lebih memilih Homebrew, ada metode instalasi alternatif meskipun tidak didokumentasikan secara resmi dalam sumber utama. Metode curl tetap menjadi pendekatan yang direkomendasikan sesuai dokumentasi resmi.
Memverifikasi Instalasi
Setelah instalasi selesai, verifikasi Claude Code dapat diakses:
| claude –version |
Perintah ini akan menampilkan nomor versi yang terinstal. Jika muncul kesalahan yang menyatakan "command not found", konfigurasi PATH perlu disesuaikan.
Menurut dokumentasi pemecahan masalah resmi, masalah PATH adalah masalah instalasi yang paling umum. Perbaikannya melibatkan penambahan direktori instalasi Claude ke file konfigurasi shell.
Menginstal Claude Code di macOS dan Linux
Proses instalasi untuk macOS dan Linux bergantung pada npm (Node Package Manager). Menurut dokumentasi resmi, Anda harus menginstal Node.js 18+ di sistem Anda sebelum melanjutkan. Berbeda dengan alat CLI tradisional yang menggunakan skrip shell, Claude Code diinstal secara global melalui terminal Anda untuk memastikan semua dependensi ditangani dengan benar.
Buka Terminal Anda dan jalankan perintah berikut untuk menginstal paket:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Catatan: Variabel lingkungan CLAUDE_CODE_RELEASE_ALPHA=1 saat ini diperlukan selama fase beta/alfa publik untuk mengakui status pratinjau alat.
Perintah ini mengunduh paket dari repositori npm resmi dan menautkan eksekusi claude ke direktori bin global sistem Anda. Meskipun beberapa pengguna mungkin mencoba mencari formula Homebrew, metode npm adalah satu-satunya jalur instalasi yang didukung dan didokumentasikan secara resmi.
Memverifikasi Instalasi
Setelah instalasi selesai, verifikasi bahwa CLI telah dipetakan dengan benar ke lingkungan Anda dengan menjalankan:
| claude –version |
Perintah ini akan menampilkan nomor versi saat ini (misalnya, 0.2.9). Jika Anda menemukan kesalahan "command not found", itu biasanya berarti direktori npm global Anda tidak ada dalam PATH sistem Anda.
Menurut dokumentasi pemecahan masalah resmi, Anda dapat memperbaikinya dengan mengidentifikasi awalan npm Anda dengan `npm config get prefix` dan memastikan folder /bin yang dihasilkan ditambahkan ke file .zshrc atau .bashrc Anda.
Menginstal Claude Code di Windows
Instalasi Windows menawarkan dua pendekatan utama: instalasi PowerShell asli atau menggunakan Windows Subsystem for Linux (WSL). Dokumentasi resmi merekomendasikan PowerShell untuk sebagian besar pengguna.
Metode Instalasi PowerShell
Buka PowerShell sebagai Administrator (klik kanan menu Mulai dan pilih "Windows PowerShell (Admin)"). Jalankan perintah ini:
| irm claude.ai/install.ps1 | iex |
Skrip PowerShell menangani unduhan, instalasi, dan konfigurasi PATH secara otomatis. Setelah selesai, tutup dan buka kembali PowerShell untuk memastikan pembaruan PATH berlaku.
Metode Instalasi WSL
Pengembang yang sudah menggunakan WSL dapat menginstal Claude Code menggunakan metode Linux. Buka terminal WSL dan jalankan perintah curl yang sama yang digunakan untuk Linux:
| curl -fsSL claude.ai/install.sh | bash |
Pendekatan WSL bekerja identik dengan instalasi Linux asli. Satu keuntungan: WSL menyediakan lingkungan yang lebih mirip Unix yang cocok dengan konfigurasi server produksi.
Menurut dokumentasi pemecahan masalah resmi, pengguna WSL sesekali mengalami masalah konektivitas jaringan. Jika instalasi macet, verifikasi bahwa WSL dapat mengakses jaringan eksternal dan aturan firewall tidak memblokir lalu lintas.
Temukan Kredit Claude dan Alat AI di Satu Tempat
Menginstal Claude Code CLI adalah satu langkah. Membayar alat AI dalam jangka panjang adalah langkah lainnya. Get AI Perks mengumpulkan kredit startup dan diskon perangkat lunak untuk alat AI dan cloud di satu tempat. Ini memberi pendiri akses ke 200+ penawaran, termasuk penawaran dari Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom, dan lainnya. Platform ini juga menampilkan kondisi penawaran dan panduan untuk mengklaim setiap penawaran.
Mencari Kredit Claude atau Anthropic?
Periksa Get AI Perks untuk:
- menemukan kredit dan diskon alat AI di satu tempat
- meninjau kondisi penawaran sebelum mengajukan
- mengakses panduan untuk mengklaim penawaran startup
👉 Kunjungi Get AI Perks untuk melihat penawaran Claude, Anthropic, dan perangkat lunak AI lainnya yang tersedia.
Otentikasi dan Konfigurasi Awal
Setelah instalasi, Claude Code memerlukan otentikasi sebelum dapat berfungsi. Alat ini menggunakan kunci API dari Anthropic untuk memverifikasi akses.
Mulai proses otentikasi dengan menjalankan:
| claude |
Saat perintah ini dijalankan pertama kali, Claude Code akan meminta otentikasi. Menurut panduan cepat resmi, ini akan membuka jendela peramban untuk masuk ke akun Anthropic.
Setelah masuk melalui peramban, CLI akan menerima token otentikasi secara otomatis. Token ini disimpan secara lokal dan tetap ada di berbagai sesi, jadi otentikasi berulang tidak diperlukan.
Mengonfigurasi Pengaturan Tingkat Proyek
Claude Code mendukung konfigurasi di berbagai tingkat sesuai dokumentasi pengaturan resmi. Tingkat konfigurasi yang paling umum adalah:
| Lingkup | Lokasi | Kasus Penggunaan |
|---|---|---|
| Pengguna | Direktori ~/.claude/ | Preferensi pribadi di semua proyek |
| Proyek | .claude/ di repositori | Konfigurasi tim bersama |
| Lokal | .claude/settings.local.json | Timpaan spesifik mesin |
Untuk penyiapan pertama kali, konfigurasi tingkat pengguna sudah cukup. Pengaturan tingkat proyek menjadi penting saat bekerja dengan tim yang berbagi standar pengodean.
Memulai Sesi Claude Code Pertama Anda
Dengan instalasi dan otentikasi selesai, luncurkan Claude Code dengan menjalankan perintah tanpa argumen:
| claude |
Ini memulai mode interaktif di mana Claude merespons permintaan bahasa alami. Dokumentasi resmi menggambarkan mode interaktif sebagai cara utama untuk menggunakan Claude Code untuk tugas-tugas pengembangan.
Coba perintah uji sederhana:
| Tunjukkan struktur proyek ini |
Claude Code menganalisis direktori saat ini dan memberikan gambaran umum tentang struktur basis kode. Ini menunjukkan bahwa instalasi berfungsi dengan benar dan Claude memiliki akses untuk membaca file.
Perintah Penting untuk Penggunaan Sehari-hari
Selain mode interaktif, Claude Code mendukung beberapa pola perintah yang didokumentasikan dalam referensi CLI:
| Pola Perintah | Tujuan | Contoh |
|---|---|---|
| claude | Mulai sesi interaktif | claude |
| claude "tugas" | Jalankan tugas sekali pakai | claude "perbaiki kesalahan linting" |
| claude -p "kueri" | Kueri cepat tanpa sesi | claude -p "apa yang dilakukan fungsi ini" |
Pola tugas sekali pakai sangat berguna untuk alur kerja CI/CD dan skrip otomatisasi di mana sesi interaktif tidak sesuai.
Pemecahan Masalah Instalasi Umum
Bahkan dengan skrip instalasi otomatis, terkadang masalah terjadi. Dokumentasi pemecahan masalah resmi mencakup masalah yang paling sering terjadi.
Kesalahan Perintah Tidak Ditemukan
Jika terminal menampilkan "command not found: claude" setelah instalasi, konfigurasi PATH tidak selesai dengan benar. Untuk macOS dan Linux, tambahkan lokasi biner Claude ke file konfigurasi shell secara manual.
Untuk pengguna bash, edit ~/.bashrc atau ~/.bash_profile dan tambahkan:
| export PATH=”$HOME/.local/bin:$PATH” |
Untuk pengguna zsh (default di macOS modern), edit ~/.zshrc dengan baris yang sama. Setelah menyimpan, muat ulang konfigurasi dengan `source ~/.zshrc` atau buka jendela terminal baru.
Masalah Jaringan dan Firewall
Jaringan perusahaan dan firewall yang ketat terkadang memblokir skrip instalasi. Menurut dokumentasi pemecahan masalah, jika instalasi macet atau mengembalikan HTML alih-alih mengeksekusi, akses jaringan ke server Anthropic mungkin diblokir.
Solusi alternatifnya adalah mengunduh skrip instalasi secara terpisah:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Pendekatan ini memberikan visibilitas lebih besar ke dalam apa yang gagal jika terjadi kesalahan selama pengunduhan atau eksekusi.
Masalah Khusus WSL
Pengguna Windows yang menjalankan WSL terkadang mengalami masalah konektivitas antara subsistem Linux dan Windows. Dokumentasi resmi menyebutkan bahwa aturan firewall mungkin perlu disesuaikan untuk mengizinkan lalu lintas WSL.
Jika Claude Code berhasil diinstal tetapi tidak dapat menjangkau server Anthropic untuk otentikasi, periksa bahwa firewall Windows mengizinkan akses jaringan WSL. Panduan pemecahan masalah menyediakan perintah PowerShell spesifik untuk mengonfigurasi aturan firewall.
Memperbarui Claude Code
Claude Code menerima pembaruan rutin dengan fitur dan peningkatan baru. Menurut dokumentasi resmi, pembaruan diinstal menggunakan perintah yang sama dengan instalasi awal.
Jalankan kembali skrip instalasi:
| curl -fsSL code.anthropic.com/install.sh | sh |
Skrip mendeteksi instalasi yang ada dan memperbaruinya ke versi terbaru. Tidak ada konfigurasi atau otentikasi yang hilang selama proses pembaruan.
Periksa versi saat ini sebelum dan sesudah memperbarui:
| claude –version |
Catatan perubahan dalam dokumentasi resmi Claude Code mencantumkan semua perubahan antar versi, yang membantu menentukan apakah pembaruan memperkenalkan fitur yang relevan dengan alur kerja tertentu.
Langkah Selanjutnya Setelah Instalasi
Dengan Claude Code terinstal dan berfungsi, eksplorasi fitur lanjutan menjadi mungkin. Dokumentasi resmi menjelaskan beberapa area yang layak untuk diselidiki:
- Keterampilan dan kustomisasi: Menurut dokumentasi keterampilan resmi, Claude Code mendukung keterampilan kustom yang ditentukan dalam file Markdown di direktori .claude/skills/. Keterampilan ini memperluas kemampuan Claude dengan perintah dan alur kerja spesifik proyek.
- Model Context Protocol (MCP): Integrasi MCP memungkinkan Claude Code terhubung dengan alat dan layanan eksternal. Ini mengubah Claude menjadi hub yang dapat mengakses database, API, dan sumber daya pengembangan lainnya.
- Kolaborasi tim: File konfigurasi tingkat proyek di direktori .claude/ dapat dikomit ke kontrol versi, berbagi pengaturan Claude Code di seluruh tim pengembang.
- Dokumentasi resmi menyediakan panduan terperinci untuk setiap area ini, berdasarkan instalasi dasar yang dibahas di sini.
Pertanyaan yang Sering Diajukan
Apakah saya perlu langganan Claude berbayar untuk menggunakan Claude Code CLI?
Claude Code memerlukan akun Claude dari Anthropic, tetapi tingkat langganan yang spesifik diperlukan tergantung pada penggunaan. Menurut dokumentasi resmi, otentikasi diperlukan tetapi detail harga harus diverifikasi di situs web resmi Anthropic karena rencana berubah seiring waktu.
Bisakah saya menginstal Claude Code tanpa hak administrator?
Di macOS dan Linux, Claude Code diinstal ke direktori home pengguna secara default dan tidak memerlukan akses administrator. Pengguna Windows mungkin memerlukan hak administrator untuk metode instalasi PowerShell, meskipun instalasi WSL tidak memerlukan akses admin.
Apakah Claude Code berfungsi secara offline?
Tidak. Claude Code adalah alat bertenaga AI yang berkomunikasi dengan server Anthropic untuk memproses permintaan. Menurut dokumentasi resmi, koneksi internet aktif diperlukan agar Claude dapat menganalisis kode dan menghasilkan respons.
Bagaimana cara mencopot pemasangan Claude Code?
Dokumentasi penyiapan lanjutan resmi menjelaskan bahwa mencopot pemasangan melibatkan penghapusan biner dan file konfigurasi. Di macOS dan Linux, hapus direktori ~/.claude dan hapus modifikasi PATH dari file konfigurasi shell. Pengguna Windows harus menghapus direktori instalasi dan menghapus variabel lingkungan PATH.
Bisakah Claude Code mengakses seluruh sistem file saya?
Secara default, Claude Code beroperasi dalam direktori kerja saat ini dan subdirektorinya. Menurut dokumentasi izin resmi, akses dapat dibatasi lebih lanjut menggunakan pengaturan sandbox dalam file konfigurasi. Claude selalu meminta konfirmasi sebelum mengeksekusi operasi yang berpotensi merusak.
Apa perbedaan antara Claude Code CLI dan Claude Desktop?
Claude Code CLI berjalan di terminal dan berfokus pada alur kerja pengembangan dengan akses langsung ke sistem file dan eksekusi perintah. Claude Desktop adalah aplikasi mandiri dengan antarmuka grafis. Kedua alat melayani kasus penggunaan yang berbeda, dengan CLI dioptimalkan untuk pengembang yang lebih memilih alur kerja berbasis terminal.
Seberapa sering saya harus memperbarui Claude Code?
Pembaruan dapat diinstal kapan saja. Catatan perubahan resmi mendokumentasikan fitur baru dan perbaikan bug. Untuk tim, mengoordinasikan pembaruan memastikan semua orang menggunakan versi yang kompatibel, meskipun Claude Code mempertahankan kompatibilitas mundur dengan file konfigurasi di berbagai versi.
Kesimpulan
Menginstal Claude Code CLI hanya membutuhkan waktu beberapa menit terlepas dari sistem operasi. Skrip instalasi otomatis menangani konfigurasi, penyiapan PATH, dan penempatan biner tanpa campur tangan manual.
Setelah instalasi dan otentikasi, Claude Code menjadi asisten pengodean AI yang kuat yang dapat diakses dari terminal mana pun. Perintah bahasa alami memungkinkan pengembang untuk menulis kode, memperbaiki bug, dan mengotomatiskan tugas tanpa meninggalkan baris perintah.
Siap merasakan pengembangan berbantuan AI? Jalankan perintah instalasi untuk platform Anda dan mulai sesi Claude Code pertama Anda hari ini. Dokumentasi resmi di code.claude.com menyediakan panduan komprehensif untuk fitur lanjutan setelah penyiapan dasar selesai.
