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.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows – wiersz polecenia (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdPerintah 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:
| Kriteria | Login dengan akun Claude | Kunci API (Kunavo) |
|---|---|---|
| Yang diperlukan | Paket 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 pembayaran | Langganan: 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 pembayaran | Langganan 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 tersedia | Tidak berlaku | Remote Control dan dikte suara. Kunavo juga tidak menerbitkan faktur VAT. |
Sebelum memulai
| Persyaratan | Menurut dokumentasi resmi (diperiksa 3 Oktober 2026) |
|---|---|
| Sistem | macOS 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 keras | RAM minimal 4 GB, prosesor x64 atau ARM64 (Windows 32-bit tidak didukung) |
| Shell | Bash, Zsh, PowerShell, atau CMD |
| Jaringan dan lokasi | Koneksi internet di negara yang didukung Anthropic (Polandia termasuk dalam daftar) |
| Akun | Login memerlukan paket Pro, Max, Team, Enterprise, atau akun Console. Dengan kunci API, Anda tidak memerlukan langganan maupun login. |
| Node.js | Hanya 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.ClaudeCodeSetelah 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 sesjiclaude 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.
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, gunakannpm install -g @anthropic-ai/claude-code@latest, bukannpm 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=optionalatau denganoptional=falsedi.npmrc, instalasi di macOS atau Linux akan berakhir dengan pesanclaude 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.
| Varian | Yang diperlukan | Sandbox | Kapan memilih |
|---|---|---|---|
| Windows native | Tidak ada; Git for Windows opsional | Tidak didukung | Proyek dan alat berjalan di Windows |
| WSL 2 | WSL 2 diaktifkan | Didukung | Anda memerlukan alat Linux atau eksekusi perintah yang terisolasi |
| WSL 1 | WSL 1 diaktifkan | Tidak didukung | Saat 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.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserPerintah „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:
# 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 --versionKunci 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):
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-5Di Windows, Anda dapat terlebih dahulu memeriksa konfigurasi dalam satu jendela 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"
claudeUntuk 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:
{
"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_URLhanyalah domain. Claude Code secara otomatis menambahkan/v1/messages. Dengan/v1di bagian akhir, permintaan akan diarahkan ke/v1/v1/messagesdan menghasilkan 404.ANTHROPIC_AUTH_TOKEN, bukanANTHROPIC_API_KEY. NilaiANTHROPIC_AUTH_TOKENmasuk ke headerAuthorizationdengan awalanBearerdan langsung berfungsi.ANTHROPIC_API_KEYmasuk ke headerx-api-keydan 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_MODELmemilih 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_MODELdanANTHROPIC_DEFAULT_SONNET_MODELmengunci aliasopusdansonnet. Menurut dokumentasi konfigurasi model resmi (diperiksa pada 3 Oktober 2026), bagi pengguna API, model default dan aliasopusmengarah ke Opus 5.5, sedangkan aliassonnetmengarah 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 aliasopuske 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 perintahclaude update. Sonnet 5.5 saat ini (per 3 Oktober 2026) tidak tersedia di Kunavo, sehingga tanpa mengunci aliassonnetkeclaude-sonnet-5,/model sonnet, tahap eksekusi dalam modeopusplandan subagen yang disetel kemodel: sonnetakan mengembalikan galat 404.- Patok juga
ANTHROPIC_DEFAULT_HAIKU_MODEL. Aliashaikumeminta 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 haikudan subagen yang ditetapkan kemodel: haikumenerima 404. ANTHROPIC_DEFAULT_HAIKU_MODELjuga menangani tugas di latar belakang. Menurut dokumentasi, variabel ini memilih model untuk aliashaikudan 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 URLhanya muncul ketika alamat gateway telah diatur. Baris ini harus menampilkanhttps://api.kunavo.com. Jika baris tersebut tidak ada,ANTHROPIC_BASE_URLtidak sampai ke sesi.Auth tokendengan namaANTHROPIC_AUTH_TOKENberarti kunci API sedang digunakan, bukan login claude.ai yang tersimpan. Jika Anda melihatLogin methoddengan 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.
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_:
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_TOKENaktif. Sejak versi 2.1.196, Remote Control juga dinonaktifkan ketikaANTHROPIC_BASE_URLmenunjuk ke host selainapi.anthropic.com. /fastmenampilkan 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_URLmenunjuk ke host selain Anthropic. - Angka pada
/contextmerupakan 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:
- Buat akun Kunavo melalui email atau akun Google. Saat mendaftar, Anda tidak perlu memasukkan kartu.
- 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.
- 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.
- Di tab Kunci API, buat kunci yang diawali
sk-kn-. Kunci hanya ditampilkan sekali, jadi segera simpan dan masukkan keANTHROPIC_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.
| Model | Satu permintaan | 50 permintaan | 50 permintaan tanpa satu pun cache hit |
|---|---|---|---|
| Claude Sonnet 5 | 0,019 USD | 0,95 USD | 3,15 USD |
| Claude Opus 5.5 | 0,033 USD | 1,65 USD | 6,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
| Pesan | Penyebab dan solusi |
|---|---|
The token '&&' is not a valid statement separator | Baris untuk CMD ditempelkan ke PowerShell. Gunakan irm … | iex. |
'irm' is not recognized as an internal or external command | Baris 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 cmdlet | Perintah untuk macOS dan Linux dijalankan di Windows. Gunakan baris untuk PowerShell. |
syntax error near unexpected token '<', 403 | Alamat 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 recognized | Direktori instalasi tidak terdapat dalam PATH. Buka terminal baru, lalu di Windows tambahkan jalur menggunakan perintah PowerShell yang diberikan di atas. |
Peringatan EBADENGINE | Node.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 loaded | Kebijakan eksekusi PowerShell memblokir skrip npm. Jalankan perintah Set-ExecutionPolicy atau gunakan penginstal native. |
Claude Code does not support 32-bit Windows | PowerShell (x86) sedang dijalankan. Buka „Windows PowerShell” biasa. |
| Layar login muncul meskipun kunci telah diatur | Claude Code tidak membaca kunci tersebut. Masukkan variabel ke shell atau ke ~/.claude/settings.json, bukan hanya ke pengaturan proyek, lalu buka terminal baru. |
401 | Kunci 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. |
404 | ANTHROPIC_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
/fastdinonaktifkan, 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
sonnetkeclaude-sonnet-5. Tanpa model yang ditetapkan, alias default dapat menghasilkan 404. Claude Opus 5.5, yang ditetapkan ke aliasopus, 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.