Cara Menggunakan Claude Code dengan OpenRouter

Jika Anda menikmati alur kerja yang mulus dari Claude Code (alat CLI dari Anthropic), maka Anda mungkin tahu bahwa secara default ia mengharapkan format API Anthropic. Namun bagaimana jika Anda ingin menggunakan model yang berbeda, atau menjelajahi model baru yang tidak tersedia melalui API langsung Anthropic? Di sinilah OpenRouter hadir! Ini menyediakan akses API yang terpadu dan kompatibel dengan OpenAI ke ratusan model dari banyak penyedia berbeda.

Dengan menjembatani kedua sistem, Anda bisa mendapatkan yang terbaik dari kedua dunia: antarmuka Claude Code yang ramah pengembang dan katalog model OpenRouter yang luas. Integrasi inilah yang kami seistilahkan sebagai “Claude Code dengan Openrouter.”

Caranya adalah menggunakan "router / proxy" yang menerjemahkan antara dua format API. Setelah Anda mengaturnya, Anda dapat menjalankan Claude Code seperti biasa, tetapi dengan OpenRouter sebagai kekuatan di belakangnya.

Keuntungan Utama Menggunakan Claude Code dengan Openrouter

Menggabungkan Claude Code dan Openrouter membuka berbagai manfaat yang kuat:

• Akses ke 400+ model — termasuk varian Claude, model gaya GPT, LLM sumber terbuka, dan banyak lagi.
• Tidak perlu berlangganan Anthropic — Anda hanya membayar sesuai penggunaan melalui harga bayar-sesuai-pakai Openrouter.
• Pergantian model yang fleksibel — ganti model di tengah sesi di Claude Code dengan /model, atau rutekan berdasarkan jenis tugas (ringan vs penalaran, biaya vs kinerja).
• Optimasi biaya — model berbiaya rendah atau gratis untuk tugas rutin, model kuat hanya saat dibutuhkan: ideal untuk pengembang yang sadar anggaran.
• Perutean lokal atau berbasis cloud — jalankan semuanya secara lokal untuk privasi, atau host router Anda untuk penggunaan tim bersama, CI/CD, atau otomatisasi cloud.
• Peralatan & fleksibilitas — beberapa router mendukung fitur canggih seperti streaming, fallback model, multipleksing beberapa penyedia, dan integrasi dengan alur kerja dev yang lebih luas.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Claude Code terinstal secara global (misalnya melalui npm install -g @anthropic-ai/claude-code).

2. Akun Openrouter dengan kunci API yang valid (sk-or-...) (Buat akun di OpenRouter).

3. Alat router/proxy (Docker paling mudah, tetapi router berbasis Node.js juga berfungsi) untuk menangani konversi format

4. Kenyamanan dasar dalam menggunakan variabel lingkungan dan baris perintah

Dengan penyiapan ini, Anda akan dapat mengarahkan Claude Code ke router — yang kemudian meneruskan permintaan ke Openrouter dan merutekan respons kembali.

Metode 1: y-router (Paling Sederhana dan Direkomendasikan)

Salah satu router yang paling banyak digunakan untuk penyiapan ini adalah y-router. Ini bertindak sebagai penerjemah antara format API yang diharapkan Anthropic dan API gaya OpenAI Openrouter (lihat repo di: GitHub). Berikut cara melakukannya langkah demi langkah dengan y-router:

1. Deploy y-router secara lokal (Docker direkomendasikan):

git clone https://github.com/luohy15/y-router.git
cd y-router
docker compose up -d

Ini akan mengaktifkan layanan router lokal yang mendengarkan (secara default) di http://localhost:8787.

2. Konfigurasikan variabel lingkungan Anda sehingga Claude Code mengirimkan permintaannya ke y-router, bukan langsung ke Anthropic:

export ANTHROPIC_BASE_URL="http://localhost:8787"
export ANTHROPIC_AUTH_TOKEN="sk-or-<kunci-openrouter-anda>"
export ANTHROPIC_MODEL="z-ai/glm-4.5-air"   # untuk model cepat, ringan
# atau export ANTHROPIC_MODEL="z-ai/glm-4.5"   # untuk model yang lebih kuat

3. Jalankan Claude Code:

claude

Antarmuka akan dimulai seperti biasa. Jika Anda mengetik /model, Anda akan melihat model yang didukung Openrouter terpilih. Selamat — Anda sekarang menggunakan Claude Code dengan Openrouter. (ishan.rs)

Metode ini menjaga perutean tetap lokal, sederhana, dan di bawah kendali Anda — ideal untuk pengembang yang menyukai privasi dan overhead minimal.

Metode 2: Claude Code Router (berbasis npm, Kaya Fitur)

Jika Anda memilih untuk tidak menggunakan Docker, ada opsi kuat lainnya: Claude Code Router — alat router berbasis Node.js yang dirancang untuk memberikan akses Claude Code ke penyedia eksternal (lihat repo di GitHub). Berikut cara mengaturnya:

1. Instal secara global:

npm install -g @musistudio/claude-code-router

Kemudian buat file konfigurasi (misalnya ~/.claude-code-router/config.json) dengan pengaturan dan model pilihan Anda. Banyak pengguna menyertakan Openrouter sebagai penyedia, menentukan kunci API mereka dan mencantumkan model yang didukung (detail lebih lanjut tentang metode ini di lgallardo.com).

2. Mulai router:

ccr start

Setelah berjalan, atur ANTHROPIC_BASE_URL ke URL router dan gunakan claude seperti biasa. Router akan menerjemahkan permintaan dan memungkinkan peralihan dinamis antar model — termasuk perilaku fallback, aturan perutean, dan banyak lagi.

Metode ini sangat ampuh jika Anda menginginkan kontrol lebih besar atas perutean model, kebijakan fallback, atau integrasi dalam toolchain yang lebih besar (seperti CI/CD, skrip otomatis, atau eksperimen multi-model).

Metode 3: Proxy Openrouter Langsung (Penyiapan Minimal untuk Pengujian Cepat)

Jika Anda hanya ingin pemeriksaan atau pengujian cepat — tanpa menjalankan router penuh — Anda dapat mencoba mengarahkan Claude Code langsung ke proxy yang kompatibel dengan Openrouter atau adaptor minimal. Beberapa solusi komunitas ada untuk mempermudah ini (lihat repo mereka di GitHub).

Misalnya, Anda dapat mengatur:

export ANTHROPIC_BASE_URL="https://proxy-pilihan-anda.com"
export ANTHROPIC_AUTH_TOKEN="sk-or-<kunci-anda>"
export ANTHROPIC_MODEL="openrouter/nama-model"

Kemudian jalankan Claude Code. Pendekatan ini berguna untuk tes sementara atau eksperimen cepat. Namun, mungkin kurang kokoh (misalnya untuk streaming, panggilan alat, atau sesi jangka panjang), tergantung pada implementasi proxy.

Praktik Terbaik & Tips untuk Pengalaman yang Lancar

1. Periksa kompatibilitas model — tidak semua model mendukung fitur canggih seperti panggilan alat atau jendela konteks panjang. Gunakan model yang lebih ringan untuk tugas sederhana, model yang lebih mumpuni untuk tugas berat seperti penalaran atau pengodean.
2. Amankan kunci API Anda — perlakukan kunci API Openrouter Anda seperti rahasia; simpan dengan aman dan jangan pernah mengeksposnya di sisi klien.
3. Kelola biaya — pantau penggunaan token saat menggunakan model besar; pertimbangkan caching prompt, model fallback, atau perutean berbasis tugas untuk mengoptimalkan keseimbangan biaya/kinerja.
4. Uji penyiapan perutean — setelah konfigurasi, selalu uji dengan perintah sederhana (misalnya claude --model <model>) untuk memastikan semuanya berjalan dengan benar.
5. Gunakan perutean fallback untuk keandalan — dalam penyiapan multi-model, konfigurasikan opsi fallback sehingga jika satu model tidak tersedia, router dapat beralih ke model lain secara otomatis.

Pertanyaan yang Sering Diajukan

P1. Apakah saya perlu membayar Anthropic untuk menggunakan Claude Code dengan Openrouter?
Tidak. Saat dikonfigurasi dengan Openrouter (melalui router atau proxy), Claude Code menggunakan kunci API Openrouter Anda untuk permintaan — Anda tidak memerlukan langganan Anthropic berbayar.

P2. Bisakah saya mengganti model dengan cepat dalam sesi Claude Code yang sama?
Ya. Banyak router (dan Claude Code itu sendiri) memungkinkan Anda mengganti model menggunakan /model <nama_model>. Ini berfungsi di tengah percakapan dalam banyak kasus.

P3. Apakah semua model di Openrouter kompatibel dengan fitur Claude Code (seperti eksekusi alat, streaming)?
Tidak selalu. Beberapa model "khusus teks" atau yang lebih ringan mungkin tidak mendukung panggilan alat, konteks panjang, atau streaming. Untuk alur kerja yang kompleks, gunakan model yang dikenal mendukung fitur-fitur tersebut.

P4. Apakah router Docker lokal lebih aman daripada yang di-hosting?
Secara umum ya. Menjalankan router secara lokal memberi Anda kendali penuh dan menghindari paparan kunci API Anda ke layanan eksternal. Router yang di-hosting nyaman tetapi mungkin menimbulkan masalah keamanan atau keandalan.

P5. Bisakah saya mengintegrasikan penyiapan ini ke dalam CI/CD atau alur kerja otomatis?
Tentu saja. Alat seperti Claude Code Router mendukung file konfigurasi dan variabel lingkungan, yang membuatnya mudah diintegrasikan ke dalam pipeline otomatisasi (GitHub Actions, skrip, dll.).

Kesimpulan

Menggunakan Claude Code dengan Openrouter adalah cara yang elegan dan kuat untuk membebaskan diri dari keterikatan satu penyedia sambil mempertahankan antarmuka pengembang yang familier dan efisien. Baik Anda memilih untuk menjalankan router lokal melalui Docker, menggunakan router berbasis Node.js, atau menguji melalui proxy minimal — Anda membuka pintu ke katalog model yang sangat besar, opsi biaya yang fleksibel, dan alur kerja yang disesuaikan.

Untuk pengembang, proyek sampingan, atau tim yang ingin mengoptimalkan pengodean bertenaga AI tanpa overhead tinggi, penyiapan ini menawarkan keseimbangan kontrol, fleksibilitas, dan skalabilitas yang menarik. Hanya dengan beberapa langkah konfigurasi, Anda dapat secara dramatis memperluas apa yang dapat dilakukan asisten AI Anda — lalu beralih atau menskala sesuai kebutuhan Anda yang berkembang.

Cobalah: sesi kode Anda berikutnya mungkin segera didukung oleh model yang tidak pernah Anda duga — semuanya di bawah antarmuka Claude Code yang familier.