Claude Code diinstal dengan satu perintah di setiap platform yang didukung, dan seluruh proses pertama adalah: instal, ketik claude, masuk. Panduan ini berisi perintah yang tepat untuk setiap OS, hal-hal yang perlu diperiksa saat tidak berfungsi, dan cara mengarahkannya ke endpoint lain setelah berhasil.
Perintah telah diverifikasi 10 Oktober 2026 berdasarkan dokumentasi penyiapan Claude Code Anthropic.
Sebelum memulai
| Persyaratan | Yang didukung |
|---|---|
| Sistem operasi | macOS 13.0+, Windows 10 1809+ / Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ |
| Perangkat keras | RAM 4 GB+, x64 atau ARM64 |
| Shell | Bash, Zsh, PowerShell, atau CMD |
| Jaringan | Koneksi internet diperlukan |
| Akun | Pro, Max, Team, Enterprise, atau Console — paket Claude.ai gratis tidak mencakup Claude Code |
Instalasi — installer native
Ini adalah metode yang direkomendasikan di setiap platform. Metode ini menginstal binary mandiri dan memperbarui dirinya sendiri di latar belakang.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdJika Anda tidak yakin sedang menggunakan shell Windows yang mana, prompt akan memberi tahu Anda: PowerShell menampilkan PS C:\, sedangkan CMD menampilkan C:\ tanpa PS. Menjalankan perintah yang salah adalah kegagalan instalasi paling umum di Windows — lihat tabel pemecahan masalah di bawah untuk kesalahan tepat pada setiap arah yang tertukar.
Manajer paket
Gunakan ini jika Anda ingin manajer paket yang sudah ada menangani instalasi. Imbalannya adalah pembaruan: tidak satu pun di antaranya memperbarui secara otomatis secara default, tidak seperti installer native.
# Homebrew (macOS, Linux) — stable channel
brew install --cask claude-code
# WinGet (Windows)
winget install Anthropic.ClaudeCode
# npm — requires Node.js 22+; never with sudo
npm install -g @anthropic-ai/claude-codeHomebrew menerbitkan dua cask: claude-code mengikuti channel stable (biasanya tertinggal sekitar satu minggu, dengan melewati rilis yang mengalami regresi besar) dan claude-code@latest mengirimkan setiap rilis segera. Repositori apt, dnf, dan apk bertanda tangan tersedia untuk Debian / Ubuntu, Fedora / RHEL, dan Alpine, masing-masing dengan channel stable dan latest yang sama.
Di npm, jangan pernah gunakan sudo npm install -g — ini menyebabkan masalah izin dan merupakan risiko keamanan. Paket npm menginstal binary native yang persis sama dengan installer mandiri, sehingga tidak ada dependensi Node saat runtime dalam kedua cara tersebut.
Verifikasi instalasi
claude --version # prints e.g. "2.1.211 (Claude Code)"
claude doctor # read-only install + settings diagnostics
claude # start a session in the current projectclaude doctor adalah perintah yang perlu diingat: perintah ini menampilkan kesehatan instalasi, kesalahan validasi file pengaturan, dan perbaikan yang disarankan tanpa memulai sesi, sehingga menjadi cara tercepat untuk membedakan instalasi yang rusak dari konfigurasi yang rusak.
Proses pertama dan login
Buka terminal di proyek yang ingin Anda gunakan dan jalankan claude. Perintah ini membuka sesi interaktif dan memandu Anda melakukan login di browser. Claude Code memerlukan akun Pro, Max, Team, Enterprise, atau Console.
Ada satu perilaku yang perlu diketahui sebelum mengejutkan Anda: jika ANTHROPIC_API_KEY sudah ditetapkan di lingkungan Anda, Claude Code akan meminta Anda sekali untuk menyetujui kunci tersebut alih-alih membuka browser. Tolak prompt itu dan kunci tersebut akan diabaikan secara diam-diam setelahnya tanpa prompt lebih lanjut — yang tampak persis seperti variabel tersebut tidak sedang dibaca. Aktifkan kembali di /config → Gunakan kunci API khusus.
Windows: native atau WSL
| Opsi | Memerlukan | Sandbox | Pilih jika |
|---|---|---|---|
| Windows native | Tidak ada; Git for Windows opsional | Tidak didukung | Proyek dan tool Anda berbasis Windows native |
| WSL 2 | WSL 2 diaktifkan | Didukung | Toolchain Linux, atau Anda menginginkan eksekusi perintah dalam sandbox |
| WSL 1 | WSL 1 diaktifkan | Tidak didukung | WSL 2 tidak tersedia untuk Anda |
Di Windows native, menginstal Git for Windows bersifat opsional tetapi direkomendasikan: aplikasi ini menyediakan Git Bash yang mendukung Bash tool. Tanpanya, Claude Code menjalankan perintah shell melalui PowerShell tool. Di WSL, Anda menginstal dan meluncurkan claude di dalam terminal WSL, bukan dari PowerShell.
Pemecahan masalah
| Gejala | Penyebab dan perbaikan |
|---|---|
The token '&&' is not a valid statement separator | Anda menjalankan perintah CMD di PowerShell. Gunakan baris irm … | iex sebagai gantinya. |
'irm' is not recognized… | Kebalikannya — Anda menjalankan perintah PowerShell di CMD. Gunakan baris curl … install.cmd. |
syntax error near unexpected token '<', 403, atau kesalahan curl lainnya | Unduhan tidak mengembalikan skrip — biasanya karena proxy atau filter jaringan antara Anda dan installer. Coba lagi, atau gunakan instalasi melalui manajer paket. |
claude: command not found setelah instalasi bersih | Buka terminal baru agar shell Anda mengambil direktori instalasi, lalu jalankan claude doctor. Instalasi kedua yang lebih lama atau alias shell yang sudah usang adalah penyebab umum lainnya. |
| Kesalahan izin selama instalasi npm | Anda menggunakan sudo, atau direktori global npm tidak dapat ditulisi. Perbaiki kepemilikan direktori tersebut, bukan menjalankan ulang dengan sudo; direktori global yang tidak dapat ditulisi juga menghalangi pembaruan otomatis. |
Binary native hilang setelah npm install -g | Manajer paket Anda dikonfigurasi untuk melewati dependensi opsional. Binary untuk platform dikirim sebagai salah satunya, jadi izinkan dependensi tersebut dan instal ulang. |
| Instalasi gagal di Alpine atau distro musl lainnya | Alpine dikirim tanpa bash dan curl. Instal bash curl libgcc libstdc++ ripgrep, lalu tetapkan USE_BUILTIN_RIPGREP ke "0" di blok env pada file pengaturan Anda. |
| Pencarian dan penemuan file gagal | ripgrep biasanya sudah disertakan. Jika tidak dapat dijalankan di platform Anda, instal ripgrep sistem dan tetapkan USE_BUILTIN_RIPGREP=0. |
| Bash tool tidak ada di Windows native | Instal Git for Windows. Jika Claude Code masih tidak dapat menemukan Git Bash, tetapkan CLAUDE_CODE_GIT_BASH_PATH di blok env pada ~/.claude/settings.json. |
401 setelah kunci dikonfigurasi | Kunci berada di header yang tidak dibaca server — tukar antara ANTHROPIC_AUTH_TOKEN dan ANTHROPIC_API_KEY. Detailnya ada di panduan kunci API. |
Mengarahkan Claude Code ke Kunavo
Setelah berjalan, Claude Code akan bekerja dengan endpoint mana pun yang menyediakan Anthropic Messages API — aplikasi ini membaca ANTHROPIC_BASE_URL secara native, sehingga ini adalah konfigurasi yang didukung, bukan solusi sementara. Tanpa plugin, tanpa proxy, tanpa binary yang ditambal:
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Lima hal tentang blok tersebut, yang masing-masing dapat menghabiskan waktu satu jam jika salah:
ANTHROPIC_BASE_URLhanyalah origin. Claude Code menambahkan/v1/messagessendiri — menyertakan path akan menghasilkan 404.- Gunakan
ANTHROPIC_AUTH_TOKEN, bukanANTHROPIC_API_KEY. Keduanya berada di header HTTP yang berbeda. Bearer token langsung berlaku, sedangkanANTHROPIC_API_KEYmemerlukan persetujuan satu kali yang dijelaskan di atas. Kunavo membaca kunci dari kedua header, termasuk/v1/models, sehingga di Kunavo langkah persetujuan tersebutlah yang membedakan keduanya. - Tetapkan
ANTHROPIC_MODELsecara eksplisit. Kunavo mencocokkan slug model secara persis dan tidak membuat alias untuk nama yang memiliki sufiks tanggal, sehinggaclaude-sonnet-4-5-20250929menghasilkan 404 sementaraclaude-sonnet-5berfungsi. - Tetapkan
ANTHROPIC_DEFAULT_OPUS_MODELdanANTHROPIC_DEFAULT_SONNET_MODELjuga. Default bawaan Claude Code dan aliasopus-nya sama-sama mengarah ke Opus terbaru, dan jika Kunavo belum melayani model tersebut, permintaan pertama menghasilkan 404. Blok ini menetapkanopuske Opus 5.5 (claude-opus-5-5), yang memerlukan Claude Code v2.1.280 atau yang lebih baru — jalankanclaude updatepada instalasi lama. Aliassonnetmeminta Sonnet 5.5, yang tidak dilayani Kunavo, sehingga tanpa pin sonnet/model sonnet, fase eksekusiopusplandan subagen apa pun yang diatur kemodel: sonnetmenghasilkan 404. - Patok juga
ANTHROPIC_DEFAULT_HAIKU_MODEL. Aliashaikumeminta ID model yang tidak disediakan Kunavo (Haiku 5.5 sejak v2.1.293, dan ID Haiku 4.5 dengan akhiran tanggal sebelumnya), sehingga tanpa baris ini/model haikudan subagen yang ditetapkan kemodel: haiku, termasukclaude-code-guidebawaan, menghasilkan 404. Pengaturan ini juga mengalihkan panggilan latar belakang untuk membuat ringkasan dan judul yang dijalankan Claude Code sendiri dari model utama:claude-haiku-4-5berharga $0,70 / $3,50 per 1 juta token, dibandingkan $1,40 / $7,00.
Masukkan ini ke blok env pada ~/.claude/settings.json, bukan sebagai ekspor shell, jika Anda ingin editor dan agen latar belakang juga melihatnya — dan jangan pernah memasukkannya ke .claude/settings.json yang dikomit dalam proyek. Buat kunci sk-kn- di dashboard setelah mendaftar; top-up $10 adalah minimum, tidak ada biaya bulanan, dan saldo tidak kedaluwarsa. Biaya setiap model per token, dibandingkan dengan harga API resmi Anthropic, menentukan sejauh mana $10 tersebut dapat digunakan.
Apa yang berubah di balik gateway
Coding, tool, subagen, MCP, hook, dan caching prompt semuanya tidak terpengaruh. Tiga hal memang berubah, dan perlu diketahui sebelum Anda menganggap ada sesuatu yang rusak:
- Remote Control dan dikte suara tidak tersedia. Keduanya memerlukan identitas claude.ai, yang digantikan oleh kredensial gateway.
/fastmungkin melaporkan mode cepat sebagai dinonaktifkan. Pemeriksaan ketersediaan memanggil Anthropic secara langsung, bukan mengikuti base URL Anda. Permintaan normal tidak terpengaruh.- Jumlah
/contextmenjadi estimasi lokal. Penghitungan token adalah satu-satunya endpoint yang ditandai opsional oleh spesifikasi gateway Anthropic sendiri, dan Claude Code melakukan estimasi secara lokal jika endpoint tersebut tidak ada — Kunavo saat ini tidak menyediakan/v1/messages/count_tokens. Kompaksi otomatis dan sesi itu sendiri tidak terpengaruh.
Daftar lengkapnya, ditambah keputusan router-versus-tanpa-router, tersedia dalam panduan router Claude Code.
Pertanyaan umum
Bagaimana cara menginstal Claude Code?
Di macOS, Linux, atau WSL, jalankan `curl -fsSL https://claude.ai/install.sh | bash`. Di Windows, jalankan `irm https://claude.ai/install.ps1 | iex` di PowerShell, atau `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` di CMD. Installer native adalah metode yang direkomendasikan dan memperbarui dirinya sendiri di latar belakang. Homebrew (`brew install --cask claude-code`), WinGet (`winget install Anthropic.ClaudeCode`), npm, dan repositori apt/dnf/apk bertanda tangan juga didukung, tetapi tidak satu pun di antaranya memperbarui secara otomatis secara default.
Apakah saya memerlukan Node.js untuk menginstal Claude Code?
Tidak untuk installer native, Homebrew, WinGet, atau repositori paket Linux — semuanya menginstal binary native yang tidak menggunakan Node saat runtime. Hanya jalur instalasi npm yang melibatkan Node, dan mulai v2.1.198 paket tersebut memerlukan Node.js 22 atau yang lebih baru. Bahkan saat itu, npm hanya mengambil binary native yang sama melalui dependensi opsional per platform.
Apa saja persyaratan sistem untuk Claude Code?
macOS 13.0+, Windows 10 1809+ atau Windows Server 2019+, Ubuntu 20.04+, Debian 10+, atau Alpine Linux 3.19+; RAM 4 GB atau lebih pada prosesor x64 atau ARM64; koneksi internet; dan Bash, Zsh, PowerShell, atau CMD sebagai shell. Anda juga harus berada di negara yang didukung Anthropic.
Bagaimana cara masuk ke Claude Code untuk pertama kalinya?
Jalankan `claude` di direktori proyek dan ikuti prompt di browser. Claude Code memerlukan akun Pro, Max, Team, Enterprise, atau Console — paket Claude.ai gratis tidak mencakup akses ke Claude Code. Jika variabel lingkungan ANTHROPIC_API_KEY ditetapkan, Claude Code akan meminta Anda sekali untuk menyetujui kunci tersebut alih-alih membuka browser.
Dapatkah saya menginstal Claude Code di Windows tanpa WSL?
Ya. Jalankan installer PowerShell atau CMD dan luncurkan `claude` dari terminal mana pun; Anda tidak memerlukan hak Administrator. Git for Windows bersifat opsional tetapi direkomendasikan, karena menyediakan Git Bash yang mendukung Bash tool — tanpanya, Claude Code menjalankan perintah shell melalui PowerShell tool. WSL 2 adalah pilihan yang tepat jika Anda menginginkan toolchain Linux atau eksekusi perintah dalam sandbox, yang tidak didukung oleh Windows native.
Mengapa `claude` menampilkan command not found setelah diinstal?
Direktori instalasi tidak ada di PATH pada shell yang Anda gunakan. Buka terminal baru terlebih dahulu — installer menambahkan ~/.local/bin di macOS dan Linux, dan sesi yang sudah ada tidak akan mengambil perubahan tersebut. Jalankan `claude doctor` untuk diagnostik read-only terhadap instalasi dan file pengaturan Anda. Instalasi kedua yang lebih lama atau alias shell yang tersisa adalah penyebab umum lainnya.
Bagaimana cara mengarahkan Claude Code ke endpoint API yang berbeda?
Atur ANTHROPIC_BASE_URL ke origin endpoint mana pun yang melayani Anthropic Messages API — Claude Code membacanya secara native dan menambahkan /v1/messages sendiri, sehingga tidak diperlukan plugin atau proxy. Pasangkan dengan ANTHROPIC_AUTH_TOKEN untuk kredensial dan ANTHROPIC_MODEL yang eksplisit, lalu tetapkan ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, dan ANTHROPIC_DEFAULT_HAIKU_MODEL ke model yang dilayani endpoint tersebut, karena alias opus dan sonnet jika tidak ditetapkan akan mengikuti model terbaru Anthropic. Di Kunavo, konfigurasi ini menjalankan model Claude yang sama dengan harga 30% di bawah harga daftar Anthropic, berdasarkan penggunaan.
Langkah berikutnya
- Kunci API Claude Code — tempat mendapatkannya, tempat memasukkannya, dan ketidaksesuaian header di balik sebagian besar 401.
- Harga Claude Code — langganan versus API, tarif per model, dan biaya per bulan.
- Apakah Claude Code gratis? — apa yang gratis, apa yang tidak, dan di mana batasnya.
- Menjalankannya tanpa prompt izin — apa yang sebenarnya dihapus oleh
--dangerously-skip-permissions, dan tiga containment yang masing-masing memerlukan sekitar satu menit. - Claude Code vs Codex CLI — jika Anda masih memilih agen terminal.