Kembali ke panduan
Instalasi·3 Oktober 2026·Diperbarui 10 Oktober 2026·Baca 14 menit

Cara menginstal Claude Code di Windows, macOS, dan Linux — kunci API tanpa langganan dan pembayaran dengan BLIK

Instalasi hanya membutuhkan satu perintah. Masalah muncul setelahnya: versi Node.js saat menggunakan npm, terminal dan PATH di Windows, kunci API tanpa login, serta pembayaran dari Polandia.

Claude Code diinstal dengan satu perintah resmi (di bawah ini tersedia versi untuk macOS dan Linux, PowerShell, serta CMD). Anthropic merekomendasikan penginstal native, sedangkan npm adalah alternatif yang memerlukan Node.js 22 atau yang lebih baru. Tanpa langganan Pro/Max dan tanpa login, cukup atur ANTHROPIC_BASE_URL=https://api.kunavo.com (tanpa /v1), ANTHROPIC_AUTH_TOKEN dengan kunci API, serta empat variabel untuk menetapkan model. Dengan demikian, Anda hanya membayar token yang digunakan dari saldo yang diisi dengan BLIK dalam złoty, mulai dari 10 USD. Terakhir, masukkan /status di Claude Code untuk memeriksa apakah kunci berfungsi.

Terminal
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows – wiersz polecenia (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Perintah dan variabel diverifikasi pada 3 Oktober 2026 berdasarkan dokumentasi instalasi resmi Claude Code dan dokumentasi variabel lingkungan. Tidak ada versi bahasa Polandia dari dokumentasi ini. Harga dan metode pembayaran diverifikasi pada 10 Oktober 2026. Polandia tercantum dalam daftar negara yang didukung Anthropic (diperiksa pada 3 Oktober 2026), baik untuk Claude.ai maupun API.

Login atau kunci API?

Setelah instalasi, Claude Code harus melakukan autentikasi. Ada dua cara, dan panduan ini menjelaskan cara kedua secara terperinci:

KriteriaLogin dengan akun ClaudeKunci API (Kunavo)
Yang diperlukanPaket Pro, Max, Team, Enterprise, atau akun Console. Paket gratis Claude.ai tidak mencakup Claude Code.Kunci sk-kn-… dan variabel lingkungan. Anda tidak memerlukan langganan atau login.
Cara pembayaranLangganan: Pro berharga 20 USD per bulan (atau 17 USD per bulan jika dibayar tahunan, yaitu 200 USD di muka), sedangkan Max mulai dari 100 USD per bulan. Harga belum termasuk pajak (daftar harga Claude, diperiksa pada 3 Oktober 2026).Untuk token yang digunakan, dari saldo prabayar. Pengisian mulai dari 10 USD, tanpa biaya bulanan. Saldo tidak kedaluwarsa.
Metode pembayaranLangganan yang dibeli melalui situs Anthropic hanya dapat dibayar dengan kartu kredit atau debit (FAQ penagihan Claude, diperiksa pada 3 Oktober 2026).BLIK (jumlah dalam złoty), kartu Visa dan Mastercard, Apple Pay, Google Pay, Link
Yang tidak tersediaTidak berlakuRemote Control dan dikte suara. Kunavo juga tidak menerbitkan faktur VAT.

Sebelum memulai

PersyaratanMenurut dokumentasi resmi (diperiksa 3 Oktober 2026)
SistemmacOS 13.0 atau yang lebih baru; Windows 10 1809 atau yang lebih baru atau Windows Server 2019 atau yang lebih baru; Ubuntu 20.04+; Debian 10+; Alpine Linux 3.19+
Perangkat kerasRAM minimal 4 GB, prosesor x64 atau ARM64 (Windows 32-bit tidak didukung)
ShellBash, Zsh, PowerShell, atau CMD
Jaringan dan lokasiKoneksi internet di negara yang didukung Anthropic (Polandia termasuk dalam daftar)
AkunLogin memerlukan paket Pro, Max, Team, Enterprise, atau akun Console. Dengan kunci API, Anda tidak memerlukan langganan maupun login.
Node.jsHanya saat menginstal melalui npm, dengan versi 22 atau yang lebih baru. Penginstal native tidak memerlukannya.

Metode 1: penginstal native (disarankan)

Dalam dokumentasi resmi, metode ini memiliki tab „Native Install (Recommended)”. Perintahnya terdapat di bagian awal halaman. Di macOS, Linux, dan WSL, gunakan baris dengan install.sh. Di Windows PowerShell, gunakan irm … | iex, sedangkan di command prompt CMD gunakan baris dengan install.cmd. Instalasi native diperbarui secara otomatis di latar belakang. Claude Code juga dapat diinstal melalui Homebrew atau WinGet, tetapi menurut dokumentasi, instalasi tersebut secara default tidak diperbarui otomatis, sehingga Anda harus memperbaruinya secara manual di pengelola paket:

# Homebrew – kanał stable; domyślnie nie aktualizuje się sam
brew install --cask claude-code

# WinGet (Windows) – domyślnie nie aktualizuje się sam
winget install Anthropic.ClaudeCode

Setelah instalasi, buka jendela terminal baru karena jendela yang dibuka sebelumnya tidak melihat variabel PATH yang telah diperbarui. Kemudian periksa:

claude --version   # wypisuje numer wersji, np. 2.1.280 (Claude Code)
claude doctor      # diagnostyka instalacji i ustawień, bez otwierania sesji

claude doctor tidak membuka sesi. Perintah ini hanya menampilkan status instalasi dan diagnosis berkas pengaturan. Dengan begitu, Anda dapat paling cepat membedakan masalah instalasi dari masalah konfigurasi.

Jika pengunduhan gagal

Jika terminal menampilkan syntax error near unexpected token '<' atau curl: (22) The requested URL returned error: 403, menurut halaman resmi pemecahan masalah instalasi (diperiksa pada 3 Oktober 2026), alamat penginstal mengembalikan halaman HTML atau kode galat alih-alih skrip. Halaman yang menampilkan App unavailable in region berarti menurut dokumentasi bahwa Claude Code tidak tersedia di negara Anda. Namun, Polandia termasuk dalam daftar negara yang didukung. Jadi, jika Anda melihat pesan tersebut di Polandia, periksa apakah koneksi Anda menggunakan VPN atau proxy. Respons 403 tanpa isi juga dapat berasal dari proxy atau firewall perusahaan yang memblokir unduhan. Dokumentasi menyarankan agar Anda memeriksa koneksi jaringan terlebih dahulu, karena metode instalasi lain terhubung ke server yang sama. Coba gunakan jaringan lain atau minta administrator membuka blokir alamat tersebut.

Metode 2: npm (Node.js 22 atau yang lebih baru)

npm masih menjadi salah satu metode yang disebutkan dalam dokumentasi resmi. Paket ini memerlukan Node.js 22 atau yang lebih baru. Beberapa panduan berbahasa Polandia masih menyebut Node.js 18, tetapi informasi itu sudah usang. Pada Node.js versi lama, npm akan menampilkan peringatan EBADENGINE tetapi tidak akan menghentikan instalasi, dan claude akan tetap berfungsi karena paket tersebut mengunduh program native yang tidak menggunakan Node.js saat berjalan. Jika Anda belum memiliki Node.js, instal versi 22 atau yang lebih baru dari situs nodejs.org.

Terminal
node -v                                    # potrzebna wersja v22 lub nowsza
npm install -g @anthropic-ai/claude-code   # bez sudo

# aktualizacja: @latest, a nie npm update -g
npm install -g @anthropic-ai/claude-code@latest
  • Jangan pernah menggunakan sudo npm install -g. Dokumentasi memperingatkan bahwa hal tersebut dapat menyebabkan masalah izin dan menimbulkan risiko keamanan.
  • Perbarui melalui @latest. Untuk memperbarui, gunakan npm install -g @anthropic-ai/claude-code@latest, bukan npm update -g.
  • Jangan melewati dependensi opsional. Program yang benar diinstal sebagai dependensi opsional, yaitu paket @anthropic-ai/claude-code-* untuk platform Anda. Dengan flag --omit=optional atau dengan optional=false di .npmrc, instalasi di macOS atau Linux akan berakhir dengan pesan claude native binary not installed.

Claude Code di Windows: PowerShell, CMD, WSL, dan PATH

Windows memiliki dua perintah instalasi yang berbeda, dan pilihannya hanya bergantung pada terminal. Jika baris dimulai dengan PS C:\Users\TwojaNazwa>, Anda bekerja di PowerShell. Jika Anda hanya melihat C:\Users\TwojaNazwa>, tanpa PS, itu adalah command prompt (CMD). Menurut dokumentasi, terminal tidak perlu dijalankan sebagai administrator, meskipun beberapa panduan menyarankannya.

Kesalahan yang paling umum adalah menempelkan perintah ke terminal yang salah. Baris untuk CMD yang ditempelkan ke PowerShell menghasilkan The token '&&' is not a valid statement separator. Baris untuk PowerShell yang ditempelkan ke CMD menghasilkan 'irm' is not recognized as an internal or external command. Di Windows berbahasa Polandia, pesan yang sama berbunyi: „irm” tidak dikenali sebagai perintah internal atau eksternal, program yang dapat dijalankan, atau berkas batch. Sebaliknya, baris curl … | bash dari macOS yang ditempelkan ke PowerShell berakhir dengan kesalahan A parameter cannot be found that matches parameter name 'fsSL' atau 'bash' is not recognized as the name of a cmdlet. Dalam semua kasus ini, cukup gunakan baris yang ditujukan untuk terminal Anda.

Di menu Start terdapat dua entri: „Windows PowerShell” dan „Windows PowerShell (x86)”. Entri kedua berjalan sebagai proses 32-bit, sehingga bahkan pada komputer 64-bit akan berakhir dengan kesalahan Claude Code does not support 32-bit Windows. Buka entri tanpa tambahan (x86).

Git for Windows bersifat opsional, tetapi disarankan. Jika terpasang, Claude Code menjalankan perintah melalui Git Bash yang disertakan; jika tidak, Claude Code menggunakan PowerShell. Jika Git sudah terpasang tetapi Claude Code tidak menemukan Git Bash, atur variabel CLAUDE_CODE_GIT_BASH_PATH di blok env pada file ~/.claude/settings.json ke path bash.exe. Contoh path dalam dokumentasi adalah C:\Program Files\Git\bin\bash.exe.

VarianYang diperlukanSandboxKapan memilih
Windows nativeTidak ada; Git for Windows opsionalTidak didukungProyek dan alat berjalan di Windows
WSL 2WSL 2 diaktifkanDidukungAnda memerlukan alat Linux atau eksekusi perintah yang terisolasi
WSL 1WSL 1 diaktifkanTidak didukungSaat WSL 2 tidak tersedia

Jika memilih WSL, jalankan baris untuk macOS dan Linux di terminal WSL, dan jalankan claude di sana juga, bukan di PowerShell atau CMD.

Kesalahan kebijakan eksekusi skrip (npm di PowerShell)

Pesan npm.ps1 cannot be loaded because running scripts is disabled on this system saat menginstal atau menjalankan melalui npm berarti kebijakan eksekusi (execution policy) PowerShell memblokir skrip startup .ps1 yang dibuat npm. Menurut dokumentasi, Anda dapat mengizinkan pengguna saat ini menjalankan skrip lokal (perintah di bawah), menggunakan npm.cmd dan claude.cmd, atau beralih ke penginstal native untuk PowerShell.

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Perintah „claude” tidak dikenali setelah instalasi

command not found: claude atau 'claude' is not recognized berarti direktori instalasi tidak terdapat dalam PATH. Penginstal native menempatkan program di ~/.local/bin/claude pada macOS dan Linux, serta di %USERPROFILE%\.local\bin\claude.exe pada Windows. Pertama, buka terminal baru. Jika di Windows masih tidak berfungsi, periksa dan tambahkan jalur di PowerShell seperti yang dijelaskan dalam dokumentasi:

PowerShell
# 1. Sprawdź, czy katalog instalacji jest już w PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Brak wyniku? Dopisz go do PATH użytkownika, zamknij i otwórz terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. W nowym terminalu
claude --version

Kunci API sebagai pengganti login (tanpa langganan)

ANTHROPIC_BASE_URL adalah variabel bawaan Claude Code. Menurut dokumentasi resmi, variabel ini menimpa endpoint API untuk mengarahkan permintaan melalui proxy atau gateway. Jadi, menghubungkan Claude Code ke layanan yang kompatibel dengan Anthropic Messages API merupakan konfigurasi yang didukung Anthropic. Anda tidak memerlukan plugin atau program yang dimodifikasi. Di macOS dan Linux, tambahkan variabel ke berkas konfigurasi shell (~/.zshrc atau ~/.bashrc):

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # sama domena, bez /v1
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-5

Di Windows, Anda dapat terlebih dahulu memeriksa konfigurasi dalam satu jendela PowerShell:

PowerShell
# Działa tylko w tym oknie PowerShella – po zamknięciu znika
$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-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Untuk pengaturan permanen, sebaiknya masukkan variabel ke dalam blok env di berkas pengaturan pengguna ~/.claude/settings.json (di Windows %USERPROFILE%\.claude\settings.json). Menurut dokumentasi, berkas ini berlaku di semua proyek Anda. Jika berkas tersebut sudah memiliki pengaturan lain, tambahkan hanya blok env:

~/.claude/settings.json
{
  "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-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Masing-masing dari enam baris ini mudah menimbulkan kesalahan:

  • ANTHROPIC_BASE_URL hanyalah domain. Claude Code secara otomatis menambahkan /v1/messages. Dengan /v1 di bagian akhir, permintaan akan diarahkan ke /v1/v1/messages dan menghasilkan 404.
  • ANTHROPIC_AUTH_TOKEN, bukan ANTHROPIC_API_KEY. Nilai ANTHROPIC_AUTH_TOKEN masuk ke header Authorization dengan awalan Bearer dan langsung berfungsi. ANTHROPIC_API_KEY masuk ke header x-api-key dan dalam mode interaktif harus disetujui sekali. Jika Anda menolaknya, kunci akan diabaikan secara diam-diam. Anda dapat mengaktifkannya kembali di /config → Use custom API key.
  • ANTHROPIC_MODEL memilih model utama. Di sini nilainya adalah Claude Sonnet 5 (claude-sonnet-5). Nama tersebut harus persis sama dengan yang ada dalam daftar model Kunavo. Kunavo tidak mengenali nama lama yang diakhiri tanggal.
  • ANTHROPIC_DEFAULT_OPUS_MODEL dan ANTHROPIC_DEFAULT_SONNET_MODEL mengunci alias opus dan sonnet. Menurut dokumentasi konfigurasi model resmi (diperiksa pada 3 Oktober 2026), bagi pengguna API, model default dan alias opus mengarah ke Opus 5.5, sedangkan alias sonnet mengarah ke Sonnet 5.5. Alias berubah dari waktu ke waktu; versi dapat dikunci dengan nama model lengkap atau variabel seperti dua variabel tersebut. Permintaan untuk model yang tidak tersedia di Kunavo menghasilkan 404. Kami mengunci alias opus ke Claude Opus 5.5 (claude-opus-5-5), karena Opus berikutnya yang dirilis Anthropic belum tentu langsung tersedia di Kunavo. Opus 5.5 memerlukan Claude Code versi 2.1.280 atau yang lebih baru; perbarui versi yang lebih lama dengan perintah claude update. Sonnet 5.5 saat ini (per 3 Oktober 2026) tidak tersedia di Kunavo, sehingga tanpa mengunci alias sonnet ke claude-sonnet-5, /model sonnet, tahap eksekusi dalam mode opusplan dan subagen yang disetel ke model: sonnet akan mengembalikan galat 404.
  • Patok juga ANTHROPIC_DEFAULT_HAIKU_MODEL. Alias haiku meminta ID yang tidak didukung Kunavo: sejak Claude Code 2.1.293, ID tersebut adalah Haiku 5.5; sebelumnya, ID Haiku 4.5 dengan akhiran tanggal. Tanpa variabel ini, /model haiku dan subagen yang ditetapkan ke model: haiku menerima 404.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL juga menangani tugas di latar belakang. Menurut dokumentasi, variabel ini memilih model untuk alias haiku dan fungsi yang berjalan di latar belakang. Di Kunavo, Claude Haiku 4.5 berharga 0,70 USD per satu juta token input dan 3,50 USD per satu juta token output. Model utama Claude Sonnet 5 berharga 1,40 USD / 7,00 USD (harga Anthropic: 2,00 USD / 10,00 USD), sedangkan Claude Opus 5.5 berharga 2,80 USD / 14,00 USD (input / output, per satu juta token).

Jangan masukkan kunci ke dalam .claude/settings.json proyek. Menurut dokumentasi untuk menghubungkan gateway, file ini masuk ke repositori, sehingga dapat diakses oleh siapa pun yang mengkloningnya. Perhatikan juga urutan prioritas. Jika variabel yang sama ditetapkan baik di shell maupun di blok env dalam file pengaturan, nilai dari file pengaturan berlaku di sebagian besar sesi. Ada aturan tersendiri untuk kunci model dalam file pengaturan: variabel ANTHROPIC_MODEL memiliki prioritas lebih tinggi, sedangkan model hanya berlaku jika variabel tersebut tidak ada. Jika perubahan di shell tidak berlaku, periksa file pengaturan terlebih dahulu. Di ekstensi Claude Code untuk VS Code, variabel ditetapkan melalui claudeCode.environmentVariables dalam pengaturan pengguna VS Code itu sendiri.

Peluncuran pertama dan /status

Menurut dokumentasi tentang menghubungkan gateway (diperiksa 3 Oktober 2026), dengan ANTHROPIC_AUTH_TOKEN yang telah diatur, perintah claude langsung membuka sesi tanpa layar login. Variabel ini langsung berfungsi dan tidak perlu disetujui seperti ANTHROPIC_API_KEY. Jika yang muncul adalah layar login, Claude Code tidak membaca kunci tersebut.

Kunci harus berada di tempat yang dibaca Claude Code sebelum konfigurasi pertama, yaitu ditetapkan dengan perintah export di shell atau di blok env berkas pengguna ~/.claude/settings.json. Dalam mode interaktif, blok env dari .claude/settings.json atau .claude/settings.local.json proyek baru mulai berlaku setelah wizard peluncuran pertama dan pertanyaan tentang kepercayaan terhadap folder selesai. Jika kunci hanya ada di pengaturan proyek, pada peluncuran pertama Anda tetap akan melihat layar login.

Dalam sesi, masukkan /status dan periksa dua baris:

  • Anthropic base URL hanya muncul ketika alamat gateway telah diatur. Baris ini harus menampilkan https://api.kunavo.com. Jika baris tersebut tidak ada, ANTHROPIC_BASE_URL tidak sampai ke sesi.
  • Auth token dengan nama ANTHROPIC_AUTH_TOKEN berarti kunci API sedang digunakan, bukan login claude.ai yang tersimpan. Jika Anda melihat Login method dengan akun claude.ai, variabel tersebut tidak berfungsi.

Anda juga dapat memeriksa alamat dan kunci sebelum menjalankan Claude Code, menggunakan metode dari dokumentasi resmi. Metode ini mengirim permintaan untuk 1 token output, yang mengambil jumlah simbolis dari saldo. Perintah tersebut membaca variabel dari shell saat ini, jadi meskipun kunci berada di berkas pengaturan, terlebih dahulu tetapkan variabel dengan perintah export di terminal ini. Respons JSON yang dimulai dengan {"id":"msg_ berarti alamat dan kunci berfungsi. Kode 401 berarti kunci ditolak.

Terminal
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": "."}]}'

Di PowerShell, pemeriksaan yang sama terlihat seperti ini. Jika semuanya berfungsi, respons akan menampilkan bidang id yang dimulai dengan msg_:

PowerShell
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": "."}]}'

Apa yang berbeda saat menggunakan kunci API

  • Remote Control dan dikte suara tidak tersedia. Menurut dokumentasi, keduanya memerlukan identitas claude.ai dan tidak berfungsi saat ANTHROPIC_AUTH_TOKEN aktif. Sejak versi 2.1.196, Remote Control juga dinonaktifkan ketika ANTHROPIC_BASE_URL menunjuk ke host selain api.anthropic.com.
  • /fast menampilkan mode cepat sebagai dinonaktifkan. Menurut dokumentasi, jika hanya ada token bearer, Claude Code menganggap mode cepat dinonaktifkan dan tidak mengirim permintaan untuk memeriksa ketersediaannya.
  • Pencarian alat MCP secara default dinonaktifkan. Hal ini terjadi ketika ANTHROPIC_BASE_URL menunjuk ke host selain Anthropic.
  • Angka pada /context merupakan perkiraan. Kunavo tidak menyediakan endpoint /v1/messages/count_tokens. Menurut dokumentasi kompatibilitas gateway (diperiksa pada 3 Oktober 2026), Claude Code menghitung token secara lokal berdasarkan jumlah karakter.

Deskripsi lengkap integrasi tersedia dalam dokumentasi integrasi Claude Code (dalam bahasa Inggris), sedangkan versi bahasa Inggris panduan ini tersedia dalam artikel Install Claude Code.

Pembayaran BLIK: pengisian saldo dan kunci API

Langganan Claude yang dibeli melalui situs Anthropic hanya dapat dibayar dengan kartu kredit atau debit (FAQ penagihan Claude, diperiksa pada 3 Oktober 2026). BLIK tidak dapat digunakan untuk membayar Pro atau Max. Di Kunavo, BLIK digunakan untuk mengisi saldo API prabayar, yang dipakai Claude Code untuk membayar token setelah kunci diatur seperti di atas. Semua langkah pembayaran dijelaskan dalam panduan cara membayar Claude dengan BLIK. Singkatnya, langkahnya seperti berikut:

  1. Buat akun Kunavo melalui email atau akun Google. Saat mendaftar, Anda tidak perlu memasukkan kartu.
  2. Di tab Penagihan (Billing), pilih jumlah pengisian. Minimum adalah 10 USD dan tidak ada biaya bulanan. Untuk jumlah yang lebih besar, Anda mendapatkan bonus: 100 USD → 110 USD di saldo, 1000 USD → 1200 USD di saldo, dan 5000 USD → 6250 USD di saldo.
  3. Di halaman pembayaran Stripe, jumlahnya ditampilkan dalam złoty. Pilih BLIK, buat kode enam digit di aplikasi bank, masukkan kode tersebut, lalu konfirmasikan pembayaran di aplikasi. Menurut dokumentasi Stripe (diperiksa pada 3 Oktober 2026), kode BLIK berlaku selama 2 menit, dan setelah memulai pembayaran, Anda memiliki waktu 60 detik untuk menyetujuinya.
  4. Di tab Kunci API, buat kunci yang diawali sk-kn-. Kunci hanya ditampilkan sekali, jadi segera simpan dan masukkan ke ANTHROPIC_AUTH_TOKEN.

Di halaman pembayaran dalam złoty, selain BLIK tersedia juga kartu (Visa, Mastercard), Apple Pay dan Google Pay pada perangkat yang didukung, serta Link. Przelewy24, PayU, PayPal, dan transfer bank biasa tidak tersedia. Harga ditetapkan dalam dolar, lalu Stripe mengonversinya ke złoty. Menurut dokumentasi Stripe tentang Adaptive Pricing (diperiksa pada 3 Oktober 2026), nilai tukar mencakup biaya konversi sebesar 2–4% yang ditanggung pembeli. Membayar dengan kartu dalam dolar akan menghindarkan Anda dari biaya ini, meskipun nilai tukar dan biaya bank Anda akan berlaku; BLIK hanya berfungsi dalam złoty. Jumlah pasti dalam złoty akan terlihat di halaman pembayaran sebelum Anda mengonfirmasi.

BLIK hanya berfungsi untuk pengisian manual. Pengisian otomatis memerlukan kartu tersimpan atau Link. Saldo tidak kedaluwarsa, dan Anda tidak membayar permintaan yang gagal. Kunavo tidak menerbitkan faktur VAT; riwayat pengisian tersedia di tab Penagihan (Billing). Ingat, ini adalah pengisian saldo API Kunavo, bukan biaya untuk Claude Pro atau Max.

Berapa biayanya (contoh perhitungan)

Di Claude Code, Anda membayar token. Pada setiap permintaan, Claude Code mengirim ulang seluruh konteks percakapan, tetapi bagian awal konteks yang berulang dapat ditagihkan dengan tarif baca dari cache. Di bawah ini adalah contoh perhitungan berdasarkan token. Ini bukan pengukuran atau batas biaya maksimum. Semua asumsi dicantumkan:

  • setiap permintaan memiliki 40.000 token input, di antaranya 36.000 (90%) ditagihkan sebagai pembacaan dari cache, sedangkan sisanya, 4000, sebagai penulisan ke cache;
  • setiap permintaan menghasilkan 1000 token output;
  • dalam satu sesi kerja terdapat 50 permintaan seperti itu, tanpa pemanggilan Claude Haiku 4.5 di latar belakang;
  • di Kunavo, pembacaan dari cache berbiaya 10% dari tarif input, sedangkan penulisan ke cache berbiaya 1,25× tarif input. Proporsi ini berlaku untuk Claude Sonnet 5, dan setiap model dalam perbandingan dihitung berdasarkan proporsinya sendiri.
ModelSatu permintaan50 permintaan50 permintaan tanpa satu pun cache hit
Claude Sonnet 50,019 USD0,95 USD3,15 USD
Claude Opus 5.50,033 USD1,65 USD6,30 USD

Biaya sebenarnya bergantung pada panjang konteks, jumlah cache hit, panjang respons, dan apakah Anda menghapus percakapan dengan perintah /clear di antara tugas. Tarif semua model tersedia dalam daftar harga. Anda dapat memperkirakan penggunaan Anda sendiri dengan kalkulator biaya token Claude (dalam bahasa Inggris). Panduan berapa biaya Claude Code menjelaskan kapan langganan lebih menguntungkan dan kapan API lebih menguntungkan.

Kesalahan yang paling umum

PesanPenyebab dan solusi
The token '&&' is not a valid statement separatorBaris untuk CMD ditempelkan ke PowerShell. Gunakan irm … | iex.
'irm' is not recognized as an internal or external commandBaris untuk PowerShell ditempelkan ke CMD. Gunakan baris dengan install.cmd.
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdletPerintah untuk macOS dan Linux dijalankan di Windows. Gunakan baris untuk PowerShell.
syntax error near unexpected token '<', 403Alamat penginstal mengembalikan halaman HTML atau kode kesalahan. Periksa VPN, proxy, dan firewall. Metode instalasi lain terhubung ke server yang sama, sehingga tidak dapat mengatasi masalah ini sendiri.
command not found: claude, 'claude' is not recognizedDirektori instalasi tidak terdapat dalam PATH. Buka terminal baru, lalu di Windows tambahkan jalur menggunakan perintah PowerShell yang diberikan di atas.
Peringatan EBADENGINENode.js lebih lama dari 22. Instalasi tetap selesai, tetapi sebaiknya perbarui Node.js.
claude native binary not installed (macOS, Linux)npm melewati dependensi opsional (--omit=optional atau optional=false) atau skrip instalasi (--ignore-scripts). Hapus pengaturan tersebut dan instal ulang.
npm.ps1 cannot be loadedKebijakan eksekusi PowerShell memblokir skrip npm. Jalankan perintah Set-ExecutionPolicy atau gunakan penginstal native.
Claude Code does not support 32-bit WindowsPowerShell (x86) sedang dijalankan. Buka „Windows PowerShell” biasa.
Layar login muncul meskipun kunci telah diaturClaude Code tidak membaca kunci tersebut. Masukkan variabel ke shell atau ke ~/.claude/settings.json, bukan hanya ke pengaturan proyek, lalu buka terminal baru.
401Kunci ditolak. Periksa apakah kunci sk-kn- disalin sepenuhnya tanpa spasi, apakah belum dihapus di /app/keys, dan apakah kunci tersebut berada di ANTHROPIC_AUTH_TOKEN.
404ANTHROPIC_BASE_URL berakhir pada /v1 atau model tersebut tidak ada dalam daftar Kunavo, misalnya karena empat variabel penetapan model belum diatur.

Batasan

  • Kunavo tidak menerbitkan faktur VAT.
  • BLIK hanya berfungsi untuk pengisian manual. Pengisian otomatis memerlukan kartu tersimpan atau Link.
  • Ini adalah API yang ditagihkan berdasarkan token, bukan langganan Claude Pro atau Max. Dengan kunci API, Remote Control dan dikte suara tidak berfungsi, mode /fast dinonaktifkan, dan pencarian alat MCP secara default dinonaktifkan.
  • Saat ini Kunavo (per 3 Oktober 2026) tidak menyediakan Sonnet 5.5, sehingga konfigurasi di atas menetapkan alias sonnet ke claude-sonnet-5. Tanpa model yang ditetapkan, alias default dapat menghasilkan 404. Claude Opus 5.5, yang ditetapkan ke alias opus, memerlukan Claude Code versi 2.1.280 atau yang lebih baru.
  • Dokumentasi resmi Claude Code dan dokumentasi integrasi Kunavo hanya tersedia dalam bahasa Inggris.

Pertanyaan yang sering diajukan

Bagaimana cara menginstal Claude Code?

Cara termudah adalah menggunakan installer native, yang ditandai Anthropic sebagai rekomendasi dalam dokumentasinya. Di macOS, Linux, dan WSL, jalankan curl -fsSL https://claude.ai/install.sh | bash. Di Windows PowerShell, jalankan irm https://claude.ai/install.ps1 | iex, sedangkan di command prompt (CMD), jalankan curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Setelah itu, buka jendela terminal baru dan periksa instalasi dengan perintah claude --version. Instalasi native diperbarui otomatis di latar belakang.

Claude Code melalui npm: versi Node.js apa yang diperlukan?

Menurut dokumentasi instalasi resmi (diperiksa 3 Oktober 2026), paket npm memerlukan Node.js 22 atau yang lebih baru, bukan 18 seperti yang disebutkan panduan lama. Pada Node.js yang lebih lama, npm hanya menampilkan peringatan EBADENGINE, dan instalasi tetap berhasil karena paket mengunduh program native yang tidak menggunakan Node.js saat berjalan. Instal dengan perintah npm install -g @anthropic-ai/claude-code tanpa sudo, lalu perbarui dengan perintah npm install -g @anthropic-ai/claude-code@latest, bukan npm update -g.

Bagaimana cara menginstal Claude Code di Windows? Apakah saya memerlukan WSL dan Git?

WSL dan Git tidak diperlukan. Jalankan perintah instalasi untuk PowerShell atau CMD tanpa hak administrator. Git for Windows bersifat opsional tetapi disarankan: jika terinstal, Claude Code menjalankan perintah melalui Git Bash, dan tanpa Git Code menggunakan PowerShell. Pilih WSL 2 jika memerlukan alat Linux atau eksekusi perintah terisolasi (sandbox); dalam hal ini, instal dan jalankan claude di terminal WSL. Jangan membuka “Windows PowerShell (x86)”: itu proses 32-bit, sedangkan Claude Code tidak mendukung Windows 32-bit.

Dapatkah saya menggunakan Claude Code tanpa langganan Pro/Max dan tanpa login?

Ya. Login dengan akun Claude memerlukan paket Pro, Max, Team, Enterprise, atau akun Console, dan paket gratis Claude.ai tidak mencakup Claude Code. Sebagai pengganti login, Anda dapat menetapkan variabel ANTHROPIC_BASE_URL=https://api.kunavo.com dan ANTHROPIC_AUTH_TOKEN dengan API key. Claude Code kemudian dimulai tanpa layar login dan membebankan token yang digunakan ke saldo prabayar Kunavo, tanpa langganan. Dalam mode ini Remote Control dan input suara tidak berfungsi karena memerlukan identitas claude.ai.

Di mana API key untuk Claude Code harus dimasukkan, dan apakah ANTHROPIC_BASE_URL harus diakhiri dengan /v1?

Tanpa /v1. Claude Code otomatis menambahkan /v1/messages, sehingga alamat yang diakhiri /v1 mengarahkan request ke /v1/v1/messages dan berakhir dengan kesalahan 404. Masukkan variabel ke file konfigurasi shell (~/.zshrc, ~/.bashrc, atau $PROFILE di PowerShell) atau ke blok env dalam file ~/.claude/settings.json pengguna (di Windows %USERPROFILE%\.claude\settings.json). Jangan pernah memasukkan key ke .claude/settings.json proyek karena file tersebut masuk ke repositori. Jika variabel yang sama ditetapkan di shell dan file settings, pada sebagian besar sesi nilai dari file settings yang berlaku.

Mengapa ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, dan ANTHROPIC_DEFAULT_SONNET_MODEL perlu ditetapkan?

Tanpa variabel tersebut, Claude Code menggunakan alias yang berubah mengikuti model Anthropic baru. Menurut dokumentasi konfigurasi model resmi (diperiksa 3 Oktober 2026), bagi pengguna API, model default dan alias opus menunjuk ke Opus 5.5, sedangkan alias sonnet menunjuk ke Sonnet 5.5. Saat ini Kunavo (per 3 Oktober 2026) tidak menyediakan Sonnet 5.5, sehingga tanpa mengunci alias sonnet, /model sonnet, fase eksekusi dalam mode opusplan, dan subagent yang ditetapkan ke model: sonnet akan menghasilkan 404. Opus baru juga belum tentu segera tersedia di Kunavo. Setelah dikunci, model utama adalah claude-sonnet-5, alias opus adalah claude-opus-5-5 (Opus 5.5 memerlukan Claude Code versi 2.1.280 atau yang lebih baru; versi lama dapat diperbarui dengan perintah claude update), alias sonnet adalah claude-sonnet-5, sedangkan alias haiku dan tugas latar belakang adalah claude-haiku-4-5, sehingga jelas model mana yang merespons dan tarif mana yang Anda bayar.

Bagaimana cara memeriksa apakah Claude Code menggunakan kunci API, bukan akun claude.ai?

Dalam sesi Claude Code, masukkan /status. Baris „Anthropic base URL” harus menampilkan https://api.kunavo.com, dan baris „Auth token” harus menunjukkan ANTHROPIC_AUTH_TOKEN. Jika yang terlihat adalah „Login method” dengan akun claude.ai, variabel tersebut belum terbaca. Tutup sesi, buka terminal baru, lalu periksa di mana variabel tersebut dimasukkan.

Apakah saya bisa membayar dengan BLIK? Bagaimana dengan pengisian saldo otomatis dan faktur VAT?

Ya, Anda dapat mengisi saldo API Kunavo dengan BLIK. Halaman pembayaran Stripe menampilkan jumlah dalam złoty; selain BLIK, tersedia juga kartu Visa dan Mastercard, Apple Pay, Google Pay, dan Link. Pengisian minimum adalah 10 USD, tanpa biaya bulanan, dan saldo tidak kedaluwarsa. Kurs Stripe mencakup biaya konversi mata uang sebesar 2–4%. BLIK hanya berfungsi untuk pengisian manual karena pengisian otomatis memerlukan kartu tersimpan atau Link. Kunavo tidak menerbitkan faktur VAT. Ini bukan pembayaran untuk Claude Pro atau Max: langganan yang dibeli di situs Anthropic hanya dapat dibayar dengan kartu.