Singkatnya: instal Claude Code dengan satu baris di terminal, tanpa Node.js dan tanpa hak administrator. Baris yang digunakan hanya bergantung pada jendela: curl -fsSL https://claude.ai/install.sh | bash di macOS, Linux, dan WSL; irm https://claude.ai/install.ps1 | iex di Windows PowerShell; baris ketiga di bawah ini pada Command Prompt (CMD). Jika tidak memiliki langganan Claude, hubungkan Claude Code ke Kunavo melalui kunci API: ANTHROPIC_BASE_URL=https://api.kunavo.com (tanpa /v1), ANTHROPIC_AUTH_TOKEN, dan empat variabel model. Periksa apakah konfigurasi tersebut berlaku dengan /status. Pembayaran dilakukan per token dari saldo mulai $10, yang dapat diisi melalui kartu debit atau kredit (termasuk Visa Debit dan Debit Mastercard), Apple Pay, Google Pay, Link, atau EPS di Austria. PayPal dan debit langsung SEPA tidak tersedia.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdAnthropic menyediakan seluruh dokumentasi Claude Code dalam bahasa Jerman, jadi panduan ini merujuk ke halaman berbahasa Jerman. Perintah di atas dicocokkan pada 3 Oktober 2026 dengan Menyiapkan Claude Code, dan variabelnya dengan daftar variabel lingkungan. Harga dan metode pembayaran Kunavo berlaku per 10 Oktober 2026. Jerman, Austria, dan Swiss tercantum dalam daftar negara Anthropic untuk Claude.ai maupun API (per 3 Oktober 2026). Versi bahasa Inggris tersedia di Memasang Claude Code.
Alur secara ringkas
- Instalasi: jalankan baris yang sesuai di atas, lalu buka jendela terminal baru.
- Periksa:
claude --versionmenampilkan nomor versi. - Tentukan: masuk dengan langganan Claude atau gunakan kunci API (perbandingan di bawah).
- Dengan kunci API: isi saldo, buat kunci, dan tetapkan enam variabel lingkungan.
- Periksa: masukkan
/statusdalam sesi.
Prasyarat: yang berlaku saat ini
Beberapa panduan berbahasa Jerman menjelaskan versi Claude Code yang lebih lama. Tabel ini membandingkan informasi yang umum beredar dengan persyaratan di halaman penyiapan resmi per 3 Oktober 2026.
| Topik | Bacaan lanjutan yang sering diperlukan | Menurut Anthropic |
|---|---|---|
| macOS | macOS 10.15 atau lebih baru | macOS 13.0 atau lebih baru |
| Windows | hanya melalui WSL | secara native di Windows 10 mulai 1809 atau Windows Server 2019; WSL adalah opsi, bukan keharusan |
| Hak akses | jalankan PowerShell sebagai administrator | tidak diperlukan |
| Node.js | Node.js 18 atau lebih baru | hanya untuk instalasi npm, lalu versi 22 atau lebih baru |
| npm | usang | tetap merupakan metode yang didokumentasikan; installer native direkomendasikan |
| Linux | — | Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ |
| Komputer dan shell | — | minimal 4 GB RAM, x64 atau ARM64, bukan Windows 32-bit; Bash, Zsh, PowerShell, atau CMD |
| Lokasi | — | negara yang didukung Anthropic; Jerman, Austria, dan Swiss termasuk di dalamnya |
| Akun | — | untuk masuk: Pro, Max, Team, Enterprise, atau Console; dengan kunci API, tidak diperlukan langganan maupun login |
Menginstal di macOS, Linux, dan WSL
Masukkan baris dengan install.sh di terminal. Dalam dokumentasi resmi, metode ini tercantum pada tab “Native Installation (Recommended)”. Skrip menempatkan starter di ~/.local/bin/claude, lalu instalasi akan memperbarui dirinya sendiri di latar belakang. Di WSL, gunakan baris yang sama dan jalankan di terminal WSL.
Menginstal Claude Code di Windows
Di Windows, jendela yang terbuka menentukan baris mana yang berfungsi, dan Anda cukup melihat baris perintah: PS C:\Users\Name> adalah PowerShell, sedangkan C:\Users\Name> tanpa PS adalah Command Prompt (CMD). Menurut halaman penyiapan, kedua cara tersebut tidak memerlukan hak administrator. Installer menempatkan claude.exe di %USERPROFILE%\.local\bin.
Jika salah memilih jendela, Anda akan menerima pesan dalam bahasa Inggris, atau dalam keadaan tertentu pesan berbahasa Jerman pada Windows berbahasa Jerman. Baris CMD di PowerShell berakhir dengan The token '&&' is not a valid statement separator, sedangkan baris PowerShell di CMD berakhir dengan 'irm' is not recognized as an internal or external command. Keduanya memiliki arti yang sama: jendela yang salah, jadi gunakan baris lainnya.
Abaikan entri “Windows PowerShell (x86)” di menu Start. Menurut pemecahan masalah, entri tersebut menjalankan proses 32-bit, sehingga installer akan berhenti dengan pesan Claude Code does not support 32-bit Windows bahkan pada PC 64-bit. Jika [Environment]::Is64BitOperatingSystem menampilkan True di jendela ini, Windows Anda siap, dan Anda cukup membuka “Windows PowerShell” tanpa embel-embel tersebut.
Anda tidak perlu memasang Git untuk Windows. Jika tersedia, Claude Code menjalankan perintah shell di Git Bash; jika tidak, Claude Code menggunakannya di PowerShell. Jika Claude Code tidak menemukan Git Bash yang terpasang, masukkan jalur ke bash.exe sebagai CLAUDE_CODE_GIT_BASH_PATH di blok env pada ~/.claude/settings.json. Untuk instalasi standar, jalurnya adalah C:\Program Files\Git\bin\bash.exe.
Memilih native atau WSL bergantung pada lokasi proyek Anda:
| Varian | Prasyarat | Sandbox | Sesuai jika |
|---|---|---|---|
| Windows native | tidak ada; Git untuk Windows opsional | tidak | proyek dan alat Anda sendiri berjalan di Windows |
| WSL 2 | WSL 2 diaktifkan | ya | Anda memerlukan alat Linux atau ingin menjalankan perintah dalam sandbox |
| WSL 1 | WSL 1 diaktifkan | tidak | WSL 2 tidak tersedia di komputer |
Dengan WSL, instal dan jalankan claude di terminal WSL, bukan di PowerShell atau CMD.
Alternatif: Homebrew, WinGet, dan npm
Jika lebih suka mengelola perangkat lunak melalui pengelola paket, Anda dapat melakukannya, dengan satu catatan: menurut dokumentasi, instalasi Homebrew dan WinGet tidak diperbarui secara otomatis, jadi Anda harus menjalankan upgrade secara berkala. Homebrew menyediakan dua Cask. claude-code mengikuti kanal stabil, yang tertinggal sekitar satu minggu dan melewati versi dengan regresi besar; claude-code@latest mendapatkan setiap versi segera.
# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code # aktualisiert sich nicht von selbst
# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode # aktualisiert sich nicht von selbstTentang npm
npm tetap merupakan metode yang dijelaskan secara resmi. Prasyaratnya adalah Node.js 22 atau lebih baru. Paket npm memuat biner native yang sama seperti installer dan sama sekali tidak memerlukan Node.js saat runtime. Karena itu, instalasi dengan Node.js yang lebih lama tidak berhenti; npm hanya menampilkan peringatan EBADENGINE. Jika belum memiliki Node.js, installer native adalah cara yang lebih singkat.
node -v # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code # niemals mit sudo
# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latestTiga aturan dari halaman penyiapan: jangan gunakan sudo npm install -g, karena dapat menimbulkan masalah izin dan risiko keamanan. Lakukan pembaruan dengan @latest, karena npm update -g tetap berada di rentang versi semula. Jangan nonaktifkan dependensi opsional: biner disertakan sebagai dependensi opsional khusus platform, dan jika --omit=optional atau optional=false digunakan di .npmrc, biner tersebut tidak akan tersedia; claude akan menampilkan Error: claude native binary not installed. di macOS dan Linux.
Memeriksa instalasi
Untuk itu, buka jendela terminal baru. Jendela yang sudah terbuka sebelum instalasi belum mengetahui PATH yang diperbarui, sehingga tidak dapat menemukan claude.
claude --version # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor # Diagnose von Installation und Einstellungen, startet keine Sitzungclaude doctor adalah alat yang digunakan ketika ada sesuatu yang tidak beres. Alat ini tidak memulai sesi, tetapi mencantumkan status instalasi, kesalahan dalam file konfigurasi, dan peringatan beserta saran penyelesaiannya. Dengan demikian, Anda dapat mengetahui apakah masalahnya terletak pada instalasi atau konfigurasi.
Jika instalasi bermasalah
Unduhan menghasilkan HTML atau 403
Jika keluaran diawali dengan syntax error near unexpected token '<' atau curl melaporkan 403, menurut pemecahan masalah (per 3 Oktober 2026), yang diterima alih-alih skrip adalah halaman web atau status kesalahan. Jika halaman tersebut menampilkan App unavailable in region, Anthropic menganggap koneksi berasal dari negara yang tidak didukung. Jika Anda berada di Jerman, Austria, atau Swiss, ini menandakan titik keluar VPN atau proksi berada di luar negeri. Kesalahan 403 tanpa teks dapat memiliki penyebab yang sama atau berasal dari firewall perusahaan. Dokumentasi menyarankan untuk memeriksa koneksi jaringan terlebih dahulu, karena metode instalasi lainnya mengakses server yang sama. Menggunakan jaringan lain atau meminta tim TI membuka akses akan lebih membantu daripada mencoba installer lain.
“claude” tidak ditemukan
command not found: claude di macOS dan Linux, atau claude yang tidak dikenali di Windows, berarti folder instalasi tidak ada dalam PATH. Biasanya cukup membuka jendela baru. Jika tidak membantu di macOS atau Linux, tambahkan ~/.local/bin ke ~/.zshrc atau ~/.bashrc. Di Windows, periksa dan tambahkan folder tersebut seperti yang ditunjukkan dalam pemecahan masalah:
# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Im neuen Fenster
claude --versionPowerShell memblokir npm.ps1
Ini hanya berlaku untuk varian npm. Pesan npm.ps1 cannot be loaded because running scripts is disabled on this system berarti kebijakan eksekusi memblokir skrip startup npm. Anda dapat memanggil npm.cmd dan claude.cmd, yang tidak tercakup oleh kebijakan tersebut, beralih ke installer native, atau mengizinkan skrip lokal untuk akun pengguna Anda:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserLangganan atau kunci API?
Saat pertama kali dijalankan, Claude Code akan menanyakan siapa yang membayar. Anda dapat masuk dengan akun Claude atau memberikan kunci API melalui variabel lingkungan. Jika kunci sudah ditetapkan, menurut panduan gateway, kunci tersebut akan diprioritaskan: sesi masuk yang tersimpan tetap tidak digunakan dan akan berlaku lagi setelah variabel dihapus. Anda tidak perlu memasang ulang untuk beralih.
| Langganan Claude | Kunci API dari Kunavo | |
|---|---|---|
| Penagihan | Bulanan: Pro seharga $20 atau $17 per bulan jika dibayar tahunan ($200 di muka), Max mulai dari $100, masing-masing belum termasuk pajak yang berlaku (claude.com/de/pricing, per 3 Oktober 2026) | per token dari saldo prabayar, pengisian mulai $10, tanpa biaya bulanan dan tanpa kedaluwarsa |
| Cocok untuk | penggunaan harian selama berjam-jam | penggunaan yang berubah-ubah; satu bulan tanpa penggunaan tidak dikenai biaya |
| Pembayaran | Di web, hanya kartu kredit atau debit; di aplikasi iOS dan Android, pembayaran melalui App Store atau Google Play (FAQ penagihan Anthropic, per 3 Oktober 2026) | Kartu debit dan kredit (Visa, Mastercard), Apple Pay, Google Pay, Link; EPS di Austria |
| Penyiapan | jalankan claude dan masuk melalui browser | enam variabel lingkungan, tanpa login |
| Tidak termasuk | — | Remote Control dan dikte suara |
Panduan harga Claude Code menunjukkan kapan Pro atau Max mulai lebih hemat dibandingkan kunci API.
Menyiapkan kunci API (tanpa langganan)
Claude Code yang menghubungi titik akhir lain bukanlah trik. ANTHROPIC_BASE_URL tercantum dalam daftar variabel Anthropic dan memang dirancang untuk merutekan permintaan melalui proksi atau gateway. Anda tidak memerlukan plugin atau versi Claude Code yang dimodifikasi.
- Daftar ke Kunavo menggunakan alamat email atau akun Google.
- Di Billing, isi saldo minimal $10 (metode pembayaran pada bagian Pembayaran).
- Di API-Keys, buat sebuah kunci. Kunci tersebut diawali
sk-kn-dan hanya terlihat sekali, jadi segera salin. - Tetapkan variabel seperti yang ditunjukkan di bawah.
Jika ditambahkan ke ~/.zshrc atau ~/.bashrc, nilainya berlaku untuk setiap terminal baru di macOS, Linux, dan WSL:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # nur die Domain, ohne /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 PowerShell, penetapan $env: hanya berlaku untuk jendela yang terbuka, cocok untuk percobaan pertama:
# Gilt nur für dieses PowerShell-Fenster
$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 jangka panjang, masukkan nilainya ke blok env dalam ~/.claude/settings.json (di Windows, %USERPROFILE%\.claude\settings.json). Menurut panduan gateway (per 3 Oktober 2026), berkas ini berlaku untuk semua proyek Anda. Jika berkas tersebut sudah ada, cukup tambahkan 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"
}
}Ekstensi VS Code membaca variabel dari claudeCode.environmentVariables di pengaturan pengguna VS Code (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" }
]
}Fungsi setiap variabel
| Variabel | Nilai | Dampak | Jika tidak ada atau salah |
|---|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | mengarahkan semua permintaan ke Kunavo; Claude Code menambahkan /v1/messages sendiri | Dengan /v1 di akhir, permintaan diarahkan ke /v1/v1/messages dan gagal dengan 404. |
ANTHROPIC_AUTH_TOKEN | Kunci Anda (sk-kn-…) | dikirim sebagai Authorization: Bearer dan langsung memiliki prioritas | Jika Anda menetapkan ANTHROPIC_API_KEY sebagai gantinya (header x-api-key), Anda harus mengonfirmasi kunci sekali dalam mode interaktif. Jika ditolak, Claude Code mengabaikan kunci tersebut tanpa bertanya lagi; Anda dapat mengaktifkannya kembali melalui /config → Use custom API key. Kunavo menerima kunci pada kedua header. |
ANTHROPIC_MODEL | claude-sonnet-5 | Model awal setiap sesi | Tanpa variabel ini, sesi dimulai dengan model dari pin Opus, yaitu Opus 5.5; jika pin tersebut juga tidak ada, sesi menggunakan default Anthropic (saat ini juga Opus 5.5). |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 | Target /model opus dan versi yang digunakan default tanpa ANTHROPIC_MODEL | Tanpa variabel ini, alias mengikuti default Anthropic, saat ini juga Opus 5.5; begitu Opus yang lebih baru dirilis, alias tersebut mungkin mengarah ke model yang belum ditawarkan Kunavo. Opus 5.5 memerlukan Claude Code versi 2.1.280 atau lebih baru; versi lama diperbarui dengan claude update. |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 | Target /model sonnet, fase eksekusi opusplan, dan subagent dengan model: sonnet | Tanpa variabel ini, alias untuk pengguna API mengarah ke Sonnet 5.5, yang saat ini tidak ditawarkan Kunavo (per 3 Oktober 2026): 404. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | Target /model haiku dan model untuk fungsi latar belakang | Tanpa pengaturan ini, alias mengarah ke Haiku 5.5 mulai Claude Code 2.1.293, dan sebelumnya ke ID Haiku 4.5 yang disertai tanggal; Kunavo tidak mengenali keduanya: 404. |
Mengapa menetapkan model awal? Menurut konfigurasi model (per 3 Oktober 2026), Opus 5.5 adalah model default bagi pengguna API, dan alias akan dialihkan ke versi baru seiring waktu. Kunavo menawarkan Opus 5.5; jadi, jika variabel model tidak ditetapkan, yang digunakan di sini adalah Opus 5.5, yaitu biaya per tokennya dua kali lipat dibandingkan Claude Sonnet 5. Dengan nama model yang ditetapkan secara eksplisit, Anda tahu model mana yang menjawab dan tarif yang berlaku. Pin Opus mempertahankan alias opus pada Claude Opus 5.5 (claude-opus-5-5), meskipun Anthropic kemudian mengalihkannya ke Opus yang lebih baru. Harga Opus 5.5 per token di Kunavo adalah lebih rendah daripada Claude Opus 5 ($2,80 / $14,00 dibandingkan dengan $3,50 / $17,50 per 1 juta token input/output), dan memerlukan Claude Code versi 2.1.280 atau lebih baru; instalasi lama dapat diperbarui dengan claude update. Pin Sonnet wajib digunakan: bagi pengguna API, alias sonnet mengarah ke Sonnet 5.5, yang tidak ditawarkan Kunavo, dan tanpa ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, fase eksekusi opusplan, serta subagen dengan model: sonnet akan berakhir dengan kesalahan 404. Claude Haiku 4.5 menjaga biaya tugas latar belakang tetap rendah, dan Anda dapat beralih kapan saja selama sesi dengan /model.
Ada dua hal tentang penyimpanan. Kunci jangan pernah diletakkan di .claude/settings.json suatu proyek, karena menurut panduan gateway, file ini di-commit dan akan tersedia bagi siapa pun yang mengkloning repositori. Jika ekspor shell dan blok env menetapkan variabel yang sama, file konfigurasi yang berlaku. Jadi, jika Anda mengubah variabel di shell tetapi tidak terjadi apa-apa, kemungkinan nilai lama masih berada di settings.json.
Perbandingan model, harga Kunavo dari katalog, harga daftar Anthropic menurut claude.com/de/pricing (per 3 Oktober 2026), masing-masing per 1 juta token:
| Model | Kunavo (Input / Output) | Harga daftar Anthropic (Input / Output) | Perbedaan | Peran dalam Claude Code |
|---|---|---|---|---|
claude-haiku-4-5 | $0,70 / $3,50 | $1,00 / $5,00 | ~30% lebih murah | Alias haiku dan tugas latar belakang Claude Code |
claude-sonnet-5 | $1,40 / $7,00 | $2,00 / $10,00 | ~30% lebih murah | Model utama (ANTHROPIC_MODEL) untuk pekerjaan sehari-hari |
claude-opus-5-5 | $2,80 / $14,00 | $4,00 / $20,00 | ~30% lebih murah | Alias opus dengan pin di atas (refaktor besar, perencanaan); tanpa pin, default untuk pengguna API |
claude-opus-5 | $3,50 / $17,50 | $5,00 / $25,00 | ~30% lebih murah | Tidak ada alias; gunakan secara khusus dengan /model claude-opus-5 |
Semua model dan tarif Claude tercantum dalam panduan harga Claude API dan di halaman harga.
Memulai pertama kali: periksa dengan /status
Buka folder proyek Anda dan jalankan claude. Jika ANTHROPIC_AUTH_TOKEN sudah ditetapkan, Anda akan langsung masuk ke sesi tanpa layar masuk. Jika layar masuk tetap muncul, Claude Code tidak menemukan kunci. Menurut panduan gateway, alasan yang paling umum adalah kunci hanya tercantum di .claude/settings.json atau .claude/settings.local.json proyek. Claude Code baru membaca blok env semacam itu dalam sesi interaktif setelah asisten penyiapan selesai dan Anda menjawab pertanyaan apakah folder tersebut tepercaya. Karena itu, tetapkan kunci di shell (export) atau di ~/.claude/settings.json.
Dalam sesi, /status pada tab Status menunjukkan dari mana Claude Code mendapatkan alamat dan kredensial. Dua baris sangat penting:
| Baris | Benar | Jika tidak |
|---|---|---|
Anthropic base URL | https://api.kunavo.com | Baris ini hanya muncul jika alamat gateway telah ditetapkan. Jika tidak ada, ANTHROPIC_BASE_URL belum masuk ke sesi. |
Auth token | menyebutkan ANTHROPIC_AUTH_TOKEN | Jika yang muncul adalah Login method dengan akun claude.ai, variabel tersebut tidak terbaca dan sesi berjalan menggunakan langganan Anda. |
Koneksi juga dapat diuji tanpa Claude Code menggunakan permintaan dari panduan gateway (model di sini ditetapkan ke claude-sonnet-5). Permintaan ini hanya meminta satu token output, sehingga biayanya sangat kecil. Perintah membaca variabel shell; jika nilai Anda hanya berada di settings.json, ekspor juga nilai tersebut untuk pengujian.
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": "."}]}'Jika JSON yang dikembalikan dimulai dengan {"id":"msg_, atau di PowerShell berupa objek dengan id yang dimulai dengan msg_, alamat dan kunci sudah benar. 401 berarti kunci ditolak.
Perubahan saat menggunakan kunci API
Sebagian besar tetap sama: pengeditan kode, alat, subagent, server MCP, hook, dan caching prompt berfungsi seperti biasa. Anda perlu mengetahui empat perbedaan:
- Remote Control dan dikte suara tidak tersedia. Menurut panduan gateway, keduanya memerlukan identitas claude.ai dan dinonaktifkan selama
ANTHROPIC_AUTH_TOKENatauANTHROPIC_API_KEYaktif. Sejak versi 2.1.196, Remote Control juga dinonaktifkan jikaANTHROPIC_BASE_URLmengarah ke host di luar Anthropic. /fastmelaporkan bahwa Fast Mode tidak tersedia. Dengan hanya token Bearer, Claude Code memperlakukannya sebagai nonaktif dan bahkan tidak mengirim pemeriksaan ketersediaan.- Pencarian alat untuk MCP dinonaktifkan. Menurut dokumentasi MCP (per 3 Oktober 2026), Claude Code menonaktifkannya saat
ANTHROPIC_BASE_URLmengarah ke penyedia pihak ketiga; Anda dapat mengaktifkannya secara eksplisit denganENABLE_TOOL_SEARCH. /contextmenampilkan perkiraan. Kunavo tidak menyediakan/v1/messages/count_tokens. Tanpa titik akhir ini, menurut panduan kompatibilitas gateway (per 3 Oktober 2026), Claude Code menghitung berdasarkan karakter.
Informasi lebih lanjut tentang integrasi tersedia dalam panduan integrasi Claude Code (dalam bahasa Inggris).
Membayar tanpa PayPal dan SEPA
Sebelumnya, perlu dijelaskan: Kunavo tidak menjual langganan Claude, melainkan saldo untuk akses API, dan Claude Code mengurangi saldo tersebut berdasarkan penggunaan token. Untuk Pro dan Max dari Anthropic, pembayaran di web hanya dapat dilakukan dengan kartu kredit atau debit; di aplikasi, pembayaran ditagihkan melalui App Store atau Google Play (FAQ penagihan). Menurut artikel bantuan tentang kartu yang ditolak, Anthropic tidak menerima PayPal atau Venmo (keduanya per 3 Oktober 2026).
Kunavo mengisi saldo melalui checkout Stripe. Harga ditetapkan dalam dolar AS; pembeli yang membayar dari Jerman atau Austria akan melihat jumlahnya dalam euro. Menurut dokumentasi Stripe tentang Adaptive Pricing (per 3 Oktober 2026), kurs ini mencakup biaya konversi 2–4% yang ditanggung pembeli. Pilih dolar AS saat checkout untuk menghindari biaya ini; bank Anda kemudian akan mengonversi dengan kursnya sendiri dan mungkin mengenakan biaya tambahan. Checkout menyediakan:
| Metode pembayaran | Di mana | Catatan |
|---|---|---|
| Kartu (Visa, Mastercard, Amex, JCB, UnionPay) | di mana saja | Kartu kredit dan debit, termasuk Visa Debit dan Debit Mastercard; kartu girocard murni tidak |
| Apple Pay | Safari serta iPhone dan iPad; tidak tersedia di India | dengan kartu di Wallet, termasuk kartu debit Visa atau Mastercard; kartu girocard murni tidak didukung |
| Google Pay | Chrome dan Android dengan Google Pay yang telah disiapkan; tidak tersedia di India | dengan kartu di Wallet, termasuk kartu debit Visa atau Mastercard; kartu girocard murni tidak didukung |
| Link | di mana saja kecuali India | Layanan pembayaran Stripe, menyimpan kartu Anda; pengisian otomatis juga dapat dilakukan dengan layanan ini |
| EPS | Austria, checkout dalam euro | Pengalihan ke perbankan online bank Anda |
Menurut Stripe, EPS adalah metode pembayaran Austria yang didukung oleh semua bank Austria. Anda akan diarahkan ke situs bank Anda untuk melakukan konfirmasi; metode ini hanya berfungsi untuk pembayaran dalam euro. Pembeli dari Swiss dapat menggunakan kartu, Apple Pay, Google Pay, atau Link.
girocard: Kartu yang hanya mendukung girocard (sebelumnya kartu EC) tidak diterima di checkout Kunavo, karena Stripe tidak mencantumkan girocard sebagai salah satu merek kartu yang didukungnya (per 3 Oktober 2026). Jika kartu Anda juga memiliki logo Visa atau Mastercard, pembayaran diproses melalui jaringan tersebut, termasuk saat menggunakan Apple Pay dan Google Pay.
Tidak tersedia: PayPal, debit langsung SEPA, transfer manual (pembayaran di muka), giropay, dan Sofort. Checkout Klarna hanya menawarkannya kepada pembeli di AS; jika Anda berada di luar AS dan beralih ke dolar AS, Klarna tetap tidak akan muncul.
- Buat akun; Kunavo tidak meminta kartu saat pendaftaran.
- Di Billing, pilih tingkat pengisian mulai $10. Tingkat yang lebih besar memberikan saldo bonus: $100 menjadi $110, $1.000 menjadi $1.200, dan $5.000 menjadi $6.250.
- Pilih metode pembayaran di checkout Stripe. Jumlah dalam euro ditampilkan sebelum konfirmasi; dengan EPS, konfirmasikan pembayaran di perbankan online.
- Di API-Keys, buat kunci dan masukkan sebagai
ANTHROPIC_AUTH_TOKEN.
Saldo dibayar di muka: tanpa biaya bulanan, tanpa kedaluwarsa, dan permintaan yang gagal tidak dikenai biaya. Pengisian otomatis hanya dapat dilakukan dengan kartu atau Link yang tersimpan; dengan Apple Pay, Google Pay, dan EPS, Anda harus mengisi saldo secara manual. Kunavo tidak menerbitkan faktur yang mencantumkan PPN; Anda dapat melihat pengisian saldo di Billing. Informasi lebih lanjut tentang metode pembayaran dan kartu yang ditolak: membayar Claude tanpa kartu kredit.
Biaya sebuah sesi: contoh perhitungan
Dengan kunci API, Anda membayar token, dan Claude Code mengirimkan seluruh konteks sebelumnya pada setiap langkah. Namun, konteks tersebut tidak sepenuhnya ditagihkan setiap kali: model membaca bagian awal yang tidak berubah dari cache, dan tarif pembacaan cache yang lebih rendah berlaku untuk bagian tersebut. Tabel ini menghitung contoh pola yang diasumsikan; tabel ini bukan pengukuran maupun batas atas. Asumsi:
- 40.000 token input per permintaan, yang terdiri dari 36.000 (90%) dibaca dari cache dan 4.000 baru ditulis ke cache;
- 1.000 token output per permintaan;
- 50 permintaan semacam itu per sesi kerja, tidak termasuk panggilan latar belakang;
- Pembacaan cache dikenai biaya sebesar 10 % dari tarif input pada Claude Sonnet 5, sedangkan penulisan cache dikenai biaya 1,25 kali lipat; setiap model dalam tabel dihitung dengan faktornya sendiri.
| Model | Satu permintaan | 50 permintaan | 50 permintaan tanpa satu pun cache hit |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,952 | $3,15 |
| Claude Opus 5 | $0,0476 | $2,38 | $7,88 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
Jumlah yang benar-benar Anda bayar bergantung pada panjang konteks, cache hit, dan panjang jawaban, serta apakah Anda memulai ulang dengan /clear di antara dua tugas. Untuk angka Anda sendiri, gunakan kalkulator token Claude (dalam bahasa Inggris); perbandingan dengan Pro dan Max dihitung dalam panduan harga Claude Code.
Pesan kesalahan dan artinya
| Pesan | Arti dan solusi |
|---|---|
The token '&&' is not a valid statement separator | Baris CMD berada di jendela PowerShell. Gunakan irm … | iex di sana. |
'irm' is not recognized as an internal or external command (atau pesan yang sama dalam bahasa Jerman) | Baris PowerShell berada di CMD. Gunakan baris dengan install.cmd di sana. |
Claude Code does not support 32-bit Windows | Yang terbuka adalah “Windows PowerShell (x86)”. Pilih entri tanpa (x86). |
syntax error near unexpected token '<' atau 403 | Alih-alih skrip, yang diterima adalah halaman web atau kode kesalahan. Periksa VPN, proxy, dan firewall perusahaan, atau coba jaringan lain. |
App unavailable in region | Koneksi tampaknya berasal dari negara yang tidak didukung. Di DE, AT, dan CH, penyebabnya biasanya VPN atau proxy. |
command not found: claude atau claude tidak dikenali | Folder instalasi tidak ada dalam PATH. Buka jendela baru; di Windows, gunakan perintah PATH di atas. |
Peringatan EBADENGINE | Node.js lebih lama dari 22. Instalasi tetap selesai; meskipun demikian, sebaiknya lakukan pembaruan. |
claude native binary not installed (macOS, Linux) | npm melewati dependensi opsional (--omit=optional, optional=false). Hapus pengaturan tersebut dan instal ulang. |
npm.ps1 cannot be loaded | Kebijakan eksekusi memblokir npm. Gunakan npm.cmd, jalankan baris Set-ExecutionPolicy, atau gunakan installer native. |
| Layar login muncul meskipun kunci sudah ditetapkan | Kunci hanya berada di pengaturan proyek. Tetapkan melalui export atau di ~/.claude/settings.json, lalu buka terminal baru. |
ANTHROPIC_API_KEY ditetapkan, tetapi tidak berpengaruh | Konfirmasi satu kali ditolak. Aktifkan melalui /config → Use custom API key atau beralih ke ANTHROPIC_AUTH_TOKEN. |
401 | Kunci ditolak. Apakah kunci disalin lengkap tanpa spasi, masih ada di /app/keys, dan dimasukkan ke ANTHROPIC_AUTH_TOKEN? |
404 | ANTHROPIC_BASE_URL berakhir dengan /v1, atau model yang diminta tidak tersedia di Kunavo, misalnya setelah /model sonnet tanpa pin Sonnet. |
Batasan metode ini
- Pembayaran dilakukan per token, bukan secara tetap. Jika menggunakan Claude Code selama berjam-jam setiap hari, Pro atau Max sering kali lebih murah. Dengan penggunaan yang berubah-ubah, Anda hanya membayar sesuai pemakaian, dan satu bulan tanpa penggunaan tidak dikenai biaya.
- Tanpa akun claude.ai, Remote Control dan dikte suara tidak tersedia;
/fastdianggap nonaktif, dan pencarian alat untuk MCP dinonaktifkan secara default. - Sonnet 5.5 saat ini tidak ditawarkan Kunavo; karena itu,
/model sonnet,opusplan, dan subagent Sonnet memerlukan pin Sonnet dari contoh di atas. - Apple Pay, Google Pay, dan EPS hanya dapat digunakan untuk pengisian manual; pengisian otomatis hanya tersedia dengan kartu atau Link. Jumlah dalam euro mencakup biaya konversi Stripe.
- Kunavo tidak menerbitkan faktur yang mencantumkan PPN.
- Dokumentasi Claude Code Anthropic tersedia dalam bahasa Jerman, sedangkan panduan integrasi Kunavo hanya tersedia dalam bahasa Inggris.
Pertanyaan umum
Bagaimana proses instalasi Claude Code?
Anda membuka terminal dan menjalankan perintah resmi untuk sistem Anda. Di macOS, Linux, dan WSL: curl -fsSL https://claude.ai/install.sh | bash. Di Windows 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. Setelah itu, buka jendela terminal baru dan masukkan claude --version. Jika nomor versi muncul, Claude Code telah terinstal. Instalasi native ini memperbarui dirinya sendiri di latar belakang; instalasi melalui Homebrew atau WinGet harus Anda perbarui sendiri.
Menginstal Claude Code di Windows: apakah saya memerlukan WSL atau hak administrator?
Tidak keduanya. Claude Code berjalan secara native di Windows 10 mulai versi 1809 dan Windows Server 2019, dan menurut Anthropic penginstal tidak perlu dijalankan sebagai administrator. WSL 2 hanya berguna jika Anda memerlukan alat Linux atau sandboxing; dalam hal itu, instal dan jalankan Claude Code di terminal WSL. Git untuk Windows opsional: dengan Git, Claude Code menjalankan perintah di Git Bash, tanpa Git di PowerShell. Kesalahan umum adalah baris CMD ditempelkan di jendela PowerShell (atau sebaliknya) dan entri menu Start “Windows PowerShell (x86)”, yang berhenti sebagai proses 32-bit.
Apakah saya memerlukan Node.js untuk Claude Code?
Hanya jika Anda menginstal melalui npm, dan dalam hal itu Node.js 22 atau yang lebih baru. Panduan lama sering menyebut Node.js 18, tetapi itu sudah usang. Penginstal native, Homebrew, dan WinGet tidak memerlukan Node.js sama sekali. Jika Node.js Anda terlalu lama, npm akan memperingatkan dengan EBADENGINE, tetapi tetap menginstal. Jangan pernah menginstal dengan sudo, dan perbarui dengan npm install -g @anthropic-ai/claude-code@latest, bukan dengan npm update -g.
Dapatkah saya menggunakan Claude Code tanpa langganan?
Ya, dengan kunci API. Untuk login, Anda memerlukan Pro, Max, Team, Enterprise, atau akun Console; paket Claude gratis tidak mencakup Claude Code. Dengan Kunavo, tetapkan ANTHROPIC_BASE_URL=https://api.kunavo.com dan ANTHROPIC_AUTH_TOKEN sebagai gantinya, lalu Claude Code akan dimulai tanpa layar login. Setiap token dipotong dari saldo prabayar yang dapat Anda isi mulai dari $10; tidak ada biaya bulanan. Anda tidak dapat menggunakan Remote Control dan dikte suara, karena keduanya memerlukan akun claude.ai.
Bagaimana cara menyiapkan kunci API di Claude Code?
Sebaiknya di blok env pada ~/.claude/settings.json (di Windows %USERPROFILE%\.claude\settings.json), atau sebagai baris export di ~/.zshrc atau ~/.bashrc. Anda memerlukan enam nilai: ANTHROPIC_BASE_URL=https://api.kunavo.com tanpa /v1 (jika tidak, permintaan menuju /v1/v1/messages dan gagal dengan 404), ANTHROPIC_AUTH_TOKEN dengan kunci Anda, serta 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. ANTHROPIC_AUTH_TOKEN langsung berlaku. ANTHROPIC_API_KEY juga berfungsi, karena Kunavo menerima kunci di kedua header, tetapi dalam mode interaktif harus dikonfirmasi sekali. Jangan pernah menulis kunci ke .claude/settings.json suatu proyek, karena berkas tersebut dibagikan bersama repositori.
Model apa yang digunakan Claude Code dengan kunci API?
Model yang Anda tetapkan. Tanpa penetapan, menurut Anthropic (per 3 Oktober 2026), Claude Code untuk pengguna API dimulai dengan Opus 5.5. Kunavo menyediakan Opus 5.5, yang biaya per tokennya dua kali lipat dibandingkan Claude Sonnet 5. Dengan ANTHROPIC_MODEL=claude-sonnet-5, Claude Sonnet 5 menjadi model awal; permintaan dari contoh perhitungan di halaman ini biayanya sekitar $0,019. ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 menentukan model yang dijalankan oleh /model opus; Opus 5.5 memerlukan Claude Code versi 2.1.280 atau yang lebih baru, dan instalasi lama dapat diperbarui dengan claude update. ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 juga diperlukan, karena alias sonnet untuk pengguna API menunjuk ke Sonnet 5.5 dan Kunavo tidak menyediakan Sonnet 5.5: tanpa baris ini, /model sonnet, tahap eksekusi opusplan, dan subagent dengan model: sonnet berakhir dengan 404. ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 juga berlaku untuk tugas latar belakang.
Bagaimana cara mengetahui di /status bahwa Claude Code menggunakan kunci API?
Ketik /status dalam sesi yang sedang berjalan, lalu lihat tab Status. Baris Anthropic base URL harus menampilkan https://api.kunavo.com, dan baris Auth token harus menyebut ANTHROPIC_AUTH_TOKEN. Jika baris Base URL tidak ada, variabel tersebut belum mencapai sesi. Jika di sana tertulis Login method dengan akun claude.ai, sesi berjalan melalui langganan Anda. Jika layar login muncul sejak awal, kemungkinan kunci hanya berada di pengaturan proyek, yang baru dievaluasi Claude Code setelah wizard penyiapan.
Dapatkah saya membayar Claude Code dengan PayPal, debit langsung SEPA, girocard, atau EPS?
Untuk saldo Kunavo berlaku ketentuan berikut: EPS tersedia jika Anda membayar dalam euro dari Austria. PayPal dan debit langsung SEPA tidak tersedia, sedangkan Klarna hanya tersedia bagi pembeli di AS. Kartu girocard murni gagal karena Stripe tidak mencantumkan girocard sebagai merek kartu. Jika kartu Anda juga memiliki logo Visa atau Mastercard, Anda dapat membayar melalui jaringan tersebut, termasuk dengan Apple Pay atau Google Pay. Kartu kredit dan debit serta Link juga dapat digunakan. Minimum $10, tidak ada biaya bulanan, dan saldo tidak kedaluwarsa; menurut Stripe, jumlah dalam euro mencakup biaya konversi sebesar 2–4%. Pengisian otomatis hanya dapat dilakukan dengan kartu tersimpan atau Link. Kunavo tidak menerbitkan faktur dengan PPN yang dirinci. Dengan cara ini Anda tidak dapat membayar langganan Claude Pro atau Max; Anthropic sendiri di web hanya menerima kartu dan tidak menerima PayPal.