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

Tutorial instalasi Claude Code: perintah instalasi Windows dan macOS, konfigurasi API key tanpa login, serta pengisian saldo dengan Alipay dan WeChat Pay

Instalasi Claude Code hanya memerlukan satu perintah resmi. Bagian yang biasanya menimbulkan masalah adalah langkah berikutnya: versi Node yang diwajibkan npm, terminal dan PATH di Windows, cara mengonfigurasi API key tanpa login, serta cara membayar dari Tiongkok daratan.

Claude Code direkomendasikan untuk diinstal menggunakan perintah instalasi native resmi Anthropic; npm adalah opsi resmi alternatif dan memerlukan Node.js 22 atau lebih tinggi. Claude Code dapat digunakan tanpa login ke akun Claude: atur ANTHROPIC_BASE_URL (tulis hingga nama domain saja, tanpa /v1), ANTHROPIC_AUTH_TOKEN, dan empat baris penetapan model, lalu gunakan API key yang ditagihkan berdasarkan token. Saldo API Kunavo dapat diisi dengan Alipay atau WeChat Pay, dengan minimum $10. Terakhir, jalankan /status di Claude Code untuk mengonfirmasi koneksi.

Terminal
# macOS、Linux、WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows 命令提示符(CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Perintah dan variabel lingkungan diverifikasi pada 3 Oktober 2026, berdasarkan dokumentasi instalasi resmi Claude Code dan dokumentasi variabel lingkungan resmi; harga dan metode pembayaran diverifikasi pada 10 Oktober 2026. Berikut satu fakta yang perlu dijelaskan terlebih dahulu: daftar negara dan wilayah yang didukung Anthropic (diverifikasi pada 3 Oktober 2026) tidak mencakup Tiongkok daratan, Hong Kong, maupun Makau. Persyaratan sistem dalam dokumentasi instalasi Claude Code juga mencantumkan “Wilayah Anda: negara yang didukung Anthropic”. Halaman ini hanya membahas metode instalasi dan konfigurasi yang tercantum dalam dokumentasi resmi; halaman ini tidak menyediakan cara apa pun untuk mengakali pembatasan wilayah. Kunavo belum menguji konektivitas jaringan di Tiongkok daratan. Anda perlu memastikan sendiri apakah alamat unduhan, sumber npm, dan api.kunavo.com yang disebutkan di bawah dapat diakses melalui jaringan Anda.

Konfirmasi sebelum instalasi

ItemPersyaratan (dokumentasi instalasi resmi, diperiksa pada 3 Oktober 2026)
Sistem operasimacOS 13.0 atau lebih tinggi; Windows 10 1809 atau lebih tinggi, atau Windows Server 2019 atau lebih tinggi; Ubuntu 20.04 atau lebih tinggi; Debian 10 atau lebih tinggi; Alpine Linux 3.19 atau lebih tinggi
Perangkat kerasMemori minimal 4 GB, prosesor x64 atau ARM64 (Windows 32-bit tidak didukung)
ShellBash, Zsh, PowerShell, atau CMD
JaringanKoneksi internet diperlukan
Wilayah tempat tinggalNegara dan wilayah yang didukung Anthropic (Tiongkok daratan, Hong Kong, dan Makau tidak tercantum)
AkunRute login memerlukan akun Pro, Max, Team, Enterprise, atau Console; Claude Code tidak termasuk dalam versi gratis Claude.ai. Dengan API key, langganan dan login tidak diperlukan
Node.jsHanya diperlukan untuk rute npm, versi 22 atau lebih tinggi; instalasi native tidak memerlukannya

Metode satu: instalasi native resmi (direkomendasikan)

Dokumentasi instalasi resmi menandai instalasi native sebagai metode yang direkomendasikan. Perintahnya adalah tiga bagian di awal halaman ini: macOS, Linux, dan WSL menggunakan baris install.sh, Windows PowerShell menggunakan irm … | iex, dan Windows CMD menggunakan baris install.cmd. Instalasi native akan diperbarui otomatis ke versi terbaru di latar belakang; dokumentasi resmi juga menyatakan bahwa instalasi Homebrew dan WinGet secara default tidak diperbarui otomatis.

Setelah instalasi, buka jendela terminal baru (jendela yang sudah terbuka tidak dapat membaca PATH baru), lalu konfirmasikan:

claude --version   # 正常会打印版本号,后面跟着 (Claude Code)
claude doctor      # 只读的安装与设置诊断,不会开启会话

claude doctor tidak memulai sesi; perintah ini hanya mencetak status instalasi dan informasi diagnostik file settings, sehingga dapat membantu membedakan apakah masalahnya ada pada instalasi atau konfigurasi.

Saat unduhan gagal

Jika terminal menampilkan syntax error near unexpected token '<' atau curl: (22) The requested URL returned error: 403, menurut dokumentasi resmi pemecahan masalah instalasi (diverifikasi pada 3 Oktober 2026), artinya alamat instalasi mengembalikan halaman web atau kode status kesalahan, bukan skrip instalasi. Jika halaman yang ditampilkan bertuliskan App unavailable in region, penjelasan resmi menyatakan bahwa Claude Code tidak tersedia di negara atau wilayah Anda. Respons 403 tanpa isi halaman web juga dapat disebabkan oleh proksi atau firewall perusahaan yang memblokir unduhan. Jika masih mengalami 403 di wilayah yang didukung, panduan resmi menyarankan untuk memeriksa koneksi jaringan terlebih dahulu, lalu mempertimbangkan metode instalasi lain.

Metode dua: instalasi npm (memerlukan Node.js 22 atau lebih tinggi)

npm masih tercantum sebagai metode instalasi dalam dokumentasi resmi. Dokumentasi resmi menyatakan bahwa paket npm memerlukan Node.js versi 22 atau lebih baru. Jika versinya lebih lama, npm akan menampilkan peringatan EBADENGINE tetapi tidak akan gagal; instalasi tetap selesai karena paket ini mengunduh program native yang tidak bergantung pada Node.js saat dijalankan. Jika belum memiliki Node.js, instal versi 22 atau lebih baru dari situs resmi Node.js.

Terminal
node -v                                    # 需要 v22 或更高
npm install -g @anthropic-ai/claude-code   # 不要加 sudo

Dokumentasi resmi dengan jelas menyatakan jangan gunakan sudo npm install -g, karena dapat menimbulkan masalah izin dan risiko keamanan. Untuk memperbarui, gunakan npm install -g @anthropic-ai/claude-code@latest, bukan npm update -g.

Saat unduhan dari sumber default gagal atau lambat: npmmirror

Jika unduhan dari sumber default npm gagal atau lambat, Anda dapat beralih ke npmmirror. Beranda npmmirror (diverifikasi pada 3 Oktober 2026) menjelaskan bahwa layanan ini adalah “mirror lengkap npmjs.com”, hanya-baca, dan akan “berusaha menyinkronkan secara langsung dengan layanan resmi”; beranda tersebut juga mencantumkan alamat registry dan perintah pengaturan. Beranda itu tidak menyebutkan frekuensi sinkronisasi secara spesifik.

Terminal
# 只在这一次安装时使用 npmmirror
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 或者把 npmmirror 设为 npm 的默认源(之后所有 npm 安装都会走它)
npm config set registry https://registry.npmmirror.com

# 以后升级用 @latest,不要用 npm update -g
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

Instalasi Claude Code menggunakan mirror memiliki dua persyaratan yang mudah terlewatkan, dan keduanya berasal dari dokumentasi pemecahan masalah resmi:

  • Mirror harus menyediakan 8 paket platform secara bersamaan.Paket npm itu sendiri hanyalah pembungkus; program sebenarnya diunduh sebagai dependensi opsional dalam bentuk paket platform @anthropic-ai/claude-code-*. Jika mirror tidak memiliki paket platform, menjalankan claude setelah instalasi di macOS atau Linux akan menampilkan claude native binary not installed (di Windows, PowerShell atau CMD akan melaporkan bahwa file ini tidak dapat dijalankan). Pada 3 Oktober 2026, Kunavo memeriksa dari jaringan di luar Tiongkok daratan bahwa paket utama serta paket Windows x64, macOS ARM64, dan Linux x64 di npmmirror sama dengan versi terbaru npmjs; paket platform lainnya (Windows ARM64, Mac Intel, Linux ARM64, dan dua versi musl) belum diperiksa.
  • Jangan melewati dependensi opsional.Jangan sertakan --omit=optional dalam perintah instalasi, dan pastikan .npmrc tidak berisi optional=false.

Khusus Windows

Windows memiliki dua perintah instalasi yang berbeda; perbedaannya hanya pada jenis terminal yang dibuka. Prompt yang diawali PS C:\Users\你的用户名> adalah PowerShell; prompt tanpa PS dan hanya dengan C:\Users\你的用户名> adalah Command Prompt (CMD). Dokumentasi resmi menyatakan bahwa instalasi tidak perlu dijalankan sebagai administrator.

Kesalahan umum di Windows adalah menempelkan perintah ke terminal yang salah: jika baris CMD dijalankan di PowerShell, Anda akan melihat The token '&&' is not a valid statement separator; jika baris PowerShell dijalankan di CMD, Anda akan melihat 'irm' is not recognized as an internal or external command. Dalam kedua kasus, gunakan kembali baris yang sesuai. Selain itu, menu Start memiliki dua entri, Windows PowerShell dan Windows PowerShell (x86); yang terakhir adalah proses 32-bit dan akan menampilkan Claude Code does not support 32-bit Windows, jadi buka entri yang tidak bertanda (x86).

Git for Windows bersifat opsional: setelah dipasang, Claude Code menggunakan Git Bash yang disertakan untuk menjalankan perintah. Jika tidak dipasang, Claude Code akan menggunakan alat PowerShell. Jika Git Bash sudah dipasang tetapi tidak ditemukan, atur CLAUDE_CODE_GIT_BASH_PATH di env dalam ~/.claude/settings.json agar menunjuk ke bash.exe. Contoh jalur resmi adalah C:\Program Files\Git\bin\bash.exe.

MetodeApa yang diperlukanEksekusi sandboxCocok untuk
Windows nativeTidak diperlukan; Git for Windows bersifat opsionalTidak didukungProyek dan alat memang sudah berada di Windows
WSL 2Aktifkan WSL 2DidukungJika memerlukan toolchain Linux atau ingin perintah dijalankan dalam sandbox
WSL 1Aktifkan WSL 1Tidak didukungJika WSL 2 tidak dapat digunakan

Jika memilih WSL, jalankan baris macOS/Linux di terminal WSL dan mulai claude juga di WSL, bukan di PowerShell atau CMD.

Kesalahan strategi eksekusi pada rute npm

Saat menginstal atau menjalankan npm di PowerShell, jika melihat npm.ps1 cannot be loaded because running scripts is disabled on this system, berarti strategi eksekusi PowerShell memblokir skrip peluncur .ps1 yang dibuat npm. Dokumentasi resmi memberikan tiga solusi: izinkan pengguna saat ini menjalankan skrip lokal (baris di bawah); gunakan npm.cmd atau claude.cmd; atau gunakan perintah instalasi native PowerShell.

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Setelah instalasi, claude tidak ditemukan

Jika muncul command not found: claude atau 'claude' is not recognized, berarti direktori instalasi tidak berada di PATH. Instalasi native menempatkan program di ~/.local/bin/claude pada macOS/Linux dan %USERPROFILE%\.local\bin\claude.exe pada Windows. Buka terminal baru lalu coba lagi; jika tetap gagal di Windows, ikuti dokumentasi pemecahan masalah resmi untuk memeriksa dan menambahkan PATH pengguna menggunakan PowerShell:

PowerShell
# 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

Konfigurasikan API key: tanpa login ke akun Claude

ANTHROPIC_BASE_URL adalah variabel lingkungan bawaan Claude Code. Dokumentasi resmi menjelaskannya sebagai variabel yang mengganti endpoint API agar permintaan melewati proxy atau gateway. Karena itu, mengarahkan Claude Code ke endpoint yang menyediakan Anthropic Messages API merupakan konfigurasi resmi yang didukung dan tidak memerlukan plugin atau program yang dimodifikasi. Di macOS/Linux, tulis variabel ini ke file konfigurasi shell:

~/.zshrc
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

Untuk mencoba terlebih dahulu di satu jendela PowerShell pada Windows:

PowerShell
# 只对当前 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 jangka panjang, disarankan menulisnya di env dalam file settings tingkat pengguna ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Dengan menulisnya di sini, setiap terminal dan tugas latar belakang dapat membacanya; jika file tersebut sudah berisi pengaturan lain, gabungkan env ke dalamnya:

~/.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"
  }
}

Enam baris ini masing-masing memiliki satu hal yang mudah salah dikonfigurasi:

  • ANTHROPIC_BASE_URL hanya ditulis hingga nama domain.Claude Code akan menambahkan /v1/messages sendiri; jika Anda menulis /v1 lagi, hasilnya menjadi /v1/v1/messages dan mengembalikan 404.
  • Gunakan ANTHROPIC_AUTH_TOKEN, bukan ANTHROPIC_API_KEY.Dokumentasi resmi menjelaskan bahwa nilai ANTHROPIC_AUTH_TOKEN dikirim sebagai header Authorization dan secara otomatis diberi awalan Bearer, sehingga langsung berlaku; ANTHROPIC_API_KEY memerlukan satu konfirmasi terlebih dahulu dalam mode interaktif. Jika Anda memilih menolak saat konfirmasi, key tersebut akan diabaikan secara diam-diam setelahnya (aktifkan kembali melalui /config di Use custom API key).
  • ANTHROPIC_MODEL menentukan model utama.Di sini tetapkan ke Claude Sonnet 5 (claude-sonnet-5). Nama model harus sama persis dengan daftar model Kunavo; nama lama dengan sufiks tanggal tidak akan dipetakan secara otomatis.
  • ANTHROPIC_DEFAULT_OPUS_MODEL menentukan alias opus. Menurut dokumentasi konfigurasi model resmi (diverifikasi pada 3 Oktober 2026), model default untuk pengguna API dan alias opus menunjuk ke Opus terbaru (saat ini Opus 5.5), sedangkan alias sonnet menunjuk ke Sonnet 5.5. Alias ini akan mengikuti versi baru dari Anthropic. Dokumentasi resmi menyatakan alias “diperbarui seiring waktu”. Untuk menetapkan versi tertentu, tulis nama model lengkap atau atur variabel seperti ANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo saat ini belum menyediakan Sonnet 5.5. Saat Anthropic merilis Opus baru, Kunavo mungkin belum menyediakannya; model yang belum tersedia akan mengembalikan 404. Karena itulah model utama, alias opus, dan alias sonnet perlu ditetapkan ke versi tertentu. Di sini, alias opus ditetapkan ke Claude Opus 5.5 (claude-opus-5-5). Claude Code versi 2.1.280 atau lebih baru diperlukan; untuk memperbarui versi yang lebih lama, jalankan claude update terlebih dahulu.
  • ANTHROPIC_DEFAULT_SONNET_MODEL menentukan alias sonnet.Dokumentasi resmi menjelaskan bahwa variabel ini menentukan model yang dituju alias sonnet dan model yang digunakan opusplan di luar mode perencanaan (pada tahap eksekusi). Alias sonnet secara default meminta Sonnet 5.5, yang saat ini tidak disediakan Kunavo. Jika baris ini tidak diatur, /model sonnet, tahap eksekusi opusplan, dan subagen yang ditetapkan model: sonnet semuanya akan mengembalikan 404. Tetapkan juga ke Claude Sonnet 5 (claude-sonnet-5).
  • ANTHROPIC_DEFAULT_HAIKU_MODEL menentukan alias haiku. Alias haiku akan meminta ID model yang tidak disediakan Kunavo: Haiku 5.5 sejak v2.1.293, dan nama Haiku 4.5 dengan akhiran tanggal pada versi sebelumnya. Jadi, jika baris ini tidak diatur, /model haiku dan subagen yang ditetapkan ke model: haiku (termasuk claude-code-guide yang dijalankan Claude Code sendiri) akan menghasilkan 404. Patok ke claude-haiku-4-5 di sini.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL juga mengatur tugas latar belakang.Dokumentasi resmi menjelaskan bahwa variabel ini menentukan alias haiku dan juga digunakan untuk fitur latar belakang. Claude Haiku 4.5 di Kunavo berharga $0,70 per satu juta token input dan $3,50 per satu juta token output; model utama Claude Sonnet 5 berharga $1,40 / $7,00(harga resmi Anthropic $2,00 / $10,00); model Claude Opus 5.5 yang terkait dengan alias opus berharga $2,80 / $14,00.

Jangan menulis key di .claude/settings.json proyek: dokumentasi resmi mengingatkan bahwa file ini akan dikomit dan dibagikan kepada setiap orang yang mengkloning repositori. Perhatikan juga aturan prioritas: jika variabel yang sama ditetapkan di shell dan file settings, nilai dalam file settings yang digunakan. Jika perubahan variabel shell tidak berlaku, periksa file settings terlebih dahulu.

Apa yang terjadi saat pertama kali dijalankan

Menurut dokumentasi koneksi gateway resmi (diverifikasi pada 3 Oktober 2026), setelah mengatur ANTHROPIC_AUTH_TOKEN lalu menjalankan claude, Anda akan langsung masuk ke sesi tanpa menampilkan halaman masuk. Variabel ini langsung berlaku, berbeda dengan ANTHROPIC_API_KEY, yang harus dikonfirmasi terlebih dahulu. Jika halaman masuk muncul setelah dibuka, berarti Claude Code tidak membaca kredensial.

Kredensial harus ditempatkan di lokasi yang dibaca Claude Code sebelum penyiapan awal: export di shell atau env di ~/.claude/settings.json tingkat pengguna. Dokumentasi resmi menjelaskan bahwa dalam mode interaktif, env pada .claude/settings.json atau .claude/settings.local.json di proyek baru berlaku setelah wizard penyiapan awal dan permintaan kepercayaan folder selesai. Karena itu, jika key ditulis dalam settings tingkat proyek, halaman login tetap muncul saat pertama kali dijalankan.

Setelah masuk ke sesi, jalankan /status dan lihat dua baris di halaman Status:

  • Anthropic base URL: hanya muncul jika alamat gateway telah diatur dan harus menampilkan https://api.kunavo.com. Jika baris ini tidak ada, berarti ANTHROPIC_BASE_URL tidak diteruskan ke sesi tersebut.
  • Auth token: jika tertulis ANTHROPIC_AUTH_TOKEN, berarti Anda sedang menggunakan API key, bukan login claude.ai yang tersimpan. Jika yang terlihat adalah Login method dan akun claude.ai, berarti variabel belum berlaku.

Untuk menguji alamat dan key secara terpisah sebelum membuka Claude Code, Anda dapat mengirim permintaan yang hanya meminta 1 token output, mengikuti metode dalam dokumentasi resmi (saldo yang dipotong sangat kecil berdasarkan token). Perintah ini membaca variabel dari shell, jadi meskipun key ditulis dalam file settings, Anda tetap harus menjalankan export di terminal saat ini. JSON yang diawali {"id":"msg_ menunjukkan bahwa alamat dan key berfungsi; 401 menunjukkan bahwa key tidak dikenali.

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

Apa yang berbeda saat menggunakan API key

  • Remote Control dan input suara tidak tersedia.Dokumentasi resmi menjelaskan bahwa keduanya bergantung pada identitas claude.ai dan tidak tersedia saat ANTHROPIC_AUTH_TOKEN diatur; jika ANTHROPIC_BASE_URL mengarah ke alamat non-Anthropic, Remote Control juga dinonaktifkan.
  • /fast akan menampilkan bahwa mode fast dinonaktifkan.Dokumentasi resmi menjelaskan bahwa dengan bearer token saja, Claude Code langsung memperlakukan mode fast sebagai nonaktif dan tidak mengirim pemeriksaan ketersediaan.
  • Pencarian alat MCP secara default dinonaktifkan.Dokumentasi resmi menjelaskan bahwa saat ANTHROPIC_BASE_URL mengarah ke alamat non-Anthropic, pencarian alat MCP secara default dinonaktifkan.
  • Angka dalam /context merupakan perkiraan lokal. Kunavo saat ini tidak menyediakan /v1/messages/count_tokens. Menurut dokumentasi kompatibilitas gateway resmi (diverifikasi pada 3 Oktober 2026), jika gateway tidak memiliki endpoint ini, Claude Code akan menggunakan perkiraan berdasarkan jumlah karakter dan /context akan menampilkan nilai perkiraan.

Penjelasan integrasi lengkap tersedia dalam dokumentasi integrasi Claude Code (bahasa Inggris).

Apa saja yang dinonaktifkan CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

Menurut dokumentasi variabel lingkungan resmi (diverifikasi pada 3 Oktober 2026), variabel ini berfungsi untuk menonaktifkan lalu lintas jaringan Claude Code yang tidak diperlukan. Hal-hal yang tercantum oleh dokumentasi resmi adalah:

  • Pembaruan otomatis, telemetri, dan laporan kesalahan;
  • Perintah /feedback dan umpan balik yang disusun Claude;
  • Catatan rilis dan pemeriksaan lencana status PR/MR;
  • Pemeriksaan ketersediaan seperti mode fast;
  • Pengambilan feature flag, sehingga Remote Control dan fitur lain yang bergantung pada feature flag tidak tersedia;
  • Menjalankan ulang di latar belakang dari sumber plugin command (ini adalah perintah lokal, bukan lalu lintas jaringan, karena dapat memicu instalasi dependensi).

Beberapa detail lain yang dinyatakan secara resmi: nilai 0 atau false juga dianggap aktif; berbeda dari sebagian besar variabel sakelar, fungsi hanya dipulihkan setelah variabel ini dihapus. Instalasi otomatis dari pasar plugin resmi tidak termasuk dalam cakupannya; variabel ini tidak memengaruhi penemuan model gateway. Dokumentasi gateway resmi menambahkan bahwa variabel ini tidak memengaruhi pemeriksaan keamanan domain alat WebFetch, yang tetap mengakses api.anthropic.com; untuk menonaktifkannya, tambahkan skipWebFetchPreflight: true di settings. Dokumentasi resmi tidak menggambarkan variabel ini sebagai pengaturan terkait pengendalian risiko akun.

Kunavo tidak mewajibkan pengaturan variabel ini, dan variabel tersebut juga tidak memengaruhi permintaan model yang dikirim ke Kunavo. Dokumentasi resmi koneksi gateway (diverifikasi pada 3 Oktober 2026) memberikan contoh kapan variabel ini berguna: meskipun ANTHROPIC_BASE_URL menunjuk ke gateway, Claude Code tetap mengirim permintaan latar belakang seperti pemeriksaan versi, telemetri, dan catatan rilis ke pihak ketiga seperti Anthropic dan GitHub. Jika jaringan Anda hanya mengizinkan akses ke alamat gateway, permintaan ini akan gagal dan mungkin muncul dalam pemantauan lalu lintas keluar sebagai koneksi yang diblokir. Solusi resmi adalah mengatur variabel ini bersama variabel gateway.

Biayanya adalah pembaruan otomatis tidak lagi berjalan; dokumentasi resmi menyarankan menyiapkan cara lain untuk memperbarui. Untuk instalasi npm, gunakan @latest untuk memperbarui secara manual (lihat baris terakhir bagian npmmirror di atas).

~/.zshrc
# 可选:关闭 Claude Code 的非必要网络流量(会同时关闭自动更新)
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# 想恢复时删掉这个变量;设成 0 或 false 仍然算开启
unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

Isi saldo dengan Alipay atau WeChat Pay dan dapatkan key

Langganan web langsung dari Anthropic hanya menerima kartu kredit atau debit (FAQ penagihan paket Claude berbayar, diverifikasi pada 3 Oktober 2026). Anda dapat mengisi saldo Kunavo menggunakan Alipay atau WeChat Pay. Berikut ringkasan langkahnya; untuk langkah lengkap, lihat panduan isi saldo Claude API dengan Alipay dan WeChat Pay:

  1. Daftarkan akun Kunavo dengan email atau akun Google; pendaftaran tidak memerlukan kartu.
  2. Di Penagihan, pilih jumlah isi ulang. Minimum $10 dan tidak ada biaya bulanan. Isi ulang yang lebih besar mendapatkan bonus: isi ulang $100, dapatkan saldo $110, isi ulang $1000, dapatkan saldo $1200, dan isi ulang $5000, dapatkan saldo $6250.
  3. Di halaman checkout Stripe, pilih Alipay atau WeChat Pay dan bayar dengan memindai kode QR. Saat dibuka dari Tiongkok daratan, jumlahnya ditampilkan dalam renminbi; gunakan angka pada halaman checkout sebagai acuan.
  4. Buka /app/keys untuk membuat key yang diawali sk-kn- (hanya ditampilkan sekali, jadi segera simpan), lalu masukkan ke ANTHROPIC_AUTH_TOKEN di atas.

Alipay dan WeChat Pay hanya dapat digunakan untuk isi ulang manual; isi ulang otomatis hanya dapat menggunakan kartu bank atau Link. Kunavo tidak menerbitkan faktur pajak pertambahan nilai Tiongkok; riwayat isi ulang dapat dilihat di halaman Billing.

Perkiraan biaya (algoritme ilustratif)

Claude Code mengenakan biaya berdasarkan token; setiap permintaan mengirim ulang konteks percakapan, dan awalan yang sama seperti pada permintaan sebelumnya dapat dihitung sebagai pembacaan cache. Berikut hanya aritmetika token ilustratif, bukan tagihan aktual atau batas biaya. Semua asumsi tercantum di bawah:

  • Setiap permintaan memiliki 40.000 token input, dengan 36.000 (90%) dihitung sebagai pembacaan cache dan sisanya, 4.000, dihitung sebagai penulisan cache;
  • Setiap permintaan menghasilkan 1.000 token output;
  • Dalam satu periode kerja dikirim 50 permintaan seperti ini; panggilan latar belakang Claude Haiku 4.5 tidak dihitung;
  • Harga Kunavo: pembacaan cache adalah 10% dari harga input, sedangkan penulisan cache adalah 1,25 kali harga input (rasio Claude Sonnet 5; pada tabel, setiap model dihitung menggunakan rasionya sendiri).
ModelSetiap permintaanTotal 50 permintaanJika tidak ada cache yang cocok sama sekali, total 50 permintaan
Claude Sonnet 5$0,019$0,95$3,15
Claude Opus 5.5$0,033$1,65$6,30

Biaya aktual bergantung pada panjang konteks, jumlah cache hit, panjang output, dan apakah Anda menggunakan /clear untuk menghapus percakapan di antara tugas. Untuk memilih antara langganan Claude Code dan API serta memperkirakan biaya bulanan, lihat harga Claude Code; harga lengkap setiap model tersedia di harga Claude API dan halaman harga; untuk memperkirakan berdasarkan penggunaan Anda sendiri, gunakan kalkulator biaya token Claude (bahasa Inggris).

Perbandingan pesan kesalahan umum

Pesan yang terlihatPenyebab dan solusi
The token '&&' is not a valid statement separatorAnda menjalankan baris CMD di PowerShell; gunakan baris irm … | iex sebagai gantinya.
'irm' is not recognized as an internal or external commandAnda menjalankan baris PowerShell di CMD; gunakan baris install.cmd sebagai gantinya.
syntax error near unexpected token '<'、403Alamat instalasi mengembalikan halaman web atau kode status kesalahan. Jika halaman menampilkan App unavailable in region, penjelasan resmi adalah bahwa Claude Code tidak tersedia di negara atau wilayah Anda; untuk kondisi lainnya, periksa jaringan berdasarkan dokumentasi pemecahan masalah resmi.
command not found: claude、'claude' is not recognizedDirektori instalasi tidak berada di PATH. Buka terminal baru terlebih dahulu; di Windows, gunakan cuplikan PowerShell di atas untuk menambahkan PATH pengguna.
Peringatan EBADENGINENode.js lebih lama dari 22. Dokumentasi resmi menyatakan bahwa instalasi tetap selesai; disarankan memperbarui ke versi 22 atau lebih tinggi.
claude native binary not installed (macOS, Linux)npm melewati dependensi opsional (--omit=optional atau optional=false), melewati skrip instalasi (--ignore-scripts), atau mirror yang digunakan tidak memiliki paket platform. Hapus pengaturan terkait lalu instal ulang.
npm.ps1 cannot be loadedStrategi eksekusi PowerShell memblokir skrip peluncur npm. Jalankan baris Set-ExecutionPolicy atau gunakan instalasi native.
Claude Code does not support 32-bit WindowsWindows PowerShell (x86) terbuka; buka versi yang tidak bertanda x86.
Setelah key diatur, halaman login tetap muncul saat menjalankan claudeClaude Code tidak membaca kredensial. Tulis variabel di konfigurasi shell atau ~/.claude/settings.json, bukan hanya di settings tingkat proyek; setelah mengubahnya, buka terminal baru.
401Key tidak dikenali: pastikan Anda menyalin seluruh key yang diawali sk-kn-, tidak ada spasi tambahan, key belum dihapus di /app/keys, dan Anda menggunakan ANTHROPIC_AUTH_TOKEN.
404ANTHROPIC_BASE_URL ditulis dengan tambahan /v1, atau nama model yang diminta tidak ada dalam daftar model Kunavo (misalnya empat baris penetapan model belum diatur).

Batasan yang perlu diketahui

  • Kunavo tidak menerbitkan faktur pajak pertambahan nilai Tiongkok.
  • Alipay dan WeChat Pay hanya dapat digunakan untuk isi ulang manual; isi ulang otomatis hanya dapat menggunakan kartu bank atau Link.
  • Ini adalah API berbasis token, bukan langganan Claude Pro/Max; saat menggunakan API key, Remote Control dan input suara tidak tersedia. Lihat harga Claude Code untuk perbandingan keduanya.
  • Kunavo belum melakukan pengujian konektivitas jaringan dari Tiongkok daratan. Anda perlu memeriksa sendiri apakah alamat instalasi claude.ai, sumber npm, npmmirror, dan api.kunavo.com dapat diakses dari jaringan Anda serta seberapa cepat aksesnya.
  • Tiongkok daratan, Hong Kong, dan Makau tidak tercantum dalam daftar negara dan wilayah yang didukung Anthropic (diperiksa pada 3 Oktober 2026); dokumentasi instalasi resmi Claude Code mencantumkan wilayah tempat Anda berada sebagai salah satu persyaratan sistem.

Pertanyaan umum

Bagaimana cara menginstal Claude Code di Tiongkok? Menggunakan skrip instalasi resmi atau npm?

Dokumentasi instalasi resmi Anthropic menandai instalasi native sebagai metode yang direkomendasikan: di macOS, Linux, dan WSL jalankan curl -fsSL https://claude.ai/install.sh | bash; di Windows, jalankan irm https://claude.ai/install.ps1 | iex di PowerShell, atau curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd di CMD. Instalasi native akan diperbarui otomatis di latar belakang. npm (npm install -g @anthropic-ai/claude-code) tetap tercantum sebagai metode instalasi resmi dan memerlukan Node.js 22 atau lebih tinggi. Perlu dicatat bahwa Tiongkok daratan tidak tercantum dalam daftar wilayah yang didukung Anthropic (diperiksa pada 3 Oktober 2026); dokumentasi instalasi resmi mencantumkan wilayah tempat tinggal sebagai salah satu persyaratan sistem. Kunavo belum menguji apakah alamat unduhan ini dapat diakses dari Tiongkok daratan.

Versi Node.js apa yang diperlukan untuk menginstal Claude Code dengan npm? Apakah mirror Taobao (npmmirror) dapat digunakan?

Dokumentasi resmi mensyaratkan Node.js 22 atau lebih tinggi, dan kolom engines paket npm juga mencantumkan >=22.0.0; ketika versi Node.js lebih lama, npm hanya menampilkan peringatan EBADENGINE, tetapi instalasi tetap selesai karena paket npm mengunduh program native yang tidak bergantung pada Node.js untuk dijalankan. Jika unduhan dari sumber default gagal atau lambat, tambahkan --registry=https://registry.npmmirror.com setelah perintah instalasi, atau gunakan npm config set registry https://registry.npmmirror.com untuk menjadikan npmmirror sebagai sumber default. Halaman utama npmmirror menjelaskan bahwa layanan ini adalah mirror npmjs.com lengkap dan hanya-baca yang berupaya menyinkronkan secara waktu nyata dengan sumber resmi. Dokumentasi pemecahan masalah resmi Claude Code mengingatkan bahwa mirror harus menyediakan 8 paket platform @anthropic-ai/claude-code-* secara bersamaan, dan npm tidak boleh melewati dependensi opsional; jika tidak, program native tidak ditemukan setelah instalasi. Pada 3 Oktober 2026, Kunavo memeriksa dari jaringan di luar Tiongkok daratan bahwa paket utama serta paket Windows x64, macOS ARM64, dan Linux x64 di npmmirror sama dengan versi npmjs; paket platform lainnya belum diperiksa.

Bagaimana cara menginstal Claude Code di Windows? Apakah WSL dan Git wajib diinstal?

Tidak wajib. Di Windows native, jalankan perintah instalasi yang sesuai langsung di PowerShell atau CMD; hak administrator tidak diperlukan. Git for Windows bersifat opsional: jika terinstal, Claude Code menggunakan Git Bash yang disertakan untuk menjalankan perintah; jika tidak, Claude Code menggunakan alat PowerShell. Windows native tidak mendukung eksekusi dalam sandbox; jika memerlukan sandbox atau toolchain Linux, pilih WSL 2, lalu instal dan jalankan claude di terminal WSL, bukan di PowerShell atau CMD. Selain itu, jangan buka PowerShell 32-bit yang bertanda (x86), karena Claude Code tidak mendukung Windows 32-bit.

Apakah saya dapat langsung menjalankan Claude Code dengan API key tanpa langganan Claude Pro/Max dan tanpa login akun?

Bisa. Login melalui akun Claude memerlukan akun Pro, Max, Team, Enterprise, atau Console; versi gratis Claude.ai tidak menyertakan Claude Code. Dengan API key, login tidak diperlukan: konfigurasikan ANTHROPIC_BASE_URL=https://api.kunavo.com dan ANTHROPIC_AUTH_TOKEN di shell atau ~/.claude/settings.json. Setelah Claude Code dimulai, Anda langsung masuk ke sesi tanpa halaman login atau konfirmasi tambahan; saldo Kunavo dipotong berdasarkan token yang benar-benar digunakan. Remote Control dan input suara memerlukan identitas claude.ai dan tidak tersedia saat menggunakan API key.

Apakah ANTHROPIC_BASE_URL perlu ditambahkan /v1? Di mana variabel lingkungan harus ditulis agar berlaku?

Jangan tambahkan. Claude Code akan menambahkan /v1/messages sendiri, jadi ANTHROPIC_BASE_URL cukup ditulis hingga nama domain: https://api.kunavo.com; jika diakhiri /v1, permintaan akan dikirim ke /v1/v1/messages dan menghasilkan 404. Tulis variabel di konfigurasi shell (~/.zshrc, ~/.bashrc, atau $PROFILE PowerShell) atau di env pada ~/.claude/settings.json tingkat pengguna (Windows: %USERPROFILE%\.claude\settings.json). Jangan menulisnya di .claude/settings.json dalam proyek: file ini akan dikomit dan dibagikan kepada semua orang yang mengkloning repositori, dan dalam mode interaktif, env tingkat proyek baru berlaku setelah wizard penyiapan awal dan permintaan kepercayaan folder selesai. Jika variabel yang sama diatur di shell dan file settings, file settings yang diutamakan.

Mengapa perlu mengatur ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, dan ANTHROPIC_DEFAULT_SONNET_MODEL? Apa yang terjadi jika tidak diatur?

Jika model tidak ditetapkan secara tetap, Claude Code menggunakan alias yang dapat berubah mengikuti versi baru Anthropic. Menurut dokumentasi resmi konfigurasi model Claude Code (diperiksa pada 3 Oktober 2026), model default pengguna API dan alias opus mengarah ke Opus 5.5, sedangkan alias sonnet mengarah ke Sonnet 5.5, dan alias tersebut diperbarui seiring waktu; cara tetap yang diberikan secara resmi adalah menulis nama model lengkap atau mengatur variabel seperti ANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo saat ini tidak menyediakan Sonnet 5.5: jika ANTHROPIC_DEFAULT_SONNET_MODEL tidak diatur, /model sonnet, tahap eksekusi opusplan, dan subagen dengan model: sonnet akan meminta Sonnet 5.5 dan menghasilkan 404. Saat Anthropic merilis Opus baru, Kunavo juga belum tentu sudah menyediakannya dan hasilnya dapat tetap 404. Setelah ditetapkan, model utama dan alias sonnet adalah claude-sonnet-5, alias opus adalah claude-opus-5-5 (Opus 5.5 memerlukan Claude Code v2.1.280 atau lebih tinggi; pada versi lama, jalankan claude update terlebih dahulu), sedangkan alias haiku dan tugas latar belakang adalah claude-haiku-4-5. Model yang digunakan dan harga yang dibebankan menjadi pasti.

Apakah CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC perlu diaktifkan? Apa yang akan dinonaktifkan?

Menurut dokumentasi resmi variabel lingkungan Claude Code (diperiksa pada 3 Oktober 2026), variabel ini menonaktifkan lalu lintas jaringan nonesensial: pembaruan otomatis, telemetri, laporan kesalahan, perintah /feedback, umpan balik yang disusun Claude, catatan rilis, pemeriksaan lencana status PR/MR, serta pemeriksaan ketersediaan seperti mode fast; variabel ini juga menghentikan pengambilan feature flag, sehingga Remote Control dan fitur yang bergantung pada feature flag tidak tersedia. Nilai 0 atau false juga dianggap aktif; hanya menghapus variabel ini yang memulihkan fungsi. Variabel ini tidak memengaruhi pemeriksaan keamanan domain alat WebFetch terhadap api.anthropic.com. Dokumentasi resmi tidak menggambarkannya sebagai pengaturan terkait pengendalian risiko akun. Setelah diaktifkan, pembaruan otomatis berhenti dan Anda perlu memperbarui secara berkala; untuk instalasi npm, gunakan npm install -g @anthropic-ai/claude-code@latest. Kunavo tidak mewajibkan pengaturan ini dan pengaturan tersebut tidak memengaruhi permintaan model yang dikirim ke Kunavo. Dokumentasi gateway resmi juga menjelaskan bahwa meskipun ANTHROPIC_BASE_URL mengarah ke gateway, Claude Code tetap mengirim permintaan latar belakang seperti pemeriksaan versi, telemetri, dan catatan rilis ke Anthropic, GitHub, dan pihak ketiga lainnya; jika jaringan Anda hanya mengizinkan akses ke alamat gateway, permintaan tersebut akan gagal, dan cara resmi yang diberikan adalah mengatur variabel ini secara bersamaan.

Apakah saya dapat mengisi saldo dengan Alipay atau WeChat Pay? Apakah perpanjangan otomatis dan penerbitan faktur tersedia?

Saldo dapat diisi dengan Alipay atau WeChat Pay: isi ulang Kunavo menggunakan halaman checkout Stripe, dan Alipay serta WeChat Pay tersedia sebagai metode pembayaran yang dapat dipilih. Saat dibuka dari Tiongkok daratan, jumlahnya ditampilkan dalam renminbi. Isi ulang minimum adalah $10 dan tidak ada biaya bulanan. Alipay dan WeChat Pay hanya mendukung isi ulang manual; isi ulang otomatis hanya dapat menggunakan kartu bank atau Link. Kunavo tidak menerbitkan faktur pajak pertambahan nilai Tiongkok; riwayat isi ulang dapat dilihat di halaman Billing.