Key Takeaways
- Dua metode instalasi: Gunakan native installer (
curl -fsSL https://claude.ai/install.sh | bash) untuk pengaturan tanpa dependensi (zero-dependency), atau npm (npm install -g @anthropic-ai/claude-code) jika Anda perlu mematok versi (version pinning). - Persyaratan sistem minimal: macOS 13+, Linux (Ubuntu 20.04+/Debian 10+), atau Windows 10+ dengan WSL. Setidaknya 4GB RAM. Tidak perlu GPU.
- Akun diperlukan: Anda memerlukan akun Claude Pro, Max, Teams, Enterprise, atau Console (API). Paket gratis Claude.ai tidak termasuk akses Claude Code.
- Pengaturan memakan waktu kurang dari lima menit: Instal, lakukan otentikasi di browser Anda, dan mulai gunakan Claude Code di direktori proyek apa pun segera.
Cara Menginstal Claude Code: Panduan Pengaturan Lengkap (2026)
Claude Code adalah asisten pengkodean AI dari Anthropic yang berjalan langsung di terminal Anda. Ia membaca codebase Anda, menulis kode, menjalankan perintah, dan menangani pengeditan multi-file yang kompleks -- semuanya dari satu antarmuka command-line interface.
Berbeda dengan alat chat AI berbasis browser, Claude Code beroperasi di dalam lingkungan pengembangan aktual Anda. Ia melihat struktur file Anda, memahami konteks proyek Anda, dan membuat perubahan pada file nyata di mesin Anda.
Panduan ini akan memandu Anda melalui setiap langkah menginstal Claude Code pada 2026, mulai dari memeriksa prasyarat hingga menjalankan sesi pengkodean berbantuan AI pertama Anda. Baik Anda menggunakan macOS, Linux, atau Windows, Anda akan menjalankan Claude Code dalam waktu kurang dari lima menit.
Apa yang Anda Butuhkan (Daftar Periksa Prasyarat)
Sebelum menginstal Claude Code, pastikan Anda memiliki hal-hal berikut:
- Sistem operasi: macOS 13.0 (Ventura) atau lebih baru, Ubuntu 20.04+ atau Debian 10+, atau Windows 10 (versi 1809+) dengan WSL
- RAM: Setidaknya 4GB (direkomendasikan 8GB untuk codebase yang lebih besar)
- Koneksi internet: Claude Code terhubung ke cloud API Anthropic, jadi koneksi aktif diperlukan
- Akun Anthropic: Akun Claude Pro ($20/bulan), Claude Max ($100-200/bulan), Teams, Enterprise, atau Console (API)
- Terminal: Bash, Zsh, atau PowerShell
- Node.js 18+ (hanya diperlukan untuk metode instalasi npm)
Anda tidak memerlukan GPU. Semua pemrosesan AI terjadi di server Anthropic. Mesin Anda hanya perlu menjalankan klien CLI dan mengirim permintaan melalui jaringan.
Langkah 1: Instal Node.js (Jika Anda Belum Memilikinya)
Jika Anda berencana menggunakan metode instalasi npm, Anda memerlukan Node.js 18 atau lebih tinggi. Jika Anda sudah menginstal Node.js, periksa versi Anda:
node --version
Jika output menunjukkan v18.0.0 atau lebih tinggi, lanjutkan ke Langkah 2. Jika tidak, instal atau perbarui Node.js menggunakan nvm (Node Version Manager), yang merupakan pendekatan yang direkomendasikan karena menghindari masalah izin (permission) dan memungkinkan Anda beralih antar versi Node dengan mudah.
Instal nvm di macOS atau Linux:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Tutup dan buka kembali terminal Anda, lalu instal Node.js:
nvm install 22
nvm use 22
node --version
Anda akan melihat nomor versi yang dimulai dengan v22. Node.js 22 adalah rilis LTS saat ini dan berfungsi dengan sempurna dengan Claude Code.
Instal Node.js di Windows (di dalam WSL):
Pertama, pastikan WSL telah diinstal (lihat bagian Windows di bawah). Kemudian buka terminal WSL Anda dan jalankan perintah nvm yang sama di atas.
Langkah 2: Instal Claude Code
Anda memiliki dua opsi untuk menginstal Claude Code. Native installer sekarang adalah metode yang direkomendasikan, tetapi npm tetap didukung sepenuhnya.
Opsi A: Native Installer (Direkomendasikan)
Native installer tidak memerlukan dependensi sama sekali -- tanpa Node.js, tanpa npm. Ia melakukan pembaruan otomatis di latar belakang dan merupakan metode utama yang diuji dan didukung oleh Anthropic.
macOS dan Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, sebagai Administrator):
irm https://claude.ai/install.ps1 | iex
Installer mengunduh biner Claude Code, menempatkannya di PATH Anda, dan mengonfigurasi pembaruan otomatis. Seluruh proses memakan waktu kurang dari satu menit.
Opsi B: Instal npm
Jika Anda lebih suka npm -- misalnya, untuk mematok versi tertentu atau karena npm adalah standar dalam alur kerja Anda -- jalankan:
npm install -g @anthropic-ai/claude-code
Penting: Jangan gunakan sudo dengan instalasi npm. Jika Anda mendapatkan kesalahan izin, perbaikan yang tepat adalah menggunakan nvm (yang menginstal Node.js di direktori home Anda) daripada menjalankan npm sebagai root.
Verifikasi Instalasi
Terlepas dari metode mana yang Anda pilih, verifikasi bahwa Claude Code telah diinstal:
claude --version
Anda akan melihat nomor versi. Anda juga dapat menjalankan diagnostik bawaan:
claude doctor
Perintah ini memeriksa lingkungan Anda dan melaporkan masalah konfigurasi apa pun.
Langkah 3: Otentikasi
Claude Code memerlukan otentikasi sebelum Anda dapat menggunakannya. Jalankan:
claude
Pertama kali Anda menjalankan perintah ini, Claude Code akan membuka browser web default Anda dan meminta Anda untuk masuk ke akun Anthropic Anda. Ikuti petunjuk untuk mengotorisasi CLI.
Opsi Otentikasi
Login berbasis browser (default): Terbaik untuk mesin pribadi. Claude Code membuka jendela browser, Anda masuk, dan CLI menerima token otentikasi secara otomatis. Ini berfungsi dengan akun Claude Pro, Max, Teams, dan Enterprise.
API key (untuk CI/CD dan otomatisasi): Jika Anda menjalankan Claude Code di lingkungan headless atau pipeline CI/CD, tetapkan API key Anda sebagai variabel lingkungan:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
Anda dapat membuat API key dari Anthropic Console. Penggunaan API ditagih per token sesuai tarif yang dipublikasikan Anthropic.
Langganan vs. Penagihan API: Dengan langganan Pro atau Max, penggunaan Claude Code Anda sudah termasuk dalam paket bulanan Anda (tunduk pada batas penggunaan). Dengan API key dari Console, Anda membayar per token. Pilih berdasarkan volume penggunaan Anda -- langganan lebih sederhana untuk penggunaan reguler, sementara penagihan API memberi Anda kontrol lebih besar untuk beban kerja variabel atau otomatis.
Langkah 4: Proyek Pertama Anda
Sekarang setelah Claude Code terinstal dan terotentikasi, cobalah pada proyek nyata.
Navigasi ke direktori proyek apa pun:
cd ~/my-project
Mulai Claude Code:
claude
Anda sekarang berada dalam sesi interaktif. Claude Code telah membaca struktur proyek Anda dan siap membantu. Cobalah memberikan tugas:
> Explain the architecture of this project
Claude Code akan memindai file Anda, mengidentifikasi tech stack, dan memberi Anda ringkasan tentang bagaimana proyek tersebut diatur.
Coba sesuatu yang lebih praktis:
> Add input validation to the user registration form
Claude Code akan mengidentifikasi file yang relevan, mengusulkan perubahan, dan meminta konfirmasi Anda sebelum memodifikasi apa pun. Anda meninjau setiap perubahan dalam tampilan diff dan menerima atau menolaknya.
Untuk tugas satu kali tanpa masuk ke mode interaktif, gunakan flag -p:
claude -p "Write unit tests for the auth module"
Ini menjalankan tugas, mengeluarkan hasilnya, dan keluar -- berguna untuk scripting dan pertanyaan cepat.
Langkah 5: Konfigurasi Esensial
Claude Code langsung berfungsi dengan pengaturan default yang masuk akal, tetapi Anda dapat menyesuaikan perilakunya untuk alur kerja Anda.
Pemilihan Model
Claude Code menggunakan model Claude terbaru secara default. Untuk menentukan model yang berbeda:
claude config set model claude-opus-4-6
Atau untuk satu sesi:
claude --model claude-sonnet-4-20250514
Izin
Claude Code meminta konfirmasi sebelum melakukan tindakan yang berpotensi merusak seperti menulis file atau menjalankan perintah shell. Anda dapat mengonfigurasi perilaku ini:
claude config set permissions.auto-accept-edits true
Pengaturan Tingkat Proyek
Buat file .claude/settings.json di root proyek Anda untuk menentukan konfigurasi yang dibagikan tim:
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-20250514",
"environment": {
"NODE_ENV": "development"
}
}
File ini harus dimasukkan ke dalam version control sehingga seluruh tim Anda berbagi perilaku Claude Code yang sama.
Untuk override pribadi yang tidak boleh dimasukkan ke version control, gunakan .claude/settings.local.json.
Konfigurasi Server MCP
Claude Code mendukung server Model Context Protocol (MCP) untuk memperluas kemampuannya. Konfigurasikan mereka di .mcp.json pada root proyek Anda:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
Menginstal di Berbagai Lingkungan
macOS
Native installer adalah jalur termudah di macOS. Baik mesin Apple Silicon (M1/M2/M3/M4) maupun Intel didukung:
curl -fsSL https://claude.ai/install.sh | bash
Sebagai alternatif, Claude Code tersedia via Homebrew:
brew install --cask claude-code
Linux
Berjalan di Ubuntu 20.04+, Debian 10+, dan sebagian besar distribusi modern:
curl -fsSL https://claude.ai/install.sh | bash
Jika Anda menggunakan distribusi lama, gunakan metode npm dengan nvm untuk menghindari masalah dependensi tingkat sistem.
Windows (WSL)
Claude Code di Windows memerlukan WSL atau Git for Windows. WSL adalah pendekatan yang direkomendasikan:
- Buka PowerShell sebagai Administrator dan instal WSL:
wsl --install
-
Restart komputer Anda saat diminta.
-
Buka terminal WSL (Ubuntu secara default) dan instal Claude Code:
curl -fsSL https://claude.ai/install.sh | bash
Sebagai alternatif, Anda dapat menggunakan native installer Windows secara langsung di PowerShell:
irm https://claude.ai/install.ps1 | iex
Docker
Untuk lingkungan kontainer, tambahkan Claude Code ke Dockerfile Anda:
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here
Untuk pipeline CI/CD, berikan API key saat runtime daripada memasukkannya ke dalam image:
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Run the test suite and fix any failures"
Pipeline CI/CD
Mode headless Claude Code (flag -p) dirancang untuk otomatisasi. Berikut adalah contoh GitHub Actions:
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Review the changes in this PR and suggest improvements" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
Flag --output-format json mengembalikan output terstruktur yang dapat diurai oleh langkah-langkah selanjutnya.
Memperbarui Claude Code
Native Installer
Jika Anda menginstal Claude Code dengan native installer, pembaruan terjadi secara otomatis di latar belakang. Tidak diperlukan tindakan. Anda dapat mengonfigurasi saluran pembaruan:
claude config set update-channel stable
Untuk memeriksa versi Anda saat ini:
claude --version
npm
Jika Anda menginstal via npm, perbarui secara manual:
npm update -g @anthropic-ai/claude-code
Atau instal versi tertentu:
npm install -g @anthropic-ai/claude-code@latest
Integrasi IDE
Meskipun Claude Code adalah alat terminal-first, ia berintegrasi langsung dengan IDE populer untuk pengalaman yang lebih visual.
Ekstensi VS Code
Ekstensi VS Code menyediakan antarmuka grafis asli untuk Claude Code di dalam editor Anda. Ini termasuk panel chat, undo berbasis checkpoint, referensi file dengan sebutan @, dan kemampuan untuk menjalankan beberapa percakapan dalam tab paralel.
Untuk menginstal, buka VS Code dan cari "Claude Code" di panel Extensions, atau jalankan:
code --install-extension anthropic.claude-code
Setelah terinstal, Anda dapat membuka panel Claude Code dari bilah samping dan berinteraksi dengannya seperti versi terminal, tetapi dengan manfaat tambahan melihat diff file yang dirender di diff viewer asli VS Code.
Plugin JetBrains
Untuk IntelliJ IDEA, PyCharm, WebStorm, GoLand, dan IDE JetBrains lainnya, instal plugin Claude Code dari JetBrains Marketplace:
- Buka IDE JetBrains Anda
- Buka Settings lalu Plugins lalu Marketplace
- Cari "Claude Code"
- Klik Install dan restart IDE
Plugin JetBrains menjalankan Claude Code CLI di dalam terminal terintegrasi IDE Anda dan membuka perubahan yang diusulkan di diff viewer IDE. Saat ini masih dalam versi beta tetapi berfungsi penuh untuk penggunaan sehari-hari.
Pemecahan Masalah
"command not found: claude"
Biner Claude Code tidak ada dalam PATH Anda. Jika Anda menggunakan native installer, coba buka jendela terminal baru. Jika itu tidak berhasil, jalankan skrip instalasi lagi. Untuk instalasi npm, pastikan direktori global npm bin Anda ada dalam PATH Anda:
npm config get prefix
Tambahkan subdirektori bin dari jalur tersebut ke variabel PATH shell Anda.
"Node.js version too old"
Claude Code memerlukan Node.js 18+. Periksa versi Anda dengan node --version. Jika di bawah 18, instal versi yang lebih baru menggunakan nvm:
nvm install 22
nvm use 22
Kesalahan Izin npm (EACCES)
Jangan pernah menggunakan sudo npm install -g. Sebaliknya, perbaiki direktori default npm atau gunakan nvm, yang menginstal semuanya di direktori home Anda dan menghindari konflik izin sepenuhnya:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code
Otentikasi Gagal atau Browser Tidak Terbuka
Jika login berbasis browser tidak berfungsi (umum pada server jarak jauh atau WSL), Anda dapat melakukan otentikasi dengan API key sebagai gantinya:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Buat API key Anda di console.anthropic.com.
"Network Error" atau Timeout Selama Instalasi
Jaringan atau firewall Anda mungkin memblokir npm atau native installer. Coba:
npm config set registry https://registry.npmjs.org/
Jika Anda berada di balik proxy perusahaan, konfigurasikan npm untuk menggunakannya:
npm config set proxy http://your-proxy:8080
npm config set https-proxy http://your-proxy:8080
Claude Code Berjalan Lambat
Claude Code sendiri ringan -- kelambatan biasanya berarti latensi jaringan ke API Anthropic. Periksa koneksi internet Anda. Jika Anda menggunakan VPN, coba putuskan sambungan. Anda juga dapat memeriksa status API di status.anthropic.com.
Langkah Selanjutnya
Anda telah menginstal, mengotentikasi, dan menjalankan Claude Code. Berikut adalah langkah selanjutnya dari sini:
- Pelajari alur kerja: Baca tutorial Claude Code kami untuk pendalaman strategi prompting, pengeditan multi-file, dan mendapatkan hasil maksimal dari pengembangan berbantuan AI.
- Bandingkan opsi Anda: Lihat bagaimana Claude Code dibandingkan dalam perbandingan Claude Code vs Cursor kami jika Anda sedang memutuskan antara alat pengkodean AI.
- Jelajahi fitur lanjutan: Claude Code mendukung server MCP, custom hooks, otomatisasi headless, dan konfigurasi multi-model. Dokumentasi resmi mencakup hal-hal ini secara mendalam.
Claude Code adalah cara tercepat untuk menghadirkan AI ke dalam alur kerja pengembangan Anda yang sudah ada tanpa mengubah alat Anda atau meninggalkan terminal Anda. Sekarang setelah terinstal, mulailah dengan tugas kecil pada proyek nyata -- Anda akan segera melihat perbedaannya.
