Cara install Claude Code: perintah resmi Windows, macOS & Linux, API key tanpa langganan, cek /status, dan bayar pakai kartu atau Link

Ringkasnya: instal Claude Code dengan satu perintah resmi (pilih baris untuk macOS/Linux, PowerShell, atau CMD di bawah), lalu sambungkan ke API key alih-alih login. Untuk itu cukup lima variabel: ANTHROPIC_BASE_URL=https://api.kunavo.com (tanpa /v1), ANTHROPIC_AUTH_TOKEN berisi key, dan tiga variabel yang mengunci model. Cek hasilnya dengan /status. Tidak perlu langganan Pro atau Max; Anda membayar token dari saldo prabayar mulai $10, diisi dengan kartu (Visa, Mastercard, dll.) atau Link. QRIS, GoPay, OVO, dan DANA tidak tersedia.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Semua perintah dan nama variabel di sini kami samakan dengan dokumentasi resmi Claude Code pada 3 Oktober 2026. Dokumentasi itu sudah ada dalam bahasa Indonesia, termasuk halaman instalasi dan halaman penghubungan ke gateway LLM, jadi Anda bisa mencocokkan sendiri. Harga dan metode pembayaran Kunavo dicek 3 Oktober 2026.

Enam langkah dari nol sampai Claude Code jalan

1. Pastikan laptop memenuhi syarat dan putuskan: login akun Claude atau API key.
2. Jalankan installer native sesuai terminal Anda.
3. Buka terminal baru, cek claude --version, dan perbaiki PATH kalau perlu.
4. Pasang API key dan kunci modelnya.
5. Buka sesi pertama dan pastikan lewat /status bahwa key Anda yang dipakai.
6. Isi saldo dengan kartu atau Link, lalu mulai bekerja.

Langkah 1: cek syarat, lalu pilih login atau API key

Setelah terinstal, Claude Code harus tahu siapa yang membayar. Jalan pertama adalah login akun Claude, yang mensyaratkan paket Pro, Max, Team, Enterprise, atau akun Console; paket gratis Claude.ai tidak mencakup Claude Code. Menurut halaman harga Claude (dicek 3 Oktober 2026), Pro berharga $20 per bulan, atau $17 per bulan kalau dibayar tahunan ($200 di muka), Max mulai $100 per bulan, dan semua harga belum termasuk pajak. Untuk langganan yang dibeli lewat web, Anthropic hanya menerima kartu kredit atau debit; langganan dari aplikasi iOS atau Android dibayar lewat App Store atau Google Play (FAQ billing Claude, dicek 3 Oktober 2026). Cara login dijelaskan di halaman autentikasi resmi.

Jalan kedua, yang dibahas lengkap di panduan ini, adalah API key: tanpa langganan dan tanpa layar login. Anda membayar per token yang benar-benar terpakai, jadi di bulan yang sepi biayanya ikut kecil. Yang hilang hanya dua fitur yang terikat akun claude.ai, yaitu Remote Control dan dikte suara; daftar lengkap perbedaannya ada di langkah 5.

Baru pertama kali membuka terminal? Anthropic menyediakan panduan terminal berbahasa Indonesia untuk pemula.

Langkah 2: jalankan installer

macOS, Linux, dan WSL

Tempel baris install.sh di awal halaman ke Terminal, tekan Enter, dan tunggu sampai selesai. Skrip itu diambil langsung dari claude.ai, memasang program ke ~/.local/bin/claude, dan sejak itu Claude Code memperbarui dirinya sendiri di latar belakang. Di dokumentasi resmi, cara ini diberi label “Direkomendasikan”.

Windows: kenali dulu terminal Anda

Banyak tutorial lama menyuruh membuka PowerShell “Run as Administrator” dan memasang WSL lebih dulu. Dua-duanya tidak perlu: dokumentasi resmi berbahasa Indonesia menyatakan instalasi di Windows berjalan dari terminal biasa tanpa hak Administrator, dan WSL hanyalah opsi. Yang menentukan perintah mana yang dipakai adalah tampilan prompt:

• Prompt PS C:\Users\NamaAnda> berarti PowerShell. Pakai baris irm … | iex.
• Prompt C:\Users\NamaAnda> tanpa PS berarti Command Prompt (CMD). Pakai baris install.cmd.
• Di menu Start, pilih “Windows PowerShell”, bukan “Windows PowerShell (x86)”. Versi x86 berjalan 32-bit dan berakhir dengan Claude Code does not support 32-bit Windows, walaupun laptopnya 64-bit.

Perintah yang tertukar terminal langsung kelihatan dari pesannya, misalnya The token '&&' is not a valid statement separator (baris CMD di PowerShell) atau 'irm' is not recognized as an internal or external command (baris PowerShell di CMD). Di Windows berbahasa Indonesia pesannya bisa tampil dalam terjemahan. Daftar lengkapnya ada di tabel error di bawah.

Git tidak wajib. Kalau Git for Windows terpasang, tool Bash Claude Code memakai Git Bash; kalau tidak, perintah dijalankan lewat PowerShell. Bila Git sudah ada tetapi Git Bash tidak ditemukan, isi CLAUDE_CODE_GIT_BASH_PATH di blok env ~/.claude/settings.json dengan lokasi bash.exe, misalnya C:\Program Files\Git\bin\bash.exe. Kapan WSL layak dipakai:

Pilih WSL? Jalankan baris install.sh di dalam terminal WSL, dan selalu buka claude dari terminal WSL itu juga.

Alternatif: Homebrew, WinGet, atau npm

Homebrew dan WinGet juga resmi, tetapi menurut dokumentasi keduanya secara bawaan tidak update otomatis. Anda harus memperbaruinya sendiri:

# macOS lewat Homebrew (tidak update otomatis; perbarui dengan brew upgrade)
brew install --cask claude-code

# Windows lewat WinGet (tidak update otomatis; perbarui dengan winget upgrade)
winget install Anthropic.ClaudeCode

npm masih didokumentasikan, dengan syarat Node.js 22 ke atas (unduh dari nodejs.org). Di Node.js lama npm hanya memberi peringatan EBADENGINE dan tetap memasang, karena paket ini sebenarnya mengunduh program native yang tidak bergantung pada Node.js saat berjalan.

node -v                                    # harus v22 ke atas
npm install -g @anthropic-ai/claude-code   # jangan pakai sudo

# memperbarui ke versi terbaru
npm install -g @anthropic-ai/claude-code@latest

Tiga kebiasaan yang bikin instalasi npm rusak: memakai sudo npm install -g (dokumentasi menyebutnya sumber masalah izin dan risiko keamanan), memperbarui dengan npm update -g alih-alih @latest, dan mematikan optional dependencies lewat --omit=optional atau optional=false di .npmrc. Yang terakhir membuat paket @anthropic-ai/claude-code-* untuk platform Anda tidak terunduh, sehingga di macOS atau Linux claude menjawab claude native binary not installed.

Di PowerShell, npm kadang mentok di npm.ps1 cannot be loaded because running scripts is disabled on this system. Itu execution policy yang memblokir skrip .ps1. Dokumentasi memberi tiga jalan keluar: izinkan skrip lokal untuk user Anda dengan perintah di bawah, panggil npm.cmd dan claude.cmd, atau tinggalkan npm dan pakai installer native.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Satu peringatan lagi: abaikan installer .exe dari pihak ketiga yang beredar di tutorial, apalagi yang minta hak Administrator. Perintah resmi di atas sudah cukup.

Langkah 3: pastikan Claude Code terpasang

Tutup terminal tempat Anda menginstal dan buka yang baru. Jendela lama masih memakai PATH sebelum instalasi, jadi di sana claude sering belum dikenali. Di terminal baru:

claude --version   # muncul nomor versi = instalasi berhasil
claude doctor      # cek instalasi dan file pengaturan tanpa membuka sesi

claude doctor berguna untuk memisahkan dua jenis masalah: kalau laporannya bersih tetapi Claude Code tetap tidak tersambung, sumbernya ada di konfigurasi (langkah 4), bukan di instalasi.

Masih command not found: claude atau 'claude' is not recognized? Folder instalasi belum masuk PATH. Di macOS dan Linux folder itu ~/.local/bin, di Windows %USERPROFILE%\.local\bin. Untuk Windows, dokumentasi memberi perintah PowerShell berikut:

# Ada hasilnya? Berarti PATH sudah benar, cukup buka terminal baru.
$env:PATH -split ';' | Select-String '\.local\\bin'

# Tidak ada hasil? Tambahkan folder instalasi ke PATH user:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# Tutup PowerShell, buka lagi, lalu:
claude --version

Kalau unduhan sudah gagal sejak awal, perhatikan pesannya. Menurut halaman troubleshooting instalasi (dicek 3 Oktober 2026), syntax error near unexpected token '<' atau curl: (22) The requested URL returned error: 403 berarti yang terunduh adalah halaman HTML atau kode error, bukan skrip. Tulisan App unavailable in region berarti koneksi Anda terlihat berasal dari negara yang tidak didukung; karena Indonesia didukung, tersangka utamanya VPN atau proxy. 403 tanpa isi juga sering datang dari proxy kantor atau firewall kampus. Homebrew, WinGet, dan npm mengambil dari host yang sama, jadi coba jaringan lain atau minta admin jaringan membuka aksesnya sebelum berganti metode.

Langkah 4: pasang API key tanpa langganan

Claude Code punya variabel bawaan ANTHROPIC_BASE_URL untuk mengirim request ke gateway selain Anthropic, dan dokumentasi resminya punya halaman khusus untuk itu. Jadi ini konfigurasi yang didukung, bukan modifikasi atau plugin. Ambil key sk-kn-… lebih dulu (lihat langkah 6 untuk daftar dan isi saldo), lalu pilih salah satu tempat menyimpannya.

macOS dan Linux: tambahkan lima baris ini di akhir ~/.zshrc (Zsh, bawaan macOS) atau ~/.bashrc, simpan, lalu buka terminal baru.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # domain saja, tanpa /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Windows, untuk mencoba dulu: isi variabel di satu jendela PowerShell lalu langsung jalankan claude.

# Untuk uji coba: hanya berlaku sampai jendela PowerShell ini ditutup
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Semua OS, permanen: taruh di blok env file pengaturan user ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Berlaku untuk semua proyek. Kalau file itu sudah ada isinya, sisipkan blok env saja tanpa menimpa pengaturan lain.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Hal yang perlu diperhatikan dari lima variabel tadi:

Kenapa model dikunci? Menurut dokumentasi konfigurasi model (dicek 3 Oktober 2026), untuk pengguna API model default dan alias opus saat ini menunjuk Opus 5.5, dan alias sonnet menunjuk Sonnet 5.5. Alias itu bergeser setiap kali ada rilis baru. Per 3 Oktober 2026 Sonnet 5.5 belum tersedia di Kunavo, dan model berikutnya belum tentu langsung tersedia; request ke model yang tidak ada dijawab 404. Kalau Anda biasa berganti lewat /model sonnet, tambahkan juga ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5.

Tarif Kunavo per 1 juta token (input / output): Claude Sonnet 5 $1,40 / $7,00 (harga list Anthropic: $2,00 / $10,00), Claude Opus 5 $3,50 / $17,50, dan Claude Haiku 4.5 $0,70 / $3,50.

Dua jebakan lain. Pertama, key jangan pernah masuk ke .claude/settings.json milik proyek: menurut dokumentasi gateway, file itu di-commit dan ikut ter-clone oleh siapa pun yang mengambil repositori. Kedua, kalau variabel yang sama ada di shell dan di blok env file pengaturan, umumnya nilai dari file pengaturan yang menang; jadi kalau perubahan di ~/.zshrc seperti tidak berefek, periksa file pengaturan. Pengguna ekstensi VS Code mengisi variabel yang sama di claudeCode.environmentVariables pada user settings VS Code.

Langkah 5: buka sesi pertama dan cek /status

Masuk ke folder proyek dan ketik claude. Kalau key sudah terbaca, sesi langsung terbuka tanpa layar login. Layar login yang muncul adalah tanda key belum sampai. Penyebab paling sering: key hanya ada di .claude/settings.json atau .claude/settings.local.json proyek. Di mode interaktif, blok env dari file proyek baru dibaca setelah wizard awal dan pertanyaan apakah folder ini dipercaya, sehingga pada peluncuran pertama Claude Code tetap meminta login. Pindahkan key ke shell atau ke ~/.claude/settings.json.

Setelah sesi terbuka, ketik /status. Konfigurasi sudah benar kalau:

• ada baris Anthropic base URL berisi https://api.kunavo.com (baris ini hanya muncul kalau gateway diatur; tidak ada berarti ANTHROPIC_BASE_URL tidak terbaca), dan
• ada baris Auth token yang menyebut ANTHROPIC_AUTH_TOKEN. Kalau yang tampil Login method dengan akun claude.ai, Claude Code masih memakai login lama.

Mau menguji key sebelum membuka Claude Code? Dokumentasi resmi memakai request yang hanya meminta 1 token output, jadi saldo yang terpotong sangat kecil. Perintahnya membaca variabel dari shell yang sedang aktif; kalau key Anda disimpan di file pengaturan, export dulu di terminal ini. Hasil yang diawali {"id":"msg_ berarti beres, 401 berarti key ditolak.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Versi PowerShell-nya; berhasil kalau field id di respons diawali msg_:

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Beberapa hal bekerja berbeda selama Claude Code memakai API key dan gateway:

Langkah 6: isi saldo dengan kartu atau Link (tanpa QRIS, GoPay, OVO, DANA)

Yang Anda bayar di Kunavo adalah saldo API prabayar, bukan langganan. Saldo ini yang dipotong Claude Code per token setelah key terpasang. Urutannya:

1. Buat akun Kunavo pakai e-mail atau akun Google. Saat mendaftar tidak diminta kartu.
2. Buka Billing dan pilih nominal. Minimal $10, tanpa biaya bulanan. Nominal lebih besar dapat bonus saldo: bayar $100 → saldo $110, bayar $1.000 → saldo $1.200, bayar $5.000 → saldo $6.250.
3. Di checkout Stripe, bayar dengan kartu (Visa, Mastercard, dll.), Link, atau Apple Pay/Google Pay kalau perangkat dan browser Anda sudah menyiapkannya. Link menyimpan data pembayaran sehingga top-up berikutnya cukup beberapa klik.
4. Buka API Keys dan buat key. Key berawalan sk-kn- hanya ditampilkan sekali, jadi salin saat itu juga ke ANTHROPIC_AUTH_TOKEN.

QRIS, GoPay, OVO, DANA, ShopeePay, virtual account, dan transfer bank tidak tersedia. Tanpa kartu yang bisa bertransaksi online internasional, saat ini Anda belum bisa top-up di Kunavo. Kartu debit berlogo Visa atau Mastercard juga termasuk kartu; kalau ditolak, biasanya transaksi online atau luar negeri belum diaktifkan di aplikasi bank, dan keputusan akhirnya ada di bank penerbit.

Harga Kunavo dalam USD. Kalau checkout menampilkan rupiah, kursnya ditentukan Stripe dan sudah memuat biaya konversi 2–4% yang ditanggung pembeli (dokumentasi Adaptive Pricing Stripe, dicek 3 Oktober 2026). Memilih bayar dalam USD menghindari biaya itu, meski kurs dan biaya dari bank Anda sendiri tetap berlaku.

Saldo tidak pernah hangus dan request yang gagal tidak memotongnya. Isi ulang otomatis hanya jalan dengan kartu tersimpan atau Link. Kunavo tidak menerbitkan dokumen pajak apa pun. Saldo ini juga tidak bisa dipakai membayar Claude Pro atau Max. Rincian tarif semua model Claude dan cara bayarnya dari Indonesia ada di harga API Claude; hitung-hitungan langganan versus API key khusus untuk Claude Code ada di harga Claude Code.

Kira-kira habis berapa?

Setiap request Claude Code mengirim ulang konteks percakapan, tetapi bagian awal yang sama dari request ke request dikenai tarif baca cache yang jauh lebih murah. Hitungan di bawah murni aritmetika token dengan asumsi yang tertulis, bukan hasil pengukuran dan bukan batas atas:

• satu request = 40.000 token input; 36.000 (90%) dibaca dari cache, sisanya 4.000 ditulis ke cache;
• satu request menghasilkan 1.000 token output;
• satu sesi = 50 request, belum termasuk panggilan Claude Haiku 4.5 di latar belakang;
• tarif baca cache 10% dan tulis cache 1,25× tarif input (proporsi Claude Sonnet 5 di Kunavo; tiap model di tabel memakai proporsinya sendiri).

Angka nyata Anda naik turun mengikuti panjang konteks, seberapa sering cache kena, panjang jawaban, dan apakah percakapan dibersihkan dengan /clear saat pindah tugas. Proses latar belakang Claude Code sendiri menurut dokumentasi biaya Anthropic biasanya di bawah $0,04 per sesi (dicek 3 Oktober 2026). Tarif lengkap ada di halaman harga, dan untuk memperkirakan pola pemakaian sendiri ada kalkulator biaya token Claude (bahasa Inggris).

Cara pakai Claude Code sehari-hari

cd ~/proyek-saya   # Claude Code bekerja di folder tempat ia dijalankan
claude              # mulai sesi
claude -c           # lanjutkan percakapan terakhir di folder ini

• Minta dalam bahasa biasa, misalnya “jelaskan struktur proyek ini” atau “perbaiki error di halaman login”. Claude Code membaca file dan menanyakan izin sebelum mengubah atau menjalankan sesuatu.
• /clear saat ganti tugas: riwayat lama tidak ikut terkirim lagi, jadi token per request turun.
• /model untuk ganti model. Dengan pin di langkah 4, opus = claude-opus-5 dan haiku = claude-haiku-4-5.
• /status untuk mengecek gateway dan key; /usage untuk perkiraan biaya (dengan harga list, lihat tabel di langkah 5).

Pesan error dan artinya

Batasan

• Bayar hanya dengan kartu, Link, atau Apple Pay/Google Pay. Tidak ada QRIS, GoPay, OVO, DANA, ShopeePay, virtual account, atau transfer bank; isi ulang otomatis hanya dengan kartu tersimpan atau Link.
• Kunavo tidak menerbitkan dokumen pajak apa pun.
• Ini API berbayar per token, bukan langganan Claude Pro atau Max. Dengan API key, Remote Control dan dikte suara tidak tersedia, /fast nonaktif, dan MCP tool search mati secara bawaan.
• Per 3 Oktober 2026 Sonnet 5.5 belum tersedia di Kunavo; tanpa pin model, alias bawaan bisa berakhir 404.
• Dokumentasi Claude Code tersedia dalam bahasa Indonesia, tetapi dokumentasi integrasi Kunavo dan versi bahasa Inggris panduan ini (Install Claude Code) belum tersedia dalam bahasa Indonesia.

Pertanyaan yang sering diajukan