Tutorial Claude Code Setup Awal untuk Pemula (Windows, Linux, macOS)

Kalau kamu baru mau mulai pakai Claude Code, biasanya masalahnya bukan di “ngodingnya”, tapi di setup awal: install, taruh API key, lalu bingung kenapa command error.

Kabar baiknya, proses setup Claude Code sebenarnya simpel kalau urutannya benar. Di panduan ini, kita bahas langkah paling dasar untuk pemula di Windows, Linux, dan macOS—plus troubleshooting paling sering.

Apa yang perlu disiapkan sebelum mulai

Sebelum setup Claude Code, pastikan kamu sudah punya:

1. Node.js & npm (cek dengan node -v dan npm -v)
2. Akun VibeRouter
3. API key VibeRouter dari dashboard

Kenapa pakai VibeRouter? Karena kamu bisa route request Claude Code lewat endpoint yang lebih praktis untuk workflow coding harian, tanpa perlu ubah banyak hal di project.

Konsep singkat: yang diubah cuma 2 hal

Di Claude Code, kamu hanya perlu set:

• ANTHROPIC_BASE_URL → https://api.viberouter.id
• ANTHROPIC_AUTH_TOKEN → isi dengan API key kamu

Penting: ANTHROPIC_BASE_URL jangan ditambah /v1 di belakang.

Setup Claude Code di Linux (Ubuntu/Debian dan turunan)

1) Install Claude Code

npm install -g @anthropic-ai/claude-code

2) Buat file konfigurasi

mkdir -p ~/.claude
nano ~/.claude/settings.json

Isi file:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.viberouter.id",
    "ANTHROPIC_AUTH_TOKEN": "vr_live_xxxxx"
  }
}

3) Jalankan Claude Code

claude

Kalau command claude tidak dikenali, restart terminal dulu atau cek ulang instalasi npm global.

Setup Claude Code di Windows 10/11

1) Install Claude Code

Buka Command Prompt atau PowerShell:

npm install -g @anthropic-ai/claude-code

2) Buka folder konfigurasi Claude

Path default:

C:\Users\<username>\.claude\settings.json

Kalau belum ada, buat folder .claude lalu buat settings.json.

3) Isi settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.viberouter.id",
    "ANTHROPIC_AUTH_TOKEN": "vr_live_xxxxx"
  }
}

4) Tes jalanin Claude Code

claude

Jika kamu pakai WSL, konfigurasi di Windows tidak otomatis terbaca di Linux environment WSL. Setup terpisah di dalam WSL mengikuti langkah Linux.

Setup Claude Code di macOS (Ventura/Sonoma/Sequoia)

1) Install Claude Code

npm install -g @anthropic-ai/claude-code

Kalau kena permission error:

sudo npm install -g @anthropic-ai/claude-code

2) Buat konfigurasi

mkdir -p ~/.claude
nano ~/.claude/settings.json

Isi:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.viberouter.id",
    "ANTHROPIC_AUTH_TOKEN": "vr_live_xxxxx"
  }
}

3) Jalankan

claude

Selesai. Claude Code sekarang akan request lewat VibeRouter.

Troubleshooting paling sering (pemula)

1) Error 401 Unauthorized

Biasanya API key salah, terpotong, atau ada spasi tambahan di settings.json.

2) Error koneksi / URL not found

Cek ANTHROPIC_BASE_URL. Pastikan persis:

https://api.viberouter.id

Tanpa /v1.

3) claude: command not found

Install global gagal atau PATH belum refresh. Coba install ulang lalu buka terminal baru.

4) Di Windows jalan, di WSL gagal

Setup ulang di environment WSL (anggap sebagai Linux terpisah).

Kapan sebaiknya pakai settings.json vs env terminal?

Untuk pemula, settings.json lebih aman karena:

• tidak perlu export ulang tiap buka terminal,
• minim typo,
• gampang dipakai lintas project.

Env terminal cocok kalau kamu butuh setup sementara atau testing cepat.

Internal links (rekomendasi)

• /artikel/cara-pakai-claude-code-dengan-viberouter-api/
• /artikel/router-ai-untuk-coding/
• /artikel/vibe-coding-apa-itu/

Penutup

Kalau kamu baru mulai, fokus ke satu target: Claude Code bisa jalan dulu di laptop kamu, apa pun OS-nya. Setelah itu baru optimasi workflow prompt, struktur project, dan kebiasaan coding harian.

Kalau mau jalur paling cepat, pakai konfigurasi settings.json + endpoint VibeRouter. Setup awal beres, kamu bisa langsung lanjut build tanpa kebanyakan friction teknis.