Anda dapat menginstal Claude Code dengan satu perintah resmi: di macOS, Linux, dan WSL dengan curl -fsSL https://claude.ai/install.sh | bash, dan di Windows dalam PowerShell dengan irm https://claude.ai/install.ps1 | iex (di Command Prompt, CMD, dengan baris install.cmd di bawah). Setelah itu, pilih cara pembayaran. Anda dapat masuk dengan akun Pro, Max, Team, Enterprise, atau Console (langganan Claude.ai gratis tidak mencakup Claude Code), atau menggunakan kunci API tanpa langganan: atur ANTHROPIC_BASE_URL (hanya domainnya, tanpa /v1), ANTHROPIC_AUTH_TOKEN, dan empat variabel model, lalu periksa dengan /status apakah kunci aktif. Saldo Kunavo dapat diisi menggunakan iDEAL (Belanda) atau Bancontact (Belgia), mulai dari $10, tanpa biaya bulanan.
Perintah dan variabel diverifikasi pada 3 Oktober 2026 berdasarkan dokumentasi instalasi resmi Claude Code dan dokumentasi variabel lingkungan; harga dan metode pembayaran diverifikasi pada 10 Oktober 2026. Belanda dan Belgia sama-sama tercantum dalam daftar negara yang didukung Anthropic (diperiksa pada 3 Oktober 2026), baik untuk Claude.ai maupun API. Panduan ini juga tersedia dalam bahasa Inggris: Install Claude Code.
Sebelum menginstal
| Komponen | Persyaratan (dokumentasi instalasi resmi, diperiksa pada 3 Oktober 2026) |
|---|---|
| Sistem operasi | 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 | Minimal 4 GB RAM, prosesor x64 atau ARM64 (tanpa Windows 32-bit) |
| Shell | Bash, Zsh, PowerShell, atau CMD |
| Jaringan dan lokasi | Koneksi internet, di negara yang didukung Anthropic (Belanda dan Belgia tercantum) |
| Akun | Untuk masuk, Anda memerlukan Pro, Max, Team, Enterprise, atau Console; langganan Claude.ai gratis tidak mencakup Claude Code. Dengan kunci API, Anda tidak memerlukan langganan dan tidak perlu masuk. |
| Node.js | Hanya untuk metode npm, dan harus versi 22 atau yang lebih baru; native installer tidak memerlukannya |
Menginstal Claude Code di macOS dan Linux
Buka Terminal dan tempel baris ini:
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bashIni adalah instalasi native yang direkomendasikan: satu program mandiri yang memperbarui dirinya sendiri di latar belakang. Perintah claude ditempatkan di ~/.local/bin. Terminal yang sudah terbuka belum mengetahui PATH baru, jadi buka jendela baru sebelum menguji. Di WSL, gunakan baris yang sama persis di terminal WSL.
Menginstal Claude Code di Windows
Di Windows ada dua baris, dan baris yang diperlukan hanya bergantung pada jendela yang terbuka. Jika prompt diawali PS C:\Users\Naam>, Anda berada di PowerShell; jika hanya terdapat C:\Users\Naam> tanpa PS, itu adalah Command Prompt (CMD). Anda tidak perlu membuka jendela sebagai administrator: menurut dokumentasi resmi, hal itu tidak diperlukan.
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows Opdrachtprompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdKesalahan yang paling umum adalah menempelkan baris di jendela yang salah. Baris CMD di PowerShell menghasilkan The token '&&' is not a valid statement separator; baris PowerShell di CMD menghasilkan 'irm' is not recognized as an internal or external command. Pada Windows berbahasa Belanda, pesan kedua mungkin muncul dalam bahasa Belanda, dengan penyebab yang sama. Baris macOS dengan | bash di PowerShell juga menghasilkan kesalahan bahwa bash tidak dikenali. Dalam ketiga kasus tersebut, gunakan baris yang sesuai dengan jendelanya.
Git for Windows bersifat opsional. Jika terpasang, Claude Code menjalankan perintah melalui Git Bash yang disertakan; tanpa Git, Claude Code menggunakan PowerShell. Jika Git sudah terpasang tetapi Git Bash tidak ditemukan, atur CLAUDE_CODE_GIT_BASH_PATH di blok env pada ~/.claude/settings.json ke path bash.exe; contoh path dalam dokumentasi adalah C:\Program Files\Git\bin\bash.exe.
| Opsi | Yang Anda perlukan | Sandbox | Kapan memilih |
|---|---|---|---|
| Windows native | Tidak ada; Git for Windows opsional | Tidak didukung | Proyek dan alat yang berjalan langsung di Windows |
| WSL 2 | WSL 2 diaktifkan | Didukung | Memerlukan alat Linux atau perintah dalam sandbox |
| WSL 1 | WSL 1 diaktifkan | Tidak didukung | Jika WSL 2 tidak tersedia |
Jadi, WSL bukan persyaratan seperti yang diklaim beberapa panduan lama, melainkan pilihan. Jika memilih WSL, jalankan baris macOS/Linux di terminal WSL dan mulai claude juga di sana, bukan dari PowerShell atau CMD.
Melalui Homebrew, WinGet, atau npm
Itu juga bisa dilakukan, dengan satu perbedaan penting: menurut dokumentasi resmi, instalasi Homebrew dan WinGet tidak diperbarui secara otomatis. Anda harus memperbaruinya sendiri:
# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code # bijwerken gebeurt niet vanzelf
# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode # bijwerken gebeurt niet vanzelfPaket npm memerlukan Node.js 22 atau yang lebih baru, bukan Node.js 18 seperti yang masih ditulis dalam panduan lama. Dengan Node.js yang lebih lama, npm hanya menampilkan peringatan EBADENGINE dan instalasi tetap berlanjut: paket tersebut menginstal program native yang sama, yang tidak memerlukan Node.js untuk berjalan. Jangan pernah gunakan sudo npm install -g: hal itu menimbulkan masalah izin dan merupakan risiko keamanan. Perbarui dengan @latest, bukan dengan npm update -g.
node -v # moet v22 of hoger zijn
npm install -g @anthropic-ai/claude-code # nooit met sudo
# later bijwerken: met @latest, niet met npm update -g
npm install -g @anthropic-ai/claude-code@latestMemeriksa instalasi
claude --version # toont het versienummer, gevolgd door (Claude Code)
claude doctor # alleen-lezen diagnose van installatie en instellingen, start geen sessieclaude doctor tidak memulai sesi, tetapi menampilkan status instalasi dan file pengaturan Anda. Dengan begitu, Anda dapat segera melihat apakah masalahnya berada pada instalasi atau konfigurasi.
Jika Anda mendapatkan command not found: claude, atau Windows menyatakan bahwa claude tidak dikenali, berarti direktori instalasi tidak ada di PATH Anda. Buka jendela terminal baru terlebih dahulu. Jika tidak membantu, tambahkan ~/.local/bin ke PATH di macOS dan Linux melalui ~/.zshrc atau ~/.bashrc. Di Windows, direktorinya adalah %USERPROFILE%\.local\bin; menurut panduan pemecahan masalah resmi, periksa dan tambahkan direktori tersebut melalui PowerShell dengan cara berikut:
# 1. Staat de installatiemap al in je PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Geen uitvoer? Voeg de map toe aan je gebruikers-PATH en open een nieuw venster
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. In het nieuwe venster: twee paden betekent twee installaties naast elkaar
where.exe claudeJika Anda menginstal melalui npm dan PowerShell menampilkan npm.ps1 cannot be loaded because running scripts is disabled on this system, kebijakan eksekusi PowerShell memblokir skrip startup npm. Gunakan native installer, mulai npm.cmd dan claude.cmd, atau izinkan skrip lokal untuk pengguna Anda sendiri:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserMulai pertama: langganan atau kunci API
Saat pertama kali memulai, Anda memilih cara pembayaran Claude Code. Kedua metode ini saling eksklusif: jika kunci API telah diatur, login tersimpan tidak digunakan; jika variabel dihapus, Claude Code kembali menggunakan login tanpa perlu diinstal ulang.
| Metode A: masuk dengan langganan | Metode B: kunci API, tanpa langganan | |
|---|---|---|
| Yang Anda perlukan | Akun Pro, Max, Team, Enterprise, atau Console | Kunci Kunavo yang diawali sk-kn- |
| Cara membayar | Pro dan Max: biaya tetap per bulan; Console: per token di Anthropic | Per token, dari saldo prabayar; tanpa biaya bulanan |
| Metode pembayaran | Melalui situs web hanya kartu kredit atau debit | iDEAL, Bancontact, kartu, Apple Pay, Google Pay, atau Link |
| Remote Control dan dikte suara | Tersedia: keduanya hanya berfungsi dengan login claude.ai | Tidak tersedia |
| Menyiapkan | Masuk di browser | Enam variabel lingkungan |
Metode A: masuk dengan langganan Anda
Mulai claude di folder proyek Anda dan masuk melalui browser. Satu hal yang perlu diperhatikan: jika ANTHROPIC_API_KEY sudah diatur, Claude Code akan sekali menanyakan apakah kunci tersebut harus digunakan. Jika Anda menolaknya, kunci akan diabaikan setelah itu tanpa ditanyakan lagi, sehingga tampak seolah-olah variabel tidak terbaca. Aktifkan kembali melalui /config → Use custom API key.
Metode B: tanpa langganan, dengan kunci API
ANTHROPIC_BASE_URL adalah variabel bawaan Claude Code. Menurut dokumentasi resmi, variabel ini mengganti endpoint API untuk mengirim permintaan melalui proxy atau gateway. Jadi, mengarahkan Claude Code ke endpoint dengan Anthropic Messages API merupakan konfigurasi yang didukung, tanpa plugin dan tanpa versi yang dimodifikasi. Langkah-langkahnya:
- Buat akun Kunavo.
- Isi saldo Anda melalui Billing, mulai dari $10 (iDEAL dan Bancontact dibahas di bagian berikutnya).
- Buat kunci di /app/keys yang diawali
sk-kn-. Kunci hanya ditampilkan satu kali, jadi segera simpan. - Atur variabelnya. Di macOS dan Linux, di
~/.zshrcatau~/.bashrc:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # alleen het domein, zonder /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 menguji terlebih dahulu dalam satu jendela PowerShell:
# Geldt alleen voor dit PowerShell-venster
$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 penggunaan tetap, blok env pada pengaturan pengguna adalah tempat terbaik: ~/.claude/settings.json (di Windows %USERPROFILE%\.claude\settings.json). Nilai tersebut berlaku di mana pun Claude Code berjalan, termasuk untuk agen latar belakang. Variabel dari shell hanya berlaku untuk jendela terminal tersebut: editor yang dibuka dari Dock atau menu Start tidak melihatnya. Jika sudah ada pengaturan lain dalam file tersebut, 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"
}
}Jangan pernah menaruh key di .claude/settings.json proyek: menurut dokumentasi gateway resmi (diperiksa pada 3 Oktober 2026), file tersebut akan di-commit dan dibagikan kepada semua orang yang mengkloning repositori. Perhatikan juga urutannya: jika shell dan file pengaturan sama-sama menetapkan variabel yang sama, file pengaturan yang berlaku. Jika perubahan variabel shell tidak berpengaruh, periksa settings.json terlebih dahulu.
Setiap baris memiliki hal yang perlu diperhatikan:
ANTHROPIC_BASE_URLhanya berupa domain. Claude Code menambahkan/v1/messagessendiri; jika diakhiri/v1, permintaan akan diarahkan ke/v1/v1/messagesdan menghasilkan 404.- Gunakan
ANTHROPIC_AUTH_TOKEN, bukanANTHROPIC_API_KEY. Menurut dokumentasi,ANTHROPIC_AUTH_TOKENdikirim sebagai headerAuthorizationdenganBearerdi depannya dan langsung berlaku.ANTHROPIC_API_KEYmasuk ke headerx-api-keydan dalam mode interaktif harus disetujui satu kali terlebih dahulu (lihat metode A). - Tuliskan nama model di
ANTHROPIC_MODELsecara persis. Kunavo hanya mengenali nama yang tepat dan tidak menerjemahkan nama lama yang diikuti tanggal. - Kunci juga
ANTHROPIC_DEFAULT_OPUS_MODELdanANTHROPIC_DEFAULT_SONNET_MODEL. Menurut dokumentasi konfigurasi model (diperiksa pada 3 Oktober 2026), pengaturan default dan aliasopusuntuk pengguna API mengarah ke Opus 5.5, sedangkan aliassonnetmengarah ke Sonnet 5.5; alias tersebut akan mengikuti versi baru. Untuk menguncinya, gunakan nama model lengkap atau variabel sepertiANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo saat ini tidak menyediakan Sonnet 5.5, dan model Opus baru tidak selalu langsung tersedia; model yang tidak tersedia akan menghasilkan 404. TanpaANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5,/model sonnet, tahap eksekusiopusplandan subagen yang disetel kemodel: sonnetakan gagal. Kunci aliasopuske Opus 5.5 (claude-opus-5-5); untuk itu, Anda memerlukan Claude Code v2.1.280 atau yang lebih baru; perbarui versi yang lebih lama denganclaude update. - Patok juga
ANTHROPIC_DEFAULT_HAIKU_MODEL. Aliashaikumeminta ID yang tidak disediakan Kunavo: Haiku 5.5 sejak v2.1.293, dan sebelumnya ID Haiku 4.5 dengan tanggal. Tanpa baris ini,/model haikudan subagen denganmodel: haikumenghasilkan 404. ANTHROPIC_DEFAULT_HAIKU_MODELjuga berlaku untuk tugas latar belakang. Menurut dokumentasi, variabel ini menentukan aliashaikudan model untuk fungsi latar belakang, seperti judul sesi. Dengan Claude Haiku 4.5, biayanya tetap rendah.
Jika Anda menggunakan ekstensi VS Code, atur variabel di claudeCode.environmentVariables, yaitu di pengaturan pengguna VS Code itu sendiri (perintah Preferences: Open User Settings (JSON)). Ekstensi memeriksa kredensial login di sana sebelum dimulai; nilai dari ~/.claude/settings.json memang diteruskan ke proses yang dimulai, tetapi tidak digunakan dalam pemeriksaan tersebut.
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
{ "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
{ "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
]
}Harga per satu juta token, dari katalog Kunavo; harga daftar Anthropic berasal dari claude.com/pricing (diperiksa pada 3 Oktober 2026):
| Model | Kunavo (input / output) | Harga daftar Anthropic (input / output) | Perbedaan | Untuk apa |
|---|---|---|---|---|
claude-haiku-4-5 | $0,70 / $3,50 | $1,00 / $5,00 | ~30% lebih rendah | Tugas latar belakang Claude Code sendiri dan pekerjaan sederhana |
claude-sonnet-5 | $1,40 / $7,00 | $2,00 / $10,00 | ~30% lebih rendah | Model default untuk pekerjaan sehari-hari |
claude-opus-5-5 | $2,80 / $14,00 | $4,00 / $20,00 | ~30% lebih rendah | Refaktor besar dan perencanaan |
Dalam satu sesi, Anda dapat berganti dengan /model claude-opus-5-5, atau langsung memulai dengan claude --model claude-opus-5-5. Perkiraan biaya Claude Code per bulan dan kapan langganan lebih hemat dijelaskan dalam Claude Code pricing (berbahasa Inggris); hitung penggunaan Anda sendiri dengan Claude-tokencalculator. Semua model dan harga tercantum di halaman harga.
Memeriksa dengan /status
Mulai claude. Dengan ANTHROPIC_AUTH_TOKEN yang diatur, Anda tidak akan melihat layar login: variabel tersebut langsung berlaku. Jika layar login tetap muncul, Claude Code tidak membaca kunci. Atur kunci di lokasi yang dibaca Claude Code sebelum wizard mulai pertama: export di shell Anda atau blok env pada ~/.claude/settings.json. Blok env di .claude/settings.json atau .claude/settings.local.json suatu proyek baru berlaku dalam sesi interaktif setelah wizard mulai pertama dan pertanyaan apakah Anda mempercayai folder tersebut.
Ketik /status dalam sesi, lalu lihat dua baris pada tab Status (sumber: dokumentasi gateway resmi, diperiksa pada 3 Oktober 2026):
Anthropic base URLharus menampilkanhttps://api.kunavo.com. Baris ini hanya muncul jika alamat gateway telah diatur; jika tidak ada,ANTHROPIC_BASE_URLbelum diterapkan ke sesi.Auth tokenharus menyebutANTHROPIC_AUTH_TOKEN. Jika yang terlihat adalahLogin methoddengan akun claude.ai, variabel tersebut tidak terbaca dan sesi berjalan menggunakan langganan Anda.
Jika sebelumnya Anda masuk dengan langganan, Claude Code mungkin memperingatkan saat dimulai bahwa dua sumber login aktif (pesan tersebut diakhiri dengan auth may not work as expected). Permintaan akan dikirim melalui kunci; gunakan /logout untuk menghapus login lama.
Ingin menguji alamat dan kunci sebelum membuka Claude Code? Kirim permintaan dengan satu token output, seperti yang disarankan dokumentasi; biayanya sangat sedikit saldo. Perintah tersebut membaca variabel dari shell Anda, jadi atur juga di sana jika variabel sudah berada di settings.json.
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": "."}]}'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": "."}]}'Respons JSON yang diawali {"id":"msg_ berarti alamat dan kunci berfungsi; di PowerShell Anda akan melihat id yang diawali msg_. 401 berarti kunci ditolak.
Hal lain yang berfungsi dengan kunci API
- Tidak ada Remote Control dan tidak ada dikte suara. Keduanya memerlukan akun claude.ai dan tidak tersedia selama
ANTHROPIC_AUTH_TOKENaktif; Remote Control juga dinonaktifkan selamaANTHROPIC_BASE_URLmenunjuk ke alamat di luar Anthropic. /fastmelaporkan bahwa mode cepat dinonaktifkan. Dengan token bearer saja, Claude Code menganggap mode cepat dinonaktifkan tanpa mengirim pemeriksaan.- Pencarian alat MCP dinonaktifkan secara default segera setelah
ANTHROPIC_BASE_URLmenunjuk ke alamat di luar Anthropic. - Angka dalam
/contextadalah perkiraan: Kunavo saat ini tidak menyediakan/v1/messages/count_tokens. Menurut dokumentasi kompatibilitas gateway resmi (diperiksa pada 3 Oktober 2026), jika endpoint tersebut tidak tersedia, Claude Code kembali menggunakan perkiraan berdasarkan karakter, sehingga/contextmenampilkan jumlah perkiraan.
Kode, alat, subagent, server MCP, hook, dan caching prompt berfungsi seperti biasa. Detail selengkapnya tersedia dalam Dokumentasi integrasi Claude Code (berbahasa Inggris) dan Claude Code without a subscription (berbahasa Inggris).
Membayar dengan iDEAL atau Bancontact
Langganan Claude yang dibayar melalui situs web hanya dapat dibayar dengan kartu kredit atau debit (artikel bantuan Claude tentang paket berbayar, diperiksa pada 3 Oktober 2026); harga di claude.com/pricing belum termasuk pajak.
Saldo Kunavo dapat ditambah melalui Stripe Checkout. Harga tercantum dalam dolar AS; bagi pembeli di Belanda dan Belgia, Stripe menampilkan jumlah dalam euro. Menurut dokumentasi Stripe tentang Adaptive Pricing (diperiksa pada 3 Oktober 2026), nilai tukar tersebut mencakup markup konversi sebesar 2–4% yang dibayar pembeli; pembayar dalam dolar tidak dikenai markup tersebut, baik membayar dengan kartu, Apple Pay, Google Pay, maupun Link. iDEAL dan Bancontact hanya berfungsi dalam euro. Metode yang tersedia di halaman pembayaran adalah:
- iDEAL, untuk Belanda. Metode ini sekarang bernama iDEAL | Wero (Stripe meminta agar nama tersebut mulai digunakan pada kuartal pertama 2026), jadi nama itu juga dapat terlihat di halaman pembayaran. Anda akan dialihkan ke lingkungan bank Anda sendiri untuk mengonfirmasi pembayaran (Stripe tentang iDEAL, diperiksa pada 3 Oktober 2026).
- Bancontact, untuk Belgia, menggunakan kartu Bancontact atau aplikasinya (Stripe tentang Bancontact, diperiksa pada 3 Oktober 2026).
- Kartu (Visa, Mastercard), Apple Pay, Google Pay, dan Link.
Tidak ditawarkan: PayPal, debit langsung SEPA, Klarna (hanya tersedia untuk pembeli di Amerika Serikat), Tikkie, Riverty (sebelumnya AfterPay), dan transfer bank biasa.
- Buat akun Kunavo.
- Pilih jumlah di Billing, minimal $10. Pengisian saldo dalam jumlah lebih besar sekaligus akan mendapatkan saldo tambahan: dengan $100 Anda mendapatkan $110, dengan $1.000 Anda mendapatkan $1.200, dan dengan $5.000 Anda mendapatkan $6.250.
- Di halaman pembayaran Stripe, pilih iDEAL atau Bancontact lalu selesaikan pembayaran di lingkungan bank Anda (iDEAL) atau dengan aplikasi atau kartu Bancontact. Jumlah dalam euro terlihat di halaman pembayaran sebelum Anda mengonfirmasi.
- Buat kunci di /app/keys dan masukkan ke
ANTHROPIC_AUTH_TOKEN.
Saldo dibayar di muka: tidak ada biaya bulanan, saldo tidak kedaluwarsa, dan permintaan yang gagal tidak ditagihkan. Pengisian otomatis hanya dapat dilakukan dengan kartu tersimpan atau Link; jadi, dengan iDEAL dan Bancontact, Anda selalu mengisi saldo secara manual. Kunavo tidak menerbitkan faktur PPN; riwayat pengisian saldo tersedia di Billing. Metode pembayaran ini hanya mengisi saldo API Kunavo: langganan Claude Pro atau Max tidak dapat dibayar dengan metode tersebut. Selengkapnya tentang pembayaran dalam euro: Claude membayar dengan iDEAL.
Kesalahan umum
| Yang Anda lihat | Penyebab dan solusi |
|---|---|
The token '&&' is not a valid statement separator | Baris CMD ditempelkan di PowerShell. Gunakan irm … | iex. |
'irm' is not recognized as an internal or external command (atau versi bahasa Belanda dari pesan tersebut) | Baris PowerShell ditempelkan di CMD. Gunakan baris install.cmd. |
'bash' is not recognized as the name of a cmdlet | Baris macOS/Linux ditempelkan di Windows. Gunakan baris PowerShell. |
| Perintah menampilkan teks skrip, tetapi tidak menginstal apa pun | Bagian kedua tidak ada. Di PowerShell, gunakan seluruh baris irm … | iex; di CMD, gunakan perintah lengkap dengan -o install.cmd. |
syntax error near unexpected token '<', atau 403 | Unduhan menghasilkan halaman web atau kode kesalahan, bukan skrip. Menurut pemecahan masalah resmi, penyebabnya dapat berupa masalah jaringan, perutean regional, gangguan sementara, atau (untuk 403 kosong) proxy perusahaan atau firewall. Coba lagi setelah beberapa menit, atau instal di macOS melalui Homebrew dan di Windows melalui WinGet. |
Claude Code does not support 32-bit Windows | Anda membuka Windows PowerShell (x86). Buka Windows PowerShell biasa. |
npm.ps1 cannot be loaded | Kebijakan eksekusi PowerShell memblokir npm. Jalankan baris Set-ExecutionPolicy atau gunakan native installer. |
command not found: claude, atau claude tidak dikenali | Folder instalasi tidak berada di PATH Anda. Buka jendela baru; di Windows, gunakan potongan PATH di atas. |
| Layar login muncul meskipun kunci telah diatur | Claude Code tidak membaca kunci. Atur variabel di shell atau di ~/.claude/settings.json, bukan hanya di pengaturan proyek, lalu buka jendela baru. |
Peringatan yang diakhiri dengan auth may not work as expected | Kunci dan login lama sama-sama aktif. Gunakan /logout untuk menyisakan kunci saja, atau hapus variabel untuk menggunakan login. |
401 | Kunci tidak dikenali: pastikan Anda menyalin seluruh kunci sk-kn-, tanpa spasi, bahwa kunci tersebut belum dihapus di /app/keys, dan bahwa kunci berada di ANTHROPIC_AUTH_TOKEN. |
404 | ANTHROPIC_BASE_URL diakhiri dengan /v1, atau model yang diminta tidak tersedia di Kunavo (misalnya karena empat variabel model tidak ada). |
Setelah instalasi
Saat pertama kali memulai di suatu proyek, ketik /init: Claude Code membaca repositori dan membuat CLAUDE.md berisi perintah pengujian serta konvensi yang ditemukannya. Periksa file tersebut dan buat tetap singkat karena file itu dimuat pada setiap sesi. Di antara tugas yang terpisah, /clear memulai percakapan baru; jika tugas menjadi panjang, /compact merangkum riwayat dan Anda melanjutkan pekerjaan.
Yang perlu Anda ketahui
- Ini adalah API dengan pembayaran per token, bukan langganan Claude Pro atau Max. Jika Claude Code digunakan berjam-jam setiap hari, langganan sering kali lebih murah; pembayaran per token cocok untuk penggunaan yang berubah-ubah, dan tidak menggunakan apa pun selama sebulan tidak dikenai biaya. Perbandingannya tersedia di Claude Code pricing (berbahasa Inggris).
- Dengan kunci API, Remote Control dan dikte suara tidak tersedia.
- Melalui Kunavo, Anda menggunakan kapasitas bersama, tanpa kuota yang dicadangkan dan tanpa jaminan kontraktual; jika memerlukannya, buat kontrak langsung dengan Anthropic.
- iDEAL dan Bancontact hanya untuk pengisian saldo manual; pengisian otomatis hanya dapat dilakukan dengan kartu atau Link.
- Jumlah dalam euro mencakup markup konversi Stripe. Kunavo tidak menerbitkan faktur PPN.
Pertanyaan yang sering diajukan
Bagaimana cara menginstal Claude Code?
Dengan satu perintah resmi. Di macOS, Linux, dan WSL: curl -fsSL https://claude.ai/install.sh | bash. Di Windows dalam PowerShell: irm https://claude.ai/install.ps1 | iex. Di Windows Command Prompt (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Ini adalah instalasi native yang direkomendasikan Anthropic; instalasi ini diperbarui sendiri di latar belakang. Setelah itu, buka jendela terminal baru, periksa dengan claude --version, lalu mulai dengan claude.
Apakah saya memerlukan WSL atau hak administrator untuk menginstal Claude Code di Windows?
Tidak. Menurut dokumentasi instalasi resmi, jalankan perintah instalasi di PowerShell atau CMD tanpa membuka jendela sebagai administrator. Git for Windows bersifat opsional: jika terinstal, Claude Code menjalankan perintah melalui Git Bash; jika tidak, melalui PowerShell. WSL 2 hanya diperlukan jika Anda membutuhkan alat Linux atau sandboxing; dalam hal itu, instal dan jalankan Claude Code di dalam terminal WSL. Jangan membuka Windows PowerShell (x86): Claude Code tidak mendukung Windows 32-bit.
Apakah saya memerlukan Node.js untuk Claude Code?
Hanya jika Anda menginstal melalui npm, dan saat itu Anda memerlukan Node.js 22 atau yang lebih baru. Penginstal native, Homebrew, dan WinGet tidak memerlukan Node.js. Dengan Node.js yang lebih lama, npm hanya menampilkan peringatan EBADENGINE dan instalasi tetap berlanjut. Jangan pernah menggunakan sudo npm install -g, dan perbarui dengan npm install -g @anthropic-ai/claude-code@latest, bukan npm update -g.
Bisakah saya menggunakan Claude Code tanpa langganan?
Ya. Untuk login, Anda memerlukan akun Pro, Max, Team, Enterprise, atau Console, dan langganan gratis Claude.ai tidak mencakup Claude Code. Tanpa langganan, atur ANTHROPIC_BASE_URL=https://api.kunavo.com dan ANTHROPIC_AUTH_TOKEN dengan kunci Kunavo; Claude Code akan melewati layar login, dan Anda membayar setiap token yang digunakan dari saldo prabayar Kunavo, mulai dari $10, tanpa biaya bulanan. Remote Control dan dikte suara tidak tersedia dengan cara ini karena keduanya memerlukan akun claude.ai.
Bagaimana cara menyiapkan kunci API untuk Claude Code?
Atur variabel di blok env pada ~/.claude/settings.json (di Windows %USERPROFILE%\.claude\settings.json) atau sebagai baris export di ~/.zshrc, ~/.bashrc, atau PowerShell-$PROFILE Anda. Gunakan ANTHROPIC_AUTH_TOKEN, bukan ANTHROPIC_API_KEY: yang pertama dikirim sebagai Authorization: Bearer dan langsung berlaku, sedangkan yang kedua masuk ke header x-api-key dan harus disetujui satu kali terlebih dahulu. ANTHROPIC_BASE_URL hanya berupa domain, https://api.kunavo.com, tanpa /v1: Claude Code menambahkan /v1/messages sendiri, jadi dengan /v1 hasilnya /v1/v1/messages dan 404. Jangan pernah menaruh kunci di .claude/settings.json suatu proyek karena file tersebut akan di-commit. Jika shell dan file pengaturan menetapkan variabel yang sama, file pengaturan yang berlaku.
Mengapa ada empat variabel model saat menggunakan Claude Code melalui kunci API?
Tanpa model yang ditetapkan secara eksplisit, Claude Code menggunakan alias yang berubah mengikuti versi baru Anthropic. Menurut dokumentasi resmi tentang konfigurasi model (diperiksa pada 3 Oktober 2026), pengaturan default dan alias opus untuk pengguna API mengarah ke Opus 5.5, sedangkan alias sonnet mengarah ke Sonnet 5.5. Kunavo saat ini tidak menawarkan Sonnet 5.5, dan model yang tidak tersedia menghasilkan 404: tanpa variabel sonnet yang ditetapkan, /model sonnet, tahap output opusplan, dan subagent dengan model: sonnet akan gagal. 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 menggunakan model yang ditawarkan Kunavo dan Anda tahu biaya yang dibayarkan. Opus 5.5 memerlukan Claude Code v2.1.280 atau yang lebih baru; perbarui versi lama dengan claude update. Variabel haiku juga menentukan model untuk tugas latar belakang Claude Code.
Bagaimana cara memeriksa apakah Claude Code menggunakan kunci API saya?
Ketik /status di Claude Code. Pada tab Status, baris Anthropic base URL harus menampilkan https://api.kunavo.com, dan baris Auth token harus menyebut ANTHROPIC_AUTH_TOKEN. Jika yang terlihat adalah Login method dengan akun claude.ai, variabel tersebut tidak terbaca dan sesi berjalan menggunakan langganan Anda. Jika layar login muncul saat memulai, Claude Code sama sekali tidak membaca kunci.
Bisakah saya membayar Claude Code dengan iDEAL atau Bancontact?
Untuk saldo API Kunavo, bisa. Di halaman pembayaran Stripe tersedia iDEAL (Belanda) dan Bancontact (Belgia), selain kartu, Apple Pay, Google Pay, dan Link. Harga ditampilkan dalam dolar dan Stripe menampilkan jumlahnya dalam euro; menurut Stripe, nilai tukar tersebut mencakup markup konversi sebesar 2–4%. Minimum adalah $10, tidak ada biaya bulanan, dan saldo tidak kedaluwarsa. iDEAL dan Bancontact hanya untuk pengisian saldo manual: pengisian otomatis hanya dapat dilakukan dengan kartu tersimpan atau Link. PayPal dan debit langsung SEPA tidak ditawarkan, dan Kunavo tidak menerbitkan faktur PPN. Langganan Claude Pro atau Max tidak dapat dibayar dengan ini; claude.ai hanya menagihnya melalui situs web menggunakan kartu kredit atau kartu debit.