Cara menginstal Claude Code [Windows dan Mac] — konfigurasi API key tanpa langganan dan pembayaran dengan JCB serta Apple Pay

Instalasi Claude Code hanya memerlukan satu baris native installer resmi. Untuk Mac, Linux, dan WSL gunakan install.sh, untuk Windows gunakan install.ps1 melalui PowerShell atau install.cmd melalui CMD (npm juga dapat digunakan, tetapi memerlukan Node.js 22 atau lebih baru). Biasanya setelah itu Anda login dengan paket seperti Pro atau Max, tetapi jika tidak berlangganan, Anda dapat memulai tanpa login dengan menetapkan ANTHROPIC_BASE_URL=https://api.kunavo.com (jangan menambahkan /v1), ANTHROPIC_AUTH_TOKEN yang berisi kunci API, dan empat variabel untuk mengunci model. Periksa apakah berjalan melalui /status. Saldo API dapat diisi prabayar mulai dari $10 menggunakan kartu seperti JCB, Apple Pay, Google Pay, atau Link, dan layar pembayaran menampilkan jumlah dalam yen.

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

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

:: Windows コマンドプロンプト（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Sumber utama untuk petunjuk instalasi adalah dokumentasi resmi Anthropic yang tersedia dalam bahasa Jepang (Penyiapan, Pemecahan masalah instalasi, diperiksa pada 3 Oktober 2026). Halaman ini tidak sekadar mengulanginya, melainkan berfokus pada hal-hal yang berbeda dalam artikel penjelasan berbahasa Jepang, yaitu versi Node.js, hak administrator Windows, dan Git, serta hal-hal yang tidak dibahas dalam dokumentasi resmi: konfigurasi untuk menggunakan kunci API tanpa login dan pembayaran dari Jepang. Informasi harga dan metode pembayaran berlaku per 10 Oktober 2026. Jepang tercantum dalam daftar negara yang didukung Anthropic, baik untuk Claude.ai maupun API (diperiksa pada 3 Oktober 2026).

Tentukan terlebih dahulu: login dengan langganan atau menjalankan dengan kunci API

Instalasinya sama untuk kedua pilihan; perbedaannya muncul setelah peluncuran pertama. Saat dijalankan, Claude Code meminta autentikasi. Jika ragu, Anda dapat menentukannya berdasarkan tiga hal berikut.

• Sudah berlangganan Pro, Max, Team, atau Enterprise, atau memiliki akun Console: Anda dapat langsung login untuk menggunakannya. Konfigurasi kunci API di halaman ini tidak diperlukan. Paket gratis tidak mencakup Claude Code.
• Anda tidak ingin membayar jumlah tetap setiap bulan dan penggunaan sangat bervariasi. Menjalankan layanan dengan kunci API dan membayar hanya untuk token yang digunakan mungkin lebih sesuai. Sebagai acuan, langganan Claude berharga $20 per bulan untuk Pro ($200 jika dibayar tahunan, setara dengan $17 per bulan) dan mulai dari $100 per bulan untuk Max. Keduanya belum termasuk pajak (halaman harga Claude, diperiksa pada 3 Oktober 2026). Titik impas untuk mengetahui pilihan yang lebih murah dihitung dalam harga Claude Code.
• Ingin menggunakan Remote Control atau input suara: keduanya memerlukan akun claude.ai, sehingga tidak dapat digunakan dengan kunci API. Pilih login.

Metode pembayaran juga berbeda. Langganan yang dibeli melalui situs web Anthropic hanya dapat dibayar dengan kartu kredit atau debit. Jika berlangganan melalui aplikasi iPhone atau Android, pembayaran ditangani oleh App Store atau Google Play (bantuan Anthropic, versi bahasa Inggris, diperiksa pada 3 Oktober 2026). Saldo API Kunavo dapat diisi dengan kartu, termasuk JCB, Apple Pay, Google Pay, atau Link. Detailnya tersedia di bagian pembayaran di bawah.

Pemeriksaan sebelum instalasi

Persyaratannya sesuai dokumentasi resmi (diperiksa 3 Oktober 2026). Kolom di sebelah kanan menunjukkan cara memeriksanya secara lokal.

Metode instalasi

Dokumentasi resmi merekomendasikan native installer. Perbedaan utamanya dengan metode lain adalah cara pembaruannya.

# Homebrew（既定では自動更新されない）
brew install --cask claude-code

# WinGet（Windows・既定では自動更新されない）
winget install Anthropic.ClaudeCode

Apa pun metodenya, setelah selesai buka kembali terminal sebelum memeriksa. Jendela yang sudah terbuka sebelum instalasi mungkin belum memuat PATH baru. claude doctor hanya menampilkan status instalasi dan konfigurasi tanpa memulai sesi, sehingga berguna untuk mengisolasi masalah saat terjadi kegagalan.

claude --version   # 2.1.211 (Claude Code) のようなバージョン番号が出れば OK
claude doctor      # セッションを開かずに、インストールと設定を診断する

Hal yang perlu diperhatikan saat menginstal melalui npm

Artikel penjelasan berbahasa Jepang masih sering menyebut “Node.js 18 atau lebih baru”, tetapi persyaratan dalam dokumentasi resmi adalah Node.js 22 atau lebih baru (dokumentasi resmi, diperiksa pada 3 Oktober 2026). Bahkan dengan Node.js versi lama, npm hanya menampilkan peringatan EBADENGINE dan tidak menghentikan instalasi, lalu claude tetap berjalan. Namun, jika peringatan muncul, lebih aman untuk memperbarui Node.js. Jika Anda menggunakan nvm, Volta, atau alat lain untuk beralih versi, periksa node -v di shell tempat Anda melakukan instalasi.

node -v                                    # v22 以上であること
npm install -g @anthropic-ai/claude-code   # sudo は付けない

# 更新は @latest で（npm update -g は使わない）
npm install -g @anthropic-ai/claude-code@latest

Dokumentasi resmi secara eksplisit melarang penggunaan sudo npm install -g. Selain itu, karena biner utama dipasang sebagai dependensi opsional, jika --omit=optional atau .npmrc menggunakan optional=false untuk menghilangkan dependensi opsional, di Mac dan Linux akan muncul claude native binary not installed dan aplikasi tidak dapat dijalankan.

Hal penting saat menginstal di Windows

Pertama, dua langkah yang sering dijumpai di internet tidak diperlukan. “Jalankan PowerShell sebagai administrator” dan “instal Git for Windows terlebih dahulu” sama-sama bukan persyaratan dalam dokumentasi resmi. Hak administrator tidak diperlukan dan Git for Windows bersifat opsional. Jika Git for Windows belum terpasang, Claude Code akan menjalankan perintah di PowerShell (Penyiapan di Windows, diperiksa pada 3 Oktober 2026).

Sebelum menempelkan perintah, periksa dua hal saja.

1. Apakah yang sedang terbuka adalah PowerShell atau CMD? Jika prompt-nya PS C:\Users\ユーザー名>, gunakan baris irm untuk PowerShell; jika PS tidak ada dan prompt-nya C:\Users\ユーザー名>, gunakan baris install.cmd untuk CMD. Jika tertukar, PowerShell akan menampilkan kesalahan bahwa && tidak dikenali sebagai pemisah, sedangkan CMD akan menampilkan kesalahan bahwa irm tidak dikenali (pada Windows berbahasa Jepang, pesan dapat muncul dalam bahasa Jepang).
2. Apakah Anda membuka “Windows PowerShell (x86)”? Versi (x86) di menu Start menjalankan proses 32 bit, sehingga bahkan pada komputer 64 bit akan berhenti dengan Claude Code does not support 32-bit Windows.

Ada tiga cara menjalankan Claude Code di Windows. Jika ragu, Anda dapat memulai dengan versi native.

Jika Claude Code tidak dapat menemukan Git Bash meskipun Git for Windows telah dipasang, tuliskan lokasi bash.exe ke CLAUDE_CODE_GIT_BASH_PATH dalam file konfigurasi pengguna env.

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Jika claude tidak berjalan setelah instalasi

'claude' is not recognized (di Mac dan Linux, command not found: claude) berarti lokasi instalasi belum masuk ke PATH. Lokasi native installer adalah %USERPROFILE%\.local\bin\claude.exe di Windows dan ~/.local/bin/claude di Mac/Linux. Jika membuka kembali terminal tidak menyelesaikannya, periksa dan tambahkan melalui PowerShell mengikuti dokumentasi resmi.

# 1. インストール先が PATH に入っているか確認する
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 何も出なければユーザーの PATH に追加し、ターミナルを開き直す
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 新しいターミナルで
claude --version

Jika Anda menginstalnya dengan npm, pesan npm.ps1 cannot be loaded because running scripts is disabled on this system (atau claude.ps1 saat memulai) muncul karena kebijakan eksekusi PowerShell memblokir skrip .ps1 milik npm (dokumentasi resmi, diperiksa pada 3 Oktober 2026). Atasi masalah ini dengan perintah berikut, yang mengizinkan eksekusi skrip lokal hanya untuk pengguna saat ini. Jika Anda tidak ingin mengubah kebijakan, gunakan npm.cmd dan claude.cmd, atau beralihlah ke penginstal bawaan untuk PowerShell.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Konfigurasi untuk menjalankan dengan kunci API tanpa login

Kunavo bukan Anthropic, melainkan gateway API independen yang menyediakan akses prabayar ke model seperti Claude. Claude Code menyediakan variabel resmi ANTHROPIC_BASE_URL untuk mengganti tujuan permintaan, dan dokumentasi resminya juga memiliki halaman “Menghubungkan Claude Code ke gateway LLM”. Anda tidak perlu menggunakan plugin atau versi modifikasi. Variabel ini hanya mengubah tujuan pengiriman. Model yang menjawab ditentukan oleh variabel lain (Konfigurasi model, diperiksa pada 3 Oktober 2026).

Tetapkan enam hal berikut.

Di Mac dan Linux, tambahkan ke file konfigurasi shell (~/.zshrc atau ~/.bashrc) lalu buka kembali terminal.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # ドメインだけ。/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

Jika hanya ingin mencoba di Windows, jalankan berikut ini di jendela PowerShell. Pengaturan akan hilang saat jendela ditutup.

# このウィンドウの中だけで有効（閉じると消える）
$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

Jika tidak ingin memasukkannya setiap kali, tulis di env pada file konfigurasi pengguna ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Ini berlaku untuk semua proyek dan formatnya sama di Mac maupun Windows. Jika file tersebut sudah berisi pengaturan lain, 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"
  }
}

Ada tiga hal yang perlu diperhatikan tentang lokasi penulisan.

• Jangan menuliskan kunci di .claude/settings.json proyek. Kunci akan masuk ke repositori dan dibagikan kepada semua orang yang mengkloningnya (dokumentasi resmi).
• Jika variabel yang sama ada di shell dan file konfigurasi, nilai dalam file konfigurasi yang digunakan. Jika tidak berubah setelah export ulang, periksa file konfigurasi.
• Saat digunakan melalui ekstensi VS Code, masukkan variabel yang sama ke claudeCode.environmentVariables dalam pengaturan pengguna VS Code.

Alasan menggunakan ANTHROPIC_AUTH_TOKEN

ANTHROPIC_AUTH_TOKEN dikirim melalui header Authorization: Bearer dan langsung aktif saat dikonfigurasi. Sementara itu, ANTHROPIC_API_KEY dikirim melalui header x-api-key, dan dalam mode interaktif, Anda akan diminta memberikan persetujuan untuk menggunakannya satu kali pada penggunaan pertama. Jika Anda menolak saat itu, kunci tersebut selanjutnya akan diabaikan tanpa pemberitahuan apa pun dan tidak akan digunakan sampai Anda mengaktifkannya kembali melalui Use custom API key di /config. Kunavo menerima kunci yang dikirim melalui kedua header tersebut, sehingga ANTHROPIC_API_KEY juga berfungsi, tetapi ANTHROPIC_AUTH_TOKEN lebih dapat diandalkan karena tidak memiliki kendala ini. Dokumentasi resmi juga menyarankan penggunaan ANTHROPIC_AUTH_TOKEN jika jenis kunci tidak ditentukan.

Alasan mengunci model (per 3 Oktober 2026)

Menurut dokumentasi resmi (diperiksa pada 3 Oktober 2026), saat menggunakan kunci API, model bawaan dan alias opus mengarah ke Opus 5.5, sedangkan alias sonnet mengarah ke Sonnet 5.5. Tujuan alias berubah setiap kali model baru dirilis, tetapi model tersebut belum tentu tersedia di Kunavo pada hari yang sama. Faktanya, Kunavo belum menyediakan Sonnet 5.5 per 3 Oktober 2026, sehingga memilih /model sonnet tanpa menetapkan model secara spesifik akan menghasilkan kesalahan 404. Hal yang sama berlaku untuk fase eksekusi opusplan dan subagen yang ditentukan dengan model: sonnet. Karena itu, konfigurasi di atas juga menetapkan alias sonnet melalui ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5. Alias opus juga ditetapkan ke Claude Opus 5.5 melalui ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, agar peralihan ke model Opus berikutnya tidak menimbulkan masalah. Claude Opus 5.5 memerlukan Claude Code v2.1.280 atau lebih baru. Jika versi Anda lebih lama, perbarui dengan claude update.

Menetapkan model secara spesifik juga memudahkan perkiraan biaya. Jika tidak menentukan apa pun, model bawaannya adalah Claude Opus 5.5, dengan biaya per token lebih tinggi daripada menggunakan Claude Sonnet 5 sebagai model utama. Tarif Kunavo per 1 juta token (input / output) adalah Claude Haiku 4.5: $0,70 / $3,50; Claude Sonnet 5: $1,40 / $7,00(Harga Anthropic adalah $2,00 / $10,00); dan Claude Opus 5.5: $2,80 / $14,00. Jika ANTHROPIC_DEFAULT_HAIKU_MODEL tidak ditetapkan, sesi yang terhubung melalui ANTHROPIC_AUTH_TOKEN juga akan menjalankan pemrosesan latar belakang seperti ringkasan percakapan untuk claude --resume menggunakan model utama (panduan kompatibilitas gateway, diperiksa pada 3 Oktober 2026). Perlu diketahui bahwa di halaman harga Anthropic, Sonnet 5 yang ditetapkan sebagai model utama kini tercantum di bagian “model lama” (diperiksa pada 3 Oktober 2026).

Verifikasi dalam tiga tahap

1. Sebelum memulai, uji URL dan kunci saja

Ini adalah permintaan dengan hanya 1 token output, sama seperti dalam dokumentasi resmi (saldo akan dipotong sangat sedikit). Karena membaca variabel shell, jika kunci hanya ditulis dalam file konfigurasi, jalankan export di terminal ini sebelum eksekusi. Jika JSON yang dimulai dengan {"id":"msg_ dan 200 dikembalikan, URL dan kunci normal; jika 401, kunci ditolak.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Untuk PowerShell, caranya seperti berikut; jika id yang dikembalikan dimulai dengan msg_, berarti berhasil.

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

2. Jalankan claude dan pastikan layar login tidak muncul

Pada penggunaan pertama, wizard eksekusi awal dan konfirmasi kepercayaan folder akan muncul, tetapi setelah itu Anda tidak akan diminta login melalui browser. Jika diminta login, kunci belum diterima.

Penyebab umum adalah kunci hanya ditulis di .claude/settings.json atau .claude/settings.local.json proyek. Dalam sesi interaktif, env pengaturan proyek baru dimuat setelah wizard dan konfirmasi kepercayaan folder selesai, sehingga saat peluncuran pertama kunci dianggap belum ada. Pindahkan ke export shell atau ~/.claude/settings.json pengguna.

3. Periksa dua baris dalam /status

Jalankan /status dalam sesi, lalu periksa tab Status (dokumentasi resmi, diperiksa pada 3 Oktober 2026).

• Pastikan https://api.kunavo.com muncul pada Anthropic base URL. Baris ini hanya muncul saat gateway dikonfigurasi; jika barisnya tidak ada, ANTHROPIC_BASE_URL belum sampai ke sesi.
• Pastikan ANTHROPIC_AUTH_TOKEN muncul pada Auth token. Jika yang muncul adalah Login method akun claude.ai, aplikasi berjalan menggunakan login tersimpan.

Perubahan saat berjalan dengan kunci API

• Remote Control dan input suara tidak dapat digunakan. Karena keduanya bergantung pada ID claude.ai, keduanya dinonaktifkan selama kredensial autentikasi gateway seperti ANTHROPIC_AUTH_TOKEN aktif. Sejak v2.1.196, Remote Control juga dinonaktifkan hanya dengan ANTHROPIC_BASE_URL yang menunjuk ke host selain Anthropic.
• /fast ditampilkan sebagai dinonaktifkan. Saat autentikasi hanya menggunakan bearer token, Claude Code tidak menanyakan apakah mode cepat tersedia dan menganggapnya dinonaktifkan, lalu menampilkan Fast mode has been disabled by your organization.
• Angka yang ditampilkan oleh /context adalah perkiraan. Karena Kunavo tidak menyediakan /v1/messages/count_tokens, Claude Code beralih ke perkiraan berbasis jumlah karakter (panduan kompatibilitas gateway, diperiksa pada 3 Oktober 2026).

Konfigurasi terperinci di sisi Kunavo tersedia dalam dokumen integrasi Claude Code dan dokumen ANTHROPIC_BASE_URL (keduanya dalam bahasa Inggris).

Pembayaran saldo API: JCB, Apple Pay, Google Pay, dan Link

Berikut rangkuman hal-hal yang paling sering ditanyakan saat membayar dari Jepang.

Ada empat langkah. Pertama, daftar ke Kunavo (alamat email atau akun Google; informasi kartu tidak diminta saat pendaftaran). Berikutnya, pilih jumlah isi ulang di Penagihan pada dasbor. Minimum $10, tanpa biaya bulanan, dan jumlah besar mendapatkan bonus ($100 untuk saldo $110, $1.000 untuk saldo $1.200, dan $5.000 untuk saldo $6.250). Setelah memilih salah satu metode di atas dan membayar di layar pembayaran Stripe, terakhir buat kunci sk-kn- di Kunci API dan masukkan ke ANTHROPIC_AUTH_TOKEN. Kunci hanya ditampilkan sekali saat dibuat, jadi salin saat itu juga.

Saldo tidak memiliki masa berlaku, dan permintaan yang gagal tidak dikenai biaya. Metode pembayaran yang dapat digunakan untuk membayar langganan Claude di Jepang (termasuk melalui App Store dan Google Play) dirangkum dengan sumber di Metode pembayaran Claude.

Perkiraan biaya (simulasi)

Claude Code yang dijalankan dengan kunci API dikenai biaya berdasarkan penggunaan token. Claude Code mengirim seluruh konteks percakapan pada setiap permintaan, tetapi bagian awal yang sama seperti sebelumnya dapat dikenai harga pembacaan cache. Tabel di bawah menghitung dengan asumsi input per permintaan sebanyak 40.000 token (di antaranya 36.000 = 90% merupakan pembacaan cache, sedangkan sisanya 4.000 merupakan penulisan cache), output sebanyak 1.000 token, dan satu tugas terdiri dari 50 permintaan. Panggilan Claude Haiku 4.5 di latar belakang tidak termasuk. Untuk harga cache Kunavo, pada Claude Sonnet 5, pembacaan adalah 10% dari harga input dan penulisan adalah 1,25 kali harga input (setiap model dalam tabel dihitung dengan rasio masing-masing). Ini bukan nilai terukur maupun batas maksimum.

Jumlah sebenarnya berubah berdasarkan panjang konteks, efektivitas cache, panjang respons, dan apakah /clear dilakukan untuk setiap tugas. Harga satuan semua model dapat dilihat di halaman harga, estimasi berdasarkan pola penggunaan Anda di kalkulator biaya token Claude (bahasa Inggris), dan harga API per model di harga Claude API.

Kesalahan umum dan penanganannya

Kasus yang tidak cocok dengan metode ini

• Faktur yang memenuhi syarat wajib untuk penggantian biaya. Checkout Kunavo tidak menerbitkan faktur maupun faktur yang memenuhi syarat dengan nomor registrasi.
• Ingin membayar melalui minimarket atau PayPay. Keduanya tidak didukung, begitu juga transfer bank atau pembayaran operator seluler. Isi ulang otomatis hanya tersedia dengan kartu yang disimpan atau Link.
• Ingin menggunakan Remote Control atau input suara. Keduanya tidak dapat digunakan dengan kunci API, dan /fast juga ditampilkan sebagai dinonaktifkan. Login dengan langganan.
• Ingin menggunakan Sonnet 5.5. Kunavo tidak menyediakannya per 3 Oktober 2026.
• Ingin menyelesaikan konfigurasi hanya dengan dokumentasi berbahasa Jepang. Dokumentasi resmi Claude Code tersedia dalam bahasa Jepang, tetapi dokumentasi integrasi Kunavo hanya tersedia dalam bahasa Inggris.

Yang perlu dilakukan berikutnya

Setelah memverifikasi melalui /status, jalankan claude di direktori proyek yang akan dikerjakan, lalu buat CLAUDE.md terlebih dahulu dengan /init. Hal-hal yang perlu ditulis di CLAUDE.md, cara mengurangi dialog konfirmasi, dan cara membuat perintah khusus dijelaskan secara berurutan dalam Cara menggunakan Claude Code.

Pertanyaan yang sering diajukan