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.
# 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.cmdPerintah 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
| Item | Persyaratan (dokumentasi instalasi resmi, diperiksa pada 3 Oktober 2026) |
|---|---|
| Sistem operasi | macOS 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 keras | Memori minimal 4 GB, prosesor x64 atau ARM64 (Windows 32-bit tidak didukung) |
| Shell | Bash, Zsh, PowerShell, atau CMD |
| Jaringan | Koneksi internet diperlukan |
| Wilayah tempat tinggal | Negara dan wilayah yang didukung Anthropic (Tiongkok daratan, Hong Kong, dan Makau tidak tercantum) |
| Akun | Rute 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.js | Hanya 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.
node -v # 需要 v22 或更高
npm install -g @anthropic-ai/claude-code # 不要加 sudoDokumentasi 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.
# 只在这一次安装时使用 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.comInstalasi 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, menjalankanclaudesetelah instalasi di macOS atau Linux akan menampilkanclaude 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=optionaldalam perintah instalasi, dan pastikan.npmrctidak berisioptional=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.
| Metode | Apa yang diperlukan | Eksekusi sandbox | Cocok untuk |
|---|---|---|---|
| Windows native | Tidak diperlukan; Git for Windows bersifat opsional | Tidak didukung | Proyek dan alat memang sudah berada di Windows |
| WSL 2 | Aktifkan WSL 2 | Didukung | Jika memerlukan toolchain Linux atau ingin perintah dijalankan dalam sandbox |
| WSL 1 | Aktifkan WSL 1 | Tidak didukung | Jika 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.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserSetelah 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:
# 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 --versionKonfigurasikan 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:
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-5Untuk mencoba terlebih dahulu di satu jendela PowerShell pada Windows:
# 只对当前 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"
claudeUntuk 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:
{
"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_URLhanya ditulis hingga nama domain.Claude Code akan menambahkan/v1/messagessendiri; jika Anda menulis/v1lagi, hasilnya menjadi/v1/v1/messagesdan mengembalikan 404.- Gunakan
ANTHROPIC_AUTH_TOKEN, bukanANTHROPIC_API_KEY.Dokumentasi resmi menjelaskan bahwa nilaiANTHROPIC_AUTH_TOKENdikirim sebagai headerAuthorizationdan secara otomatis diberi awalanBearer, sehingga langsung berlaku;ANTHROPIC_API_KEYmemerlukan satu konfirmasi terlebih dahulu dalam mode interaktif. Jika Anda memilih menolak saat konfirmasi, key tersebut akan diabaikan secara diam-diam setelahnya (aktifkan kembali melalui/configdi Use custom API key). ANTHROPIC_MODELmenentukan 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_MODELmenentukan aliasopus. Menurut dokumentasi konfigurasi model resmi (diverifikasi pada 3 Oktober 2026), model default untuk pengguna API dan aliasopusmenunjuk ke Opus terbaru (saat ini Opus 5.5), sedangkan aliassonnetmenunjuk 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 sepertiANTHROPIC_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, aliasopus, dan aliassonnetperlu ditetapkan ke versi tertentu. Di sini, aliasopusditetapkan 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, jalankanclaude updateterlebih dahulu.ANTHROPIC_DEFAULT_SONNET_MODELmenentukan aliassonnet.Dokumentasi resmi menjelaskan bahwa variabel ini menentukan model yang dituju aliassonnetdan model yang digunakanopusplandi luar mode perencanaan (pada tahap eksekusi). Aliassonnetsecara default meminta Sonnet 5.5, yang saat ini tidak disediakan Kunavo. Jika baris ini tidak diatur,/model sonnet, tahap eksekusiopusplan, dan subagen yang ditetapkanmodel: sonnetsemuanya akan mengembalikan 404. Tetapkan juga ke Claude Sonnet 5 (claude-sonnet-5).ANTHROPIC_DEFAULT_HAIKU_MODELmenentukan aliashaiku. Aliashaikuakan 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 haikudan subagen yang ditetapkan kemodel: haiku(termasukclaude-code-guideyang dijalankan Claude Code sendiri) akan menghasilkan 404. Patok keclaude-haiku-4-5di sini.ANTHROPIC_DEFAULT_HAIKU_MODELjuga mengatur tugas latar belakang.Dokumentasi resmi menjelaskan bahwa variabel ini menentukan aliashaikudan 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 aliasopusberharga $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 menampilkanhttps://api.kunavo.com. Jika baris ini tidak ada, berartiANTHROPIC_BASE_URLtidak diteruskan ke sesi tersebut.Auth token: jika tertulisANTHROPIC_AUTH_TOKEN, berarti Anda sedang menggunakan API key, bukan login claude.ai yang tersimpan. Jika yang terlihat adalahLogin methoddan 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.
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_TOKENdiatur; jikaANTHROPIC_BASE_URLmengarah ke alamat non-Anthropic, Remote Control juga dinonaktifkan. /fastakan 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_URLmengarah ke alamat non-Anthropic, pencarian alat MCP secara default dinonaktifkan. - Angka dalam
/contextmerupakan 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/contextakan 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
/feedbackdan 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).
# 可选:关闭 Claude Code 的非必要网络流量(会同时关闭自动更新)
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# 想恢复时删掉这个变量;设成 0 或 false 仍然算开启
unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICIsi 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:
- Daftarkan akun Kunavo dengan email atau akun Google; pendaftaran tidak memerlukan kartu.
- 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.
- 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.
- Buka /app/keys untuk membuat key yang diawali
sk-kn-(hanya ditampilkan sekali, jadi segera simpan), lalu masukkan keANTHROPIC_AUTH_TOKENdi 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).
| Model | Setiap permintaan | Total 50 permintaan | Jika 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 terlihat | Penyebab dan solusi |
|---|---|
The token '&&' is not a valid statement separator | Anda menjalankan baris CMD di PowerShell; gunakan baris irm … | iex sebagai gantinya. |
'irm' is not recognized as an internal or external command | Anda menjalankan baris PowerShell di CMD; gunakan baris install.cmd sebagai gantinya. |
syntax error near unexpected token '<'、403 | Alamat 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 recognized | Direktori instalasi tidak berada di PATH. Buka terminal baru terlebih dahulu; di Windows, gunakan cuplikan PowerShell di atas untuk menambahkan PATH pengguna. |
Peringatan EBADENGINE | Node.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 loaded | Strategi eksekusi PowerShell memblokir skrip peluncur npm. Jalankan baris Set-ExecutionPolicy atau gunakan instalasi native. |
Claude Code does not support 32-bit Windows | Windows PowerShell (x86) terbuka; buka versi yang tidak bertanda x86. |
Setelah key diatur, halaman login tetap muncul saat menjalankan claude | Claude Code tidak membaca kredensial. Tulis variabel di konfigurasi shell atau ~/.claude/settings.json, bukan hanya di settings tingkat proyek; setelah mengubahnya, buka terminal baru. |
401 | Key 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. |
404 | ANTHROPIC_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.comdapat 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.