@halilertekin/claude-code-router-config 2.0.9 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.1.0
+- **NEW**: UI now supports 3 languages - Turkish (TR), Dutch (NL), and English (EN)
+- **NEW**: Comprehensive provider setup guide added with multi-provider routing documentation
+- **NEW**: Inter-provider routing with automatic fallback support
+- **IMPROVED**: Default routing strategy now prioritizes GLM (z.ai) for cost optimization
+- **IMPROVED**: Smart intent router updated with GLM-first approach for all intents
+- **DOCS**: Added `docs/PROVIDER_SETUP.md` with detailed multi-language instructions
+
 ## 2.0.9
 - GLM print mode disables attachments to avoid EMFILE (too many open files) watcher errors.
 

package/README.md

@@ -176,12 +176,43 @@ Metrics tracked:
 
 ## Documentation
 
+- [**Provider Setup Guide** (EN/TR)](docs/PROVIDER_SETUP.md) - **Multiple providers with intelligent routing**
 - [Complete Documentation (EN)](docs/FULL_DOCUMENTATION_EN.md)
 - [Complete Documentation (TR)](docs/FULL_DOCUMENTATION.md)
 - [Setup Prompt (EN)](docs/SETUP_PROMPT_EN.md)
 - [Setup Prompt (TR)](docs/SETUP_PROMPT.md)
 - [Configuration Templates Guide](templates/README.md)
 
+## Provider Setup / Sağlayıcı Kurulumu 🆕
+
+**📖 Read the [Provider Setup Guide](docs/PROVIDER_SETUP.md) for:**
+- How to add multiple providers (OpenRouter, OpenAI, Gemini, Qwen)
+- Inter-provider routing with automatic fallback
+- Cost optimization strategies (up to 87% savings!)
+- Configuration examples and troubleshooting
+
+**🔗 Hızlı Provider Ekleme:**
+
+| Provider | Get API Key | Cost (1M tokens) |
+|----------|-------------|------------------|
+| [GLM (z.ai)](https://open.bigmodel.cn/) | [Sign Up](https://open.bigmodel.cn/) | ~$0.50 ⭐ |
+| [Qwen](https://dashscope-intl.aliyuncs.com/) | [Sign Up](https://dashscope-intl.aliyuncs.com/) | ~$0.10 |
+| [Gemini](https://ai.google.dev/) | [Sign Up](https://ai.google.dev/) | ~$0.01 |
+| [OpenAI](https://platform.openai.com/) | [Sign Up](https://platform.openai.com/) | ~$2.50 |
+| [OpenRouter](https://openrouter.ai/) | [Sign Up](https://openrouter.ai/) | Variable |
+
+```bash
+# Add to ~/.env
+export GLM_API_KEY="your_key_here"
+export OPENROUTER_API_KEY="your_key_here"
+export GEMINI_API_KEY="your_key_here"
+
+# Verify setup
+ccr status --detailed
+ccr test glm
+ccr benchmark --all
+```
+
 ## License
 
 MIT © [Halil Ertekin](https://github.com/halilertekin)

package/SETUP.md

@@ -0,0 +1,165 @@
+# Claude Code Router - Setup Guide / Kurulum Rehberi
+
+> **Türkçe** | [English](#english)
+
+## Kullanım
+
+```bash
+# .zshrc dosyanıza ekleyin:
+source ~/code/claude-code-router-config/cli/ccc.zsh
+```
+
+## Alias'lar
+
+| Komut | Provider | Endpoint | Model |
+|-------|----------|----------|-------|
+| `glm` | z.ai Coding Plan | `api.z.ai/api/coding/paas/v4` | GLM-5 |
+| `glmapi` | z.ai API (Kredi) | `api.z.ai/api/paas/v4` | GLM-5 |
+| `claude-pro` | Anthropic Claude Pro | Official API | Claude Sonnet 4.5 |
+| `deepseek` | DeepSeek | `api.deepseek.com/anthropic` | deepseek-chat |
+
+## API Key Kurulumu
+
+### 1. z.ai (GLM) API Key
+
+`~/.env` dosyanıza ekleyin:
+
+```bash
+export GLM_API_KEY="your_z.ai_api_key_here"
+```
+
+Key almak için: https://z.ai/apikeys
+
+### 2. Claude Pro
+
+Claude Pro kullanıcıları `claude login` ile giriş yapabilir veya:
+
+```bash
+export ANTHROPIC_API_KEY="your_anthropic_api_key"
+```
+
+### 3. DeepSeek (opsiyonel)
+
+```bash
+export DEEPSEEK_API_KEY="your_deepseek_api_key"
+```
+
+## Örnek Kullanım
+
+```bash
+# Coding Plan ile GLM-5 kullan
+glm
+
+# API kredisi ile GLM-5 kullan
+glmapi
+
+# Claude Pro kullan
+claude-pro
+
+# DeepSeek kullan
+deepseek
+```
+
+## Dosya Yapısı
+
+```
+claude-code-router-config/
+├── cli/
+│   └── ccc.zsh          # Ana konfigürasyon dosyası
+├── config/              # Model konfigürasyonları
+├── router/              # Routing mantığı
+└── docs/               # Dokümantasyon
+```
+
+## Sorun Giderme
+
+### "GLM_API_KEY not set" hatası
+- `~/.env` dosyasında key'in doğru olduğundan emin olun
+- Dosyayı kaydettikten sonra terminali yeniden açın veya `source ~/.env` yapın
+
+### Model çalışmıyorsa
+- API key'in geçerli olduğunu kontrol edin
+- Kotalarınızı kontrol edin (özellikle glmapi için)
+
+---
+
+<a name="english"></a>
+
+## Usage
+
+```bash
+# Add to your .zshrc:
+source ~/code/claude-code-router-config/cli/ccc.zsh
+```
+
+## Aliases
+
+| Command | Provider | Endpoint | Model |
+|---------|----------|----------|-------|
+| `glm` | z.ai Coding Plan | `api.z.ai/api/coding/paas/v4` | GLM-5 |
+| `glmapi` | z.ai API (Credits) | `api.z.ai/api/paas/v4` | GLM-5 |
+| `claude-pro` | Anthropic Claude Pro | Official API | Claude Sonnet 4.5 |
+| `deepseek` | DeepSeek | `api.deepseek.com/anthropic` | deepseek-chat |
+
+## API Key Setup
+
+### 1. z.ai (GLM) API Key
+
+Add to your `~/.env`:
+
+```bash
+export GLM_API_KEY="your_z.ai_api_key_here"
+```
+
+Get your key from: https://z.ai/apikeys
+
+### 2. Claude Pro
+
+Claude Pro users can login with `claude login` or:
+
+```bash
+export ANTHROPIC_API_KEY="your_anthropic_api_key"
+```
+
+### 3. DeepSeek (optional)
+
+```bash
+export DEEPSEEK_API_KEY="your_deepseek_api_key"
+```
+
+## Example Usage
+
+```bash
+# Use GLM-5 with Coding Plan
+glm
+
+# Use GLM-5 with API credits
+glmapi
+
+# Use Claude Pro
+claude-pro
+
+# Use DeepSeek
+deepseek
+```
+
+## File Structure
+
+```
+claude-code-router-config/
+├── cli/
+│   └── ccc.zsh          # Main configuration file
+├── config/              # Model configurations
+├── router/              # Routing logic
+└── docs/               # Documentation
+```
+
+## Troubleshooting
+
+### "GLM_API_KEY not set" error
+- Make sure the key in `~/.env` is correct
+- After saving, restart terminal or run `source ~/.env`
+
+### Model not working
+- Check if your API key is valid
+- Check your quotas (especially for glmapi)

package/cli/ccc.zsh

@@ -50,28 +50,48 @@ ccc() {
 
   # 2. CONFIGURATION based on alias
   case "$model_alias" in
-    glm|zhipu|zai|pp|zero)
-      # z.ai / GLM 4.7 configuration
-      export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
-      # Priority: 1. ENV, 2. PP_KEY (config), 3. GLM_KEY (config)
+    glm)
+      # z.ai / GLM Coding Plan endpoint
+      export ANTHROPIC_BASE_URL="https://api.z.ai/api/coding/paas/v4"
       export ANTHROPIC_API_KEY="${GLM_API_KEY:-${PPINFRA_API_KEY:-$GLM_KEY}}"
       export ANTHROPIC_AUTH_TOKEN="$ANTHROPIC_API_KEY"
-      export ANTHROPIC_MODEL="glm-4.7"
+      export ANTHROPIC_MODEL="glm-5"
       export API_TIMEOUT_MS=3000000
       
-      # Force mappings for z.ai
-      export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-4.7"
-      export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-4.7"
+      export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5"
+      export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5"
       export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-4.5-air"
       export ANTHROPIC_SMALL_FAST_MODEL="glm-4.5-air"
-      export CLAUDE_CODE_SUBAGENT_MODEL="glm-4.7"
+      export CLAUDE_CODE_SUBAGENT_MODEL="glm-5"
 
       if [[ -z "$ANTHROPIC_API_KEY" ]]; then
         echo "GLM_API_KEY not set. Add it to ~/.env or ~/.claude-code-router/keys.env" >&2
         return 1
       fi
       
-      echo "🔄 Provider: z.ai (GLM 4.7)"
+      echo "🔄 Provider: z.ai (GLM-5 Coding Plan)"
+      ;;
+      
+    glmapi)
+      # z.ai / GLM Standard API (kredi ile kullanım)
+      export ANTHROPIC_BASE_URL="https://api.z.ai/api/paas/v4"
+      export ANTHROPIC_API_KEY="${GLM_API_KEY:-${PPINFRA_API_KEY:-$GLM_KEY}}"
+      export ANTHROPIC_AUTH_TOKEN="$ANTHROPIC_API_KEY"
+      export ANTHROPIC_MODEL="glm-5"
+      export API_TIMEOUT_MS=3000000
+      
+      export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5"
+      export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5"
+      export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-4.5-air"
+      export ANTHROPIC_SMALL_FAST_MODEL="glm-4.5-air"
+      export CLAUDE_CODE_SUBAGENT_MODEL="glm-5"
+
+      if [[ -z "$ANTHROPIC_API_KEY" ]]; then
+        echo "GLM_API_KEY not set. Add it to ~/.env or ~/.claude-code-router/keys.env" >&2
+        return 1
+      fi
+      
+      echo "🔄 Provider: z.ai (GLM-5 API - Kredi)"
       ;;
       
     ds|deepseek)
@@ -93,7 +113,7 @@ ccc() {
       
     *)
       echo "Unknown model alias: $model_alias"
-      echo "Available: glm, ds, claude"
+      echo "Available: glm (coding plan), glmapi (kredi), ds, claude"
       return 1
       ;;
   esac
@@ -110,5 +130,6 @@ ccc() {
 
 # Shortcuts
 alias glm="ccc glm"
+alias glmapi="ccc glmapi"
 alias deepseek="ccc ds"
 alias claude-pro="ccc claude"

package/docs/PROVIDER_SETUP.md

@@ -0,0 +1,599 @@
+# Provider Setup Guide / Provider Kurulum Rehberi
+
+[English](#english) | [Türkçe](#türkçe)
+
+---
+
+<a name="english"></a>
+## 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 (Primary)
+          (Cost Optimized)      Qwen (Fallback)
+                                Gemini (Backup)
+                                OpenAI (Premium)
+                                Anthropic (Quality)
+```
+
+### Quick Start
+
+1. **Install & Setup**
+```bash
+npm install -g @halilertekin/claude-code-router-config
+ccr-setup
+```
+
+2. **Configure API Keys**
+```bash
+# Edit your .env file
+nano ~/.env
+```
+
+3. **Start Router**
+```bash
+ccr start    # Start router server
+ccr code     # Start router + Claude Code
+```
+
+---
+
+### Available Providers
+
+| Provider | API Base URL | Cost (per 1M tokens) | Best For |
+|----------|-------------|---------------------|----------|
+| **GLM (z.ai)** | `https://api.z.ai/api/anthropic` | ~$0.50 | Cost-effective, multilingual |
+| **Qwen** | `https://dashscope-intl.aliyuncs.com/...` | ~$0.10 | Coding, cost-optimized |
+| **Gemini** | `https://generativelanguage.googleapis.com/...` | ~$0.01 | Fast responses |
+| **OpenAI** | `https://api.openai.com/v1/...` | ~$2.50 | Premium quality |
+| **Anthropic** | `https://api.anthropic.com/v1/...` | ~$3.00 | Best quality |
+| **OpenRouter** | `https://openrouter.ai/api/v1/...` | Variable | Variety, fallback |
+
+---
+
+### Adding Providers
+
+#### Step 1: Get API Key
+
+**GLM (z.ai)**
+- Website: https://open.bigmodel.cn/
+- Pricing: https://open.bigmodel.cn/pricing
+- 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`:
+
+```bash
+# 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
+
+```bash
+# 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:
+
+1. **Intent Analysis**
+   - Coding tasks → GLM (cost-effective)
+   - Reasoning → GLM with fallback to Qwen
+   - Fast responses → GLM or Gemini
+   - Complex tasks → OpenAI with fallback
+
+2. **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)
+
+3. **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 (primary)
+     ↓
+Try GLM → Success ✅
+     OR
+Try GLM → Failure ❌ → Fallback to Qwen ✅
+```
+
+---
+
+### Configuration Examples
+
+#### Example 1: Cost-Optimized Setup (GLM Only)
+
+```json
+{
+  "Router": {
+    "default": "glm,glm-4.7",
+    "fallbacks": ["qwen,qwen-plus", "gemini,gemini-2.5-flash"]
+  }
+}
+```
+
+`.env`:
+```bash
+export GLM_API_KEY="your_key"
+# No other keys needed - GLM handles everything
+```
+
+#### Example 2: Multi-Provider Setup (With Routing)
+
+```json
+{
+  "Router": {
+    "default": "glm,glm-4.7",
+    "fallbacks": ["qwen,qwen-plus", "gemini,gemini-2.5-flash", "openai,gpt-4o"]
+  }
+}
+```
+
+`.env`:
+```bash
+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)
+
+```json
+{
+  "Router": {
+    "default": "anthropic,claude-sonnet-4-latest",
+    "fallbacks": ["openai,gpt-4o", "glm,glm-4.7"]
+  }
+}
+```
+
+`.env`:
+```bash
+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`:
+
+```javascript
+// Custom routing based on your needs
+CODING: {
+  patterns: [/\b(coding|debug|refactor)\b/i],
+  route: "glm,glm-4.7",           // Primary
+  fallbacks: [
+    "qwen,qwen3-coder-plus",      // Fallback 1
+    "openai,gpt-4o"               // Fallback 2 (premium)
+  ]
+}
+```
+
+---
+
+### Troubleshooting
+
+**Issue: Provider not working**
+```bash
+# 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**
+```bash
+# 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**
+```bash
+# 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%** |
+
+---
+
+<a name="türkçe"></a>
+---
+## 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 (Birincil)
+        (Maliyet Optimize)       Qwen (Yedek)
+                               Gemini (Yedek 2)
+                               OpenAI (Premium)
+                               Anthropic (Kalite)
+```
+
+### Hızlı Başlangıç
+
+1. **Kurulum**
+```bash
+npm install -g @halilertekin/claude-code-router-config
+ccr-setup
+```
+
+2. **API Key Yapılandırma**
+```bash
+# .env dosyasını düzenle
+nano ~/.env
+```
+
+3. **Router'ı Başlat**
+```bash
+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 (z.ai)** | `https://api.z.ai/api/anthropic` | ~$0.50 | Ucuz, çok dilli |
+| **Qwen** | `https://dashscope-intl.aliyuncs.com/...` | ~$0.10 | Kodlama, ucuz |
+| **Gemini** | `https://generativelanguage.googleapis.com/...` | ~$0.01 | Hızlı cevap |
+| **OpenAI** | `https://api.openai.com/v1/...` | ~$2.50 | Premium kalite |
+| **Anthropic** | `https://api.anthropic.com/v1/...` | ~$3.00 | En iyi kalite |
+| **OpenRouter** | `https://openrouter.ai/api/v1/...` | Değişken | Çeşitlilik |
+
+---
+
+### Sağlayıcı Ekleme
+
+#### Adım 1: API Key Al
+
+**GLM (z.ai)**
+- Website: https://open.bigmodel.cn/
+- Fiyatlandırma: https://open.bigmodel.cn/pricing
+- 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:
+
+```bash
+# 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 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
+
+```bash
+# 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:
+
+1. **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
+
+2. **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)
+
+3. **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-4.7 (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)
+
+```json
+{
+  "Router": {
+    "default": "glm,glm-4.7",
+    "fallbacks": ["qwen,qwen-plus", "gemini,gemini-2.5-flash"]
+  }
+}
+```
+
+`.env`:
+```bash
+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)
+
+```json
+{
+  "Router": {
+    "default": "glm,glm-4.7",
+    "fallbacks": ["qwen,qwen-plus", "gemini,gemini-2.5-flash", "openai,gpt-4o"]
+  }
+}
+```
+
+`.env`:
+```bash
+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)
+
+```json
+{
+  "Router": {
+    "default": "anthropic,claude-sonnet-4-latest",
+    "fallbacks": ["openai,gpt-4o", "glm,glm-4.7"]
+  }
+}
+```
+
+`.env`:
+```bash
+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:
+
+```javascript
+// İhtiyaçlarına göre özel yönlendirme
+CODING: {
+  patterns: [/\b(coding|debug|refactor|kodlama)\b/i],
+  route: "glm,glm-4.7",              // Birincil
+  fallbacks: [
+    "qwen,qwen3-coder-plus",         // Yedek 1
+    "openai,gpt-4o"                  // Yedek 2 (premium)
+  ]
+}
+```
+
+---
+
+### Sorun Giderme
+
+**Sorun: Sağlayıcı çalışmıyor**
+```bash
+# 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**
+```bash
+# 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**
+```bash
+# 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ı
+
+```bash
+# 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](../CHANGELOG.md)
+
+---
+
+*Created by Halil Ertekin*
+*Version: 2.0.9*
+*Last Updated: 2025-01-11*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halilertekin/claude-code-router-config",
-  "version": "2.0.9",
+  "version": "2.2.0",
   "description": "Multi-provider configuration for Claude Code Router with intent-based routing, advanced CLI tools, analytics, and smart routing. Setup OpenAI, Anthropic, Gemini, Qwen, GLM, OpenRouter, and GitHub Copilot with intelligent routing.",
   "main": "install.js",
   "bin": {
@@ -39,7 +39,9 @@
     "CHANGELOG.md",
     "LICENSE",
     "README.md",
-    "NPM_README.md"
+    "NPM_README.md",
+    "SETUP.md",
+    "quick-setup.sh"
   ],
   "keywords": [
     "claude",

package/quick-setup.sh

@@ -0,0 +1,55 @@
+#!/bin/zsh
+
+# Claude Code Router - Quick Setup Script
+# Usage: ./quick-setup.sh
+
+echo "🔧 Claude Code Router - Quick Setup / Hızlı Kurulum"
+echo "====================================================="
+
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+ZSHRC="$HOME/.zshrc"
+
+# 1. Add source line to .zshrc
+SOURCE_LINE='[[ -f "$HOME/code/claude-code-router-config/cli/ccc.zsh" ]] && source "$HOME/code/claude-code-router-config/cli/ccc.zsh"'
+
+if grep -q "claude-code-router-config/cli/ccc.zsh" "$ZSHRC" 2>/dev/null; then
+    echo "✅ .zshrc already configured"
+else
+    echo "" >> "$ZSHRC"
+    echo "# Claude Code Router" >> "$ZSHRC"
+    echo "$SOURCE_LINE" >> "$ZSHRC"
+    echo "✅ .zshrc updated"
+fi
+
+# 2. Check .env file
+ENV_FILE="$HOME/.env"
+if [[ ! -f "$ENV_FILE" ]]; then
+    touch "$ENV_FILE"
+fi
+
+if grep -q "GLM_API_KEY" "$ENV_FILE" 2>/dev/null; then
+    echo "✅ GLM_API_KEY defined"
+else
+    echo "" >> "$ENV_FILE"
+    echo "# z.ai GLM API Key" >> "$ENV_FILE"
+    echo 'export GLM_API_KEY="YOUR_KEY_HERE"' >> "$ENV_FILE"
+    echo "⚠️ Added GLM_API_KEY to .env - replace with your actual key"
+fi
+
+# 3. Reload shell
+source "$ZSHRC"
+
+echo ""
+echo "✅ Setup complete!"
+echo ""
+echo "Usage / Kullanım:"
+echo "  glm       → z.ai Coding Plan (GLM-5)"
+echo "  glmapi    → z.ai API Credits (GLM-5)"  
+echo "  claude-pro → Claude Pro"
+echo "  deepseek  → DeepSeek"
+echo ""
+echo "Next steps / Sonraki adımlar:"
+echo "  1. Get API key from https://z.ai/apikeys"
+echo "  2. Update GLM_API_KEY in ~/.env"
+echo "  3. Restart terminal"
+echo ""

package/web-dashboard/public/index.html

@@ -23,6 +23,7 @@
         <div class="lang-switch">
           <button class="lang-btn" data-lang="tr">TR</button>
           <button class="lang-btn" data-lang="nl">NL</button>
+          <button class="lang-btn" data-lang="en">EN</button>
         </div>
       </div>
     </header>

package/web-dashboard/public/js/dashboard.js

@@ -130,6 +130,65 @@ class Dashboard {
         statusDown: 'Niet beschikbaar',
         statusUnknown: 'Onbekend',
         dataUnavailable: 'Geen gegevens'
+      },
+      en: {
+        appTitle: 'Claude Code Router',
+        appSubtitle: 'Unified router dashboard',
+        refresh: 'Refresh',
+        connected: 'Connected',
+        disconnected: 'Disconnected',
+        overview: 'Overview',
+        lastUpdated: 'Last updated',
+        requests: 'Requests',
+        tokens: 'Tokens',
+        cost: 'Cost',
+        avgLatency: 'Avg Latency',
+        providers: 'Providers',
+        quickActions: 'Quick Actions',
+        export: 'Export',
+        refreshHealth: 'Refresh Health',
+        analytics: 'Analytics',
+        periodLabel: 'Period',
+        periodToday: 'Today',
+        periodWeek: 'Last 7 days',
+        periodMonth: 'Last 30 days',
+        totalRequests: 'Total Requests',
+        totalTokens: 'Total Tokens',
+        totalCost: 'Total Cost',
+        topProviders: 'Most Used',
+        health: 'Health',
+        system: 'System',
+        uptime: 'Uptime',
+        memory: 'Memory',
+        cpu: 'CPU',
+        node: 'Node Version',
+        config: 'Configuration',
+        configSummary: 'Summary',
+        providerCount: 'Provider count',
+        defaultRoute: 'Default route',
+        logging: 'Logging',
+        configJson: 'Configuration',
+        env: 'Environment Variables',
+        envHint: 'Quickly update keys',
+        envStatus: 'Status',
+        envUpdate: 'Update',
+        envKeyLabel: 'Key',
+        envKeyPlaceholder: 'CUSTOM_KEY',
+        envValueLabel: 'Value',
+        envSave: 'Save',
+        envSaved: 'Saved',
+        envSaveError: 'Save failed',
+        envSet: 'Set',
+        envMissing: 'Missing',
+        envPath: 'File',
+        envSelect: 'Select key',
+        logOn: 'On',
+        logOff: 'Off',
+        statusHealthy: 'Healthy',
+        statusDegraded: 'Degraded',
+        statusDown: 'Down',
+        statusUnknown: 'Unknown',
+        dataUnavailable: 'No data'
       }
     };
   }
@@ -137,10 +196,10 @@ class Dashboard {
   detectLanguage() {
     const stored = localStorage.getItem('ccr_lang');
     if (stored) return stored;
-    const lang = navigator.language || 'tr';
+    const lang = navigator.language || 'en';
     if (lang.startsWith('nl')) return 'nl';
     if (lang.startsWith('tr')) return 'tr';
-    return 'tr';
+    return 'en';
   }
 
   t(key) {
@@ -512,7 +571,11 @@ class Dashboard {
   }
 
   locale() {
-    return this.lang === 'nl' ? 'nl-NL' : 'tr-TR';
+    switch (this.lang) {
+      case 'nl': return 'nl-NL';
+      case 'tr': return 'tr-TR';
+      default: return 'en-US';
+    }
   }
 
   formatNumber(value) {