Langsung ke konten utama
Halaman ini mencakup persyaratan sistem, detail instalasi khusus platform, pembaruan, dan penghapusan instalasi. Untuk panduan langkah demi langkah sesi pertama Anda, lihat quickstart. Jika Anda belum pernah menggunakan terminal sebelumnya, lihat panduan terminal.

Persyaratan sistem

Claude Code berjalan pada platform dan konfigurasi berikut:
  • Sistem operasi:
    • macOS 13.0+
    • Windows 10 1809+ atau Windows Server 2019+
    • Ubuntu 20.04+
    • Debian 10+
    • Alpine Linux 3.19+
  • Perangkat keras: RAM 4 GB+, prosesor x64 atau ARM64
  • Jaringan: koneksi internet diperlukan. Lihat konfigurasi jaringan.
  • Shell: Bash, Zsh, PowerShell, atau CMD.
  • Lokasi: negara yang didukung Anthropic

Dependensi tambahan

Instal Claude Code

Lebih suka antarmuka grafis? Aplikasi Desktop memungkinkan Anda menggunakan Claude Code tanpa terminal. Unduh untuk macOS, Windows, atau Linux.Baru mengenal terminal? Lihat panduan terminal untuk instruksi langkah demi langkah.
To install Claude Code, use one of the following methods: You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine. Setelah instalasi selesai, buka terminal di proyek yang ingin Anda kerjakan dan mulai Claude Code:
Jika Anda mengalami masalah apa pun selama instalasi, lihat Troubleshoot installation and login.

Pengaturan di Windows

Anda dapat menjalankan Claude Code secara asli di Windows atau di dalam WSL. Pilih berdasarkan di mana proyek Anda berada dan fitur apa yang Anda butuhkan: Opsi 1: Windows Asli Jalankan perintah instalasi dari PowerShell atau CMD. Anda tidak perlu menjalankan sebagai Administrator. Menginstal Git for Windows bersifat opsional. Ini mengaktifkan alat Bash dengan menyediakan Git Bash. Apakah Anda menginstal dari PowerShell atau CMD hanya mempengaruhi perintah instalasi mana yang Anda jalankan. Prompt Anda menampilkan PS C:\Users\YourName> di PowerShell dan C:\Users\YourName> tanpa PS di CMD. Jika Anda baru mengenal terminal, panduan terminal memandu setiap langkah. Setelah instalasi, luncurkan claude dari terminal apa pun.
  • Tanpa Git for Windows, Claude Code menjalankan perintah shell melalui alat PowerShell.
  • Dengan Git for Windows, Claude Code menggunakan Git Bash untuk alat Bash. Jika Claude Code tidak dapat menemukan Git Bash, atur jalur di file settings.json Anda:
Ketika Git for Windows diinstal, alat PowerShell sedang diluncurkan secara progresif sebagai opsi tambahan bersama Bash. Atur CLAUDE_CODE_USE_POWERSHELL_TOOL=1 untuk memilih masuk atau 0 untuk memilih keluar. Lihat alat PowerShell untuk pengaturan dan batasan. Opsi 2: WSL Buka distribusi WSL Anda dan jalankan penginstal Linux dari instruksi instalasi di atas. Anda menginstal dan meluncurkan claude di dalam terminal WSL, bukan dari PowerShell atau CMD.

Alpine Linux dan distribusi berbasis musl

Penginstal asli di Alpine dan distribusi berbasis musl/uClibc lainnya memerlukan libgcc, libstdc++, dan ripgrep. Instal ini menggunakan manajer paket distribusi Anda, kemudian atur USE_BUILTIN_RIPGREP=0. Contoh ini menginstal paket yang diperlukan di Alpine:
Kemudian atur USE_BUILTIN_RIPGREP ke 0 di file settings.json Anda:

Verifikasi instalasi Anda

Setelah menginstal, konfirmkan Claude Code berfungsi:
Jika ini gagal dengan command not found atau kesalahan lainnya, lihat Troubleshoot installation and login. Untuk pemeriksaan yang lebih terperinci tentang instalasi dan konfigurasi Anda, jalankan claude doctor:

Autentikasi

Claude Code memerlukan akun Pro, Max, Team, Enterprise, atau Console. Paket Claude.ai gratis tidak termasuk akses Claude Code. Anda juga dapat menggunakan Claude Code dengan penyedia API pihak ketiga seperti Amazon Bedrock, Google Cloud’s Agent Platform, atau Microsoft Foundry. Setelah menginstal, masuk dengan menjalankan claude dan mengikuti petunjuk browser. Lihat Autentikasi untuk semua jenis akun dan opsi pengaturan tim.

Perbarui Claude Code

Instalasi asli secara otomatis diperbarui di latar belakang. Anda dapat mengonfigurasi saluran rilis untuk mengontrol apakah Anda menerima pembaruan segera atau sesuai jadwal stabil yang tertunda, atau menonaktifkan pembaruan otomatis sepenuhnya. Instalasi Homebrew, WinGet, dan manajer paket Linux memerlukan pembaruan manual secara default.

Pembaruan otomatis

Claude Code memeriksa pembaruan saat startup dan secara berkala saat berjalan. Pembaruan diunduh dan diinstal di latar belakang, kemudian berlaku saat Anda memulai Claude Code berikutnya. Jalankan claude doctor untuk melihat hasil upaya pembaruan terbaru. Di macOS dan Linux, installer asli mengelola launcher di ~/.local/bin/claude sebagai symlink ke ~/.local/share/claude/versions/. Jika Anda mengganti launcher itu dengan skrip atau symlink Anda sendiri, auto-update dan claude update membiarkannya tetap ada: versi baru masih diinstal di bawah direktori versions/, dan launcher Anda memutuskan versi mana yang berjalan. Sebelum v2.1.207, auto-updater mengganti launcher kustom di jalur itu dengan symlink miliknya sendiri pada setiap pembaruan. Dengan launcher kustom, Claude Code juga menyimpan setiap versi yang diinstal di disk karena tidak dapat menentukan versi mana yang dibutuhkan launcher. claude doctor melaporkan launcher yang tidak dibuat oleh installer asli. Untuk membiarkan Claude Code mengelola launcher lagi, hapus ~/.local/bin/claude dan jalankan claude update. Jika instalasi npm global tidak dapat auto-update karena direktori global npm tidak dapat ditulis, Claude Code menampilkan pemberitahuan satu kali saat startup, dan claude doctor mencantumkan perbaikan yang tersedia. Lihat permission errors during installation untuk detail.
Instalasi Homebrew, WinGet, apt, dnf, dan apk tidak auto-update secara default; lihat di bawah untuk memilih masuk untuk Homebrew dan WinGet. Untuk upgrade Homebrew secara manual, jalankan brew upgrade claude-code atau brew upgrade claude-code@latest, tergantung cask mana yang Anda instal. Untuk WinGet, jalankan winget upgrade Anthropic.ClaudeCode. Untuk manajer paket Linux, lihat perintah upgrade di Install with Linux package managers.Untuk membuat Claude Code menjalankan perintah upgrade untuk Anda di Homebrew atau WinGet, atur CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE ke 1. Claude Code kemudian menjalankan upgrade di latar belakang ketika versi baru tersedia dan menampilkan prompt restart saat berhasil. Upgrade menargetkan hanya paket Claude Code dan tidak mempengaruhi perangkat lunak lain yang telah Anda instal.Di WinGet upgrade mungkin gagal saat Claude Code berjalan karena Windows mengunci executable. Dalam hal itu Claude Code menampilkan perintah manual sebagai gantinya. apt, dnf, dan apk terus memerlukan upgrade manual karena perintah tersebut memerlukan privilege yang ditingkatkan.Masalah yang diketahui: Claude Code dapat memberi tahu Anda tentang pembaruan sebelum versi baru tersedia di manajer paket ini. Jika upgrade gagal, tunggu dan coba lagi nanti.Homebrew menyimpan versi lama di disk setelah upgrade. Jalankan brew cleanup secara berkala untuk membebaskan ruang disk.

Konfigurasi saluran rilis

Kontrol saluran rilis mana yang diikuti Claude Code untuk pembaruan otomatis dan claude update dengan pengaturan autoUpdatesChannel:
  • "latest", default: terima fitur baru segera setelah dirilis
  • "stable": gunakan versi yang biasanya sekitar satu minggu lama, lewati rilis dengan regresi besar
Konfigurasi ini melalui /configAuto-update channel, atau tambahkan ke file settings.json Anda:
Untuk penerapan enterprise, Anda dapat memberlakukan saluran rilis yang konsisten di seluruh organisasi Anda menggunakan managed settings. Instalasi Homebrew memilih saluran berdasarkan nama cask sebagai gantinya: claude-code melacak stable dan claude-code@latest melacak latest.

Tetapkan versi minimum

Pengaturan minimumVersion menetapkan batas bawah. Pembaruan otomatis latar belakang dan claude update menolak untuk menginstal versi apa pun di bawah nilai ini, jadi beralih ke saluran "stable" tidak menurunkan Anda jika Anda sudah di build "latest" yang lebih baru. Beralih dari "latest" ke "stable" melalui /config meminta Anda untuk tetap di versi saat ini atau memungkinkan downgrade. Memilih untuk tetap menetapkan minimumVersion ke versi itu. Beralih kembali ke "latest" menghapusnya. Tambahkan ke file settings.json Anda untuk menetapkan batas secara eksplisit:
Dalam managed settings, ini memberlakukan minimum di seluruh organisasi yang tidak dapat ditimpa oleh pengaturan pengguna dan proyek. Pengaturan minimumVersion hanya membatasi pembaruan. Untuk membuat Claude Code menolak untuk memulai di luar rentang versi, gunakan pengaturan terkelola requiredMinimumVersion dan requiredMaximumVersion sebagai gantinya. Pembaruan juga menghormati batas requiredMaximumVersion. Lihat available settings.

Nonaktifkan pembaruan otomatis

Atur DISABLE_AUTOUPDATER ke "1" di kunci env dari file settings.json Anda:
DISABLE_AUTOUPDATER hanya menghentikan pemeriksaan latar belakang; claude update dan claude install masih berfungsi. Untuk memblokir semua jalur pembaruan, termasuk pembaruan manual, atur DISABLE_UPDATES sebagai gantinya. Gunakan ini ketika Anda mendistribusikan Claude Code melalui saluran Anda sendiri dan perlu pengguna tetap di versi yang Anda sediakan.

Perbarui secara manual

Untuk menerapkan pembaruan segera tanpa menunggu pemeriksaan latar belakang berikutnya, jalankan:

Opsi instalasi lanjutan

Opsi ini untuk version pinning, manajer paket Linux, npm, dan verifikasi integritas biner.

Instal versi tertentu

Penginstal asli menerima nomor versi tertentu atau saluran rilis (latest atau stable). Saluran yang Anda pilih saat instalasi menjadi default Anda untuk pembaruan otomatis. Lihat konfigurasi saluran rilis untuk informasi lebih lanjut. Untuk menginstal versi terbaru (default):
Untuk menginstal versi stabil:
Untuk menginstal nomor versi tertentu:

Instal dengan manajer paket Linux

Claude Code menerbitkan repositori apt, dnf, dan apk yang ditandatangani. Setiap repositori menawarkan dua saluran: stable melayani versi yang biasanya sekitar satu minggu lama, melewati rilis dengan regresi besar, dan latest melayani setiap rilis segera setelah dikirim. Perintah di bawah mengonfigurasi saluran stable, yang sesuai untuk sebagian besar pengguna; setiap tab juga menunjukkan URL repositori latest. Instalasi manajer paket tidak auto-update melalui Claude Code; pembaruan tiba melalui alur upgrade sistem normal Anda. Semua repositori ditandatangani dengan kunci penandatanganan rilis Claude Code. Sebelum mempercayai kunci, verifikasi seperti yang dijelaskan di setiap tab.
Untuk Debian dan Ubuntu. Perintah instalasi di bawah mengunduh kunci penandatanganan dengan curl, yang instalasi Debian dan Ubuntu segar mungkin tidak sertakan. Jika unduhan gagal dengan sudo: curl: command not found, instal curl terlebih dahulu:
Perintah berikut mengonfigurasi saluran stable:
Untuk menggunakan saluran latest sebagai gantinya, jalur URL dan nama suite keduanya berubah. Gunakan baris deb ini:
Verifikasi sidik jari kunci GPG sebelum mempercayainya: gpg --show-keys /etc/apt/keyrings/claude-code.asc harus melaporkan 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.Untuk upgrade nanti, jalankan sudo apt update && sudo apt upgrade claude-code.

Instal dengan npm

Anda juga dapat menginstal Claude Code sebagai paket npm global. Mulai dari v2.1.198, paket npm memerlukan Node.js 22 atau lebih baru. Pada versi Node.js yang lebih lama, npm mencetak peringatan EBADENGINE selama instalasi daripada gagal; instalasi selesai dan claude masih berjalan, karena paket mengunduh biner asli yang tidak menggunakan Node.js Anda saat runtime.
Paket npm menginstal biner asli yang sama dengan penginstal standalone. npm menarik biner melalui dependensi opsional per-platform seperti @anthropic-ai/claude-code-darwin-arm64, dan langkah postinstall menautkannya ke tempat. Biner claude yang terinstal tidak sendiri memanggil Node. Platform instalasi npm yang didukung adalah darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64, dan win32-arm64. Manajer paket Anda harus memungkinkan dependensi opsional. Lihat troubleshooting jika biner hilang setelah instalasi. Untuk upgrade instalasi npm, jalankan npm install -g @anthropic-ai/claude-code@latest. Hindari npm update -g, yang menghormati rentang semver dari instalasi asli dan mungkin tidak membawa Anda ke rilis terbaru.
JANGAN gunakan sudo npm install -g karena ini dapat menyebabkan masalah izin dan risiko keamanan. Jika Anda mengalami kesalahan izin, lihat troubleshooting kesalahan izin.

Integritas biner dan penandatanganan kode

Setiap rilis menerbitkan manifest.json yang berisi checksum SHA256 untuk setiap biner platform. Manifes ditandatangani dengan kunci GPG Anthropic, jadi memverifikasi tanda tangan pada manifes secara transitif memverifikasi setiap biner yang tercantum.

Verifikasi tanda tangan manifes

Langkah-langkah 1-3 memerlukan shell POSIX dengan gpg dan curl. Di Windows, jalankan di Git Bash atau WSL. Langkah 4 mencakup opsi PowerShell.
1

Unduh dan impor kunci publik

Kunci penandatanganan rilis dipublikasikan di URL tetap.
Tampilkan sidik jari kunci yang diimpor.
Konfirmasi output mencakup sidik jari ini:
2

Unduh manifes dan tanda tangan

Atur VERSION ke rilis yang ingin Anda verifikasi.
3

Verifikasi tanda tangan

Verifikasi tanda tangan terpisah terhadap manifes.
Hasil yang valid melaporkan Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>".gpg juga mencetak WARNING: This key is not certified with a trusted signature! untuk kunci yang baru diimpor. Ini diharapkan. Baris Good signature mengkonfirmasi pemeriksaan kriptografi lulus. Perbandingan sidik jari di Langkah 1 mengkonfirmasi kunci itu sendiri asli.
4

Periksa biner terhadap manifes

Bandingkan checksum SHA256 biner dengan nilai yang tercantum di bawah platforms.<platform>.checksum di manifest.json. Perintah di bawah mengasumsikan biner claude di direktori saat ini. Untuk memverifikasi biner asli yang terinstal sebagai gantinya, jalankan perintah terhadap ~/.local/share/claude/versions/VERSION, mengganti VERSION dengan rilis yang Anda atur di Langkah 2.
Tanda tangan manifes tersedia untuk rilis dari 2.1.89 ke depan. Rilis sebelumnya menerbitkan checksum di manifest.json tanpa tanda tangan terpisah.

Tanda tangan kode platform

Selain manifes yang ditandatangani, biner individual membawa tanda tangan kode native platform di mana didukung.
  • macOS: ditandatangani oleh “Anthropic PBC” dan dinotarisi oleh Apple. Verifikasi dengan codesign --verify --verbose ./claude.
  • Windows: ditandatangani oleh “Anthropic, PBC”. Verifikasi dengan Get-AuthenticodeSignature .\claude.exe.
  • Linux: biner tidak ditandatangani kode secara individual. Jika Anda mengunduh langsung dari bucket claude-code-releases atau menggunakan penginstal asli, verifikasi integritas dengan tanda tangan manifes di atas. Jika Anda menginstal dengan apt, dnf, atau apk, manajer paket Anda memverifikasi tanda tangan secara otomatis menggunakan kunci penandatanganan repositori.

Hapus instalasi Claude Code

Untuk menghapus Claude Code, ikuti instruksi untuk metode instalasi Anda. Jika claude masih berjalan setelahnya, Anda kemungkinan memiliki instalasi kedua atau alias shell yang tertinggal dari installer yang lebih lama. Lihat Periksa instalasi yang bertentangan untuk menemukan dan menghapusnya.

Instalasi asli

Hapus biner Claude Code dan file versi:

Instalasi Homebrew

Hapus cask Homebrew yang Anda instal. Jika Anda menginstal cask stabil:
Jika Anda menginstal cask latest:

Instalasi WinGet

Hapus paket WinGet:

apt / dnf / apk

Hapus paket dan konfigurasi repositori:

npm

Hapus paket npm global:

Hapus file konfigurasi

Menghapus file konfigurasi akan menghapus semua pengaturan, alat yang diizinkan, konfigurasi server MCP, dan riwayat sesi Anda.
Ekstensi VS Code, plugin JetBrains, dan Aplikasi Desktop juga menulis ke ~/.claude/. Jika salah satunya masih terinstal, direktori akan dibuat ulang saat berikutnya dijalankan. Untuk menghapus Claude Code sepenuhnya, copot ekstensi VS Code, plugin JetBrains, dan Aplikasi Desktop sebelum menghapus file ini. Untuk menghapus pengaturan Claude Code dan data cache: