Cara Setup Claude Code + 9Router di Windows

Claude Code dapat digunakan di Windows dan dihubungkan ke 9Router untuk meneruskan request melalui gateway lokal sebelum diproses oleh provider atau Combo yang tersedia di 9Router.

Pada tutorial ini kita akan melakukan setup dari awal menggunakan Windows, PowerShell, Node.js, Claude Code, dan 9Router. Konfigurasi juga menggunakan settings.json sehingga tidak perlu mengetik environment variable setiap kali membuka terminal.

Apa Itu Claude Code dan 9Router?

Claude Code adalah CLI dari Anthropic yang memungkinkan developer menggunakan AI langsung dari terminal untuk membantu membaca, membuat, mengubah, dan menganalisis source code.

9Router berfungsi sebagai gateway yang dapat menerima request dari Claude Code kemudian meneruskannya ke provider atau Combo yang telah dikonfigurasi.

Secara sederhana, alurnya seperti berikut:

Claude Code
    ↓
9Router
    ↓
Combo / Provider
    ↓
AI Model

Claude Code mendukung Windows secara native maupun melalui WSL. Pada tutorial ini kita menggunakan Windows native agar seluruh proses dapat dilakukan langsung dari PowerShell.

Persiapan

Sebelum memulai, siapkan:

• Windows 10 atau Windows 11
• Node.js 18 atau versi lebih baru
• npm
• Claude Code
• 9Router
• API Key 9Router
• Minimal satu provider atau Combo di 9Router

Claude Code saat ini mendukung Windows native dan WSL. Untuk native Windows, Git for Windows direkomendasikan karena Claude Code menggunakan Git Bash untuk beberapa operasi.

1. Install Node.js

Jika Node.js belum terpasang, install Node.js terlebih dahulu. Setelah instalasi selesai, buka PowerShell.

Cek versi Node.js:

node --version

Kemudian cek npm:

npm --version

Pastikan Node.js dapat dipanggil dari PowerShell. Claude Code membutuhkan Node.js versi yang didukung oleh instalasi yang digunakan.

2. Install Git for Windows

Untuk penggunaan Claude Code secara native di Windows, install Git for Windows.

Setelah selesai, pastikan Git tersedia:

git --version

Claude Code mendokumentasikan Git for Windows sebagai kebutuhan yang direkomendasikan untuk penggunaan native Windows.

3. Install Claude Code

Buka PowerShell dan jalankan:

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

Setelah selesai, cek instalasi:

claude --version

Jika command claude belum dikenali, tutup PowerShell lalu buka kembali. Dokumentasi Anthropic juga menyarankan membuka terminal baru jika command belum masuk ke PATH.

Kamu juga dapat menjalankan:

claude doctor

Command tersebut berguna untuk memeriksa instalasi Claude Code.

4. Install 9Router

Setelah Claude Code berhasil dipasang, install 9Router menggunakan npm:

npm install -g 9router

Cek apakah command 9Router sudah tersedia:

9router --version

5. Jalankan 9Router

Jalankan 9Router:

9router

Setelah berjalan, dashboard 9Router dapat diakses melalui browser pada:

http://localhost:20128/dashboard

Endpoint API lokal yang digunakan Claude Code adalah:

http://localhost:20128/v1

Dokumentasi integrasi 9Router untuk Claude Code juga menggunakan endpoint lokal http://localhost:20128/v1.

6. Hubungkan Provider atau Combo

Buka dashboard 9Router dan masuk ke bagian provider atau Combo. Pastikan provider yang ingin digunakan sudah terhubung dan aktif.

Jika menggunakan Combo, pilih atau buat Combo yang ingin digunakan Claude Code.

Contohnya:

coding-free

Perlu diperhatikan bahwa nama Combo seperti coding-free bukan nama universal. Nama tersebut bergantung pada konfigurasi 9Router yang digunakan.

7. Siapkan API Key 9Router

Dari dashboard 9Router, siapkan API Key yang akan digunakan oleh Claude Code.

Contoh:

sk-xxxxxxxxxxxxxxxxxxxxxxxx

8. Buat File settings.json

Claude Code dapat menyimpan environment variable pada settings.json. Dokumentasi Claude Code mendukung environment variable di bawah property env.

Pada Windows, file user-level tersebut berada di:

%USERPROFILE%\.claude\settings.json

Kamu dapat membukanya menggunakan Notepad melalui PowerShell:

notepad "$HOME\.claude\settings.json"

Jika folder .claude belum tersedia, buat terlebih dahulu:

New-Item -ItemType Directory -Force "$HOME\.claude"

9. Isi settings.json

Masukkan konfigurasi berikut:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128/v1",
    "ANTHROPIC_AUTH_TOKEN": "API_KEY_9ROUTER",

    "ANTHROPIC_DEFAULT_OPUS_MODEL": "coding-free",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "coding-free",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "coding-free"
  },
  "theme": "auto"
}

Ganti:

API_KEY_9ROUTER

dengan API Key milikmu.

Konfigurasi ANTHROPIC_BASE_URL digunakan untuk mengarahkan Claude Code ke gateway atau proxy, sedangkan ANTHROPIC_AUTH_TOKEN digunakan sebagai nilai header Authorization dengan prefix Bearer.

10. Penjelasan Konfigurasi

ANTHROPIC_BASE_URL

Variable ini menentukan endpoint API yang digunakan Claude Code. Karena kita menggunakan 9Router lokal, nilainya adalah:

http://localhost:20128/v1

ANTHROPIC_AUTH_TOKEN

Variable ini berisi API Key 9Router.

ANTHROPIC_DEFAULT_OPUS_MODEL

Menentukan model tujuan ketika Claude Code menggunakan alias Opus.

ANTHROPIC_DEFAULT_SONNET_MODEL

Menentukan model tujuan ketika menggunakan alias Sonnet.

ANTHROPIC_DEFAULT_HAIKU_MODEL

Menentukan model tujuan ketika menggunakan alias Haiku.

9Router mendokumentasikan ketiga environment variable model mapping tersebut untuk Claude Code.

11. Kenapa Model Mapping Dibutuhkan?

Claude Code dapat meminta model tertentu berdasarkan alias seperti opus, sonnet, atau haiku. Ketika menggunakan gateway seperti 9Router, model tujuan harus tersedia pada konfigurasi 9Router.

Jika Claude Code meminta model yang tidak tersedia, kamu dapat menemukan error seperti:

There's an issue with the selected model.
It may not exist or you may not have access.

Oleh karena itu, alias tersebut dapat diarahkan ke Combo yang tersedia, misalnya:

coding-free

12. Cek Model yang Tersedia di 9Router

Sebelum menggunakan Combo sebagai model mapping, kamu dapat mengecek model yang tersedia melalui endpoint /v1/models.

Jalankan dari PowerShell:

curl.exe http://localhost:20128/v1/models `
  -H "Authorization: Bearer API_KEY_9ROUTER"

Jika API Key dan endpoint benar, 9Router akan mengembalikan daftar model.

Contohnya:

{
  "object": "list",
  "data": [
    {
      "id": "coding-free",
      "object": "model",
      "owned_by": "combo"
    }
  ]
}

Gunakan nilai id yang benar-benar tersedia pada konfigurasi 9Router.

13. Restart PowerShell

Setelah menyimpan settings.json, tutup Claude Code jika sedang berjalan.

Kemudian tutup PowerShell dan buka PowerShell baru.

Langkah ini membantu memastikan session baru menggunakan konfigurasi terbaru.

14. Jalankan Claude Code

Pastikan 9Router masih berjalan, kemudian pada PowerShell baru jalankan:

claude

Claude Code sekarang seharusnya menggunakan endpoint 9Router berdasarkan konfigurasi pada settings.json.

15. Tes Claude Code

Setelah Claude Code berhasil masuk, coba prompt sederhana terlebih dahulu:

halo

Kemudian coba prompt coding:

buatkan file test.txt yang berisi "Hello from Claude Code"

Jika berhasil, berarti Claude Code sudah dapat mengirim request melalui konfigurasi yang telah dibuat.

16. Tes dengan Prompt Coding

Untuk memastikan workflow coding berjalan, kamu dapat mencoba:

buatkan landing page SaaS menggunakan Tailwind CSS

Claude Code kemudian dapat bekerja pada project directory yang sedang dibuka.

17. Pastikan Request Masuk ke 9Router

Cara terbaik untuk memastikan konfigurasi benar adalah memeriksa dashboard atau log 9Router setelah mengirim prompt melalui Claude Code.

Alur yang diharapkan:

Claude Code
    ↓
settings.json
    ↓
ANTHROPIC_BASE_URL
    ↓
localhost:20128/v1
    ↓
9Router
    ↓
Combo
    ↓
Provider
    ↓
AI Model

18. Troubleshooting: Command claude Tidak Ditemukan

Jika PowerShell menampilkan:

claude : The term 'claude' is not recognized...

coba tutup PowerShell dan buka kembali.

Kemudian cek:

claude --version

Jika masih gagal, pastikan instalasi npm global berada di PATH Windows.

19. Troubleshooting: 401 Invalid API Key

Jika Claude Code menampilkan:

401 Invalid API key

tes API Key secara langsung:

curl.exe http://localhost:20128/v1/models `
  -H "Authorization: Bearer API_KEY_9ROUTER"

Jika daftar model muncul, berarti API Key dan endpoint 9Router sudah berhasil.

Jika hasilnya tetap 401, periksa API Key pada dashboard 9Router.

20. Troubleshooting: Model Tidak Ditemukan

Jika muncul pesan:

model may not exist or you may not have access

kemungkinan model yang diminta Claude Code tidak tersedia di 9Router.

Cek model menggunakan:

curl.exe http://localhost:20128/v1/models `
  -H "Authorization: Bearer API_KEY_9ROUTER"

Kemudian gunakan model ID yang tersedia untuk model mapping.

21. Troubleshooting: 9Router Tidak Bisa Diakses

Jika Claude Code tidak dapat terhubung ke 9Router, pastikan aplikasi 9Router masih berjalan.

Jalankan:

9router

Kemudian pastikan endpoint:

http://localhost:20128/v1

dapat diakses dari Windows.

22. Konfigurasi Final

Jika menggunakan Combo coding-free, konfigurasi akhirnya dapat terlihat seperti berikut:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128/v1",
    "ANTHROPIC_AUTH_TOKEN": "API_KEY_9ROUTER",

    "ANTHROPIC_DEFAULT_OPUS_MODEL": "coding-free",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "coding-free",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "coding-free"
  },
  "theme": "auto"
}

Jangan menggunakan API Key contoh. Ganti dengan API Key milik sendiri.

23. Apakah Harus Menggunakan WSL?

Tidak harus.

Claude Code dapat digunakan secara native di Windows. Anthropic juga menyediakan opsi WSL 1 dan WSL 2. Untuk pengguna yang membutuhkan toolchain Linux, WSL 2 dapat menjadi pilihan yang lebih cocok. Namun, untuk project Windows-native, penggunaan native Windows dapat lebih sederhana.

Kesimpulan

Setup Claude Code dengan 9Router di Windows dapat dilakukan tanpa harus menggunakan macOS atau Linux. Dengan Node.js, Claude Code, 9Router, API Key, dan konfigurasi settings.json, request Claude Code dapat diarahkan ke endpoint lokal 9Router.

Konfigurasi utamanya adalah:

Claude Code
    ↓
ANTHROPIC_BASE_URL
    ↓
http://localhost:20128/v1
    ↓
9Router
    ↓
Combo / Provider
    ↓
AI Model

Pastikan 9Router selalu berjalan ketika Claude Code digunakan, API Key valid, dan model atau Combo yang dipilih memang tersedia pada instance 9Router kamu.

Dengan setup ini, pengguna Windows dapat menggunakan workflow Claude Code yang sama seperti di macOS, tetapi seluruh proses dijalankan langsung dari Windows.