Provider Setup Guide / Provider Kurulum Rehberi

English | Provider Setup Guide

Overview

Claude Code Router supports multiple AI providers with intelligent routing. You can use one or more providers simultaneously, and the router will automatically switch between them based on cost, performance, and quality.

Current Architecture

Request → Smart Intent Router → Provider Selection → AI Response
                ↓                    ↓
          Intent Analysis       GLM-5 (Primary)
          (Cost Optimized)      Claude Pro (Quality)
                                DeepSeek (Budget)
                                MiniMax (Long Context)
                                Qwen (Fallback)
                                Gemini (Backup)
                                OpenAI (Premium)

Quick Start

Install & Setup

npm install -g @halilertekin/claude-code-router-config
ccr-setup

Configure API Keys

# Edit your .env file
nano ~/.env

Start Router

ccr start    # Start router server
ccr code     # Start router + Claude Code

Available Providers

Provider	API Base URL	Cost (per 1M tokens)	Best For
GLM-5 (z.ai)	`api.z.ai/api/coding/paas/v4`	~$0.50	Coding Plan (3x usage)
GLM API (z.ai)	`api.z.ai/api/paas/v4`	~$0.50	Pay-per-use
Claude Pro	Official Anthropic	~$3.00	Premium quality
DeepSeek	`api.deepseek.com/anthropic`	~$0.60	Budget coding
MiniMax	`api.minimax.io/anthropic`	~$0.30	Long context (200k+)
Qwen	`dashscope-intl.aliyuncs.com/...`	~$0.10	Cost-optimized
Gemini	`generativelanguage.googleapis.com/...`	~$0.01	Fast responses
OpenAI	`api.openai.com/v1/...`	~$2.50	Premium quality

Adding Providers

Step 1: Get API Key

GLM-5 (z.ai) - Recommended

Website: https://z.ai/apikeys
Pricing: Very competitive, 3x usage with Coding Plan
Sign up → Create API Key
Two endpoints:
- Coding Plan: https://api.z.ai/api/coding/paas/v4
- API Credits: https://api.z.ai/api/paas/v4

MiniMax

Website: https://platform.minimax.io/
Pricing: Very competitive, ultra-long context (200k+ tokens)
Sign up → Create API Key

DeepSeek

Website: https://platform.deepseek.com/
Pricing: Affordable
Sign up → Create API Key

Qwen (Alibaba)

Website: https://dashscope-intl.aliyuncs.com/
Pricing: https://dashscope-intl.aliyuncs.com/pricing
Sign up → Create API Key

Gemini (Google)

Website: https://ai.google.dev/
Pricing: Free tier available
Sign up → Create API Key

OpenAI

Website: https://platform.openai.com/
Pricing: https://openai.com/pricing
Sign up → Create API Key

Anthropic

Website: https://console.anthropic.com/
Pricing: https://anthropic.com/pricing
Sign up → Create API Key

OpenRouter

Website: https://openrouter.ai/
Pricing: Varies by model
Sign up → Create API Key

Step 2: Add to `.env` File

Edit ~/.env:

# Primary Provider (GLM - Recommended)
export GLM_API_KEY="your_glm_api_key_here"

# Additional Providers (Optional - for routing)
export QWEN_API_KEY="your_qwen_api_key_here"
export GEMINI_API_KEY="your_gemini_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"
export ANTHROPIC_API_KEY="your_anthropic_api_key_here"
export OPENROUTER_API_KEY="your_openrouter_api_key_here"

Step 3: Verify Setup

# Check configuration
ccr status --detailed

# Test provider connection
ccr test glm
ccr test qwen
ccr test gemini

# Benchmark providers
ccr benchmark --all --compare-speed

Inter-Provider Routing

The router automatically switches between providers based on:

Intent Analysis
- Coding tasks → GLM (cost-effective)
- Reasoning → GLM with fallback to Qwen
- Fast responses → GLM or Gemini
- Complex tasks → OpenAI with fallback
Cost Optimization
- Primary: GLM (~$0.50/1M tokens)
- Fallback 1: Qwen (~$0.10/1M tokens)
- Fallback 2: Gemini (~$0.01/1M tokens)
- Premium: OpenAI/Anthropic (when quality needed)
Health Monitoring
- If provider fails → automatic fallback
- Performance tracking → optimal provider selection
- Cost tracking → budget management

Routing Flow Example

User Request: "Help me refactor this code"
     ↓
Intent Router: CODING intent detected
     ↓
Provider Selection: glm,glm-4.7 (Pro) or glm5,glm-5 (Max) or glmapi,glm-5 (API Credits)
     ↓
Try GLM → Success ✅
     OR
Try GLM → Failure ❌ → Fallback to Qwen ✅

Configuration Examples

Example 1: Cost-Optimized Setup (GLM Only)

{
  "Router": {
    "default": "glm,glm-5",
    "fallbacks": ["qwen,qwen-plus", "gemini,gemini-2.5-flash"]
  }
}

.env:

export GLM_API_KEY="your_key"
# No other keys needed - GLM handles everything

Example 2: Multi-Provider Setup (With Routing)

{
  "Router": {
    "default": "glm,glm-5",
    "fallbacks": ["qwen,qwen-plus", "gemini,gemini-2.5-flash", "openai,gpt-4o"]
  }
}

.env:

export GLM_API_KEY="your_glm_key"
export QWEN_API_KEY="your_qwen_key"
export GEMINI_API_KEY="your_gemini_key"
export OPENAI_API_KEY="your_openai_key"

Example 3: Quality-Optimized Setup (Premium)

{
  "Router": {
    "default": "anthropic,claude-sonnet-4-latest",
    "fallbacks": ["openai,gpt-4o", "glm,glm-5"]
  }
}

.env:

export ANTHROPIC_API_KEY="your_anthropic_key"
export OPENAI_API_KEY="your_openai_key"
export GLM_API_KEY="your_glm_key"

Advanced: Custom Routing Rules

Edit ~/.claude-code-router/smart-intent-router.js:

// Custom routing based on your needs
CODING: {
  patterns: [/\b(coding|debug|refactor)\b/i],
  route: "glm,glm-5",           // Primary
  fallbacks: [
    "qwen,qwen3-coder-plus",      // Fallback 1
    "openai,gpt-4o"               // Fallback 2 (premium)
  ]
}

Troubleshooting

Issue: Provider not working

# Check if API key is set
echo $GLM_API_KEY

# Test connection
ccr test glm

# Check logs
tail -f ~/.claude-code-router/logs/app.log

Issue: Always using same provider

# Check router config
cat ~/.claude-code-router/config.json | jq '.Router'

# Verify intent router
cat ~/.claude-code-router/smart-intent-router.js

Issue: High costs

# Check analytics
ccr analytics --today

# Verify cost optimization is enabled
ccr status --detailed --show-costs

Cost Comparison

Task	Claude Sonnet 4.5	GLM 4.7	Savings
100K coding tasks	$300	$50	83%
1M tokens input	$3.00	$0.50	83%
1M tokens output	$15.00	$2.00	87%

Türkçe | Provider Kurulum Rehberi

Genel Bakış

Claude Code Router, birden fazla AI sağlayıcısını akıllı yönlendirme ile destekler. Aynı anda bir veya daha fazla sağlayıcı kullanabilirsiniz, router maliyet, performans ve kaliteye göre otomatik olarak sağlayıcılar arası geçiş yapar.

Mevcut Mimari

İstek → Akıllı Intent Router → Sağlayıcı Seçimi → AI Cevabı
              ↓                      ↓
        Intent Analizi           GLM-5 (Birincil)
        (Maliyet Optimize)      Claude Pro (Kalite)
                                DeepSeek (Bütçe)
                                MiniMax (Uzun Bağlam)
                                Qwen (Yedek)
                                Gemini (Yedek 2)
                                OpenAI (Premium)

Hızlı Başlangıç

Kurulum

npm install -g @halilertekin/claude-code-router-config
ccr-setup

API Key Yapılandırma

# .env dosyasını düzenle
nano ~/.env

Router'ı Başlat

ccr start    # Router sunucusunu başlat
ccr code     # Router + Claude Code'u başlat

Mevcut Sağlayıcılar

Sağlayıcı	API URL	Maliyet (1M token)	En İyi Kullanım
GLM-5 (z.ai)	`api.z.ai/api/coding/paas/v4`	~$0.50	Coding Plan (3x kullanım)
GLM API (z.ai)	`api.z.ai/api/paas/v4`	~$0.50	Kredi ile ödeme
Claude Pro	Official Anthropic	~$3.00	Premium kalite
DeepSeek	`api.deepseek.com/anthropic`	~$0.60	Bütçe kodlama
MiniMax	`api.minimax.io/anthropic`	~$0.30	Uzun bağlam (200k+)
Qwen	`dashscope-intl.aliyuncs.com/...`	~$0.10	Maliyet optimize
Gemini	`generativelanguage.googleapis.com/...`	~$0.01	Hızlı cevap
OpenAI	`api.openai.com/v1/...`	~$2.50	Premium kalite

Sağlayıcı Ekleme

Adım 1: API Key Al

GLM-5 (z.ai) - Önerilen

Website: https://z.ai/apikeys
Fiyatlandırma: Çok uygun, Coding Plan ile 3x kullanım
Kayıt ol → API Key Oluştur
İki endpoint:
- Coding Plan: https://api.z.ai/api/coding/paas/v4
- API Kredileri: https://api.z.ai/api/paas/v4

MiniMax

Website: https://platform.minimax.io/
Fiyatlandırma: Çok uygun, ultra-uzun bağlam (200k+ token)
Kayıt ol → API Key Oluştur

DeepSeek

Website: https://platform.deepseek.com/
Fiyatlandırma: Uygun fiyat
Kayıt ol → API Key Oluştur

Qwen (Alibaba)

Website: https://dashscope-intl.aliyuncs.com/
Fiyatlandırma: https://dashscope-intl.aliyuncs.com/pricing
Kayıt ol → API Key Oluştur

Gemini (Google)

Website: https://ai.google.dev/
Fiyatlandırma: Ücretsiz tier mevcut
Kayıt ol → API Key Oluştur

OpenAI

Website: https://platform.openai.com/
Fiyatlandırma: https://openai.com/pricing
Kayıt ol → API Key Oluştur

Anthropic

Website: https://console.anthropic.com/
Fiyatlandırma: https://anthropic.com/pricing
Kayıt ol → API Key Oluştur

OpenRouter

Website: https://openrouter.ai/
Fiyatlandırma: Modele göre değişir
Kayıt ol → API Key Oluştur

Adım 2: `.env` Dosyasına Ekle

~/.env dosyasını düzenle:

# Birincil Sağlayıcı (GLM - Önerilen)
export GLM_API_KEY="glm_api_key_buraya"

# Ek Sağlayıcılar (Opsiyonel - yönlendirme için)
export MINIMAX_API_KEY="minimax_api_key_buraya"
export DEEPSEEK_API_KEY="deepseek_api_key_buraya"
export QWEN_API_KEY="qwen_api_key_buraya"
export GEMINI_API_KEY="gemini_api_key_buraya"
export OPENAI_API_KEY="openai_api_key_buraya"
export ANTHROPIC_API_KEY="anthropic_api_key_buraya"
export OPENROUTER_API_KEY="openrouter_api_key_buraya"

Adım 3: Kurulumu Doğrula

# Yapılandırmayı kontrol et
ccr status --detailed

# Sağlayıcı bağlantısını test et
ccr test glm
ccr test qwen
ccr test gemini

# Sağlayıcıları benchmark et
ccr benchmark --all --compare-speed

Sağlayıcılar Arası Yönlendirme

Router, sağlayıcılar arasında şunlara göre otomatik geçiş yapar:

Intent Analizi
- Kodlama görevleri → GLM (ucuz)
- Akıl yürütme → GLM, Qwen yedeği
- Hızlı cevaplar → GLM veya Gemini
- Karmaşık görevler → OpenAI, yedeği mevcut
Maliyet Optimizasyonu
- Birincil: GLM (~$0.50/1M token)
- Yedek 1: Qwen (~$0.10/1M token)
- Yedek 2: Gemini (~$0.01/1M token)
- Premium: OpenAI/Anthropic (kalite gerektiğinde)
Sağlık İzleme
- Sağlayıcı başarısız → otomatik yedek
- Performans izleme → optimal sağlayıcı seçimi
- Maliyet izleme → bütçe yönetimi

Yönlendirme Akışı Örneği

Kullanıcı İsteği: "Bu kodu refactor etmemeye yardımcı olur musun?"
     ↓
Intent Router: KODlama intent'i algılandı
     ↓
Sağlayıcı Seçimi: glm,glm-5 (birincil)
     ↓
GLM Dene → Başarılı ✅
     VEYA
GLM Dene → Başarısız ❌ → Qwen Yedeği ✅

Yapılandırma Örnekleri

Örnek 1: Maliyet Optimize Kurulum (Sadece GLM)

{
  "Router": {
    "default": "glm,glm-5",
    "fallbacks": ["qwen,qwen-plus", "gemini,gemini-2.5-flash"]
  }
}

.env:

export GLM_API_KEY="senin_key"
# Diğer key'lere gerek yok - GLM her şeyi halleder

Örnek 2: Çoklu Sağlayıcı Kurulum (Yönlendirme ile)

{
  "Router": {
    "default": "glm,glm-5",
    "fallbacks": ["qwen,qwen-plus", "gemini,gemini-2.5-flash", "openai,gpt-4o"]
  }
}

.env:

export GLM_API_KEY="glm_key"
export QWEN_API_KEY="qwen_key"
export GEMINI_API_KEY="gemini_key"
export OPENAI_API_KEY="openai_key"

Örnek 3: Kalite Optimize Kurulum (Premium)

{
  "Router": {
    "default": "anthropic,claude-sonnet-4-latest",
    "fallbacks": ["openai,gpt-4o", "glm,glm-5"]
  }
}

.env:

export ANTHROPIC_API_KEY="anthropic_key"
export OPENAI_API_KEY="openai_key"
export GLM_API_KEY="glm_key"

İleri Seviye: Özel Yönlendirme Kuralları

~/.claude-code-router/smart-intent-router.js dosyasını düzenle:

// İhtiyaçlarına göre özel yönlendirme
CODING: {
  patterns: [/\b(coding|debug|refactor|kodlama)\b/i],
  route: "glm,glm-5",              // Birincil
  fallbacks: [
    "qwen,qwen3-coder-plus",         // Yedek 1
    "openai,gpt-4o"                  // Yedek 2 (premium)
  ]
}

Sorun Giderme

Sorun: Sağlayıcı çalışmıyor

# API key'in ayarlanmış olduğunu kontrol et
echo $GLM_API_KEY

# Bağlantıyı test et
ccr test glm

# Logları kontrol et
tail -f ~/.claude-code-router/logs/app.log

Sorun: Her zaman aynı sağlayıcıyı kullanıyor

# Router yapılandırmasını kontrol et
cat ~/.claude-code-router/config.json | jq '.Router'

# Intent router'ı doğrula
cat ~/.claude-code-router/smart-intent-router.js

Sorun: Yüksek maliyetler

# Analitikleri kontrol et
ccr analytics --today

# Maliyet optimizasyonunun açık olduğunu doğrula
ccr status --detailed --show-costs

Maliyet Karşılaştırması

Görev	Claude Sonnet 4.5	GLM 4.7	Tasarruf
100K kodlama görevi	$300	$50	%83
1M token input	$3.00	$0.50	%83
1M token output	$15.00	$2.00	%87

CLI Komutları

# Router yönetimi
ccr start              # Router'ı başlat
ccr stop               # Router'ı durdur
ccr restart            # Router'ı yeniden başlat
ccr status             # Durumu göster
ccr code               # Router + Claude Code

# İstatistikler
ccr analytics --today  # Bugünün kullanımı
ccr analytics          # Haftalık özet
ccr benchmark          # Karşılaştırmalı test

# Test ve doğrulama
ccr test glm           # GLM bağlantısını test et
ccr config validate    # Yapılandırmayı doğrula

# Dashboard
ccr ui                 # Web dashboard'ı aç

Daha Fazla Bilgi

GitHub Repository: https://github.com/halilertekin/CC-RouterMultiProvider
Issues: https://github.com/halilertekin/CC-RouterMultiProvider/issues
Changelog: CHANGELOG.md

Created by Halil Ertekin Version: 2.4.0 Last Updated: 2026-02-15

FilesExpand file tree

PROVIDER_SETUP.md

Latest commit

History

PROVIDER_SETUP.md

File metadata and controls

Provider Setup Guide / Provider Kurulum Rehberi

English | Provider Setup Guide

Overview

Current Architecture

Quick Start

Available Providers

Adding Providers

Step 1: Get API Key

Step 2: Add to .env File

Step 3: Verify Setup

Inter-Provider Routing

Routing Flow Example

Configuration Examples

Example 1: Cost-Optimized Setup (GLM Only)

Example 2: Multi-Provider Setup (With Routing)

Example 3: Quality-Optimized Setup (Premium)

Advanced: Custom Routing Rules

Troubleshooting

Cost Comparison

Türkçe | Provider Kurulum Rehberi

Genel Bakış

Mevcut Mimari

Hızlı Başlangıç

Mevcut Sağlayıcılar

Sağlayıcı Ekleme

Adım 1: API Key Al

Adım 2: .env Dosyasına Ekle

Adım 3: Kurulumu Doğrula

Sağlayıcılar Arası Yönlendirme

Yönlendirme Akışı Örneği

Yapılandırma Örnekleri

Örnek 1: Maliyet Optimize Kurulum (Sadece GLM)

Örnek 2: Çoklu Sağlayıcı Kurulum (Yönlendirme ile)

Örnek 3: Kalite Optimize Kurulum (Premium)

İleri Seviye: Özel Yönlendirme Kuralları

Sorun Giderme

Maliyet Karşılaştırması

CLI Komutları

Daha Fazla Bilgi

Step 2: Add to `.env` File

Adım 2: `.env` Dosyasına Ekle