Langsung ke konten utama

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.

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. 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

Instal Claude Code

Lebih suka antarmuka grafis? Aplikasi Desktop memungkinkan Anda menggunakan Claude Code tanpa terminal. Unduh untuk macOS atau Windows.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:
claude
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:
OpsiMemerlukanSandboxingKapan digunakan
Windows AsliGit for Windows direkomendasikan; PowerShell digunakan jika tidak adaTidak didukungProyek dan alat Windows asli
WSL 2WSL 2 diaktifkanDidukungToolchain Linux atau eksekusi perintah bersandbox
WSL 1WSL 1 diaktifkanTidak didukungJika WSL 2 tidak tersedia
Opsi 1: Windows Asli dengan Git Bash Instal Git for Windows, kemudian jalankan perintah instalasi dari PowerShell atau CMD. Anda tidak perlu menjalankan sebagai Administrator. 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 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:
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
Claude Code juga dapat menjalankan PowerShell secara asli di Windows. Ketika Git Bash diinstal, alat PowerShell sedang diluncurkan secara progresif sebagai opsi tambahan: atur 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 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:
apk add libgcc libstdc++ ripgrep
Kemudian atur USE_BUILTIN_RIPGREP ke 0 di file settings.json Anda:
{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Verifikasi instalasi Anda

Setelah menginstal, konfirmkan Claude Code berfungsi:
claude --version
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:
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 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.
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:
{
  "autoUpdatesChannel": "stable"
}
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:
{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}
Dalam managed settings, ini memberlakukan minimum di seluruh organisasi yang tidak dapat ditimpa oleh pengaturan pengguna dan proyek.

Nonaktifkan pembaruan otomatis

Atur DISABLE_AUTOUPDATER ke "1" di kunci env dari file settings.json Anda:
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}
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:
claude update

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):
curl -fsSL https://claude.ai/install.sh | bash
Untuk menginstal versi stabil:
curl -fsSL https://claude.ai/install.sh | bash -s stable
Untuk menginstal nomor versi tertentu:
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

Instal dengan manajer paket Linux

Claude Code menerbitkan repositori apt, dnf, dan apk yang ditandatangani. Ganti stable 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.
Untuk Debian dan Ubuntu. Untuk menggunakan saluran rolling, ubah kedua kemunculan stable di baris deb: jalur URL dan nama suite.
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code
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. Paket memerlukan Node.js 18 atau lebih baru.
npm install -g @anthropic-ai/claude-code
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.
curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import
Tampilkan sidik jari kunci yang diimpor.
gpg --fingerprint security@anthropic.com
Konfirmasi output mencakup sidik jari ini:
31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE
2

Unduh manifes dan tanda tangan

Atur VERSION ke rilis yang ingin Anda verifikasi.
REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"
3

Verifikasi tanda tangan

Verifikasi tanda tangan terpisah terhadap manifes.
gpg --verify manifest.json.sig manifest.json
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 yang diunduh dengan nilai yang tercantum di bawah platforms.<platform>.checksum di manifest.json.
sha256sum claude
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:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Instalasi Homebrew

Hapus cask Homebrew yang Anda instal. Jika Anda menginstal cask stabil:
brew uninstall --cask claude-code
Jika Anda menginstal cask latest:
brew uninstall --cask claude-code@latest

Instalasi WinGet

Hapus paket WinGet:
winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

Hapus paket dan konfigurasi repositori:
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

npm

Hapus paket npm global:
npm uninstall -g @anthropic-ai/claude-code

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:
# Hapus pengaturan pengguna dan status
rm -rf ~/.claude
rm ~/.claude.json

# Hapus pengaturan khusus proyek (jalankan dari direktori proyek Anda)
rm -rf .claude
rm -f .mcp.json