Cara Setting Claude Code CLI di Windows dengan Helipod AI Gateway (Bayar Rupiah)
Bài viết này được viết bằng tiếng Indonesia.
Claude Code adalah asisten coding berbasis terminal: kamu cukup mengetik permintaan, lalu ia membaca kode, mengedit file, dan menjalankan perintah di project kamu. Secara bawaan Claude Code butuh akun berbayar dengan tagihan dalam dolar. Kabar baiknya, Claude Code bisa diarahkan ke endpoint lain yang memakai format Anthropic, termasuk Helipod AI Gateway.
Hasilnya: Claude Code tetap sama persis, tapi model yang berpikir di belakangnya adalah GLM, DeepSeek, Kimi, atau model lain di katalog Helipod. Kamu bayar per token dari saldo AI dalam Rupiah, diisi lewat QRIS atau virtual account.
Panduan ini khusus untuk Windows 10 dan Windows 11, memakai PowerShell.
Daftar Isi#
- Yang Kamu Butuhkan
- Buat API Key dan Isi Saldo AI
- Tes API Key dari PowerShell
- Install Claude Code di Windows
- Arahkan Claude Code ke Helipod AI Gateway
- Jalankan dan Cek Koneksinya
- Pilih Model yang Cocok
- Tips Hemat Biaya
- Troubleshooting
- FAQ
1. Yang Kamu Butuhkan#
- Windows 10 (versi 1809 ke atas) atau Windows 11
- Git for Windows. Claude Code di Windows memakai Git Bash untuk menjalankan perintah shell, jadi ini wajib.
- Akun Helipod (bisa daftar dengan Google)
- Saldo AI minimal Rp5.000 untuk mencoba
Kamu tidak perlu akun Anthropic atau kartu kredit.
2. Buat API Key dan Isi Saldo AI#
Buat API key#
- Masuk ke dashboard Helipod, buka project kamu, lalu pilih menu AI Gateway.
- Buka API keys, klik Create API key.
- Beri nama yang jelas, misalnya
claude-code-laptop. Satu key per tool atau per perangkat memudahkan kamu melihat biaya masing-masing dan mencabut satu key tanpa mengganggu yang lain. - (Disarankan) Isi batas belanja bulanan, misalnya Rp150.000. Sesi coding yang panjang bisa memakai banyak token, dan batas ini mencegah tagihan melewati rencana.
- Salin key yang muncul. Formatnya diawali
hel_ai_. Key hanya ditampilkan sekali.
Isi saldo AI#
Saldo AI diisi dari wallet Helipod:
- Di AI Gateway → Overview, pilih nominal top up atau masukkan nominal sendiri.
- Kalau saldo wallet kurang, isi wallet dulu lewat QRIS atau virtual account.
- Aktifkan Auto top-up kalau kamu tidak mau Claude Code berhenti di tengah pekerjaan karena saldo habis.
3. Tes API Key dari PowerShell#
Sebelum memasang Claude Code, pastikan key kamu sudah bisa dipakai. Buka PowerShell, lalu simpan key di variabel sementara:
$key = "hel_ai_xxxxxxxxxxxxxxxxxxxxxxxx"
Kirim satu pesan ke gateway dengan format Anthropic:
$body = @{
model = "deepseek-v4.1-flash"
max_tokens = 100
messages = @(@{ role = "user"; content = "Halo, tes koneksi" })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Method Post -Uri "https://ai.helipod.io/v1/messages" `
-Headers @{ "x-api-key" = $key; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json" -Body $body
Kalau yang keluar berisi content dan usage, key dan saldo kamu sudah benar.
Di PowerShell, perintah
curladalah alias untukInvoke-WebRequest, bukan curl asli. Kalau kamu menyalin contoh curl dari dokumentasi, ketikcurl.exesupaya yang jalan adalah curl bawaan Windows.
4. Install Claude Code di Windows#
Ada dua cara. Pilih salah satu.
Cara A: Installer native (disarankan)#
Jalankan di PowerShell (tidak perlu Run as Administrator):
irm https://claude.ai/install.ps1 | iex
Installer ini tidak butuh Node.js dan akan memperbarui Claude Code secara otomatis.
Cara B: Lewat npm#
Kalau kamu sudah memakai Node.js 18 atau lebih baru:
npm install -g @anthropic-ai/claude-code
Jangan memakai sudo atau menjalankan npm sebagai Administrator kalau tidak perlu.
Cek hasil install#
Tutup lalu buka lagi PowerShell, kemudian jalankan:
claude --version
Kalau muncul nomor versi, Claude Code sudah terpasang. Kalau muncul claude is not recognized, lihat bagian Troubleshooting.
5. Arahkan Claude Code ke Helipod AI Gateway#
Claude Code membaca alamat API, token, dan nama model dari environment variable. Ada tiga cara mengaturnya di Windows. Untuk pemakaian sehari-hari, Cara A paling rapi.
Variabel yang dipakai:
| Variabel | Isi | Fungsi |
|---|---|---|
ANTHROPIC_BASE_URL |
https://ai.helipod.io |
Alamat gateway. Tanpa /v1 di belakang, karena Claude Code menambahkannya sendiri. |
ANTHROPIC_AUTH_TOKEN |
hel_ai_... |
API key Helipod kamu |
ANTHROPIC_MODEL |
misalnya glm-5.3 |
Model utama untuk coding |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
misalnya deepseek-v4.1-flash |
Model cepat untuk tugas latar belakang (judul sesi, ringkasan, dan sejenisnya) |
Cara A: File settings Claude Code (disarankan)#
Claude Code membaca file settings.json di folder .claude milik user Windows kamu. Buka file-nya dengan Notepad:
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
notepad "$env:USERPROFILE\.claude\settings.json"
Kalau Notepad bertanya apakah mau membuat file baru, pilih Yes. Isi dengan:
{
"env": {
"ANTHROPIC_BASE_URL": "https://ai.helipod.io",
"ANTHROPIC_AUTH_TOKEN": "hel_ai_xxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_MODEL": "glm-5.3",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4.1-flash"
}
}
Simpan dengan Ctrl+S. Pastikan nama file-nya settings.json, bukan settings.json.txt. Kalau ragu, cek dengan:
Get-ChildItem "$env:USERPROFILE\.claude"
Kelebihan cara ini: setting hanya berlaku untuk Claude Code, tidak mengganggu aplikasi lain yang mungkin juga membaca variabel ANTHROPIC_*.
File ini berisi API key. Jangan ikut menyalinnya ke repository Git atau membagikannya. Kalau key sempat bocor, cabut di AI Gateway → API keys lalu buat yang baru.
Cara B: Environment variable permanen untuk user Windows#
Kalau kamu lebih suka variabel sistem, jalankan sekali di PowerShell:
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.helipod.io", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "hel_ai_xxxxxxxxxxxxxxxxxxxxxxxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "glm-5.3", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-v4.1-flash", "User")
Variabel ini baru terbaca di jendela terminal baru. Tutup semua PowerShell dan terminal di VS Code, lalu buka lagi.
Cek apakah sudah tersimpan:
$env:ANTHROPIC_BASE_URL
Kamu juga bisa melihat dan mengubahnya lewat Start → ketik "environment variables" → Edit environment variables for your account.
Cara C: Hanya untuk satu sesi PowerShell#
Cocok untuk mencoba-coba. Variabel hilang begitu jendela PowerShell ditutup:
$env:ANTHROPIC_BASE_URL = "https://ai.helipod.io"
$env:ANTHROPIC_AUTH_TOKEN = "hel_ai_xxxxxxxxxxxxxxxxxxxxxxxx"
$env:ANTHROPIC_MODEL = "glm-5.3"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-v4.1-flash"
claude
Kalau kamu memakai Command Prompt (cmd), bentuknya set ANTHROPIC_BASE_URL=https://ai.helipod.io dan seterusnya, tanpa tanda kutip.
6. Jalankan dan Cek Koneksinya#
Masuk ke folder project kamu, lalu jalankan Claude Code:
cd C:\Users\kamu\projects\toko-online
claude
Di dalam Claude Code, ketik:
/status
Pastikan alamat API yang tampil adalah https://ai.helipod.io dan modelnya sesuai yang kamu atur. Lalu coba permintaan sederhana:
jelaskan struktur project ini dalam 5 poin
Kalau Claude Code membaca file dan menjawab, semuanya sudah tersambung. Pemakaian token akan muncul di AI Gateway → Usage di dashboard Helipod, lengkap dengan biaya per request dalam Rupiah.
7. Pilih Model yang Cocok#
Claude Code bekerja dengan banyak langkah: membaca file, memanggil tool, mengedit, lalu mengecek hasil. Karena itu model utamanya perlu kuat di tool calling dan konteks panjang. Semua model di bawah ini mendukung format Anthropic dan tool calling.
| Model | Cocok untuk |
|---|---|
glm-5.3 |
Model utama sehari-hari, seimbang antara kualitas dan harga |
deepseek-v4-pro |
Refactor besar dan debugging yang butuh penalaran panjang |
kimi-k3 |
Tugas paling berat, kalau kualitas lebih penting dari biaya |
glm-5.3-flash |
Model cepat dan murah, bagus untuk tugas latar belakang |
deepseek-v4.1-flash |
Model cepat dengan konteks 1 juta token |
Harga tiap model per 1 juta token, dalam Rupiah, ada di daftar harga AI Gateway dan di menu Models & pricing di dashboard.
Untuk mengganti model utama, ubah ANTHROPIC_MODEL di settings.json. Untuk mencoba model lain di tengah sesi tanpa mengubah file, jalankan Claude Code dengan:
claude --model deepseek-v4-pro
Pakai kode model Helipod (misalnya
glm-5.3), bukan nama modelclaude-*. Nama model yang tidak ada di daftar kamu bisa dijawab oleh model default yang dipilih Helipod, dan biayanya mengikuti model itu.
8. Tips Hemat Biaya#
- Setiap giliran mengirim ulang percakapan. Makin panjang sesi, makin banyak token input per pesan. Ketik
/clearsaat pindah ke tugas yang tidak berhubungan, atau/compactuntuk meringkas percakapan yang sudah panjang. - Prompt cache membuat sesi panjang lebih murah. Model yang mendukung caching menagih bagian percakapan yang berulang dengan harga cached, yang jauh lebih murah dari harga input biasa.
- Perhatikan jam sibuk. Beberapa model, seperti
deepseek-v4.1-flash, punya harga berbeda di jam sibuk hari kerja. Jadwal dan harganya ada di daftar harga AI Gateway. Kalau kamu sering coding di jam kantor, pilih model latar belakang yang harganya sama sepanjang hari. - Pasang batas belanja per key. Kalau batas tercapai, key menolak request sampai bulan berikutnya. Tidak ada kejutan di akhir bulan.
- Cek Usage secara rutin. Menu AI Gateway → Usage menampilkan token dan biaya per model, per key, dan per hari.
9. Troubleshooting#
claude is not recognized as the name of a cmdlet
Tutup lalu buka lagi PowerShell setelah install. Kalau masih gagal, pastikan folder instalasi masuk ke PATH. Untuk instalasi native, foldernya biasanya %USERPROFILE%\.local\bin. Untuk npm, jalankan npm config get prefix dan pastikan folder itu ada di PATH.
Claude Code minta Git Bash atau tidak bisa menjalankan perintah
Install Git for Windows. Kalau Git sudah terpasang di lokasi yang tidak biasa, tambahkan baris ini ke bagian env di settings.json (sesuaikan path-nya):
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
Perhatikan backslash ditulis dua kali di dalam JSON.
Claude Code masih menampilkan layar login Anthropic
Biasanya karena variabel belum terbaca. Cek settings.json sudah benar dan valid (tidak ada koma berlebih), atau kalau memakai Cara B, pastikan kamu membuka terminal baru. Jalankan /status untuk melihat alamat API yang sedang dipakai.
Error 401 atau authentication_error
Key salah, tertukar spasi saat disalin, atau sudah dicabut. Salin ulang key dari dashboard dan pastikan tidak ada spasi di awal atau akhir.
Error 402
Saldo AI habis atau batas belanja bulanan key sudah tercapai. Isi saldo AI, naikkan batasnya, atau aktifkan Auto top-up.
Error 404 pada /v1/v1/messages
ANTHROPIC_BASE_URL diisi dengan /v1 di belakang. Ganti menjadi https://ai.helipod.io saja.
Error 429
Terlalu banyak request dalam waktu singkat. Tunggu sebentar lalu coba lagi.
Error SSL atau koneksi ditolak di jaringan kantor
Beberapa jaringan kantor memakai proxy. Atur HTTPS_PROXY di bagian env dengan alamat proxy dari tim IT kamu.
10. FAQ#
Apakah ini memakai model Claude buatan Anthropic? Tidak. Yang kamu pakai adalah aplikasi Claude Code, sedangkan modelnya dari katalog Helipod AI Gateway (GLM, DeepSeek, Kimi, dan lainnya). Daftar lengkap ada di menu Models & pricing.
Apakah semua fitur Claude Code jalan? Fitur inti seperti membaca dan mengedit file, menjalankan perintah, subagent, MCP server, dan slash command berjalan normal karena semuanya memakai tool calling standar. Tool yang dijalankan di server Anthropic (misalnya web search bawaan) tidak tersedia.
Apakah bisa dipakai di VS Code?
Bisa. Jalankan claude di terminal VS Code. Kalau memakai Cara A, setting di settings.json otomatis terbaca. Kalau memakai Cara B, restart VS Code setelah mengatur variabel.
Bisakah saya pindah lagi ke akun Anthropic?
Bisa. Hapus bagian env dari settings.json (atau hapus variabelnya kalau memakai Cara B), lalu jalankan claude dan login seperti biasa.
Apakah bisa dipakai di WSL?
Bisa. Di dalam WSL, Claude Code berjalan seperti di Linux. Atur variabelnya di ~/.claude/settings.json milik user Linux kamu, dengan isi yang sama seperti di atas.
Bagaimana dengan tool coding lain seperti Codex, opencode, atau Cline? Satu API key Helipod bisa dipakai di semuanya. Panduan konfigurasinya ada di dokumentasi Coding tools.
Siap mencoba? Buat API key di menu AI Gateway, isi saldo AI mulai Rp5.000, dan Claude Code di laptop Windows kamu langsung jalan dengan model pilihanmu. Daftar model dan harga lengkap ada di helipod.io/ai-gateway.