Clouvia RouterClouvia Router
Konsol Client →
PANDUAN INTEGRASI · CLI & TERMINAL

Koneksi ke Claude Code & Aider

Panduan menyambungkan tool CLI berbasis terminal terpopuler — Claude Code dan Aider — ke Clouvia Router. Nikmati workflow git-aware, auto-commit, dan refactoring codebase langsung dari baris perintah.

TARGET CLI:Claude Code CLI, Aider
ENVIRONMENT:Bash, Zsh, Fish
SPEK PROTOKOL:OpenAI & Anthropic Compatible
DUAL-PROTOCOL GATEWAY AKTIF OTOMATIS
Clouvia Router mendukung dua protokol AI terbesar secara transparan: OpenAI format (/v1/chat/completions) dan Anthropic Messages format (/v1/messages). Tool seperti Claude Code CLI akan langsung berkomunikasi via protokol Anthropic tanpa perlu adapter atau wrapper proxy tambahan.

1. Menghubungkan Claude Code CLI

Pilih sistem operasi atau terminal yang Anda gunakan di bawah ini, lalu jalankan perintah konfigurasi sebelum mengeksekusi binary claude:

Terminal - Claude Code Setup (BASH)bash
1export ANTHROPIC_BASE_URL="https://router.clouvia.id"
2export ANTHROPIC_API_KEY="clv_live_xxxxxxxxxxxxxxxxxxxxxxxx"
3export ANTHROPIC_MODEL="coding-high"
4 
5claude
Atau jalankan one-liner langsung di Bash / WSL:
One-Liner Executionbash
ANTHROPIC_BASE_URL="https://router.clouvia.id" ANTHROPIC_API_KEY="clv_live_xxxxxxxxxxxxxxxxxxxxxxxx" ANTHROPIC_MODEL="coding-high" claude

Mengapa di Hermes / OpenCode Langsung Berjalan, Sedangkan Claude Code Berbeda?

Hermes Agent & OpenCode (OpenAI Compatible)

Hermes, OpenCode, dan Cline dirancang dengan spesifikasi OpenAI API Standard. Mereka mengirim request ke /v1/chat/completions menggunakan header Authorization: Bearer <key>. Ini merupakan standar gateway yang sudah aktif sejak awal di Clouvia Router.

Claude Code CLI (Anthropic Native Protocol)

Claude Code CLI berkomunikasi menggunakan Anthropic Messages Protocol. Client mengirim payload ke /v1/messages dengan header x-api-key dan format message blocks khusus. Gateway Clouvia Router kini memiliki modul Anthropic Translation Engine bawaan untuk menerjemahkan streaming dan token secara real-time.

Solusi Masalah Umum (Troubleshooting)

Error: 'There is an issue with the selected model (coding-high)...'

TROUBLESHOOTING

Jika Claude Code menampilkan pesan error model tidak ditemukan atau tidak dapat diakses, periksa langkah berikut:

  1. Periksa Base URL: Pastikan Anda menyetel ANTHROPIC_BASE_URL="https://router.clouvia.id". Clouvia Router juga mendukung jika Anda menyetel https://router.clouvia.id/v1.
  2. Periksa API Key: Pastikan API key Anda dimulai dengan clv_live_ dan berstatus aktif di dashboard.
  3. Pilih Model: Jalankan perintah /model di dalam Claude Code untuk beralih ke model lain, atau ekspor environment variable ANTHROPIC_MODEL="coding-high".
  4. Gunakan Model Rekomendasi: Model premier untuk coding agen adalah coding-high, claude-opus-4.8, atau sonnet-4.5-thinking-agentic.

2. Menghubungkan Aider Terminal Pair Programmer

Aider mendukung mode OpenAI kompatibel penuh. Gunakan flag openai/coding-high untuk memberitahu Aider agar menggunakan model coding premier Clouvia Router:

Terminal Shell - Menjalankan Aiderbash
1export OPENAI_API_BASE="https://router.clouvia.id/v1"
2export OPENAI_API_KEY="clv_live_xxxxxxxxxxxxxxxxxxxxxxxx"
3 
4aider --model openai/coding-high

Konfigurasi Permanen Aider via .aider.conf.yml

FILE CONFIG

Agar tidak perlu mengekspor environment variables setiap kali membuka terminal baru, Anda dapat membuat file .aider.conf.yml di root repositori proyek Anda:

.aider.conf.ymlyaml
1openai-api-base: https://router.clouvia.id/v1
2openai-api-key: clv_live_xxxxxxxxxxxxxxxxxxxxxxxx
3model: openai/coding-high
4edit-format: diff

3. Menyimpan Environment Variable Secara Permanen

Pilih metode penyimpanan permanen sesuai sistem operasi Anda:

Pilihan A: Linux / macOS / WSL (~/.bashrc atau ~/.zshrc)
~/.bashrc atau ~/.zshrcbash
1export OPENAI_API_BASE="https://router.clouvia.id/v1"
2export OPENAI_API_KEY="clv_live_xxxxxxxxxxxxxxxxxxxxxxxx"
3export ANTHROPIC_BASE_URL="https://router.clouvia.id"
4export ANTHROPIC_API_KEY="clv_live_xxxxxxxxxxxxxxxxxxxxxxxx"
5export ANTHROPIC_MODEL="coding-high"
Pilihan B: Windows PowerShell (Permanen User Environment Variable)
Windows PowerShell (Jalankan Sekali)powershell
1[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://router.clouvia.id', 'User')
2[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'clv_live_xxxxxxxxxxxxxxxxxxxxxxxx', 'User')
3[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'coding-high', 'User')

Setelah menyimpan konfigurasi di atas, buka jendela terminal baru agar environment variable aktif secara otomatis di setiap sesi.