Menginstal Claude Code: Windows, macOS, dan Linux, kunci API tanpa langganan, serta pembayaran melalui Bancontact

Untuk memasang Claude Code, cukup satu baris, tetapi perintahnya berbeda di setiap tempat: curl -fsSL https://claude.ai/install.sh | bash di terminal macOS, Linux, atau WSL, irm https://claude.ai/install.ps1 | iex di PowerShell, dan satu baris install.cmd di Command Prompt Windows. Pertanyaan sebenarnya muncul saat pertama kali dijalankan: siapa yang membayar permintaan? Akun Pro, Max, Team, Enterprise, atau Console memungkinkan Anda masuk (paket gratis Claude.ai tidak mencakup Claude Code). Tanpa langganan, kunci API sudah cukup: enam variabel, termasuk ANTHROPIC_BASE_URL tanpa /v1 dan ANTHROPIC_AUTH_TOKEN, lalu periksa /status. Saldo Kunavo dapat dibayar dengan kartu, Apple Pay, Google Pay, Link, atau, di Belgia, Bancontact, mulai dari $10, tanpa langganan.

Sumber informasi: perintah dan variabel diambil dari dokumentasi resmi Claude Code (instalasi, variabel lingkungan, koneksi ke gateway), yang ditinjau pada 3 Oktober 2026; harga dan metode pembayaran Kunavo diperiksa pada 10 Oktober 2026. Menurut daftar negara yang didukung Anthropic (dibaca pada 3 Oktober 2026), Claude.ai dan API tersedia di Prancis, Belgia, Swiss, Luksemburg, dan Kanada, serta Maroko, Tunisia, Aljazair, Senegal, dan Pantai Gading. Panduan yang sama tersedia dalam bahasa Inggris dan, untuk Flandria, dalam bahasa Belanda.

Perintah yang harus diketik: semuanya bergantung pada jendela

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Invite de commandes Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Tiga baris pertama memasang versi native yang direkomendasikan Anthropic: biner mandiri yang disimpan di ~/.local/bin (%USERPROFILE%\.local\bin di Windows), mengunduh pembaruannya di latar belakang, lalu menerapkannya saat mulai berikutnya. Setelah instalasi selesai, tutup terminal dan buka kembali terminal baru: terminal yang digunakan untuk memasang belum mengenali PATH baru.

Di Windows, salah memilih jendela adalah penyebab kegagalan nomor satu, dan pesannya menyatakannya dengan jelas. The token '&&' is not a valid statement separator: Anda menempelkan baris CMD di PowerShell. 'irm' is not recognized as an internal or external command: kebalikannya. Pada Windows berbahasa Prancis, pesan kedua ini mungkin muncul dalam terjemahan; penyebabnya tetap sama. Pesan lainnya ada di tabel kesalahan di akhir panduan.

Persyaratan

Windows: apa yang dikatakan tutorial lama dan apa yang benar

Banyak panduan berbahasa Prancis berasal dari versi awal Claude Code. Berikut petunjuk yang paling sering muncul dalam panduan tersebut, dibandingkan dengan dokumentasi instalasi terkini dan halaman pemecahan masalah (dibaca pada 3 Oktober 2026):

Jika Anda menginstal Git for Windows, Claude Code menggunakan Git Bash dan tetap menyediakan alat PowerShell. Terkadang Claude Code tidak dapat menemukannya bash.exe: dalam hal itu, cantumkan jalurnya dalam variabel CLAUDE_CODE_GIT_BASH_PATH, di dalam blok env pada ~/.claude/settings.json (dokumentasi memberikan C:\Program Files\Git\bin\bash.exe sebagai contoh). Hal lain yang perlu diperhatikan: pintasan “Windows PowerShell (x86)” menjalankan versi 32-bit, yang tidak diterima Claude Code.

Native atau WSL, pilihannya bergantung pada lokasi proyek Anda:

Di sisi WSL, semuanya berlangsung di dalam distribusi Linux: di sanalah Anda menempelkan baris curl … | bash, dan di sanalah Anda kemudian mengetik claude. Jika dijalankan dari PowerShell atau CMD, instalasi ini tidak akan terlihat.

Homebrew, WinGet, apt, atau npm

Pengelola paket berfungsi, dengan konsekuensi: Claude Code tidak diperbarui secara otomatis. Untuk Homebrew dan WinGet, variabel CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 meminta Claude Code menjalankan pembaruan sendiri; tanpa variabel itu, Anda harus melakukannya sendiri:

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # pas de mise à jour automatique

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # pas de mise à jour automatique

Di Debian, Ubuntu, Fedora, RHEL, dan Alpine, Anthropic juga menerbitkan repositori apt, dnf, dan apk yang ditandatangani, dan diperbarui bersama bagian sistem lainnya; prosedurnya tercantum di halaman instalasi.

Tersisa npm, yang praktis jika Node.js sudah menjadi bagian dari perangkat kerja Anda. Paket ini memerlukan minimal Node.js 22. Pada versi yang lebih lama, npm hanya menampilkan peringatan EBADENGINE lalu melanjutkan, karena paket tersebut memasang biner native yang sama, yang tidak memerlukan Node.js untuk berjalan. Dua aturan: jangan gunakan sudo npm install -g, dan lakukan pembaruan dengan @latest, karena npm update -g tetap berada dalam rentang versi awal dan dapat membuat Anda tertinggal.

node -v                                       # v22 ou plus récent
npm install -g @anthropic-ai/claude-code      # jamais avec sudo

# mise à jour : avec @latest, pas avec npm update -g
npm install -g @anthropic-ai/claude-code@latest

Memeriksa instalasi dan memperbaiki PATH

claude --version   # affiche le numéro de version, suivi de (Claude Code)
claude doctor      # diagnostic de l’installation et des réglages, sans ouvrir de session

Jika nomor versi muncul sebagai keluaran, berarti instalasi selesai. claude doctor melakukan pemeriksaan lebih jauh tanpa memulai sesi: status instalasi, kesalahan pada file pengaturan, dan hasil pembaruan terakhir. Saat ada masalah, inilah perintah pertama yang harus dijalankan.

command not found: claude di macOS atau Linux, claude “tidak dikenali” di Windows: program sudah terpasang, tetapi shell tidak tahu di mana harus mencarinya. Biasanya, membuka jendela baru sudah cukup. Jika tidak, tambahkan ~/.local/bin ke PATH di ~/.zshrc atau ~/.bashrc. Di Windows, halaman pemecahan masalah resmi mencantumkan tiga langkah PowerShell berikut:

# 1. Le dossier d'installation est-il déjà dans le PATH ?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Aucun résultat ? Ajoutez-le au PATH de l'utilisateur, puis ouvrez une nouvelle fenêtre
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Dans la nouvelle fenêtre : deux chemins = deux installations concurrentes
where.exe claude

Dipasang melalui npm, tetapi PowerShell menjawab npm.ps1 cannot be loaded? Kebijakan eksekusinya memblokir skrip npm. Gunakan penginstal native, atau izinkan skrip lokal hanya untuk akun Anda:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Siapa yang membayar permintaan: langganan Claude atau kunci API

Pilihan ini tidak dibuat saat instalasi, melainkan saat pertama kali dijalankan, dan tetap dapat dibalik. Kunci yang ditetapkan di lingkungan mengesampingkan koneksi claude.ai yang tersimpan, yang tetap tidak aktif; hapus variabel tersebut, dan koneksi akan kembali digunakan saat mulai berikutnya.

Dengan langganan Claude

Tidak ada yang perlu dikonfigurasi: claude di folder proyek, lalu login di browser. Satu-satunya pengecualian adalah ANTHROPIC_API_KEY yang tersisa di lingkungan Anda. Claude Code kemudian bertanya sekali apakah harus menggunakannya; penolakan diingat, dan kunci selanjutnya diabaikan tanpa pesan, sehingga seolah-olah variabel tidak dibaca. Untuk mengubah pilihan ini: /config → Use custom API key.

Tanpa langganan: kunci API Kunavo

Mengarahkan Claude Code ke layanan selain Anthropic bukanlah praktik yang tidak resmi. Daftar resmi variabel lingkungan menyebut ANTHROPIC_BASE_URL sebagai cara untuk mengirim permintaan melalui proksi atau gateway. Kunavo merespons dalam format API Messages Anthropic: Anda tetap menggunakan Claude Code resmi, tanpa ekstensi atau versi modifikasi.

1. Buat akun: pendaftaran Kunavo.
2. Isi saldo di Billing, minimal $10 (metode pembayaran di bawah).
3. Buat kunci di /app/keys. Kunci dimulai dengan sk-kn- dan hanya ditampilkan saat dibuat: segera salin.
4. Isi keenam variabel di bawah ini.

Mengapa menetapkan empat model secara spesifik? Alias Claude Code mengikuti rilis Anthropic. Menurut dokumentasi konfigurasi model (dibaca pada 3 Oktober 2026), untuk akun API, pengaturan default dan opus saat ini mengarah ke Opus 5.5, sedangkan sonnet mengarah ke Sonnet 5.5, yang tidak disediakan Kunavo: tanpa ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, tahap eksekusi opusplan dan subagen yang disetel ke sonnet akan menghasilkan 404. Alias opus ditetapkan ke Opus 5.5 (claude-opus-5-5), yang memerlukan Claude Code v2.1.280 atau yang lebih baru; jika Anda menggunakan versi lama, jalankan claude update. Model yang baru dirilis juga mungkin belum tersedia di Kunavo pada hari yang sama. Dengan nama model lengkap, setiap permintaan dikirim ke model yang tersedia dengan harga yang sudah Anda ketahui. Dokumentasi protokol gateway (dibaca pada 3 Oktober 2026) mengonfirmasi hal terkait tugas latar belakang: dengan Claude Haiku 4.5, biayanya rendah.

Tempat menulis variabel

Versi yang direkomendasikan, untuk digabungkan dengan isi file yang sudah ada jika ada (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"
  }
}

Nilai yang sama di shell, pada macOS dan Linux:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # le domaine seul, sans /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

Untuk pengujian cepat di jendela PowerShell:

# Valable uniquement dans cette fenêtre PowerShell
$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

Dan untuk ekstensi VS Code, di pengaturan pengguna editor (perintah Preferences: Open User Settings (JSON)):

{
  "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" }
  ]
}

Aplikasi desktop Claude merupakan pengecualian: aplikasi ini tidak membaca ANTHROPIC_BASE_URL maupun settings.json. Variabel yang diubah di shell tetap tidak berpengaruh? Pertama-tama cari variabel yang sama dalam settings.json, yang memiliki prioritas.

Tarif per satu juta token dari katalog Kunavo, di samping harga publik Anthropic yang tercantum di claude.com/pricing (dibaca pada 3 Oktober 2026):

Untuk beralih ke Opus selama suatu tugas: /model opus saat sesi berlangsung (alias yang dikunci ke claude-opus-5-5), atau claude --model claude-opus-5-5 saat memulai. Anggaran bulanan berdasarkan penggunaan Anda, serta ambang ketika langganan menjadi lebih menguntungkan, dihitung dalam harga Claude Code. kalkulator biaya token Claude menghitung berdasarkan volume Anda sendiri, dan halaman harga mencantumkan semua model.

Periksa dengan /status

Tanda pertama, bahkan sebelum /status: dengan ANTHROPIC_AUTH_TOKEN aktif, Claude Code dimulai tanpa layar login. Jika layar itu muncul, tidak ada kunci yang terbaca, sering kali karena kunci hanya berada dalam pengaturan proyek (.claude/settings.json atau .claude/settings.local.json). Dalam sesi interaktif, blok env ini hanya diterapkan setelah asisten peluncuran pertama dan pertanyaan kepercayaan untuk folder tersebut. Pindahkan kunci ke shell atau ke ~/.claude/settings.json.

Setelah masuk ke sesi, /status terbuka pada tab Status. Berikut cara membacanya, menurut dokumentasi gateway (dibaca pada 3 Oktober 2026):

Apakah Anda sudah masuk dengan langganan? Claude Code kemudian dapat melaporkan saat mulai bahwa ada dua sumber kredensial aktif, dalam peringatan yang diakhiri dengan auth may not work as expected. Kunci itulah yang digunakan untuk permintaan; /logout menghapus koneksi lama dan menghilangkan peringatan.

Untuk mengetahui apakah masalah berasal dari Kunavo atau konfigurasi Anda, lakukan pengujian tanpa Claude Code. Dokumentasi menyediakan permintaan yang dibatasi hanya satu token keluaran, dengan biaya sebagian kecil sen. Dua perintah di bawah ini mengambil alamat dan kunci dari shell: jika hanya ditetapkan di settings.json, keduanya tidak akan terlihat di sini.

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

JSON yang diawali {"id":"msg_, atau di PowerShell objek yang id-nya diawali msg_: alamat dan kunci berfungsi. 401: kunci ditolak.

Yang berubah saat menggunakan kunci API

• Remote Control dan dikte suara tidak tersedia. Keduanya bergantung pada akun claude.ai dan tetap tidak tersedia selama ANTHROPIC_AUTH_TOKEN ditetapkan. Remote Control juga dinonaktifkan saat ANTHROPIC_BASE_URL menunjuk ke host selain Anthropic.
• Mode cepat (/fast) tampak dinonaktifkan, karena verifikasinya memerlukan koneksi claude.ai atau kunci Anthropic, bukan sekadar token bearer.
• Pencarian alat MCP dinonaktifkan secara default ketika ANTHROPIC_BASE_URL menunjuk ke luar Anthropic.
• /context menampilkan perkiraan. Kunavo tidak menyediakan /v1/messages/count_tokens, dan dalam kondisi ini Claude Code menghitung berdasarkan jumlah karakter (dokumentasi protokol gateway).

Untuk hal lainnya (membaca dan menulis kode, alat, subagen, server MCP, hook, cache prompt), tidak ada yang berubah. Detail teknis dalam bahasa Inggris ada di dokumentasi integrasi Claude Code.

Membayar dari Prancis atau Belgia

Ada dua alur yang tidak boleh disamakan. Langganan Claude yang dibeli melalui web hanya dapat dibayar dengan kartu kredit atau debit (FAQ penagihan Anthropic, dibaca pada 3 Oktober 2026); jika berlangganan melalui aplikasi seluler, pembayarannya diproses melalui App Store atau Google Play. Harga di claude.com/pricing belum termasuk pajak.

Saldo Kunavo diisi melalui halaman pembayaran Stripe. Harga ditetapkan dalam dolar AS, tetapi jika Anda berada di Prancis atau Belgia, Stripe menampilkan jumlah dalam euro dengan nilai tukar yang dijamin selama 24 jam, termasuk biaya konversi 2–4% yang ditanggung Anda (dokumentasi Adaptive Pricing Stripe, dibaca pada 3 Oktober 2026). Anda dapat membayar dalam dolar untuk menghindari biaya ini, tetapi bank Anda akan menerapkan nilai tukarnya sendiri, dan Bancontact hanya tersedia untuk pembayaran dalam euro. Metode pembayaran yang tersedia:

• Kartu CB Prancis? Menurut dokumentasi Stripe tentang Cartes Bancaires (dibaca pada 3 Oktober 2026), lebih dari 95 % kartu CB bermerek bersama Visa atau Mastercard. Karena itu, kartu tersebut dapat digunakan saat checkout sebagai Visa atau Mastercard, dan kartu debit biasa sudah cukup.
• Bancontact tersedia bagi pembeli yang berada di Belgia. Stripe mengarahkan Anda ke situs atau aplikasi Bancontact untuk melakukan konfirmasi, dan hasilnya langsung diketahui (dokumentasi Stripe tentang Bancontact, dibaca pada 3 Oktober 2026).
• Pay by Bank, pembayaran melalui bank daring Anda, tidak tersedia dari Prancis maupun Belgia: checkout hanya menampilkannya kepada pembeli yang berada di Britania Raya, Irlandia, dan Finlandia. Dokumentasi Stripe tentang Pay by Bank (dibaca pada 3 Oktober 2026) menyebutnya sebagai pratinjau privat untuk Prancis dan tidak menyebut Belgia.
• Dari Swiss atau Kanada, jumlah ditampilkan dalam franc Swiss atau dolar Kanada, dengan kartu dan Link, ditambah Apple Pay dan Google Pay yang menggunakan kartu.

Tidak ditawarkan: PayPal, debit langsung SEPA, Klarna, yang hanya tersedia bagi pembeli di Amerika Serikat (membayar dalam dolar saja tidak cukup).

1. Daftar di Kunavo; kartu belum diperlukan pada tahap ini.
2. Di Billing, pilih jumlahnya: minimal $10. Jumlah yang lebih tinggi berhak mendapatkan bonus ($100 dibayar, $110 dikreditkan; $1.000 dibayar, $1.200 dikreditkan; $5.000 dibayar, $6.250 dikreditkan).
3. Di halaman Stripe, pilih metode pembayaran; jumlah dalam euro ditampilkan sebelum konfirmasi. Dengan Bancontact, konfirmasikan dalam aplikasi atau menggunakan kartu.
4. Buat kunci di /app/keys dan letakkan di ANTHROPIC_AUTH_TOKEN.

Saldo bersifat prabayar: tanpa biaya bulanan, tanpa tanggal kedaluwarsa, dan permintaan yang gagal tidak ditagihkan. Isi ulang otomatis memerlukan kartu tersimpan atau Link. Bancontact tidak mendukung pembayaran berulang di Stripe, jadi setiap isi ulang Bancontact dilakukan secara manual. Kunavo tidak menerbitkan faktur dengan PPN, baik Prancis, Belgia, maupun negara lain; riwayat isi ulang dapat dilihat di Billing. Terakhir, metode pembayaran ini hanya digunakan untuk saldo API Kunavo dan tidak membayar langganan Claude Pro atau Max. Semua opsi lainnya, termasuk App Store dan Google Play, dibahas dalam membayar Claude tanpa kartu bank.

Kesalahan umum

Memulai dalam sebuah proyek

Dalam repositori yang ditemukan Claude Code, mulailah dengan /init: alat ini menjelajahi kode dan menulis CLAUDE.md yang mencatat perintah pengujian serta konvensi yang ditemukan. Tinjau dan ringkas file ini, karena file tersebut dimuat ulang pada setiap sesi. Untuk berganti topik, /clear memulai percakapan baru; untuk melanjutkan tugas panjang, /compact merangkum riwayatnya.

Batas kunci API

• Anda membayar berdasarkan penggunaan, bukan paket Claude Pro atau Max. Untuk penggunaan Claude Code selama beberapa jam setiap hari, setiap hari, langganan sering kali lebih menguntungkan; untuk penggunaan yang tidak teratur, pembayaran per token lebih fleksibel, dan bulan-bulan dengan penggunaan rendah tidak dikenai biaya. Lihat angkanya di harga Claude Code.
• Remote Control dan dikte suara tidak tersedia selama kunci ini aktif.
• Kapasitas Kunavo digunakan bersama, tanpa kuota khusus atau komitmen kontraktual; jika Anda membutuhkannya, buat kontrak langsung dengan Anthropic.
• Bancontact hanya memungkinkan pengisian ulang manual; pengisian otomatis dilakukan melalui kartu yang tersimpan atau Link.
• Jumlah dalam euro mencakup biaya konversi Stripe, dan Kunavo tidak menerbitkan faktur dengan PPN.

Pertanyaan umum