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

Instal Claude Code: perintah untuk Windows, macOS, dan Linux, kunci API tanpa langganan, serta pembayaran dengan MB WAY

Claude Code diinstal dengan satu perintah. Masalah biasanya muncul setelahnya: jendela yang salah di Windows, PATH atau versi Node.js saat menggunakan npm. Tanpa langganan, Anda juga perlu mengonfigurasi kunci API dan mengetahui cara membayar dalam euro dengan MB WAY.

Claude Code diinstal dengan satu perintah resmi untuk setiap sistem: 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 Command Prompt, CMD, gunakan baris install.cmd di bawah). Setelah itu ada dua cara untuk menggunakannya. Dengan langganan, login menggunakan akun Pro, Max, Team, Enterprise, atau Console (akun yang hanya memiliki paket gratis Claude.ai tidak memiliki akses ke Claude Code). Tanpa langganan, gunakan key API: tetapkan ANTHROPIC_BASE_URL (hanya domainnya, tanpa /v1), ANTHROPIC_AUTH_TOKEN dan empat variabel model, lalu konfirmasikan dengan /status. Saldo Kunavo dapat diisi dengan MB WAY di checkout dalam euro, mulai dari US$ 10, tanpa biaya bulanan.

Perintah dan variabel diperiksa pada 3 Oktober 2026 berdasarkan dokumentasi resmi instalasi Claude Code dan dokumentasi variabel lingkungan; harga dan metode pembayaran diperiksa pada 10 Oktober 2026. Portugal 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

KomponenPersyaratan (dokumentasi instalasi resmi, dibaca pada 3 Oktober 2026)
Sistem operasimacOS 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 kerasRAM 4 GB atau lebih, prosesor x64 atau ARM64 (Windows 32-bit tidak didukung)
ShellBash, Zsh, PowerShell, atau CMD
Jaringan dan lokasiKoneksi internet, di negara yang didukung Anthropic (Portugal tercantum dalam daftar)
AkunUntuk login: Pro, Max, Team, Enterprise, atau Console (paket gratis Claude.ai tidak cukup). Dengan key API, tidak diperlukan langganan atau login.
Node.jsHanya untuk instalasi melalui npm, dan saat itu versi 22 atau yang lebih baru; penginstal native tidak memerlukannya

macOS, Linux, dan WSL: satu baris

Di Terminal (di macOS berada di Applications › Utilities), jalankan:

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

Ini adalah instalasi native yang direkomendasikan: program mandiri yang, menurut dokumentasi resmi, memperbarui dirinya sendiri di latar belakang. Perintah claude berada di ~/.local/bin. Terminal yang sudah terbuka belum mengenal PATH baru, jadi buka jendela baru sebelum menguji. Di WSL, barisnya persis sama dan dijalankan di dalam terminal WSL.

Menginstal di Windows

Di Windows ada dua baris, dan pilihannya hanya bergantung pada jendela yang terbuka. Jika baris dimulai dengan PS C:\Users\Nome>, Anda berada di PowerShell; jika hanya C:\Users\Nome> yang muncul, tanpa PS, Anda berada di Command Prompt (CMD). Tidak perlu menggunakan “Run as administrator”: dokumentasi resmi menyatakan dengan jelas bahwa hal tersebut tidak diperlukan, berbeda dari rekomendasi beberapa panduan berbahasa Portugis.

PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Linha de Comandos do Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Di Windows, kesalahan yang paling sering terjadi adalah jendela yang keliru. Jika PowerShell menjawab The token '&&' is not a valid statement separator, Anda menerima baris untuk CMD; jika CMD menjawab 'irm' is not recognized as an internal or external command, Anda menerima baris untuk PowerShell. Pada Windows berbahasa Portugis, pesan kedua ini mungkin muncul dalam terjemahan, dengan penyebab yang sama. Dan baris macOS, dengan | bash, jika ditempelkan ke PowerShell akan menghasilkan error yang menyatakan bahwa bash tidak dikenali. Dalam ketiga kasus, solusinya adalah menggunakan baris yang sesuai dengan jendelanya.

Git for Windows bersifat opsional. Dengan Git for Windows, alat Bash Claude Code berjalan di Git Bash, sementara PowerShell tetap tersedia; tanpa Git for Windows, semua perintah dijalankan melalui PowerShell. Jika Git diinstal di folder yang tidak biasa dan Claude Code tidak dapat menemukan bash.exe, tentukan jalurnya di CLAUDE_CODE_GIT_BASH_PATH, di dalam blok env pada ~/.claude/settings.json; contoh dalam dokumentasi adalah C:\Program Files\Git\bin\bash.exe.

OpsiYang diperlukanSandboxKapan memilih
Windows nativeTidak ada; Git for Windows opsionalTidak didukungProyek dan alat yang berjalan langsung di Windows
WSL 2WSL 2 diaktifkanDidukungJika alat Linux atau perintah di dalam sandbox diperlukan
WSL 1WSL 1 diaktifkanTidak didukungSaat WSL 2 tidak tersedia

Jadi, WSL adalah pilihan, bukan persyaratan, berbeda dari yang dinyatakan beberapa panduan. 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

Juga berfungsi, dengan satu perbedaan penting: menurut dokumentasi resmi, instalasi melalui Homebrew dan WinGet tidak diperbarui secara otomatis. Pembaruan dilakukan secara manual. Tersedia pula repositori apt, dnf, dan apk bertanda tangan untuk Linux.

# Homebrew
brew install --cask claude-code
brew upgrade claude-code              # não se atualiza sozinho

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # não se atualiza sozinho

Paket npm memerlukan Node.js 22 atau yang lebih baru—bukan Node.js 18 yang masih disebutkan beberapa panduan. Dengan Node.js yang lebih lama, npm hanya menampilkan peringatan EBADENGINE selama instalasi, bukan gagal. Jangan pernah menggunakan sudo npm install -g: dokumentasi resmi secara tegas tidak merekomendasikannya. Untuk memperbarui, gunakan @latest, bukan npm update -g.

Terminal
node -v                                           # tem de ser v22 ou posterior
npm install -g @anthropic-ai/claude-code          # nunca com sudo

# para atualizar mais tarde: com @latest, não com npm update -g
npm install -g @anthropic-ai/claude-code@latest

Mengonfirmasi instalasi

claude --version   # mostra o número da versão, seguido de (Claude Code)
claude doctor      # diagnóstico só de leitura da instalação e das definições, sem abrir sessão

claude doctor tidak memulai sesi apa pun: perintah ini menampilkan status instalasi dan file pengaturan. Ini adalah cara tercepat untuk mengetahui apakah masalahnya ada pada instalasi atau konfigurasi.

command not found: claude (atau, di Windows, pemberitahuan bahwa claude bukan perintah yang dikenal) berarti terminal tidak tahu lokasi program tersebut. Sering kali cukup tutup jendela terminal lalu buka yang baru. Jika masalah berlanjut, foldernya belum ada di PATH: di macOS dan Linux, foldernya adalah ~/.local/bin, yang perlu ditambahkan ke file inisialisasi shell (~/.zshrc atau ~/.bashrc); di Windows, foldernya adalah %USERPROFILE%\.local\bin. Menurut panduan pemecahan masalah resmi, verifikasi dan tambahkan folder tersebut di PowerShell seperti berikut:

PowerShell
# 1. A pasta de instalação já está no PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sem resultado? Acrescente-a ao PATH do utilizador e abra uma janela nova
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Na janela nova: dois caminhos significam duas instalações lado a lado
where.exe claude

Jika Anda menginstal melalui npm dan PowerShell menjawab npm.ps1 cannot be loaded because running scripts is disabled on this system, kebijakan eksekusi PowerShell memblokir skrip npm. Gunakan penginstal native atau izinkan skrip lokal untuk pengguna Anda:

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Jika Claude Code does not support 32-bit Windows muncul, berarti «Windows PowerShell (x86)» telah dibuka. Windows memiliki dua entri PowerShell, dan versi x86 berjalan sebagai proses 32-bit; buka entri «Windows PowerShell», tanpa (x86).

Penggunaan pertama: langganan atau key API

Saat pertama kali dimulai, tentukan bagaimana Claude Code dibayar. Anda tidak perlu menginstal ulang untuk mengubah rute: yang menentukan adalah ada atau tidaknya key yang ditetapkan.

Rute A: login dengan langgananRute B: key API, tanpa langganan
Yang diperlukanAkun Pro, Max, Team, Enterprise, atau ConsoleKey Kunavo yang dimulai dengan sk-kn-
Cara membayarPro dan Max: biaya tetap, bulanan atau tahunan; Console: per token, kepada AnthropicPer token, mulai dari saldo prabayar; tanpa biaya bulanan
Metode pembayaranPro dan Max yang dibeli di situs: hanya kartu kredit atau debitMB WAY, kartu, Apple Pay, Google Pay, atau Link
Remote Control dan dikte suaraTersedia dengan akun claude.ai (Pro, Max, Team, Enterprise); tidak dengan akun ConsoleTidak tersedia
KonfigurasiLogin di browserEnam variabel lingkungan

Rute A — login dengan langganan

Di folder proyek, jalankan claude dan login di browser. Perhatikan jika Anda sudah memiliki ANTHROPIC_API_KEY di lingkungan: alih-alih membuka browser, Claude Code meminta satu persetujuan untuk key tersebut. Setelah persetujuan ditolak, key diabaikan selanjutnya dan pertanyaan tidak akan muncul lagi, sehingga tampak seolah-olah variabel tidak terbaca. Untuk mengaktifkannya kembali: /config → Use custom API key.

Rute B — tanpa langganan, dengan key API

ANTHROPIC_BASE_URL adalah variabel milik Claude Code sendiri, yang dirancang untuk meneruskan permintaan melalui proxy atau gateway. Karena itu, mengarahkannya ke endpoint yang kompatibel dengan Messages API Anthropic merupakan konfigurasi yang didukung, tanpa plug-in atau versi modifikasi. Langkah-langkahnya:

  1. Buat akun Kunavo.
  2. Isi saldo di Penagihan, mulai dari US$ 10 (pembayaran dengan MB WAY dijelaskan di bawah).
  3. Di /app/keys, buat key yang dimulai dengan sk-kn-. Key ini hanya ditampilkan sekali, jadi sebaiknya segera disimpan.
  4. Tetapkan variabelnya. Di macOS dan Linux, dalam ~/.zshrc atau ~/.bashrc:
~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # só o domínio, sem /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

Di Windows, untuk menguji terlebih dahulu dalam jendela PowerShell:

PowerShell
# Vale só para esta janela do 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

Untuk penggunaan permanen, tempat terbaik adalah blok env pada pengaturan pengguna: ~/.claude/settings.json (di Windows, %USERPROFILE%\.claude\settings.json). Nilai tersebut berlaku untuk semua proyek, termasuk agen latar belakang; ekstensi VS Code adalah pengecualian (lihat di bawah). Variabel yang diekspor di shell hanya tersedia bagi program yang dimulai dari shell tersebut: editor yang dibuka melalui Dock atau menu Start tidak dapat melihatnya. Jika file sudah memiliki pengaturan lain, tambahkan hanya 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"
  }
}

Jangan pernah masukkan kunci ke dalam .claude/settings.json proyek: menurut dokumentasi resmi gateway (diperiksa pada 3 Oktober 2026), file tersebut akan disertakan dalam commit dan dibagikan kepada siapa pun yang mengkloning repositori. Perhatikan juga urutan prioritas: jika shell dan file pengaturan menetapkan variabel yang sama, file pengaturan yang berlaku. Jika perubahan di shell tidak berdampak, periksa settings.json terlebih dahulu.

Pengguna ekstensi VS Code menetapkan variabel di claudeCode.environmentVariables, dalam pengaturan pengguna VS Code itu sendiri (perintah Preferences: Open User Settings (JSON)). Menurut dokumentasi gateway, ekstensi memeriksa kredensial dalam pengaturan ini sebelum dimulai; nilai dari ~/.claude/settings.json diteruskan ke proses Claude Code, tetapi tidak ke pemeriksaan tersebut:

VS Code 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" }
  ]
}

Empat variabel model dan jebakan lainnya

Setiap baris dalam blok memiliki jebakannya sendiri:

  • ANTHROPIC_BASE_URL tidak boleh berisi path. Path /v1/messages ditambahkan sendiri oleh Claude Code; alamat yang sudah diakhiri /v1 menjadi /v1/v1/messages, yang mengembalikan 404.
  • ANTHROPIC_AUTH_TOKEN atau ANTHROPIC_API_KEY: Kunavo menerima keduanya. Menurut dokumentasi gateway, ANTHROPIC_AUTH_TOKEN diteruskan dalam header Authorization: Bearer dan langsung berlaku; ANTHROPIC_API_KEY diteruskan dalam header x-api-key dan, dalam mode interaktif, harus disetujui satu kali sebelum berlaku (lihat Rute A). Karena itu panduan ini menggunakan ANTHROPIC_AUTH_TOKEN.
  • Nama dalam ANTHROPIC_MODEL harus persis. Salin persis seperti yang ditampilkan di sini: claude-sonnet-5.
  • Tanpa ANTHROPIC_DEFAULT_SONNET_MODEL dan ANTHROPIC_DEFAULT_OPUS_MODEL, alias berubah dengan sendirinya. Menurut dokumentasi konfigurasi model (diperiksa pada 3 Oktober 2026), bagi pengguna API Anthropic, alias opus mengarah ke Opus 5.5 dan alias sonnet mengarah ke Sonnet 5.5; alias ini berubah seiring hadirnya versi baru. Tetapkan model dengan nama lengkapnya atau melalui variabel seperti ANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo tidak menyediakan Sonnet 5.5, dan model yang tidak tersedia akan menghasilkan 404: tanpa ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5, /model sonnet, subagen dengan model: sonnet, dan tahap eksekusi opusplan akan gagal. Sementara itu, opus mengarah ke claude-opus-5-5, yang disediakan Kunavo, tetapi hanya mulai Claude Code v2.1.280; jika menggunakan versi yang lebih lama, jalankan claude update.
  • Atur juga ANTHROPIC_DEFAULT_HAIKU_MODEL. Alias haiku meminta ID yang tidak disediakan Kunavo: sejak v2.1.293, ID tersebut adalah Haiku 5.5; sebelumnya, ID Haiku 4.5 yang disertai tanggal. Tanpa baris ini, /model haiku dan subagen dengan model: haiku mengembalikan 404.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL juga berlaku untuk tugas latar belakang. Menurut dokumentasi, variabel ini menetapkan alias haiku dan model untuk fungsi latar belakang Claude Code. Dengan Claude Haiku 4.5, panggilan tersebut menggunakan model termurah pada tabel di bawah.

Harga per satu juta token, dari katalog Kunavo; kolom Anthropic bersumber dari claude.com/pricing (diperiksa pada 3 Oktober 2026):

ModelKunavo (input / output)Harga tabel Anthropic (input / output)PerbedaanUntuk apa
claude-haiku-4-5US$ 0,70 / US$ 3,50US$ 1,00 / US$ 5,00sekitar 30% lebih murahTugas latar belakang Claude Code itu sendiri dan pekerjaan sederhana
claude-sonnet-5US$ 1,40 / US$ 7,00US$ 2,00 / US$ 10,00sekitar 30% lebih murahModel default untuk pekerjaan sehari-hari
claude-opus-5-5US$ 2,80 / US$ 14,00US$ 4,00 / US$ 20,00sekitar 30% lebih murahRefaktor besar dan perencanaan

Dalam satu sesi, model dapat diganti dengan /model claude-opus-5-5, atau sesi dapat langsung dimulai dengan claude --model claude-opus-5-5. Perhitungan dalam euro, dengan contoh penggunaan bulanan dan titik saat langganan menjadi lebih menguntungkan, tersedia di Harga Claude Code dalam euro; konsumsi masing-masing dapat dihitung dengan kalkulator biaya token. Semua model dan harga tercantum di halaman harga.

Konfirmasi dengan /status

Jalankan claude. Dengan ANTHROPIC_AUTH_TOKEN yang ditetapkan, layar login tidak muncul: variabel tersebut langsung berlaku. Jika layar login muncul, Claude Code tidak membaca kunci apa pun. Dalam hal ini, tetapkan di tempat yang dibaca Claude Code sebelum asisten pengaktifan pertama: export di shell atau blok env dalam ~/.claude/settings.json. Blok env dalam .claude/settings.json atau .claude/settings.local.json proyek hanya berlaku, dalam sesi interaktif, setelah asisten pengaktifan pertama dan pertanyaan tentang mempercayai folder selesai.

Di dalam sesi, ketik /status lalu cari dua baris pada tab Status (sumber: dokumentasi resmi gateway, diperiksa pada 3 Oktober 2026):

  • Anthropic base URL harus menampilkan https://api.kunavo.com. Baris ini hanya muncul jika alamat gateway ditetapkan; jika tidak ada, ANTHROPIC_BASE_URL tidak diteruskan ke sesi.
  • Baris Auth token harus menunjukkan ANTHROPIC_AUTH_TOKEN. Jika yang muncul adalah Login method dengan akun claude.ai, variabel tersebut tidak dibaca dan sesi menggunakan langganan.

Pengguna yang sebelumnya masuk dengan langganan mungkin melihat peringatan saat memulai bahwa ada dua kredensial aktif (pesan berakhir dengan auth may not work as expected). Permintaan diteruskan melalui kunci; /logout menghapus login lama.

Untuk menguji alamat dan kunci sebelum membuka Claude Code, dokumentasi menyarankan permintaan satu token output, yang hanya menggunakan sebagian sangat kecil dari saldo. Perintah membaca variabel shell, jadi tetapkan juga di sana, meskipun sudah ada dalam settings.json.

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

Respons JSON yang diawali {"id":"msg_ berarti alamat dan kunci berfungsi; di PowerShell muncul id yang diawali msg_. 401 berarti kunci tidak dikenali.

Apa yang berubah dengan kunci API

  • Tanpa Remote Control atau dikte suara. Menurut dokumentasi gateway, keduanya tidak tersedia selama ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN atau apiKeyHelper aktif; Remote Control juga dinonaktifkan selama ANTHROPIC_BASE_URL mengarah ke alamat di luar Anthropic.
  • /fast menampilkan mode cepat sebagai dinonaktifkan. Dengan bearer token saja, Claude Code menganggap mode cepat dinonaktifkan.
  • Pencarian alat MCP (MCP tool search) dinonaktifkan secara default ketika ANTHROPIC_BASE_URL mengarah ke alamat di luar Anthropic (dokumentasi variabel lingkungan, diperiksa pada 3 Oktober 2026).
  • Angka pada /context merupakan perkiraan. Kunavo tidak menyediakan /v1/messages/count_tokens dan, menurut dokumentasi kompatibilitas gateway (diperiksa pada 3 Oktober 2026), tanpa endpoint tersebut Claude Code menggunakan perkiraan berdasarkan jumlah karakter.

Selebihnya—kode, alat, subagen, server MCP, hook, dan prompt caching—berfungsi seperti biasa. Detail selengkapnya dalam dokumentasi integrasi Claude Code (dalam bahasa Inggris) dan Claude Code without a subscription (dalam bahasa Inggris).

Mengisi saldo dengan MB WAY

Pertama, soal langganan: langganan Claude yang dibeli melalui situs hanya dapat dibayar dengan kartu kredit atau debit (artikel bantuan Anthropic tentang paket berbayar, diperiksa pada 3 Oktober 2026); untuk langganan yang dibeli melalui aplikasi Claude di iOS atau Android, metode pembayarannya ditentukan oleh App Store atau Google Play. Metode pembayaran Kunavo, termasuk MB WAY, tidak dapat digunakan untuk membayar Claude Pro atau Max: metode tersebut mengisi saldo API Kunavo, yang digunakan Rute B.

Saldo diisi melalui checkout Stripe. Harga ditetapkan dalam dolar AS; bagi pembeli di Portugal, Stripe menampilkan jumlahnya dalam euro. Menurut dokumentasi Stripe tentang Adaptive Pricing (diperiksa pada 3 Oktober 2026), konversi ini mencakup biaya sebesar 2–4% yang ditanggung pembeli; jika memilih membayar dalam dolar (dengan kartu, Apple Pay, Google Pay, atau Link), Anda tidak dikenai biaya tersebut, meskipun bank dapat menerapkan nilai tukar dan biayanya sendiri. MB WAY hanya berfungsi dalam euro. Metode berikut tersedia pada checkout dalam euro:

  • MB WAY. Pilih MB WAY, masukkan nomor ponsel, lalu konfirmasikan pembelian di aplikasi MB WAY melalui notifikasi atau bagian aktivitas (Stripe tentang MB WAY dan MB WAY tentang pembelian online, diperiksa pada 3 Oktober 2026). Menurut Stripe, nomor internasional diterima, tetapi sebagian besar pelanggan menggunakan nomor Portugal yang diawali +351.
  • Kartu (Visa, Mastercard), Apple Pay, Google Pay, dan Link.

Metode yang tidak tersedia: referensi Multibanco (pembayaran dengan entitas dan referensi), PayPal, debit langsung SEPA, dan Klarna, yang hanya ditampilkan kepada pembeli di Amerika Serikat. Konversi ke euro menggunakan Adaptive Pricing dari Stripe, dan daftar metode pembayaran yang disediakan olehnya mencakup MB WAY, tetapi tidak mencakup Multibanco. MB WAY juga memungkinkan Anda membuat kartu virtual MB NET untuk pembelian online (MB WAY tentang MB NET, diperiksa pada 3 Oktober 2026); belum dipastikan apakah kolom kartu di checkout menerima kartu tersebut, jadi cara yang aman adalah memilih MB WAY secara langsung.

Yang didokumentasikan Stripe tentang MB WAY (diperiksa 3 Oktober 2026):

  • Per pembayaran: antara 0,50 € dan 5000 €.
  • Per hari: 1000 € secara default, dapat disesuaikan hingga 10.000 € di aplikasi MB WAY. Pengisian yang lebih besar dapat melampaui batas harian default; jika demikian, naikkan batasnya di aplikasi sebelum membayar. Bandingkan jumlah dalam euro yang ditampilkan checkout dengan batas-batas ini.
  • Pembayaran berulang: tidak didukung.
  • Pada rekening koran muncul nama Stripe (Stripe Inc), beserta jumlah transaksi.
  1. Buat akun Kunavo.
  2. Di Penagihan, pilih jumlah mulai dari US$ 10. Pengisian yang lebih besar memberikan saldo tambahan: siapa pun yang mengisi US$ 100 menerima US$ 110; siapa pun yang mengisi US$ 1000 menerima US$ 1200; siapa pun yang mengisi US$ 5000 menerima US$ 6250.
  3. Di checkout Stripe, dengan jumlah dalam euro, pilih MB WAY, masukkan nomor ponsel, lalu konfirmasikan pembelian di aplikasi MB WAY. Jumlah dalam euro ditampilkan sebelum konfirmasi.
  4. Di /app/keys, buat kunci lalu masukkan ke ANTHROPIC_AUTH_TOKEN.

Saldo bersifat prabayar: tidak ada biaya bulanan, saldo tidak kedaluwarsa, dan permintaan yang gagal tidak ditagih. Pengisian otomatis hanya berfungsi dengan kartu tersimpan atau Link; dengan MB WAY, pengisian selalu dilakukan secara manual karena menurut Stripe MB WAY tidak menerima pembayaran berulang dan tidak disimpan untuk pembayaran mendatang. Kunavo tidak menerbitkan faktur, baik dengan NIF maupun IVA; riwayat pengisian tersedia di Billing. Metode pembayaran ini hanya mengisi saldo API Kunavo. Selengkapnya tentang topik ini di Membayar Claude dengan MB WAY.

Kesalahan umum

Yang munculPenyebab dan solusi
The token '&&' is not a valid statement separatorBaris CMD yang ditempelkan di PowerShell. Gunakan irm … | iex.
'irm' is not recognized as an internal or external command (atau pesan yang sama dalam bahasa Portugis)Baris PowerShell yang ditempelkan di CMD. Gunakan baris install.cmd.
'bash' is not recognized as the name of a cmdletPowerShell menerima baris dengan | bash, yang ditujukan untuk macOS, Linux, dan WSL. Di PowerShell, baris yang benar adalah baris install.ps1.
Perintah menampilkan teks skrip, tetapi tidak menginstal apa punPerintah terpotong saat ditempelkan: irm hanya mengunduh skrip, sedangkan yang menjalankannya adalah | iex. Di CMD, biasanya bagian -o install.cmd && install.cmd tidak ada.
syntax error near unexpected token '<' atau 403Unduhan mengembalikan halaman web atau kode kesalahan, bukan skrip. Menurut pemecahan masalah resmi (diperiksa 3 Oktober 2026), halaman yang bertuliskan «App unavailable in region» berarti Claude Code tidak tersedia di negara tersebut (Portugal ada dalam daftar). 403 sederhana juga dapat berasal dari proxy atau firewall perusahaan: di negara yang didukung, periksa jaringan terlebih dahulu (jika berada di balik proxy, tetapkan HTTPS_PROXY dan HTTP_PROXY), karena Homebrew dan WinGet mengakses server yang sama. Jika bukan itu, masalahnya mungkin jaringan, perutean regional, atau gangguan sementara: coba lagi nanti, atau instal melalui Homebrew di macOS dan WinGet di Windows.
Claude Code does not support 32-bit WindowsWindows PowerShell (x86) terbuka. Buka Windows PowerShell biasa.
npm.ps1 cannot be loadedKebijakan eksekusi PowerShell memblokir npm. Jalankan baris Set-ExecutionPolicy atau gunakan penginstal native.
command not found: claude, atau claude tidak dikenaliTerminal tidak menemukan program tersebut. Tutup dan buka kembali jendela; jika masalah berlanjut, tambahkan folder ke PATH (di Windows, gunakan blok di atas).
Layar login dengan kunci yang telah ditetapkanClaude Code tidak membaca kunci tersebut. Tetapkan variabel di shell atau dalam ~/.claude/settings.json, bukan hanya di pengaturan proyek, lalu buka jendela baru.
Peringatan yang berakhir dengan auth may not work as expectedKunci dan login lama aktif bersamaan. Gunakan /logout agar hanya kunci yang digunakan, atau hapus variabel tersebut untuk kembali ke langganan.
401Kunci tidak dikenali: pastikan Anda menyalin seluruh kunci sk-kn-, tanpa spasi, kunci tersebut tidak dihapus di /app/keys, dan kunci berada dalam variabel dengan nama yang benar, seperti ANTHROPIC_AUTH_TOKEN.
404ANTHROPIC_BASE_URL berakhir dengan /v1, model yang diminta tidak ada di Kunavo, atau /model sonnet digunakan tanpa ANTHROPIC_DEFAULT_SONNET_MODEL.

Setelah menginstal

Saat pertama kali memulai di sebuah proyek, ketik /init: Claude Code memindai repositori dan menulis CLAUDE.md berisi hal-hal yang disimpulkannya: cara menjalankan proyek, cara menguji perubahan, dan aturan gaya yang diikuti. Tinjau file tersebut dan jaga agar tetap singkat karena file ini dimuat di setiap sesi. Di antara tugas yang tidak saling berkaitan, /clear memulai percakapan baru; dalam tugas panjang, /compact merangkum riwayat agar dapat dilanjutkan.

Hal yang perlu diketahui

  • Ini adalah API berbayar per token, bukan langganan Claude Pro atau Max. Pengguna yang memakai Claude Code selama beberapa jam setiap hari biasanya membayar lebih sedikit dengan langganan; pembayaran per token lebih menguntungkan untuk penggunaan yang tidak teratur, dan satu bulan tanpa penggunaan tidak dikenai biaya. Perbandingan dalam euro tersedia di Harga Claude Code dalam euro.
  • Pengguna yang bekerja dengan kunci API tidak memiliki Remote Control atau dikte suara.
  • Melalui Kunavo, Anda menggunakan kapasitas bersama, tanpa kuota yang dicadangkan dan tanpa jaminan kontraktual; jika membutuhkannya, Anda harus berlangganan langsung kepada Anthropic.
  • MB WAY hanya digunakan untuk pengisian manual; pengisian otomatis memerlukan kartu atau Link.
  • Jumlah dalam euro yang ditampilkan di checkout sudah termasuk biaya konversi Stripe.

Pertanyaan yang sering diajukan

Bagaimana cara menginstal Claude Code?

Dengan satu perintah resmi untuk setiap sistem. 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 Command Prompt Windows (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Ini adalah instalasi native yang direkomendasikan Anthropic dan diperbarui otomatis di latar belakang. Setelah itu, buka jendela terminal baru, konfirmasikan dengan claude --version, lalu mulai dengan claude.

Apakah WSL atau izin administrator diperlukan untuk menginstal Claude Code di Windows?

Tidak keduanya. Menurut dokumentasi instalasi resmi, perintah tersebut dijalankan di PowerShell atau Command Prompt (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 berguna jika proyek bergantung pada alat Linux atau Anda ingin menjalankan perintah dalam sandbox; dalam hal itu Claude Code diinstal dan dijalankan dari dalam terminal WSL. Jangan gunakan Windows PowerShell (x86): Claude Code tidak mendukung Windows 32-bit.

Apakah saya memerlukan Node.js untuk menginstal Claude Code?

Hanya jika Anda menginstalnya melalui npm, dan dalam hal itu diperlukan Node.js 22 atau yang lebih baru—bukan versi 18 yang masih disebutkan beberapa panduan. 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.

Apakah Claude Code dapat digunakan tanpa langganan Pro atau Max?

Bisa. Login memerlukan akun berbayar (Pro, Max, Team, atau Enterprise) atau akun Console; paket gratis Claude.ai tidak berlaku. Tanpa langganan, tetapkan ANTHROPIC_BASE_URL=https://api.kunavo.com dan ANTHROPIC_AUTH_TOKEN dengan key Kunavo: Claude Code tidak memerlukan login dan Anda membayar per token, mulai dari saldo prabayar yang diisi dari US$ 10, tanpa biaya bulanan. Dengan cara ini, dua fitur tidak tersedia: Remote Control dan dikte suara.

Di mana key API Claude Code dikonfigurasi: di settings.json atau di PowerShell?

Untuk penggunaan permanen, di blok env pada ~/.claude/settings.json (di Windows, %USERPROFILE%\.claude\settings.json). Untuk pengujian, gunakan $env:ANTHROPIC_AUTH_TOKEN dalam jendela PowerShell, yang hanya berlaku untuk jendela tersebut, atau export dalam ~/.zshrc atau ~/.bashrc. Jangan pernah menaruhnya di .claude/settings.json milik proyek, karena file tersebut masuk ke commit repositori. Jika shell dan file pengaturan memiliki variabel yang sama, file tersebut yang berlaku. Kunavo menerima key baik dalam ANTHROPIC_AUTH_TOKEN (header Authorization: Bearer, langsung berlaku) maupun ANTHROPIC_API_KEY (header x-api-key, yang dalam mode interaktif meminta persetujuan satu kali); panduan ini menggunakan ANTHROPIC_AUTH_TOKEN. ANTHROPIC_BASE_URL hanya berisi domain, https://api.kunavo.com, tanpa /v1.

Mengapa /model sonnet menghasilkan error 404?

Karena alias sonnet Claude Code meminta Sonnet 5.5, yang tidak disediakan Kunavo. Menurut dokumentasi konfigurasi model (dibaca pada 3 Oktober 2026), bagi pengguna API Anthropic, alias mengikuti model terbaru: opus mengarah ke Opus 5.5 dan sonnet ke Sonnet 5.5. Dengan ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5, serta ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, dan ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5, setiap permintaan menggunakan model yang disediakan Kunavo, termasuk subagen dan langkah eksekusi opusplan. Opus 5.5 memerlukan Claude Code v2.1.280 atau yang lebih baru (perbarui dengan claude update). Error 404 umum lainnya adalah ANTHROPIC_BASE_URL yang diakhiri /v1, sehingga menghasilkan /v1/v1/messages.

Bagaimana saya tahu apakah Claude Code menggunakan key, bukan langganan?

Ketik /status di Claude Code. Pada tab Status, baris Anthropic base URL harus menampilkan https://api.kunavo.com dan baris Auth token harus menunjukkan ANTHROPIC_AUTH_TOKEN. Jika Login method menampilkan akun claude.ai, variabel tersebut tidak terbaca dan sesi menggunakan langganan. Jika Claude Code meminta login segera setelah dimulai, tidak ada key yang terbaca.

Bisakah saya membayar Claude Code dengan MB WAY?

Saldo API Kunavo bisa: MB WAY tersedia di checkout Stripe ketika checkout menampilkan jumlah dalam euro. Pilih MB WAY, masukkan nomor ponsel, lalu konfirmasikan pembelian di aplikasi MB WAY. Menurut Stripe, setiap pembayaran MB WAY berkisar dari 0,50 € hingga 5000 €, dan batas harian default sebesar 1000 € dapat dinaikkan hingga 10.000 € di aplikasi. Konversi dolar ke euro mencakup komisi 2–4%, pengisian minimum adalah US$ 10, dan tidak ada biaya bulanan. MB WAY hanya dapat digunakan untuk pengisian manual: pengisian otomatis memerlukan kartu tersimpan atau Link. Referensi Multibanco, PayPal, dan debit langsung SEPA tidak tersedia, dan Kunavo tidak menerbitkan faktur. Checkout Kunavo tidak membayar langganan Claude Pro atau Max; langganan tersebut, yang dibeli di situs Claude, hanya dapat dibayar dengan kartu kredit atau debit.