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

Instal Claude Code: perintah instalasi di Windows dan macOS, konfigurasi kunci API tanpa paket Pro/Max, pembayaran dengan kartu atau Link

Menginstal Claude Code hanya memerlukan satu perintah resmi. Bagian yang sering menimbulkan masalah adalah langkah setelahnya: versi Node.js saat menggunakan npm, terminal dan PATH di Windows, konfigurasi kunci API tanpa paket Pro/Max, serta cara membayar dari Vietnam tanpa MoMo, ZaloPay, atau VNPay.

Untuk menggunakan Claude Code tanpa membeli paket Pro/Max, lakukan tiga hal: instal dengan perintah native resmi (satu baris untuk setiap jenis terminal, tepat di bawah ini), tetapkan ANTHROPIC_BASE_URL=https://api.kunavo.com (tanpa /v1) bersama ANTHROPIC_AUTH_TOKEN dan empat variabel penguncian model, lalu ketik /status untuk memastikan Claude Code berjalan menggunakan key. Biaya token dipotong dari saldo prabayar, yang diisi dari 10 USD menggunakan kartu Visa/Mastercard atau Link; MoMo, ZaloPay, dan VNPay tidak tersedia. Instalasi melalui npm memerlukan Node.js 22 atau yang lebih baru.

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 Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Perintah instalasi dan nama variabel dalam artikel ini bersumber dari dokumentasi resmi Claude Code, termasuk halaman instalasi dan daftar variabel lingkungan, yang diperiksa kembali pada 3 Oktober 2026. Anthropic belum menyediakan versi bahasa Vietnam untuk halaman-halaman ini (jalur /docs/vi/setup menghasilkan 404 pada tanggal yang sama), jadi pesan kesalahan dalam artikel dipertahankan dalam bahasa Inggris agar mudah dicari. Harga dan metode pembayaran Kunavo diverifikasi pada 10 Oktober 2026.

Pilih perintah instalasi sesuai terminal yang sedang terbuka

Semua metode instalasi menghasilkan program claude yang sama; perbedaannya adalah siapa yang menangani pembaruan. Dokumentasi resmi menempatkan metode native di tab “Native Install (Recommended)”, dan ini juga satu-satunya metode yang memperbarui ke versi baru secara otomatis tanpa tindakan Anda.

Anda berada diGunakan perintahPembaruan
macOS, Linux, atau terminal WSLinstall.sh (baris pertama di atas)Otomatis, berjalan di latar belakang
Windows PowerShell, dengan prompt berbentuk PS C:\Users\TenBan>irm https://claude.ai/install.ps1 | iexOtomatis, berjalan di latar belakang
Windows CMD, dengan prompt berbentuk C:\Users\TenBan> (tanpa PS)Baris yang berisi install.cmdOtomatis, berjalan di latar belakang
Sudah terbiasa dengan Homebrew atau WinGetbrew install --cask claude-code, winget install Anthropic.ClaudeCodeSecara default tidak diperbarui otomatis; tingkatkan versi melalui pengelola paket itu sendiri
Harus melalui npmnpm install -g @anthropic-ai/claude-code, memerlukan Node.js 22+Jalankan kembali dengan @latest
# Homebrew (macOS, Linux) – mặc định không tự cập nhật
brew install --cask claude-code

# WinGet (Windows) – mặc định không tự cập nhật
winget install Anthropic.ClaudeCode

Mesin harus memenuhi persyaratan berikut (menurut halaman instalasi, dibaca pada 3 Oktober 2026):

  • Sistem operasi: macOS 13.0 atau yang lebih baru; Windows 10 versi 1809 atau yang lebih baru, atau Windows Server 2019 atau yang lebih baru; Ubuntu 20.04+, Debian 10+, atau Alpine Linux 3.19+.
  • Minimal 4 GB RAM, CPU x64 atau ARM64. Windows 32-bit tidak didukung.
  • Shell harus berupa Bash, Zsh, PowerShell, atau CMD, dan memiliki koneksi Internet.
  • Node.js hanya diperlukan jika menginstal melalui npm, dan harus versi 22 atau yang lebih baru.

Setelah instalasi selesai, jangan langsung mengetik claude di jendela lama: jendela tersebut belum menerima PATH yang baru. Buka terminal lain lalu jalankan:

claude --version   # in ra số phiên bản, kèm chữ (Claude Code)
claude doctor      # chẩn đoán cài đặt và file cấu hình, không mở phiên làm việc

Jika claude --version menampilkan nomor versi, instalasi telah selesai; semua kesalahan berikutnya berkaitan dengan konfigurasi. claude doctor berguna ketika Anda tidak yakin letak kesalahannya, karena memeriksa instalasi dan file settings tanpa membuka sesi kerja apa pun.

Windows: lima kesalahan umum

  1. Salah menempelkan baris perintah. PowerShell yang menerima baris CMD akan menampilkan The token '&&' is not a valid statement separator; CMD yang menerima baris PowerShell akan menampilkan 'irm' is not recognized as an internal or external command. Perhatikan prompt: jika ada PS, gunakan baris irm; jika tidak ada, gunakan baris install.cmd.
  2. Salah membuka “Windows PowerShell (x86)”. Item ini di menu Start adalah proses 32-bit, sehingga bahkan pada mesin 64-bit akan menampilkan Claude Code does not support 32-bit Windows. Pilih item yang tidak memiliki tulisan (x86).
  3. Menjalankan dengan hak Administrator tidak diperlukan. Dokumentasi tidak memintanya, dan versi native diinstal ke folder pengguna: %USERPROFILE%\.local\bin\claude.exe.
  4. Mengetik claude menampilkan “not recognized”. Folder tersebut belum masuk ke PATH. Coba terminal baru terlebih dahulu; jika masih gagal, gunakan potongan PowerShell di bawah untuk memeriksa dan menambahkan path. Di macOS/Linux, kesalahan yang setara adalah command not found: claude, dan program berada di ~/.local/bin/claude.
  5. npm menampilkan npm.ps1 cannot be loaded because running scripts is disabled on this system. Execution policy PowerShell memblokir script .ps1 yang dibuat npm. Dokumentasi menyediakan tiga solusi: izinkan pengguna saat ini menjalankan script lokal dengan perintah Set-ExecutionPolicy di bawah, panggil npm.cmd dan claude.cmd sebagai pengganti versi .ps1, atau tinggalkan npm dan gunakan perintah native.
PowerShell
# 1. Kiểm tra thư mục cài đặt đã có trong PATH chưa
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Không có kết quả nào? Thêm vào PATH của người dùng, rồi đóng và mở lại terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Trong terminal mới
claude --version
PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Native atau WSL? Jika proyek Anda berada di Windows, menjalankannya secara native sudah cukup. Dalam hal itu, Git for Windows bersifat opsional: jika terpasang, Claude Code menjalankan perintah melalui Git Bash; jika tidak, Claude Code menggunakan PowerShell. Jika Git sudah terpasang, tetapi Claude Code tidak menemukan Git Bash, tetapkan CLAUDE_CODE_GIT_BASH_PATH dalam blok env di ~/.claude/settings.json, dengan jalur ke bash.exe (dokumentasi memberikan contoh C:\Program Files\Git\bin\bash.exe). Pilih WSL 2 jika Anda memerlukan alat Linux atau ingin perintah berjalan di sandbox, karena sandbox hanya tersedia di WSL 2; Windows native dan WSL 1 tidak menyediakannya. WSL 1 hanya menjadi pilihan jika komputer Anda tidak dapat mengaktifkan WSL 2. Jika memilih WSL, instal dengan perintah install.sh dan jalankan claude sepenuhnya di terminal WSL.

Instalasi melalui npm: persyaratan dan tiga catatan

npm cocok jika Anda sudah mengelola alat baris perintah dengan Node, atau jika jaringan perusahaan hanya mengizinkan pengunduhan paket melalui registry npm. Syaratnya adalah Node.js 22 atau yang lebih baru; angka Node 18 yang tercantum dalam banyak artikel lama sudah tidak berlaku. Perlu diketahui bahwa Node versi lebih lama tidak menggagalkan instalasi: npm hanya menampilkan peringatan EBADENGINE, karena program yang sebenarnya dijalankan adalah program native yang diunduh oleh paket npm dan tidak bergantung pada Node. Jika Node belum terpasang di komputer, unduh versi 22+ dari nodejs.org.

Terminal
node -v                                    # cần v22 trở lên
npm install -g @anthropic-ai/claude-code   # không dùng sudo

# nâng cấp bằng @latest, không dùng npm update -g
npm install -g @anthropic-ai/claude-code@latest
  • Jangan gunakan sudo npm install -g: dokumentasi memperingatkan bahwa metode ini menyebabkan masalah izin dan merupakan risiko keamanan.
  • Perbarui ke versi baru dengan npm install -g @anthropic-ai/claude-code@latest; npm update -g bukan metode yang dianjurkan.
  • Program native berasal dari dependency opsional (paket @anthropic-ai/claude-code-* yang sesuai dengan platform Anda). Flag --omit=optional, baris optional=false di .npmrc, atau --ignore-scripts akan membuatnya tidak terpasang, dan di macOS/Linux Anda akan menerima claude native binary not installed.

Apakah VPN diperlukan? Kesalahan saat mengunduh script instalasi

Tidak perlu. Việt Nam tercantum dalam daftar negara yang didukung Anthropic untuk Claude.ai maupun API (diperiksa pada 3 Oktober 2026). VPN justru sering menimbulkan masalah: menurut halaman pemecahan masalah instalasi (dibaca pada 3 Oktober 2026), saat alamat instalasi mengembalikan App unavailable in region, Claude Code tidak tersedia di lokasi tempat koneksi Anda terdeteksi. Jika Anda berada di Việt Nam dan melihat pesan ini, nonaktifkan VPN atau proksi yang berlokasi di negara lain, lalu jalankan kembali.

Dua kesalahan lainnya memiliki akar yang sama: syntax error near unexpected token '<' atau curl: (22) The requested URL returned error: 403 berarti Anda menerima halaman HTML atau kode kesalahan, bukan script. Jaringan perusahaan dengan proxy atau firewall yang memblokir pengunduhan file adalah tersangka pertama. Jangan buru-buru beralih ke Homebrew, WinGet, atau npm: dokumentasi menyarankan untuk memeriksa koneksi jaringan terlebih dahulu, karena metode instalasi alternatif juga mengunduh dari server yang sama. Coba jaringan lain atau minta departemen IT membuka blokirnya.

Konfigurasi API key: menjalankan Claude Code tanpa paket Pro/Max

Claude Code melakukan autentikasi dengan salah satu dari dua cara. Tabel di bawah memberikan perbandingan singkat; bagian selanjutnya mengikuti kolom kanan.

Login ke akun ClaudeAPI key Kunavo
PersyaratanPaket Pro, Max, Team, Enterprise, atau akun Console. Paket gratis Claude.ai tidak mencakup Claude Code.Satu key sk-kn-… yang ditetapkan dalam variabel lingkungan. Tidak perlu membeli paket atau login.
PenagihanHarga bulanan: Pro seharga 20 USD/bulan (17 USD/bulan jika membayar tahunan, atau 200 USD sekaligus), Max mulai dari 100 USD/bulan, belum termasuk pajak (claude.com/pricing, dibaca pada 3 Oktober 2026).Berdasarkan token yang benar-benar digunakan, dipotong dari saldo prabayar dari 10 USD. Tidak ada biaya bulanan, saldo tidak kedaluwarsa, dan request yang gagal tidak dikenai biaya.
Bayar denganPembelian melalui situs web Anthropic hanya dapat dibayar dengan kartu kredit atau debit (FAQ pembayaran Claude, dibaca pada 3 Oktober 2026).Kartu Visa, Mastercard, atau Link; Apple Pay atau Google Pay jika tersedia di perangkat. MoMo, ZaloPay, dan VNPay tidak tersedia.
Yang tidak tersedia—Remote Control dan input suara. Tidak tersedia faktur VAT.

Mengalihkan Claude Code ke layanan selain Anthropic bukanlah trik: dokumentasi resmi menjelaskan bahwa ANTHROPIC_BASE_URL adalah variabel untuk mengganti endpoint API saat melalui proxy atau gateway. Kunavo menggunakan protokol Anthropic Messages API yang sama, sehingga Anda menggunakan Claude Code asli tanpa plugin atau patch. Diperlukan tepat enam variabel:

VariabelNilaiFungsi dan kesalahan umum
ANTHROPIC_BASE_URLhttps://api.kunavo.comHanya nama domain. Claude Code otomatis menambahkan /v1/messages; jika Anda menambahkan /v1, request menjadi /v1/v1/messages dan menerima 404.
ANTHROPIC_AUTH_TOKENKunci sk-kn-…Dikirim dalam header Authorization: Bearer, langsung berlaku tanpa langkah konfirmasi.
ANTHROPIC_MODELclaude-sonnet-5Model utama (Claude Sonnet 5). Namanya harus sama persis dengan daftar Kunavo; nama lama dengan akhiran tanggal tidak dikonversi secara otomatis.
ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-5-5Kunci alias opus (dan opusplan saat berada dalam plan mode) ke Claude Opus 5.5, agar tidak mengikuti versi Opus terbaru. Memerlukan Claude Code v2.1.280 atau yang lebih baru; pada versi yang lebih lama jalankan claude update.
ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-5Alias sonnet secara default mengarah ke Sonnet 5.5, model yang tidak disediakan Kunavo. Jika tidak dikunci, /model sonnet, tahap eksekusi opusplan, dan subagent dengan model: sonnet semuanya menerima 404.
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5Alias haiku dan tugas latar belakang Claude Code menggunakan model ini. Jika tidak dipatok, alias ini meminta ID yang tidak disediakan Kunavo (Haiku 5.5 sejak v2.1.293), sehingga /model haiku dan subagen yang ditetapkan ke model: haiku menerima 404.

Tempat menetapkan variabel

Cara paling ringkas untuk penggunaan jangka panjang adalah blok env dalam file settings pengguna, ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). File ini berlaku untuk semua proyek; jika sudah berisi sesuatu, cukup tambahkan 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"
  }
}

Jika lebih suka menyimpannya di shell, tambahkan ke ~/.zshrc atau ~/.bashrc. Di Windows, potongan kedua di bawah (baris $env:) cocok untuk pengujian cepat, tetapi variabel akan hilang segera setelah jendela PowerShell ditutup.

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # chỉ tên miền, không thêm /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
PowerShell
# Chỉ có hiệu lực trong cửa sổ PowerShell này, đóng cửa sổ là mất
$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

Tiga hal yang perlu diketahui sebelum mengalami masalah:

  • Jangan simpan kunci API di .claude/settings.json proyek. Dokumentasi penghubungan gateway mengingatkan bahwa berkas ini akan di-commit dan dapat diakses oleh siapa pun yang mengkloning repositori.
  • File settings mengalahkan shell. Jika sebuah variabel ada di kedua tempat, nilai dalam blok env file settings yang digunakan. Jika perubahan di shell tidak terlihat, periksa file settings terlebih dahulu.
  • Eksekusi pertama memerlukan key pada tingkat pengguna. Dalam mode interaktif, blok env di .claude/settings.json atau .claude/settings.local.json proyek baru berlaku setelah wizard pertama dan pertanyaan apakah folder dipercaya selesai. Jika key hanya berada di sana, layar login tetap muncul saat startup pertama.

ANTHROPIC_AUTH_TOKEN atau ANTHROPIC_API_KEY, dan masalah “kesalahan 403”

Kunavo membaca kunci baik dari Authorization: Bearer maupun x-api-key, jadi kedua variabel dapat digunakan untuk terhubung. Perbedaannya ada di sisi Claude Code. Menurut dokumentasi variabel lingkungan (dibaca pada 3 Oktober 2026), ANTHROPIC_AUTH_TOKEN dikirim melalui header Authorization dengan awalan Bearer dan langsung berlaku. ANTHROPIC_API_KEY dikirim melalui header X-Api-Key, dan dalam mode interaktif Claude Code akan menanyakan satu kali apakah Anda ingin menggunakan kunci ini sebagai pengganti langganan. Jika Anda menjawab “tidak”, kunci akan diabaikan dan Claude Code tidak akan bertanya lagi; untuk mengaktifkannya kembali, buka /config lalu pilih Use custom API key. Artikel ini memilih ANTHROPIC_AUTH_TOKEN hanya agar langkah konfirmasi tersebut tidak diperlukan.

Beberapa panduan berbahasa Vietnam menyebut bahwa ANTHROPIC_API_KEY membuat Claude Code mengabaikan ANTHROPIC_BASE_URL, memanggil api.anthropic.com secara langsung, lalu menerima 403. Baik dokumentasi variabel lingkungan maupun dokumentasi koneksi gateway (dibaca pada 3 Oktober 2026) tidak menyatakan demikian: kedua variabel tersebut adalah dua cara untuk mengirimkan key ke gateway yang sama di ANTHROPIC_BASE_URL. Jika Anda benar-benar mengalami 403 setelah mengganti variabel, periksa kembali base URL dan key, alih-alih terus mengganti nama variabel.

Mengapa model perlu dikunci, dan berapa harga setiap model

Alias Claude Code tidak tetap. Menurut dokumentasi konfigurasi model (dibaca 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; dokumentasi juga menyebut alias “diperbarui dari waktu ke waktu” dan menyarankan penggunaan nama lengkap atau variabel ANTHROPIC_DEFAULT_*_MODEL jika perlu menguncinya. Per 3 Oktober 2026, Kunavo menyediakan Opus 5.5, tetapi tidak menyediakan Sonnet 5.5. Jika langkah penguncian dilewati: sesi default akan menjalankan Opus 5.5 yang lebih mahal Claude Sonnet 5; /model sonnet, tahap eksekusi opusplan dan subagen yang disetel ke model: sonnet akan mengembalikan 404; dan saat alias opus beralih ke versi Opus baru, versi tersebut belum tentu tersedia di Kunavo. Karena itu, konfigurasi di atas mengunci alias sonnet ke claude-sonnet-5 menggunakan ANTHROPIC_DEFAULT_SONNET_MODEL, dan mengunci alias opus ke Opus 5.5 (claude-opus-5-5). Opus 5.5 memerlukan Claude Code v2.1.280 atau yang lebih baru; untuk versi lebih lama, jalankan claude update.

Harga di Kunavo, dihitung per satu juta token (input / output): Claude Sonnet 5 1,40 USD / 7,00 USD (harga Anthropic: 2,00 USD / 10,00 USD); Claude Opus 5.5 2,80 USD / 14,00 USD; Claude Haiku 4.5 0,70 USD / 3,50 USD.

Periksa dengan /status

Setelah ANTHROPIC_AUTH_TOKEN terbaca, perintah claude langsung masuk ke sesi kerja, tanpa layar login (menurut dokumentasi koneksi gateway, dibaca pada 3 Oktober 2026); pertama kali tetap ada beberapa langkah pengaturan, seperti pertanyaan kepercayaan folder. Jika layar login muncul, key belum sampai ke tempat yang benar. Di dalam sesi, ketik /status dan cari:

  • Anthropic base URL: https://api.kunavo.com. Baris ini hanya muncul jika ada alamat gateway; jika tidak ada, berarti ANTHROPIC_BASE_URL tidak masuk ke sesi.
  • Auth token: ANTHROPIC_AUTH_TOKEN. Jika bagian tersebut berisi Login method bersama akun claude.ai, sesi masih menggunakan login yang tersimpan.

Untuk memastikan key dan alamat sudah benar sebelum membuka Claude Code, kirim request uji yang meminta tepat 1 token output (biayanya sangat kecil dari saldo). Perintah ini membaca variabel dari shell saat ini, jadi jika key hanya berada di file settings, jalankan export terlebih dahulu di terminal ini. Hasil yang diawali {"id":"msg_ berarti berhasil; 401 berarti key 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": "."}]}'

Versi PowerShell untuk pengujian yang sama; jika berhasil, field id dalam hasil diawali 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 hilang jika menggunakan API key

  • Remote Control dan input suara memerlukan identitas claude.ai, sehingga tidak berjalan saat ANTHROPIC_AUTH_TOKEN aktif. Remote Control juga dinonaktifkan ketika ANTHROPIC_BASE_URL mengarah ke server selain api.anthropic.com.
  • /fast menampilkan Fast mode has been disabled by your organization: menurut dokumentasi koneksi gateway, pemeriksaan fast mode memerlukan login claude.ai atau API key Anthropic, sehingga dengan bearer token Claude Code menganggapnya dinonaktifkan dan tidak menanyakan server.
  • MCP tool search secara default dinonaktifkan jika base URL bukan milik Anthropic.
  • Angka dalam /context merupakan perkiraan: Kunavo tidak memiliki endpoint /v1/messages/count_tokens, dan menurut dokumentasi protokol gateway (dibaca pada 3 Oktober 2026), jika endpoint ini tidak tersedia, Claude Code menghitung token berdasarkan jumlah karakter.

Detail integrasi tersedia dalam dokumentasi integrasi Claude Code (bahasa Inggris); artikel terkait dalam bahasa Inggris adalah Install Claude Code.

Mengisi saldo dari Vietnam: kartu atau Link, tanpa dompet elektronik lokal

Terus terang: Kunavo tidak menerima MoMo, ZaloPay, VNPay, atau transfer bank. Kartu ATM lokal yang hanya beroperasi di jaringan Napas juga tidak dapat digunakan karena bukan kartu Visa atau Mastercard. Halaman pembayaran Stripe Kunavo menyediakan pilihan berikut bagi pembeli di Vietnam:

  • Kartu Visa atau Mastercard, baik kartu kredit maupun debit internasional.
  • Link, dompet Stripe yang menyimpan metode pembayaran agar pembayaran berikutnya lebih cepat (dokumentasi Link, dibaca pada 3 Oktober 2026).
  • Apple Pay atau Google Pay, hanya muncul di perangkat dan browser yang dompetnya telah disiapkan, karena pembayaran dilakukan dengan kartu yang tersimpan di dompet. Apple Pay tersedia di Vietnam sejak 08/08/2023 dan dapat digunakan untuk pembelian online (Apple Newsroom Vietnam, dibaca pada 3 Oktober 2026).

Di pihak Anthropic juga demikian: paket Claude yang dibeli melalui web hanya menerima kartu kredit atau debit (FAQ pembayaran Claude, dibaca pada 3 Oktober 2026), sehingga dompet digital Vietnam tidak dapat digunakan untuk membayar langsung di sana; paket yang dibeli melalui aplikasi iOS atau Android menggunakan metode pembayaran App Store atau Google Play. Bedanya, dana yang ditambahkan ke Kunavo menjadi saldo API, dan Claude Code menguranginya berdasarkan token setelah Anda mengonfigurasi key seperti di atas.

Bayar dalam VND atau USD

Kunavo mencantumkan harga dalam USD. Karena Vietnam termasuk pasar yang didukung Stripe Adaptive Pricing (dibaca pada 3 Oktober 2026), halaman pembayaran dapat menampilkan jumlah yang dikonversi ke VND, dan jumlah pastinya selalu ditampilkan sebelum Anda mengeklik konfirmasi. Nilai tukar yang diberikan Stripe sudah mencakup biaya konversi sebesar 2–4% yang ditanggung pembeli. Jika memilih membayar dalam USD, biaya tersebut tidak dikenakan, tetapi bank penerbit kartu mungkin menerapkan nilai tukar dan biayanya sendiri.

Membayar dalam VND juga belum tentu lebih murah: beberapa bank mengenakan biaya saat kartu membayar dalam VND kepada penjual yang terdaftar di luar negeri. Misalnya, Techcombank mengenakan “biaya transaksi mata uang lokal di luar negeri” sebesar 1,1% dari jumlah transaksi (termasuk PPN) untuk kartu debit Visa, berlaku mulai 13/08/2023 (FAQ Techcombank, dibaca pada 3 Oktober 2026). Ini hanya contoh dari satu bank, dan Kunavo belum memverifikasi apakah bank menggolongkan transaksinya sebagai jenis ini; periksa daftar biaya kartu Anda sebelum memilih VND atau USD.

Kartu biasanya ditolak karena pembayaran online atau internasional belum diaktifkan di aplikasi bank. Aktifkan lalu coba lagi, atau beralih ke Link maupun Apple Pay/Google Pay dengan kartu yang didukung dompet tersebut.

Dari pendaftaran hingga mendapatkan key

  1. Daftar ke Kunavo menggunakan email atau akun Google; langkah ini tidak meminta kartu.
  2. Buka Billing, lalu pilih jumlah top-up (minimum 10 USD). Jumlah yang lebih besar memiliki tambahan: isi ulang 100 USD, saldo menjadi 110 USD; isi ulang 1.000 USD, saldo menjadi 1.200 USD; isi ulang 5.000 USD, saldo menjadi 6.250 USD.
  3. Di halaman Stripe, pilih kartu, Link, atau dompet yang tersedia di perangkat, tinjau jumlahnya, lalu konfirmasi.
  4. Buka API Keys, lalu buat key sk-kn-…. Key hanya ditampilkan sekali, jadi segera salin ke ANTHROPIC_AUTH_TOKEN.

Untuk mengisi saldo otomatis saat saldo menurun, Anda harus menggunakan kartu tersimpan atau Link. Saldo tidak memiliki masa berlaku, dan request yang gagal tidak dikenai biaya. Kunavo tidak menerbitkan faktur VAT, termasuk faktur elektronik sesuai peraturan Vietnam; riwayat top-up dapat dilihat di Billing. Saldo ini hanya dapat digunakan untuk API Kunavo, bukan untuk membayar Claude Pro, Claude Max, atau ChatGPT Plus.

Berapa biaya kira-kira untuk satu sesi coding?

Pada setiap giliran, Claude Code mengirimkan kembali seluruh konteks percakapan, sehingga biaya sangat bergantung pada cache: bagian konteks yang berulang dikenai harga pembacaan cache yang jauh lebih murah. Tabel berikut adalah perhitungan teoretis dengan asumsi yang dinyatakan, bukan pengukuran aktual dan bukan batas maksimum:

  • per permintaan, 40.000 token input: 36.000 token (90%) dibaca dari cache, 4.000 token ditulis ke cache;
  • setiap request 1.000 token output;
  • satu sesi dengan 50 request, belum termasuk giliran Claude Haiku 4.5 yang berjalan di latar belakang;
  • dengan Claude Sonnet 5 di Kunavo, pembacaan cache menggunakan 10% harga input dan penulisan cache menggunakan 1,25 kali harga input; setiap model dalam tabel menggunakan tarifnya sendiri.
ModelSatu request50 permintaan50 request, tanpa cache yang cocok sama sekali
Claude Sonnet 50,019 USD0,95 USD3,15 USD
Claude Opus 5.50,033 USD1,65 USD6,30 USD

Kolom terakhir menunjukkan betapa pentingnya cache. Konteks yang panjang, jawaban yang panjang, atau lupa menggunakan /clear di antara dua tugas berbeda semuanya meningkatkan angka. Perbandingan paket langganan dengan API dan estimasi bulanan tersedia dalam artikel Berapa harga Claude Code; harga setiap model dapat dilihat di tabel harga Claude API atau halaman harga; untuk memasukkan angka Anda sendiri, gunakan kalkulator biaya token Claude (bahasa Inggris).

Telusuri kesalahan berdasarkan pesannya

KapanYang terlihatPenanganan
InstalasiThe token '&&' is not a valid statement separatorAnda sedang berada di PowerShell tetapi menempelkan baris CMD. Gunakan irm … | iex.
Instalasi'irm' is not recognized as an internal or external commandAnda sedang berada di CMD tetapi menempelkan baris PowerShell. Gunakan baris install.cmd.
Instalasisyntax error near unexpected token '<', 403, App unavailable in regionMenerima halaman HTML, bukan script. Nonaktifkan VPN/proxy yang mengarah ke negara lain, lalu coba jaringan lain sebelum mengganti metode instalasi (metode lain mengunduh dari server yang sama).
InstalasiClaude Code does not support 32-bit WindowsPowerShell (x86) sedang terbuka. Buka “Windows PowerShell” biasa.
Instalasi (npm)Peringatan EBADENGINENode.js di bawah 22. Instalasi tetap selesai, tetapi sebaiknya perbarui Node.
Instalasi (npm)claude native binary not installedDependency opsional tidak ada karena --omit=optional, optional=false, atau --ignore-scripts. Hapus pengaturan tersebut lalu instal ulang.
Instalasi (npm)npm.ps1 cannot be loadedExecution policy memblokir script. Jalankan Set-ExecutionPolicy di atas, gunakan npm.cmd, atau beralih ke perintah native.
Setelah instalasicommand not found: claude, 'claude' is not recognizedFolder instalasi belum ada di PATH. Buka terminal baru; di Windows, jalankan potongan PowerShell untuk menambahkan PATH.
KonfigurasiLayar login tetap munculKey belum terbaca. Tetapkan di shell atau ~/.claude/settings.json pengguna, bukan hanya dalam konfigurasi proyek; buka terminal baru.
Konfigurasi401Key ditolak: penyalinan kurang atau berlebih, key telah dihapus di /app/keys, atau key berada di variabel yang salah.
Konfigurasi404Base URL memiliki /v1 yang tidak semestinya, atau model tidak tersedia di Kunavo (biasanya alias sonnet belum dikunci dan masih mengarah ke Sonnet 5.5).
Mengisi saldoKartu ditolakAktifkan pembayaran online dan internasional di aplikasi bank; kartu yang hanya mendukung Napas tidak dapat digunakan. Atau coba Link, Apple Pay, atau Google Pay.

Sebelum mengisi saldo

  • Hanya kartu Visa/Mastercard, Link, dan dompet yang berjalan di atas kartu; tidak ada MoMo, ZaloPay, VNPay, atau transfer.
  • Top-up otomatis hanya berfungsi dengan kartu tersimpan atau Link. Kunavo tidak menerbitkan faktur VAT.
  • Ini adalah API berbasis pembayaran per token, bukan paket Claude Pro/Max: Remote Control dan input suara tidak tersedia, /fast menunjukkan bahwa fitur tersebut dinonaktifkan, dan MCP tool search secara default dinonaktifkan.
  • Per 3 Oktober 2026, Kunavo tidak menyediakan Sonnet 5.5, sehingga alias sonnet yang belum dikunci akan menghasilkan 404.
  • Dokumentasi Claude Code dan dokumentasi integrasi Kunavo saat ini hanya tersedia dalam bahasa Inggris.

Pertanyaan umum

Apakah Claude Code gratis? Apa arti “Claude Code tidak memerlukan paket”?

Mengunduh dan menginstal Claude Code tidak dikenai biaya, tetapi agar dapat merespons, Anda memerlukan salah satu dari dua hal: login dengan paket berbayar Claude (Pro, Max, Team, Enterprise) atau akun Console, atau menggunakan kunci API. Paket gratis Claude.ai tidak menyertakan Claude Code. “Tidak memerlukan paket” adalah cara kedua: tetapkan ANTHROPIC_BASE_URL=https://api.kunavo.com dan ANTHROPIC_AUTH_TOKEN, lalu Claude Code melewati login dan memotong biaya berdasarkan token yang benar-benar digunakan dari saldo prabayar Kunavo, minimum 10 USD, tanpa biaya bulanan.

Apa perintah untuk menginstal Claude Code di Windows? Apakah perlu menginstal WSL atau menjalankannya dengan hak Administrator?

Buka PowerShell (prompt diawali huruf PS) dan jalankan irm https://claude.ai/install.ps1 | iex; jika berada di CMD, gunakan curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Hak Administrator tidak diperlukan, dan WSL atau Git juga tidak wajib. Jika Git for Windows tersedia, Claude Code menjalankan perintah melalui Git Bash; jika tidak, melalui PowerShell. WSL 2 hanya layak diinstal jika Anda memerlukan alat Linux atau ingin perintah berjalan di dalam sandbox. Ingat untuk membuka “Windows PowerShell”, bukan entri yang memuat (x86), karena Claude Code tidak berjalan di Windows 32-bit.

Versi Node.js apa yang diperlukan untuk menginstal Claude Code dengan npm?

Node.js 22 atau yang lebih baru, menurut dokumentasi instalasi resmi yang dibaca pada 3 Oktober 2026. Banyak artikel lama masih mencantumkan Node 18, tetapi angka tersebut sudah tidak berlaku. Node yang lebih lama hanya membuat npm menampilkan peringatan EBADENGINE; instalasi tetap selesai karena paket npm sebenarnya mengunduh program native yang tidak memerlukan Node. Perintah instalasinya adalah npm install -g @anthropic-ai/claude-code (tanpa sudo); untuk memperbarui ke versi terbaru, jalankan ulang dengan @latest, bukan npm update -g. Jika tidak ada alasan khusus untuk menggunakan npm, perintah native lebih ringkas.

Di mana memasukkan kunci API untuk Claude Code? Apakah ANTHROPIC_BASE_URL harus ditambah /v1?

Tempat yang paling tahan lama adalah blok env dalam file ~/.claude/settings.json milik pengguna (Windows: %USERPROFILE%\.claude\settings.json), yang berlaku untuk semua proyek; Anda juga dapat mengekspornya di ~/.zshrc, ~/.bashrc, atau $PROFILE PowerShell. Base URL hanya https://api.kunavo.com, tanpa /v1, karena Claude Code otomatis menambahkan /v1/messages; /v1 tambahan akan menjadi /v1/v1/messages dan menghasilkan 404. Jangan menaruh kunci di .claude/settings.json proyek: file tersebut berada di repositori dan ikut terbawa setiap kali clone.

Ada artikel yang mengatakan penggunaan ANTHROPIC_API_KEY akan menghasilkan 403. Benarkah?

Tidak benar menurut dokumentasi resmi. Baik ANTHROPIC_API_KEY maupun ANTHROPIC_AUTH_TOKEN dikirim ke alamat dalam ANTHROPIC_BASE_URL; perbedaannya ada pada header (X-Api-Key dibandingkan dengan Authorization: Bearer) dan pada fakta bahwa ANTHROPIC_API_KEY harus Anda setujui sekali dalam mode interaktif. Kunavo membaca kunci dari kedua header. Panduan ini merekomendasikan ANTHROPIC_AUTH_TOKEN hanya karena dapat langsung digunakan. Jika Anda tidak sengaja menolak pada pertanyaan tersebut, kunci diabaikan tanpa ditanyakan lagi; buka /config, pilih Use custom API key untuk mengaktifkannya kembali.

Model apa yang dijalankan Claude Code jika ANTHROPIC_MODEL tidak ditetapkan?

Claude Code berjalan berdasarkan alias, dan alias berubah seiring waktu. Dokumentasi konfigurasi model (dibaca 3 Oktober 2026) menyatakan bahwa bagi pengguna API, default dan alias opus saat ini adalah Opus 5.5, sedangkan alias sonnet adalah Sonnet 5.5. Kunavo memiliki Opus 5.5 tetapi tidak memiliki Sonnet 5.5, sehingga sesi yang tidak dikunci akan menjalankan Opus 5.5 dengan harga lebih tinggi Claude Sonnet 5, sementara /model sonnet, tahap eksekusi opusplan, dan subagent dengan model: sonnet semuanya mengembalikan 404. Dengan menetapkan ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5, dan ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5, Anda dapat memastikan model mana yang ditagihkan pada setiap giliran. Menetapkan alias opus ke Opus 5.5 memerlukan Claude Code v2.1.280 atau yang lebih baru; pada versi yang lebih lama, jalankan claude update.

Apa yang ditampilkan oleh /status berarti sudah berjalan dengan API key?

Dua baris: “Anthropic base URL” adalah https://api.kunavo.com, dan “Auth token” berisi ANTHROPIC_AUTH_TOKEN. Jika yang muncul adalah “Login method” dengan akun claude.ai, sesi masih menggunakan login lama; keluar, buka terminal baru, lalu periksa kembali di mana variabel tersebut ditetapkan. Anda dapat menguji key sebelum membuka Claude Code dengan perintah curl yang mengirim ke /v1/messages dengan max_tokens sebesar 1: JSON yang diawali {"id":"msg_ berarti berhasil, sedangkan 401 berarti key ditolak.

Apakah di Vietnam diperlukan VPN untuk menginstal atau menggunakan Claude Code?

Tidak perlu. Vietnam tercantum dalam daftar negara yang didukung Anthropic untuk Claude.ai dan API (diperiksa 3 Oktober 2026). Sebaliknya, jika VPN mengarahkan koneksi ke negara yang tidak didukung, alamat instalasi dapat mengembalikan halaman “App unavailable in region” alih-alih script. Jika mengalami kesalahan tersebut saat berada di Vietnam, nonaktifkan VPN atau proxy lalu jalankan kembali perintah instalasi.

Apakah pembayaran melalui MoMo, ZaloPay, atau VNPay tersedia? Apakah tersedia faktur VAT?

Keduanya tidak tersedia. Halaman pembayaran Stripe Kunavo memungkinkan pembeli di Vietnam memilih Visa, Mastercard, atau Link, serta Apple Pay atau Google Pay jika perangkat telah menyiapkannya; MoMo, ZaloPay, VNPay, dan transfer bank tidak tersedia. Jumlah dapat ditampilkan dalam VND; dalam hal ini, nilai tukar Stripe sudah mencakup biaya konversi 2–4% yang ditanggung pembeli. Jika memilih membayar dalam USD, biaya tersebut tidak ada, tetapi bank Anda dapat menerapkan nilai tukar dan biaya tersendiri. Top-up minimum 10 USD, saldo tidak kedaluwarsa, dan top-up otomatis hanya berfungsi dengan kartu tersimpan atau Link. Kunavo tidak menerbitkan faktur VAT, termasuk faktur elektronik.