Langsung ke konten utama

Persyaratan sistem

  • Sistem Operasi: macOS 13.0+, Ubuntu 20.04+/Debian 10+, atau Windows 10+ (dengan WSL 1, WSL 2, atau Git untuk Windows)
  • Perangkat Keras: RAM 4 GB+
  • Jaringan: Koneksi internet diperlukan (lihat konfigurasi jaringan)
  • Shell: Bekerja terbaik di Bash atau Zsh
  • Lokasi: Negara yang didukung Anthropic

Dependensi tambahan

Instalasi

To install Claude Code, use one of the following methods: Setelah proses instalasi selesai, navigasikan ke proyek Anda dan mulai Claude Code:
cd your-awesome-project
claude
Jika Anda mengalami masalah apa pun selama instalasi, konsultasikan panduan pemecahan masalah.
Jalankan claude doctor setelah instalasi untuk memeriksa jenis dan versi instalasi Anda.
Alpine Linux dan distribusi berbasis musl/uClibc lainnya: Penginstal asli memerlukan libgcc, libstdc++, dan ripgrep. Untuk Alpine: apk add libgcc libstdc++ ripgrep. Atur USE_BUILTIN_RIPGREP=0.

Autentikasi

Untuk individu

  1. Paket Claude Pro atau Max (direkomendasikan): Berlangganan paket Pro atau Max Claude untuk langganan terpadu yang mencakup Claude Code dan Claude di web. Kelola akun Anda di satu tempat dan masuk dengan akun Claude.ai Anda.
  2. Claude Console: Terhubung melalui Claude Console dan selesaikan proses OAuth. Memerlukan penagihan aktif di Konsol Anthropic. Ruang kerja “Claude Code” dibuat secara otomatis untuk pelacakan penggunaan dan manajemen biaya. Anda tidak dapat membuat kunci API untuk ruang kerja Claude Code; ini didedikasikan secara eksklusif untuk penggunaan Claude Code.

Untuk tim dan organisasi

  1. Claude untuk Tim atau Perusahaan (direkomendasikan): Berlangganan Claude untuk Tim atau Claude untuk Perusahaan untuk penagihan terpusat, manajemen tim, dan akses ke Claude Code dan Claude di web. Anggota tim masuk dengan akun Claude.ai mereka.
  2. Claude Console dengan penagihan tim: Siapkan organisasi Claude Console bersama dengan penagihan tim. Undang anggota tim dan tetapkan peran untuk pelacakan penggunaan.
  3. Penyedia cloud: Konfigurasikan Claude Code untuk menggunakan Amazon Bedrock, Google Vertex AI, atau Microsoft Foundry untuk penyebaran dengan infrastruktur cloud yang ada.

Instal versi tertentu

Penginstal asli menerima nomor versi tertentu atau saluran rilis (latest atau stable). Saluran yang Anda pilih saat instalasi menjadi default untuk pembaruan otomatis. Lihat Konfigurasikan 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 1.0.58

Integritas biner dan penandatanganan kode

  • Checksum SHA256 untuk semua platform dipublikasikan dalam manifes rilis, saat ini berlokasi di https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json (contoh: ganti {VERSION} dengan 2.0.30)
  • Biner yang ditandatangani didistribusikan untuk platform berikut:
    • macOS: Ditandatangani oleh “Anthropic PBC” dan dinotarisi oleh Apple
    • Windows: Ditandatangani oleh “Anthropic, PBC”

Instalasi NPM (sudah usang)

Instalasi NPM sudah usang. Gunakan metode instalasi asli jika memungkinkan. Untuk memigrasikan instalasi npm yang ada ke asli, jalankan claude install. Instalasi npm global
npm install -g @anthropic-ai/claude-code
JANGAN gunakan sudo npm install -g karena ini dapat menyebabkan masalah izin dan risiko keamanan. Jika Anda mengalami kesalahan izin, lihat pemecahan masalah kesalahan izin untuk solusi yang direkomendasikan.

Pengaturan Windows

Opsi 1: Claude Code dalam WSL
  • Baik WSL 1 maupun WSL 2 didukung
Opsi 2: Claude Code di Windows asli dengan Git Bash
  • Memerlukan Git untuk Windows
  • Untuk instalasi Git portabel, tentukan jalur ke bash.exe Anda:
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
    

Perbarui Claude Code

Pembaruan otomatis

Claude Code secara otomatis memperbarui dirinya sendiri untuk memastikan Anda memiliki fitur dan perbaikan keamanan terbaru.
  • Pemeriksaan pembaruan: Dilakukan saat startup dan secara berkala saat berjalan
  • Proses pembaruan: Mengunduh dan menginstal secara otomatis di latar belakang
  • Notifikasi: Anda akan melihat notifikasi ketika pembaruan diinstal
  • Menerapkan pembaruan: Pembaruan berlaku saat Anda memulai Claude Code berikutnya
Instalasi Homebrew dan WinGet tidak diperbarui secara otomatis. Gunakan brew upgrade claude-code atau winget upgrade Anthropic.ClaudeCode untuk memperbarui secara manual.Masalah yang diketahui: Claude Code mungkin memberi tahu Anda tentang pembaruan sebelum versi baru tersedia di pengelola paket ini. Jika upgrade gagal, tunggu dan coba lagi nanti.

Konfigurasikan saluran rilis

Konfigurasikan 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 lebih lama, melewati rilis dengan regresi besar
Konfigurasikan ini melalui /configSaluran pembaruan otomatis, atau tambahkan ke file settings.json Anda:
{
  "autoUpdatesChannel": "stable"
}
Untuk penyebaran perusahaan, Anda dapat memberlakukan saluran rilis yang konsisten di seluruh organisasi Anda menggunakan pengaturan terkelola.

Nonaktifkan pembaruan otomatis

Atur variabel lingkungan DISABLE_AUTOUPDATER di shell Anda atau file settings.json:
export DISABLE_AUTOUPDATER=1

Perbarui secara manual

claude update

Copot Claude Code

Jika Anda perlu mencopot Claude Code, ikuti instruksi untuk metode instalasi Anda.

Instalasi asli

Hapus biner Claude Code dan file versi: macOS, Linux, WSL:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Windows PowerShell:
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Windows CMD:
del "%USERPROFILE%\.local\bin\claude.exe"
rmdir /s /q "%USERPROFILE%\.local\share\claude"

Instalasi Homebrew

brew uninstall --cask claude-code

Instalasi WinGet

winget uninstall Anthropic.ClaudeCode

Instalasi NPM

npm uninstall -g @anthropic-ai/claude-code

Bersihkan file konfigurasi (opsional)

Menghapus file konfigurasi akan menghapus semua pengaturan, alat yang diizinkan, konfigurasi server MCP, dan riwayat sesi Anda.
Untuk menghapus pengaturan dan data cache Claude Code: macOS, Linux, WSL:
# 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
Windows PowerShell:
# Hapus pengaturan pengguna dan status
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Hapus pengaturan khusus proyek (jalankan dari direktori proyek Anda)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force
Windows CMD:
REM Hapus pengaturan pengguna dan status
rmdir /s /q "%USERPROFILE%\.claude"
del "%USERPROFILE%\.claude.json"

REM Hapus pengaturan khusus proyek (jalankan dari direktori proyek Anda)
rmdir /s /q ".claude"
del ".mcp.json"