Setup AgentRouter + Claude Code (Windows PowerShell)

Panduan lengkap untuk menginstall dan menjalankan CLI agent AI menggunakan AgentRouter di Windows.

Daftar Isi

• Prasyarat
• Cara Mendapatkan API Key
• Instalasi
• Konfigurasi API Key
• Menjalankan Claude Code
• Troubleshooting
• Keamanan

---

Prasyarat

Sebelum memulai, pastikan Anda telah menginstall:

1. Node.js (versi 18 atau lebih baru)

   • Download dari: https://nodejs.org/
   • Verifikasi instalasi:

     node --version
     npm --version

2. Package Manager (salah satu):

   • npm (sudah termasuk dengan Node.js)
   • pnpm (opsional): npm install -g pnpm

3. PowerShell (sudah termasuk di Windows)

   • Buka PowerShell sebagai Administrator untuk instalasi global

---

Cara Mendapatkan API Key

1. Kunjungi AgentRouter
2. Daftar atau login ke akun Anda
3. Navigasi ke halaman API Keys
4. Buat API key baru atau copy existing key
5. Simpan API key dengan aman (format: sk-xxx...)

Catatan: API key hanya ditampilkan sekali, pastikan menyimpannya dengan aman.

---

Instalasi

Langkah 1: Clone atau Download Repository

cd C:\Users\admin\Desktop\test
git clone <repository-url> ankara-cli
cd ankara-cli

Atau download dan extract manual ke folder C:\Users\admin\Desktop\test\ankara-cli

Langkah 2: Instal Claude Code

Skrip run-ankara.ps1 akan otomatis menginstal @anthropic-ai/claude-code jika belum ada.

Atau install manual:

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

# Atau menggunakan pnpm
pnpm install -g @anthropic-ai/claude-code

Verifikasi instalasi:

claude --version

---

Konfigurasi API Key

Anda hanya perlu mengkonfigurasi ANTHROPIC_API_KEY. Ada 3 cara untuk mengkonfigurasi:

Opsi 1: Menggunakan Script Setup (Disarankan)

Untuk sesi saat ini saja:

./setup-agentrouter.ps1 -ApiKey "sk-your-api-key-here"

Untuk persisten (permanen):

./setup-agentrouter.ps1 -ApiKey "sk-your-api-key-here" -Persist

Catatan: Setelah menggunakan -Persist, restart PowerShell terminal untuk efek penuh.

Opsi 2: Menggunakan File .env

1. Copy file template:

   Copy-Item ENV_SAMPLE .env

2. Edit file .env menggunakan text editor:

   notepad .env

3. Isi dengan API key Anda:

   ANTHROPIC_API_KEY=sk-your-api-key-here
   ANTHROPIC_BASE_URL=https://agentrouter.org/
   

4. Simpan file

Opsi 3: Set Environment Variable Manual

Untuk sesi saat ini:

$env:ANTHROPIC_API_KEY = "sk-your-api-key-here"
$env:ANTHROPIC_BASE_URL = "https://agentrouter.org/"

Untuk persisten (User level):

[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-your-api-key-here', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://agentrouter.org/', 'User')

Restart PowerShell setelah set persistent variable.

---

Menjalankan Claude Code

Cara 1: Menggunakan Run Script (Disarankan)

cd C:\Users\admin\Desktop\test\ankara-cli
./run-ankara.ps1

Skrip ini akan:

1. Mengecek apakah Node.js terinstal
2. Mengecek package manager (npm/pnpm)
3. Menginstal @anthropic-ai/claude-code jika belum ada
4. Membaca API key dari .env atau environment variable
5. Menjalankan perintah claude di direktori saat ini

Cara 2: Menjalankan Claude Langsung

Jika sudah setup API key dan install global:

cd C:\Users\admin\Desktop\test\ankara-cli
claude

Menjalankan di Folder Proyek Lain

cd C:\path\to\your\project
C:\Users\admin\Desktop\test\ankara-cli\run-ankara.ps1

Atau:

cd C:\path\to\your\project
$env:ANTHROPIC_API_KEY = "sk-your-api-key"
claude

---

Troubleshooting

Error: "Node.js tidak ditemukan"

Solusi:

• Install Node.js dari https://nodejs.org/
• Restart PowerShell setelah instalasi
• Verifikasi: node --version

Error: "ANTHROPIC_API_KEY tidak ditemukan"

Solusi:

1. Cek apakah file .env ada dan berisi API key yang benar
2. Atau jalankan: ./setup-agentrouter.ps1 -ApiKey "sk-xxx"
3. Pastikan tidak ada spasi atau karakter tersembunyi di API key

Error: "Gagal memasang package secara global"

Solusi:

• Jalankan PowerShell sebagai Administrator
• Atau gunakan: npm install -g @anthropic-ai/claude-code --force

API Key Tidak Terdeteksi Setelah Restart

Solusi:

• Jika menggunakan -Persist, pastikan restart PowerShell setelah setup
• Verifikasi dengan: Get-ChildItem Env:ANTHROPIC_API_KEY
• Atau gunakan file .env sebagai alternatif

Claude Command Not Found

Solusi:

1. Install ulang global package:

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

2. Check npm global path:

   npm config get prefix

3. Pastikan path tersebut ada di system PATH

Connection Error atau 401 Unauthorized

Solusi:

• Verifikasi API key valid di https://agentrouter.org/
• Cek ANTHROPIC_BASE_URL: https://agentrouter.org/
• Coba generate API key baru

---

Keamanan

Jangan Commit API Key ke Repository

1. Pastikan .env ada di .gitignore:

   .env
   .env.local
   

2. Gunakan GITIGNORE_SAMPLE sebagai referensi:

   Copy-Item GITIGNORE_SAMPLE .gitignore

Best Practices

• Jangan share API key dengan orang lain
• Jangan commit file .env ke Git
• Rotate API key secara berkala
• Gunakan .env untuk development, environment variables untuk production
• Hapus API key dari history PowerShell setelah set manual:

  Clear-History

---

Referensi & Dokumentasi

• Claude Code: https://docs.claude.com/claude-code
• AgentRouter: https://docs.agentrouter.org/start.html
• Node.js: https://nodejs.org/
• PowerShell: https://docs.microsoft.com/powershell

---

Struktur File

ankara-cli/
├── run-ankara.ps1           # Script utama untuk menjalankan Claude
├── setup-agentrouter.ps1    # Script setup API key
├── ENV_SAMPLE               # Template file .env
├── GITIGNORE_SAMPLE         # Template .gitignore
├── README.md                # Dokumentasi ini
└── .env                     # File konfigurasi (jangan commit!)

---

Bantuan & Support

Jika mengalami masalah:

1. Baca bagian Troubleshooting
2. Cek dokumentasi resmi di link referensi
3. Pastikan semua prasyarat terpenuhi
4. Verifikasi API key valid dan aktif