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.Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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. Pada Windows asli, Git for Windows direkomendasikan; Claude Code kembali ke PowerShell ketika Git Bash tidak ada. Pengaturan WSL tidak memerlukan Git for Windows.
- Lokasi: negara yang didukung Anthropic
Dependensi tambahan
- ripgrep: biasanya disertakan dengan Claude Code. Jika pencarian gagal, lihat troubleshooting pencarian.
Instal Claude Code
To install Claude Code, use one of the following methods:- Native Install (Recommended)
- Homebrew
- WinGet
macOS, Linux, WSL:Windows PowerShell:Windows CMD:If you see
The token '&&' is not a valid statement separator, you’re in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you’re in CMD, not PowerShell. Your prompt shows PS C:\ when you’re in PowerShell and C:\ without the PS when you’re in CMD.Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.Native installations automatically update in the background to keep you on the latest version.
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 | Memerlukan | Sandboxing | Kapan digunakan |
|---|---|---|---|
| Windows Asli | Git for Windows direkomendasikan; PowerShell digunakan jika tidak ada | Tidak didukung | Proyek dan alat Windows asli |
| WSL 2 | WSL 2 diaktifkan | Didukung | Toolchain Linux atau eksekusi perintah bersandbox |
| WSL 1 | WSL 1 diaktifkan | Tidak didukung | Jika WSL 2 tidak tersedia |
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 PowerShell, CMD, atau Git Bash. Ketika Git Bash diinstal, Claude Code menggunakannya secara internal untuk menjalankan perintah terlepas dari tempat Anda meluncurkannya. Jika Claude Code tidak dapat menemukan instalasi Git Bash Anda, atur jalur di file settings.json Anda:
CLAUDE_CODE_USE_POWERSHELL_TOOL=1 untuk memilih masuk atau 0 untuk memilih keluar. Lihat PowerShell tool 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 memerlukanlibgcc, libstdc++, dan ripgrep. Instal ini menggunakan manajer paket distribusi Anda, kemudian atur USE_BUILTIN_RIPGREP=0.
Contoh ini menginstal paket yang diperlukan di Alpine:
USE_BUILTIN_RIPGREP ke 0 di file settings.json Anda:
Verifikasi instalasi Anda
Setelah menginstal, konfirmkan Claude Code berfungsi: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 Vertex AI, atau Microsoft Foundry. Setelah menginstal, masuk dengan menjalankanclaude 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.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 danclaude 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
/config → Auto-update channel, atau tambahkan ke file settings.json Anda:
claude-code melacak stable dan claude-code@latest melacak latest.
Tetapkan versi minimum
PengaturanminimumVersion 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:
Nonaktifkan pembaruan otomatis
AturDISABLE_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):
- macOS, Linux, WSL
- Windows PowerShell
- Windows CMD
- macOS, Linux, WSL
- Windows PowerShell
- Windows CMD
- macOS, Linux, WSL
- Windows PowerShell
- Windows CMD
Instal dengan manajer paket Linux
Claude Code menerbitkan repositori apt, dnf, dan apk yang ditandatangani. Gantistable dengan latest untuk saluran rolling. 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.
- apt
- dnf
- apk
Untuk Debian dan Ubuntu. Untuk menggunakan saluran rolling, ubah kedua kemunculan Verifikasi sidik jari kunci GPG sebelum mempercayainya:
stable di baris deb: jalur URL dan nama suite.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. Paket memerlukan Node.js 18 atau lebih baru.@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.
Integritas biner dan penandatanganan kode
Setiap rilis menerbitkanmanifest.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 dengangpg dan curl. Di Windows, jalankan di Git Bash atau WSL. Langkah 4 mencakup opsi PowerShell.
Unduh dan impor kunci publik
Kunci penandatanganan rilis dipublikasikan di URL tetap.Tampilkan sidik jari kunci yang diimpor.Konfirmasi output mencakup sidik jari ini:
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.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-releasesatau 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. Jikaclaude 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:- macOS, Linux, WSL
- Windows PowerShell
Instalasi Homebrew
Hapus cask Homebrew yang Anda instal. Jika Anda menginstal cask stabil:Instalasi WinGet
Hapus paket WinGet:apt / dnf / apk
Hapus paket dan konfigurasi repositori:- apt
- dnf
- apk
npm
Hapus paket npm global:Hapus file konfigurasi
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:
- macOS, Linux, WSL
- Windows PowerShell