Untuk menginstal Claude Code, cukup satu perintah yang berbeda sesuai terminal: baris dengan install.sh di macOS, Linux, dan WSL, irm … | iex di PowerShell, serta baris dengan install.cmd di Command Prompt. Ini adalah metode yang direkomendasikan Anthropic; npm tetap bisa digunakan, tetapi memerlukan Node.js 22 atau yang lebih baru. Paket gratis Claude tidak mencakup Claude Code, jadi Anda memerlukan langganan Pro atau yang lebih tinggi, atau kunci API. Di sini Anda mengikuti cara kedua: ANTHROPIC_BASE_URL=https://api.kunavo.com (tanpa /v1), kunci di ANTHROPIC_AUTH_TOKEN, empat variabel yang menetapkan model, dan /status untuk verifikasi akhir. Kredit dapat diisi ulang dengan Satispay dalam euro mulai dari $10, dan Anda hanya membayar token yang digunakan.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows – Prompt dei comandi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdAsal perintah ini: dokumentasi Claude Code juga tersedia dalam bahasa Italia dan telah kami baca ulang pada 3 Oktober 2026, khususnya halaman tentang instalasi dan gateway LLM. Harga dan metode pembayaran Kunavo diperbarui pada 10 Oktober 2026. Anthropic menyediakan layanan untuk Italia, baik melalui Claude.ai maupun API (negara yang didukung, dibaca pada 3 Oktober 2026).
Yang diperlukan
Persyaratan dalam dokumentasi resmi (dibaca pada 3 Oktober 2026) tidak tinggi:
- 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+, atau Alpine Linux 3.19+.
- Setidaknya 4 GB RAM dan prosesor x64 atau ARM64. Windows 32-bit tidak didukung.
- Salah satu shell berikut: Bash, Zsh, PowerShell, atau CMD.
- Koneksi dari negara yang didukung Anthropic: Italia termasuk di dalamnya.
- Node.js hanya jika Anda memilih npm, dan dalam hal itu minimal versi 22.
Perintah yang mana, di terminal mana
| Tempat menjalankannya | Cara mengenalinya | Baris untuk ditempel |
|---|---|---|
| macOS, Linux, WSL | Terminal, iTerm, atau shell WSL | curl … install.sh | bash |
| Windows PowerShell | Prompt dimulai dengan PS C:\Users\nome> | irm … install.ps1 | iex |
| Windows, Command Prompt | Prompt hanya berupa C:\Users\nome>, tanpa PS | Baris dengan install.cmd |
Hak administrator tidak diperlukan dan WSL juga tidak diperlukan: dokumentasi resmi menyatakannya secara eksplisit, meskipun banyak panduan menyarankan sebaliknya. Setelah terinstal, Claude Code memperbarui dirinya sendiri di latar belakang. Jika Anda lebih menyukai pengelola paket, Anda dapat menggunakan Homebrew atau WinGet, dengan catatan bahwa dalam hal itu Anda harus menjalankan pembaruannya sendiri:
# Homebrew – canale stable; non si aggiorna da solo
brew install --cask claude-code
# WinGet (Windows) – non si aggiorna da solo
winget install Anthropic.ClaudeCodeSebelum mencoba, tutup terminal dan buka terminal baru: hanya jendela baru yang membaca ulang PATH. Kemudian lakukan verifikasi. claude doctor juga akan berguna nanti karena memeriksa instalasi dan pengaturan tanpa membuka sesi, lalu segera memberi tahu apakah masalahnya ada pada salah satunya.
claude --version # stampa la versione, ad esempio 2.1.284 (Claude Code)
claude doctor # diagnostica di installazione e impostazioni, senza aprire una sessioneUnduhan diblokir: 403 atau halaman HTML, bukan skrip
Saat skrip tidak dapat diunduh, terminal tidak menjelaskannya dengan terang: bash menampilkan syntax error near unexpected token '<' (karena mencoba menjalankan halaman web), atau curl berhenti dengan curl: (22) The requested URL returned error: 403. Halaman resmi tentang masalah instalasi (dalam bahasa Inggris, dibaca pada 3 Oktober 2026) membedakan dua kasus. Jika halaman yang diunduh menampilkan App unavailable in region, server mengira Anda terhubung dari negara yang dikecualikan: dari Italia, hal ini hampir selalu terjadi karena VPN atau proxy yang terhubung melalui negara lain. Respons 403 tanpa teks lebih sering disebabkan oleh proxy perusahaan atau firewall. Mengganti metode instalasi tidak membantu karena Homebrew dan WinGet mengunduh dari server yang sama: coba gunakan jaringan lain atau minta tim TI membuka akses ke domain tersebut.
Dengan npm: Node.js 22, bukan 18
Jika Anda menggunakan Node.js setiap hari, npm tampaknya pilihan yang wajar. Cara ini berfungsi dan termasuk metode yang didokumentasikan, dengan satu syarat yang belum diperbarui di banyak panduan berbahasa Italia: diperlukan Node.js 22 atau yang lebih baru. Dengan Node versi lama, Anda akan melihat peringatan EBADENGINE, tetapi instalasi tetap selesai dan claude tetap berjalan (dokumentasi resmi, dibaca pada 3 Oktober 2026). Versi Node terbaru tersedia di nodejs.org.
node -v # serve v22 o successiva
npm install -g @anthropic-ai/claude-code # senza sudo
# aggiornamento: @latest, non npm update -g
npm install -g @anthropic-ai/claude-code@latestTiga kebiasaan yang harus dihindari:
sudodi depannpm install -g. Dokumentasi tidak menyarankannya, baik karena izin yang saling bertabrakan maupun alasan keamanan.npm update -guntuk memperbarui. Sebagai gantinya, ulangi instalasi dengan@latest, seperti pada baris terakhir di atas.- Melewati dependensi opsional. Biner Claude Code disertakan sebagai dependensi opsional, yaitu satu paket
@anthropic-ai/claude-code-*untuk setiap platform. Dengan--omit=optional, atau denganoptional=falsedi file.npmrc, paket itu tidak diunduh dan di macOS atau Linuxclaudemenampilkanclaude native binary not installed(masalah instalasi, dalam bahasa Inggris, dibaca pada 3 Oktober 2026).
Claude Code di Windows: titik-titik yang sering bermasalah
Di Windows, Claude Code berjalan secara native, dan instalasinya sendiri adalah bagian yang mudah. Masalah muncul dari lingkungan. Yang pertama adalah terminal: jika Anda menempelkan baris untuk CMD ke PowerShell, PowerShell akan memprotes &&; jika Anda menempelkan baris untuk PowerShell ke CMD, CMD tidak mengenali irm; dan baris curl … | bash untuk Mac sama sekali tidak berfungsi di PowerShell. Pada Windows berbahasa Italia, sebagian pesan ini mungkin ditampilkan dalam terjemahan. Apa pun itu, solusinya adalah kembali ke tabel di atas dan menggunakan baris untuk terminal yang sedang Anda gunakan (pesan dalam bahasa Inggris ada di tabel kesalahan di bagian akhir; sumber: dokumentasi, dibaca pada 3 Oktober 2026).
Perhatikan juga menu Start: “Windows PowerShell (x86)” membuka proses 32-bit dan Claude Code berhenti dengan Claude Code does not support 32-bit Windows, meskipun PC Anda 64-bit. Pilih entri tanpa (x86).
Git for Windows tidak wajib. Jika terpasang, Claude Code menjalankan perintah melalui Git Bash; jika tidak, Claude Code menggunakan PowerShell. Jika Git terpasang tetapi Claude Code tidak menemukan bash.exe, tentukan jalurnya dengan CLAUDE_CODE_GIT_BASH_PATH di blok env pada ~/.claude/settings.json, biasanya C:\Program Files\Git\bin\bash.exe. Bagaimana dengan WSL? WSL hanya diperlukan dalam satu kasus tertentu:
| Tempat Claude Code berjalan | Prasyarat | Sandbox perintah | Cocok jika… |
|---|---|---|---|
| Windows native | Tidak ada (Git for Windows opsional) | Tidak | proyek dan alat-alatnya berada di Windows |
| WSL 2 | WSL 2 terinstal | Ya | Anda bekerja dengan alat Linux atau ingin mengisolasi perintah |
| WSL 1 | WSL 1 terinstal | Tidak | WSL 2 tidak tersedia di mesin Anda |
Dengan WSL, semuanya berlangsung di dalam Linux: baris install.sh harus dijalankan di shell WSL, lalu dari sana jalankan claude.
“claude” tidak ditemukan
Jika setelah instalasi terminal merespons command not found: claude atau 'claude' is not recognized, programnya ada tetapi foldernya tidak berada di PATH. Installer native menyalinnya ke ~/.local/bin/claude di macOS dan Linux, serta ke %USERPROFILE%\.local\bin\claude.exe di Windows. Percobaan pertama: buka terminal baru. Jika di Windows belum cukup, berikut perintah PowerShell dari dokumentasi untuk memeriksa dan menambahkan folder tersebut ke PATH pengguna:
# 1. Controlla se la cartella di installazione è già nel PATH
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Nessun risultato? Aggiungila al PATH utente, poi chiudi e riapri il terminale
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Nel nuovo terminale
claude --versionnpm.ps1 cannot be loaded di PowerShell
Ini hanya berlaku bagi yang menginstal dengan npm: execution policy PowerShell memblokir skrip .ps1 yang dibuat npm, dan pesan lengkapnya memuat running scripts is disabled on this system. Dokumentasi menyebutkan tiga solusi: izinkan pengguna saat ini menjalankan skrip lokal dengan perintah di bawah, jalankan npm.cmd dan claude.cmd sebagai pengganti skrip PowerShell, atau tinggalkan npm dan gunakan installer native.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserTanpa langganan: akun Claude atau kunci API
Terpasang bukan berarti siap digunakan: saat pertama kali dijalankan, Claude Code meminta Anda untuk masuk, dan paket gratis Claude.ai tidak cukup (dokumentasi, dibaca pada 3 Oktober 2026). Berikut perbandingan kedua opsi:
| Langganan Claude | Kunci API Kunavo | |
|---|---|---|
| Persyaratan | Paket Pro, Max, Team, atau Enterprise, atau akun Console, lalu login | Kunci sk-kn-… dalam variabel lingkungan, tanpa login |
| Biaya | Pro seharga $20 per bulan, atau $17 per bulan dengan pembayaran tahunan ($200 di muka); Max mulai dari $100 per bulan; belum termasuk pajak (harga Claude, dibaca pada 3 Oktober 2026) | Bayar sesuai pemakaian, per token, dari kredit prabayar: isi ulang mulai $10, tanpa biaya bulanan, tanpa kedaluwarsa |
| Pembayaran dengan | Di web, hanya kartu kredit atau debit yang diterima (bantuan Anthropic); PayPal tidak diterima (bantuan Anthropic), keduanya dibaca pada 3 Oktober 2026 | Satispay di checkout dalam euro, kartu Visa dan Mastercard, Apple Pay, Google Pay, Link |
| Yang tidak tersedia | — | Remote Control dan dikte suara; tidak ada faktur |
Kunci Console Anthropic juga tersedia, dengan skema bayar sesuai pemakaian. Namun, kredit prabayar di sana kedaluwarsa setelah satu tahun dan tidak dapat dikembalikan (bantuan Anthropic, dibaca pada 3 Oktober 2026); pembayaran dilakukan dengan kartu, sedangkan transfer ACH hanya tersedia untuk akun API dengan penagihan bulanan (bantuan Anthropic). Kredit Kunavo tidak kedaluwarsa.
Mengonfigurasi kunci API: enam variabel
Claude Code mengirim permintaan ke endpoint yang berbeda dari milik Anthropic adalah hal yang memang didukung: dokumentasi resmi memiliki halaman, yang juga diterjemahkan ke bahasa Italia, tentang cara menghubungkannya ke gateway LLM. Tidak perlu plugin atau versi modifikasi. Cukup gunakan variabel berikut:
| Variabel | Nilai | Kegunaan |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | Alamat layanan. Hanya domain: Claude Code menambahkan /v1/messages, dan dengan /v1 di akhir, permintaan akan berakhir di /v1/v1/messages, yaitu 404. |
ANTHROPIC_AUTH_TOKEN | kunci sk-kn-… Anda | Dikirim sebagai Authorization: Bearer dan langsung berlaku, tanpa konfirmasi. |
ANTHROPIC_MODEL | claude-sonnet-5 | Model utama, di sini Claude Sonnet 5. Nama harus ditulis persis seperti dalam daftar Kunavo: versi lama dengan tanggal di bagian akhir tidak dikenali. |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 | Model di balik alias opus dan di balik opusplan dalam Plan Mode, di sini Claude Opus 5.5. Memerlukan Claude Code 2.1.280 atau yang lebih baru: jika versi Anda lebih lama, jalankan claude update. |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 | Model di balik alias sonnet, di balik opusplan di luar Plan Mode, dan di balik subagent dengan model: sonnet. Tanpa baris ini, alias tersebut meminta Sonnet 5.5, yang tidak ditawarkan Kunavo. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | Model di balik alias haiku dan di balik fungsi yang dijalankan Claude Code sendiri di latar belakang. Tanpa baris ini, alias meminta ID yang tidak disediakan Kunavo (Haiku 5.5 sejak v2.1.293): /model haiku dan subagen dengan model: haiku menerima 404. |
Di macOS dan Linux, tambahkan di bagian akhir ~/.zshrc atau ~/.bashrc:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # solo il dominio, senza /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, untuk pengujian cepat yang berlaku selama jendela PowerShell terbuka:
# Vale solo in questa finestra di PowerShell: chiusa la finestra, sparisce
$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"
claudeAgar tidak perlu mengaturnya ulang setiap kali, tempat yang tepat adalah blok env dalam ~/.claude/settings.json (di Windows %USERPROFILE%\.claude\settings.json): berlaku untuk semua proyek Anda. Jika file sudah berisi pengaturan lain, tambahkan hanya 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"
}
}AUTH_TOKEN atau API_KEY?
Kunavo membaca kunci dari kedua header, Authorization: Bearer dan x-api-key, jadi secara teori kedua variabel dapat digunakan. Perbedaannya ditentukan oleh Claude Code. Dengan ANTHROPIC_API_KEY, yang dikirim sebagai x-api-key, sesi interaktif akan sekali meminta persetujuan Anda untuk menggunakan kunci tersebut; jika Anda menjawab tidak, kunci itu akan diabaikan tanpa pemberitahuan hingga Anda mengaktifkannya kembali melalui /config → Use custom API key. ANTHROPIC_AUTH_TOKEN tidak meminta konfirmasi, dan variabel inilah yang disarankan oleh dokumentasi gateway (dibaca pada 3 Oktober 2026) jika Anda tidak tahu harus memilih yang mana.
Mengapa model perlu ditetapkan
Tanpa variabel, Claude Code menggunakan alias, dan alias mengikuti rilis Anthropic. Saat ini, menurut dokumentasi konfigurasi model (dibaca pada 3 Oktober 2026), bagi pengguna API, opus mengarah ke Opus 5.5 dan sonnet ke Sonnet 5.5. Pada 3 Oktober 2026, Kunavo belum menyediakan Sonnet 5.5: tanpa ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, tahap eksekusi opusplan dan subagen dengan model: sonnet akan meminta model yang tidak tersedia di Kunavo dan menghasilkan 404. Dengan claude-sonnet-5 pada variabel tersebut, alias mengarah ke Claude Sonnet 5, model yang sama dengan ANTHROPIC_MODEL. Sementara itu, variabel terakhir menentukan model sesi: tanpanya, Claude Code akan menggunakan model default-nya, yang saat ini adalah Opus 5.5. Opus 5.5 tersedia, dan menetapkan opus ke claude-opus-5-5 berguna untuk hal lain: mencegah model dan tarif berubah dari hari ke hari saat alias beralih ke Opus berikutnya. Claude Opus 5.5 memerlukan Claude Code 2.1.280 atau versi lebih baru; jika menggunakan versi yang lebih lama, jalankan claude update terlebih dahulu.
Tarif Kunavo untuk tiga model dalam konfigurasi, per juta token (input / output): Claude Sonnet 5 $1,40 / $7,00 (daftar harga Anthropic: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; Claude Haiku 4.5 $0,70 / $3,50, yang juga bekerja di balik layar.
Tempat untuk tidak menaruhnya, dan pengaturan mana yang berlaku
File .claude/settings.json di dalam proyek akan dikomit: kunci yang ditulis di sana akan masuk ke repositori dan diteruskan kepada siapa pun yang mengkloningnya (dokumentasi gateway). Jika suatu variabel tercantum baik di shell maupun di blok env dalam file pengaturan, file tersebut yang berlaku: jika perubahan pada ~/.zshrc tampaknya diabaikan, biasanya penyebabnya ada di sana. Namun, kolom model pada file pengaturan mengalah kepada ANTHROPIC_MODEL. Di ekstensi Claude Code untuk VS Code, variabel yang sama dimasukkan ke claudeCode.environmentVariables, di pengaturan pengguna VS Code. Aplikasi desktop Claude tidak termasuk dalam semua ini: aplikasi tersebut tidak membaca ANTHROPIC_BASE_URL maupun settings.json (dokumentasi gateway, dibaca pada 3 Oktober 2026).
Memulai dan memeriksa dengan /status
Jika kunci sudah tersedia, claude akan dimulai tanpa layar masuk: yang tersisa hanya konfigurasi awal dan pertanyaan apakah Anda memercayai folder tersebut. Jika layar masuk muncul, Claude Code tidak menemukan kuncinya. Kasus yang umum adalah kunci hanya ditulis di .claude/settings.json atau .claude/settings.local.json milik proyek: dalam mode interaktif, blok env tersebut baru berlaku setelah konfigurasi awal dan konfirmasi kepercayaan (dokumentasi gateway, dibaca pada 3 Oktober 2026), jadi blok itu belum ada saat pertama kali dijalankan. Pindahkan kunci ke shell atau file pengguna. Login Pro atau Max lama tidak mengganggu, karena variabel tersebut lebih diprioritaskan daripada akses yang tersimpan; jika ingin menghapusnya, gunakan /logout.
Di dalam sesi, ketik /status. Ada dua baris penting:
Anthropic base URL, yang hanya muncul ketika gateway dikonfigurasi: harus tertulishttps://api.kunavo.com. Jika tidak ada,ANTHROPIC_BASE_URLbelum masuk ke sesi.Auth tokendengan namaANTHROPIC_AUTH_TOKEN: Anda menggunakan kunci tersebut. Jika yang muncul adalahLogin methoddengan akun claude.ai, variabelnya diabaikan.
Ingin memeriksanya bahkan sebelum membuka Claude Code? Dokumentasi menyarankan permintaan minimal dengan 1 token output, yang mengurangi saldo dengan jumlah yang dapat diabaikan. Perintah ini membaca variabel shell saat ini: jika kunci hanya berada di settings.json, ekspor terlebih dahulu di terminal ini. Jika JSON yang dikembalikan dimulai dengan {"id":"msg_, berarti siap; 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, pengujian yang sama adalah sebagai berikut, dan respons yang benar berisi 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": "."}]}'Yang hilang jika menggunakan kunci API
- Remote Control dan dikte suara. Keduanya memerlukan identitas claude.ai dan tidak berfungsi dengan
ANTHROPIC_AUTH_TOKENatauANTHROPIC_API_KEY; sejak versi 2.1.196, Remote Control juga dinonaktifkan ketikaANTHROPIC_BASE_URLmengarah ke host yang bukan milik Anthropic. - Mode
/fast. Dengan hanya token bearer, Claude Code menganggapnya dinonaktifkan dan bahkan tidak mencoba memintanya. - Pencarian alat MCP, pada awalnya. Dengan
ANTHROPIC_BASE_URLkhusus, fitur ini dinonaktifkan secara default (dokumentasi MCP, dalam bahasa Inggris, dibaca pada 3 Oktober 2026). Fitur ini dapat diaktifkan kembali denganENABLE_TOOL_SEARCH=truejika gateway meneruskan bloktool_reference; kami belum mengujinya dengan Kunavo. - Keakuratan
/context. Kunavo tidak menyediakan/v1/messages/count_tokens, sebuah endpoint opsional menurut spesifikasi gateway (dibaca pada 3 Oktober 2026); tanpa endpoint ini, Claude Code memperkirakan token berdasarkan jumlah karakter.
Untuk informasi lebih lanjut, dalam bahasa Inggris: dokumentasi integrasi dengan Claude Code, halaman tentang kasus khusus ANTHROPIC_BASE_URL, dan panduan Install Claude Code.
Membayar dengan Satispay, tanpa kartu kredit
Sebelumnya, satu klarifikasi karena ini pertanyaan yang paling sering diajukan: Satispay tidak dapat digunakan untuk membayar langganan Claude. Untuk paket Pro dan Max yang dibeli melalui web, Anthropic hanya menerima kartu kredit atau debit (bantuan Anthropic) dan tidak menerima PayPal (bantuan Anthropic), keduanya dibaca pada 3 Oktober 2026. Di Kunavo, Satispay digunakan untuk mengisi saldo API yang digunakan Claude Code dengan kunci yang dikonfigurasi di atas. Semua detail, termasuk biaya untuk mengisi Saldo Tersedia, ada di panduan membayar Claude dengan Satispay. Untuk Claude Code, langkah-langkahnya sebagai berikut:
- Daftar di Kunavo dengan email atau akun Google: tidak diperlukan kartu.
- Buka Penagihan dan pilih jumlah saldo yang ingin diisi: minimum $10, tanpa biaya berlangganan. Di atas ambang tertentu ada bonus: $100 menjadi $110, $1.000 menjadi $1.200, dan $5.000 menjadi $6.250 kredit.
- Di halaman checkout Stripe, yang menampilkan jumlah dalam euro, pilih Satispay. Anda akan diarahkan ke halaman Satispay (dokumentasi Stripe): masukkan nomor ponsel atau pindai kode QR dari aplikasi, lalu konfirmasi dengan Kirim (bantuan Satispay, dibaca pada 3 Oktober 2026). Sebaiknya pastikan Saldo Tersedia Anda cukup sebelum memulai.
- Kredit muncul di Billing segera setelah Stripe mengonfirmasi pembayaran. Jika belum langsung terlihat, segarkan halaman alih-alih membayar lagi: pembayaran kedua menambah kredit, bukan menggantikan pembayaran pertama.
- Di Kunci API, buat kunci
sk-kn-…dan segera salin keANTHROPIC_AUTH_TOKEN: kunci tersebut hanya ditampilkan satu kali.
| Metode | Di checkout Kunavo dalam euro |
|---|---|
| Satispay | Tersedia (lihat catatan di bawah) |
| Kartu Visa dan Mastercard | Ya, termasuk kartu debit dan prabayar jika diaktifkan untuk pembelian online |
| Apple Pay, Google Pay | Ya, pada perangkat yang kompatibel |
| Link | Ya |
| Pay by Bank | Tidak, jika membayar dari Italia: Stripe hanya menyediakannya bagi mereka yang membayar dari Britania Raya (dalam pound sterling), Irlandia, dan Finlandia; di Prancis dan Jerman, fitur ini tersedia dalam pratinjau privat (Stripe, Pay by Bank, dibaca pada 3 Oktober 2026) |
| PayPal, debit SEPA | Tidak |
| Klarna | Tidak, bahkan dalam dolar: Stripe hanya menawarkannya kepada pembayar dari Amerika Serikat |
Kunavo menetapkan harga dalam dolar dan Stripe mengonversinya ke euro dengan biaya konversi 2–4% yang ditanggung pembayar (Stripe, Adaptive Pricing, dibaca pada 3 Oktober 2026): untuk pengisian minimum sebesar $10, biayanya berkisar antara $0,20 dan $0,40. Jika membayar dalam dolar, biaya konversi tidak dikenakan, tetapi Satispay juga tidak tersedia, karena hanya ada di halaman checkout dalam euro; jika halaman checkout Anda ditampilkan dalam dolar, VPN sering menjadi penyebabnya. Jumlah pasti dalam euro adalah jumlah yang Anda lihat di halaman checkout sebelum mengonfirmasi.
Dengan Satispay, pengisian saldo dilakukan secara manual: pengisian otomatis Kunavo hanya menagih kartu yang tersimpan atau Link. Jika memiliki kartu Satispay, yaitu Mastercard debit untuk paket Plus, Metal, dan Velvet (bantuan Satispay, dibaca pada 3 Oktober 2026), Anda dapat menyimpannya dan menggunakannya seperti kartu lainnya. Saldo tidak kedaluwarsa dan permintaan yang gagal tidak ditagihkan. Kunavo tidak menerbitkan faktur, baik dengan PPN maupun faktur elektronik melalui SDI; riwayat pengisian saldo tersedia di Billing.
Catatan jujur: Satispay tersedia di checkout Kunavo sejak 3 Oktober 2026 dan Stripe menawarkannya dalam pembayaran euro, tetapi belum ada pengisian yang dilakukan melalui metode tersebut. Jika tidak menemukannya, kartu, Apple Pay, Google Pay, dan Link memberikan hasil yang sama.
Berapa biaya satu sesi kerja
Dengan kunci API, biaya berasal dari token, dan Claude Code mengirim cukup banyak token: pada setiap langkah, seluruh konteks dikirim ulang. Namun bagian yang tidak berubah dapat dibaca dari cache dengan tarif yang jauh lebih rendah. Berikut contoh yang dibuat khusus dengan asumsi yang jelas: ini bukan pengukuran dan bukan batas pengeluaran.
- 40.000 token input per permintaan, di antaranya 36.000 (90%) dibaca dari cache dan 4.000 ditulis ke cache;
- 1.000 token output per permintaan;
- 50 permintaan dalam satu sesi, tidak termasuk panggilan ke Claude Haiku 4.5 di latar belakang;
- pembacaan dari cache dengan 10% tarif input dan penulisan dengan 1,25× tarif input: itulah rasio Kunavo untuk Claude Sonnet 5, dan setiap baris tabel menggunakan rasio modelnya sendiri.
| Model | Satu permintaan | 50 permintaan | 50 permintaan tanpa cache |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,95 | $3,15 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
Konteks panjang, sedikit pembacaan dari cache, dan respons yang bertele-tele menaikkan tagihan; /clear di antara tugas dapat menurunkannya. Anda dapat menemukan apakah langganan atau API lebih menguntungkan di berapa biaya Claude Code; tarif semua model Claude tersedia di harga API Claude dan halaman harga. Untuk menghitung ulang menggunakan angka Anda sendiri, tersedia kalkulator biaya token Claude (dalam bahasa Inggris).
Kesalahan: pesan, penyebab, solusi
| Yang Anda lihat | Makna dan tindakan yang harus dilakukan |
|---|---|
The token '&&' is not a valid statement separator | Baris untuk CMD berakhir di PowerShell. Gunakan irm … | iex. |
'irm' is not recognized as an internal or external command | Baris untuk PowerShell berakhir di 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 | Anda menempelkan perintah untuk macOS dan Linux di Windows. Gunakan baris untuk PowerShell. |
syntax error near unexpected token '<', 403, App unavailable in region | Yang diterima sebagai pengganti skrip adalah halaman HTML atau kesalahan. Matikan VPN atau proxy, atau coba jaringan lain: Homebrew dan WinGet menggunakan server yang sama. |
command not found: claude, 'claude' is not recognized | Folder program tidak berada di PATH. Buka terminal baru; di Windows, gunakan perintah PowerShell pada bagian tentang PATH. |
Peringatan EBADENGINE | Node.js lebih lama dari versi 22. Instalasi berhasil, tetapi perbarui Node sesegera mungkin. |
claude native binary not installed (macOS, Linux) | npm melewati dependensi opsional (--omit=optional, optional=false) atau skrip instalasi (--ignore-scripts). Hapus opsi tersebut lalu instal ulang. |
npm.ps1 cannot be loaded | execution policy PowerShell memblokir skrip npm. Jalankan Set-ExecutionPolicy untuk pengguna saat ini, atau gunakan installer native. |
Claude Code does not support 32-bit Windows | Anda berada di “Windows PowerShell (x86)”. Buka entri tanpa (x86). |
| Login muncul meskipun Anda telah menetapkan kunci | Kunci tidak terbaca. Letakkan di shell atau di ~/.claude/settings.json, bukan hanya di pengaturan proyek, lalu buka kembali terminal. |
401 | Kunci ditolak. Pastikan sk-kn-… disalin seluruhnya tanpa spasi, masih aktif di /app/keys, dan berada di ANTHROPIC_AUTH_TOKEN. |
404 | ANTHROPIC_BASE_URL diakhiri dengan /v1, atau model yang diminta bukan salah satu model Kunavo, biasanya karena variabel penetapan model tidak ada. |
| Satispay tidak muncul di checkout | Checkout menggunakan dolar, biasanya karena VPN atau proxy luar negeri. Nonaktifkan keduanya dan buka kembali checkout dari Billing. |
Yang tidak dilakukan konfigurasi ini
- Tidak mengaktifkan langganan Claude Pro atau Max: kredit Kunavo membayar API dan Claude Code dengan kunci, bukan claude.ai maupun aplikasi Claude.
- Tidak menerbitkan faktur: baik dengan PPN maupun elektronik melalui SDI.
- Tidak mengisi ulang secara otomatis dengan Satispay: pengisian otomatis memerlukan kartu tersimpan atau Link.
- Tidak berfungsi tanpa variabel model selama Kunavo belum menawarkan Sonnet 5.5 (situasi per 3 Oktober 2026): alias
sonnetakan menghasilkan 404, begitu pula/model sonnet, fase eksekusiopusplan, dan subagent denganmodel: sonnet. - Tidak memiliki dokumentasi Kunavo dalam bahasa Italia: panduan integrasi dan halaman tentang saldo dan pembayaran tersedia dalam bahasa Inggris, sedangkan dokumentasi Anthropic tentang Claude Code telah diterjemahkan.
Untuk gambaran umum bagi pengembang di Italia yang menggunakan Claude, tersedia panduan API Claude di Italia. Mulai dari sini: buat akun, isi ulang $10 dengan Satispay, tetapkan keenam variabel, lalu periksa dengan /status.
Pertanyaan umum
Bagaimana cara menginstal Claude Code di Windows, Mac, dan Linux?
Dengan satu perintah, yang berbeda bergantung pada terminal. Di macOS, Linux, dan WSL: curl -fsSL https://claude.ai/install.sh | bash. Di Windows PowerShell: irm https://claude.ai/install.ps1 | iex. Di Command Prompt (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Ini adalah installer native yang direkomendasikan dalam dokumentasi Anthropic, dan dapat memperbarui dirinya sendiri. Setelah selesai, buka terminal baru dan ketik claude --version. Homebrew dan WinGet dapat digunakan, tetapi pembaruannya harus Anda tangani sendiri.
Apakah instalasi Claude Code di Windows memerlukan WSL atau hak administrator?
Tidak keduanya. Claude Code berjalan secara native mulai Windows 10 1809, dan dokumentasi resmi menyatakan bahwa terminal administrator tidak diperlukan. WSL 2 hanya berguna jika Anda bekerja dengan alat Linux atau menginginkan sandbox perintah, yang tidak tersedia di Windows native maupun WSL 1. Git for Windows bersifat opsional: jika tersedia, Claude Code menggunakan Git Bash; jika tidak, PowerShell. Hindari “Windows PowerShell (x86)”: versi tersebut 32-bit dan Claude Code tidak dapat berjalan.
Claude Code dengan npm: apakah memerlukan Node 18 atau Node 22?
Node.js 22 atau yang lebih baru (dokumentasi instalasi resmi, dibaca pada 3 Oktober 2026); versi 18 yang tercantum dalam beberapa panduan merupakan persyaratan lama. Dengan Node yang lebih lama, peringatan EBADENGINE akan muncul, tetapi instalasi selesai dan claude dapat digunakan. Perintahnya: npm install -g @anthropic-ai/claude-code, tanpa sudo; untuk memperbarui, ulangi instalasi dengan @latest, bukan npm update -g. Jika menggunakan installer native, Node.js sama sekali tidak diperlukan.
Apakah Claude Code gratis? Dapatkah digunakan tanpa langganan?
Tidak gratis: paket gratis Claude.ai tidak mencakup Claude Code, dan login memerlukan Pro, Max, Team, Enterprise, atau akun Console. Tanpa langganan, Anda tetap dapat menggunakannya dengan kunci API: tetapkan ANTHROPIC_BASE_URL=https://api.kunavo.com dan ANTHROPIC_AUTH_TOKEN, Claude Code melewati login dan token dipotong dari kredit prabayar Kunavo. Tanpa biaya bulanan, isi ulang minimum $10. Anda tidak dapat menggunakan Remote Control dan dikte suara, yang memerlukan akun claude.ai.
Di mana kunci API dimasukkan di Claude Code?
Di variabel lingkungan, bukan di menu. Tempat yang paling praktis adalah blok env dalam ~/.claude/settings.json (di Windows %USERPROFILE%\.claude\settings.json), yang berlaku untuk semua proyek; alternatifnya adalah ~/.zshrc, ~/.bashrc, atau profil PowerShell. Gunakan ANTHROPIC_AUTH_TOKEN: Kunavo juga menerima ANTHROPIC_API_KEY, tetapi dengan variabel tersebut Claude Code meminta persetujuan dan, jika ditolak, mengabaikannya sampai diaktifkan kembali di /config. Jangan pernah menuliskannya di .claude/settings.json proyek, karena file tersebut akan masuk ke repositori.
Bagaimana cara mengetahui apakah Claude Code menggunakan kunci API, bukan akun saya?
Buka sesi dan ketik /status. Baris “Anthropic base URL” dengan https://api.kunavo.com dan baris “Auth token” dengan ANTHROPIC_AUTH_TOKEN harus muncul. Jika Anda melihat “Login method” dengan akun claude.ai, variabel tersebut tidak masuk ke sesi: tutup, buka terminal baru, lalu periksa tempat Anda menuliskannya. Login Pro atau Max lama tidak mengganggu karena variabel tersebut memiliki prioritas; jika ingin menghapusnya, gunakan /logout.
Mengapa Claude Code mengembalikan 404 dengan ANTHROPIC_BASE_URL?
Biasanya karena salah satu dari dua alasan. Pertama, alamat diakhiri /v1: Claude Code sudah menambahkan /v1/messages, sehingga permintaan berakhir di /v1/v1/messages. Tulis hanya https://api.kunavo.com. Kedua, model: tanpa variabel, Claude Code menggunakan alias, dan bagi pengguna API alias sonnet saat ini mengarah ke Sonnet 5.5 (dokumentasi model, dibaca 3 Oktober 2026), yang tidak ditawarkan Kunavo: /model sonnet, fase eksekusi opusplan, dan subagent dengan model: sonnet akan berakhir dengan 404. Dengan 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, setiap permintaan diarahkan ke model yang tersedia, dengan tarif yang Anda ketahui. Opus 5.5 memerlukan Claude Code 2.1.280 atau yang lebih baru: dengan versi yang lebih lama, jalankan claude update.
Bisakah Claude Code dibayar dengan Satispay? Bagaimana dengan PayPal?
Satispay bisa, tetapi untuk kredit API, bukan langganan. Di Kunavo, Satispay muncul di checkout Stripe dalam euro dan mengisi saldo yang digunakan Claude Code untuk membayar token; minimum $10, dengan biaya konversi 2–4% ditanggung pembayar. Pengisian dengan Satispay dilakukan manual: pengisian otomatis Kunavo hanya berfungsi dengan kartu tersimpan (termasuk kartu Satispay, Mastercard debit dari paket Plus, Metal, dan Velvet) atau Link. PayPal tidak bisa, baik di Kunavo maupun di Anthropic, yang untuk Pro dan Max di web hanya menerima kartu kredit atau debit. Kunavo tidak menerbitkan faktur, baik dengan PPN maupun elektronik melalui SDI.