@halilertekin/claude-code-router-config 1.1.1

package/docs/HOMEBREW_SETUP.md

@@ -0,0 +1,252 @@
+# Homebrew Setup Documentation
+
+## Overview
+
+This document explains how to set up and use the custom Homebrew tap for installing `claude-code-router-config`. The custom tap allows easy installation of the multi-provider AI routing configuration with intent-based routing support.
+
+## Custom Tap Details
+
+**Tap Repository**: https://github.com/halilertekin/homebrew-tap
+**Formula**: `claude-code-router-config`
+**Main Repository**: https://github.com/halilertekin/CC-RouterMultiProvider
+
+## Installation Instructions
+
+### Prerequisites
+
+- macOS with [Homebrew](https://brew.sh/) installed
+- An Anthropic API key (for Claude models)
+- Optional API keys for other providers (OpenAI, Gemini, Qwen, GLM, OpenRouter, GitHub Copilot)
+
+### Step 1: Add the Custom Tap
+
+```bash
+# Add the custom tap to your Homebrew installation
+brew tap halilertekin/homebrew-tap
+```
+
+### Step 2: Install the Package
+
+```bash
+# Install claude-code-router-config
+brew install claude-code-router-config
+```
+
+### Step 3: Configure API Keys
+
+The installer automatically creates configuration files and an `.env.example` file. You need to:
+
+1. **Edit your environment variables:**
+   ```bash
+   nano ~/.env
+   ```
+
+2. **Add your API keys:**
+   ```bash
+   # Required for Claude models
+   export ANTHROPIC_API_KEY="your_anthropic_api_key_here"
+
+   # Optional - Add other providers
+   export OPENAI_API_KEY="your_openai_api_key_here"
+   export GEMINI_API_KEY="your_gemini_api_key_here"
+   export QWEN_API_KEY="your_qwen_api_key_here"
+   export GLM_API_KEY="your_glm_api_key_here"
+   export OPENROUTER_API_KEY="your_openrouter_api_key_here"
+   export GITHUB_TOKEN="your_github_token_here"
+   ```
+
+3. **Add to shell configuration:**
+   ```bash
+   # Add to ~/.zshrc or ~/.bashrc
+   export $(cat ~/.env | xargs)
+   export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
+   export NO_PROXY="127.0.0.1"
+   ```
+
+4. **Reload your shell:**
+   ```bash
+   source ~/.zshrc
+   # or
+   source ~/.bashrc
+   ```
+
+### Step 4: Start the Router
+
+```bash
+# Start the Claude Code Router
+ccr code
+```
+
+## What Gets Installed
+
+The Homebrew formula installs the following components:
+
+### 1. Core Package
+- **@musistudio/claude-code-router**: The main routing application (via pnpm)
+
+### 2. Configuration Files
+- **`~/.claude-code-router/config.json`**: Multi-provider configuration with 7 AI providers
+- **`~/.claude-code-router/intent-router.js`**: Intelligent intent-based routing logic
+
+### 3. Environment Template
+- **`~/.env`**: Environment variables file (created from `.env.example`)
+
+## Supported AI Providers
+
+The configuration supports 7 AI providers:
+
+1. **OpenAI**: GPT-4o, GPT-4 Turbo, O1, O1-mini
+2. **Anthropic**: Claude Sonnet 4, Claude 3.5 Sonnet
+3. **Gemini**: Gemini 2.5 Flash, Gemini 2.5 Pro
+4. **Qwen**: Qwen Plus, Qwen Max
+5. **GLM**: GLM-4.6, GLM-4.5
+6. **OpenRouter**: Multiple models via OpenRouter
+7. **GitHub Copilot**: Code assistance
+
+## Intent-Based Routing
+
+The router automatically routes requests to the most appropriate provider based on the task type:
+
+- **Coding tasks** → OpenAI (GPT-4o/O1)
+- **Deep reasoning** → Anthropic Claude
+- **Fast responses** → Gemini Flash
+- **Simple tasks** → Qwen
+- **Multilingual** → GLM
+- **Heavy reasoning** → OpenAI O1
+- **Coding assistance** → GitHub Copilot
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Permission Denied Errors**
+   ```bash
+   # Fix permissions on config directory
+   sudo chown -R $USER:$USER ~/.claude-code-router
+   chmod 755 ~/.claude-code-router
+   ```
+
+2. **pnpm Not Found**
+   ```bash
+   # Install pnpm
+   brew install pnpm
+
+   # Or the formula automatically falls back to npm
+   ```
+
+3. **Environment Variables Not Loading**
+   ```bash
+   # Verify .env file exists
+   ls -la ~/.env
+
+   # Manually source environment
+   export $(cat ~/.env | xargs)
+   ```
+
+4. **Router Fails to Start**
+   ```bash
+   # Check configuration files
+   ls -la ~/.claude-code-router/
+
+   # Verify config syntax
+   node -c ~/.claude-code-router/intent-router.js
+   ```
+
+5. **API Key Issues**
+   ```bash
+   # Test API key
+   curl -X POST https://api.anthropic.com/v1/messages \
+     -H "x-api-key: $ANTHROPIC_API_KEY" \
+     -H "content-type: application/json" \
+     -d '{"model": "claude-3-sonnet-20240229", "max_tokens": 10, "messages": [{"role": "user", "content": "test"}]}'
+   ```
+
+### Getting Help
+
+1. **Check logs**: The router provides detailed logging information
+2. **Verify configuration**: Ensure all JSON files are valid
+3. **Test providers individually**: Use direct API calls to test each provider
+4. **Check network connectivity**: Ensure you can reach the provider APIs
+
+## Updating the Installation
+
+To update to the latest version:
+
+```bash
+# Update the tap
+brew update
+
+# Upgrade the package
+brew upgrade claude-code-router-config
+
+# Or reinstall for clean setup
+brew reinstall claude-code-router-config
+```
+
+## Uninstallation
+
+To completely remove the installation:
+
+```bash
+# Uninstall the package
+brew uninstall claude-code-router-config
+
+# Remove configuration files (optional)
+rm -rf ~/.claude-code-router
+
+# Remove environment variables from ~/.zshrc or ~/.bashrc
+# Remove the tap (optional)
+brew untap halilertekin/homebrew-tap
+```
+
+## Advanced Configuration
+
+### Custom Intent Patterns
+
+Edit `~/.claude-code-router/intent-router.js` to add custom routing patterns:
+
+```javascript
+// Add custom intent
+CUSTOM_TASK: {
+  patterns: [/\b(custom|special|specific)\b/i],
+  route: "openai,gpt-4o"
+}
+```
+
+### Provider Priority
+
+Modify the routing order in `~/.claude-code-router/config.json`:
+
+```json
+"Router": {
+  "default": "anthropic,claude-sonnet-4-latest",
+  "background": "qwen,qwen-turbo",
+  "think": "openai,o1"
+}
+```
+
+## Performance Tips
+
+1. **Use appropriate models**: Choose the right model for each task
+2. **Set timeouts**: Configure appropriate API timeouts
+3. **Monitor usage**: Track token usage and costs
+4. **Cache results**: Use caching for repeated requests
+
+## Security Considerations
+
+1. **Protect API keys**: Never commit API keys to version control
+2. **Use environment variables**: Keep sensitive data in `.env`
+3. **Regular key rotation**: Rotate API keys periodically
+4. **Audit logs**: Monitor router logs for unusual activity
+
+## Support
+
+- **Main Repository**: https://github.com/halilertekin/CC-RouterMultiProvider
+- **Issues**: Report issues via GitHub
+- **Documentation**: See `docs/` directory for comprehensive guides
+
+## Attribution
+
+This configuration package is for use with [@musistudio/claude-code-router](https://github.com/musistudio/claude-code-router).
+Original project: https://github.com/musistudio/claude-code-router
+Configuration by Halil Ertekin

package/docs/README_EN.md

@@ -0,0 +1,146 @@
+# Claude Code Router - Multi-Provider Setup
+
+Use Claude Code as a single interface to access multiple AI providers with intent-based routing for optimal performance and cost.
+
+## Features
+
+- **6+ Provider Support**: OpenAI, Anthropic, Gemini, Qwen, GLM, OpenRouter, GitHub Copilot
+- **Intent-Based Routing**: Automatically selects the best model based on your request
+- **Cost Optimization**: Simple tasks go to cheaper models
+- **Performance Optimization**: Fast responses use optimized models
+
+## Routing Strategy
+
+| Request Type | Provider | Model |
+|--------------|----------|-------|
+| Code writing, debugging | OpenAI | gpt-4o |
+| Deep analysis, architecture | Anthropic | claude-sonnet-4 |
+| Quick responses, summaries | Gemini | gemini-2.5-flash |
+| Simple tasks | Qwen | qwen-plus |
+| Translation, multilingual | GLM | glm-4.6 |
+| Complex algorithms | OpenAI | o1 |
+| Coding assistance | GitHub Copilot | copilot |
+
+## Quick Setup
+
+```bash
+git clone https://github.com/YOUR_USERNAME/claude-code-router-config.git
+cd claude-code-router-config
+chmod +x install.sh
+./install.sh
+```
+
+## Manual Setup
+
+### 1. Install Package
+
+```bash
+pnpm add -g @musistudio/claude-code-router
+```
+
+### 2. Copy Configuration Files
+
+```bash
+mkdir -p ~/.claude-code-router
+cp config/config.json ~/.claude-code-router/
+cp config/intent-router.js ~/.claude-code-router/
+```
+
+### 3. Set Up Environment Variables
+
+Create `.env` file in your home directory:
+
+```bash
+cp .env.example ~/.env
+# Edit ~/.env with your API keys
+```
+
+Or add to `~/.zshrc` / `~/.bashrc`:
+
+```bash
+# Claude Code Router - API Keys
+export OPENAI_API_KEY="sk-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+export GEMINI_API_KEY="AIza..."
+export QWEN_API_KEY="sk-..."
+export GLM_API_KEY="..."
+export OPENROUTER_API_KEY="sk-or-..."
+export GITHUB_COPIOT_API_KEY="ghu_..."
+
+# Router Connection
+export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
+export NO_PROXY="127.0.0.1"
+```
+
+### 4. Start Router
+
+```bash
+source ~/.zshrc  # Reload environment
+ccr code
+```
+
+## Usage
+
+### Basic Commands
+
+```bash
+ccr start    # Start router
+ccr code     # Start with Claude Code
+ccr status   # Check status
+ccr stop     # Stop router
+```
+
+### Switch Models (Runtime)
+
+Inside Claude Code:
+
+```
+/model openai,gpt-4o
+/model anthropic,claude-sonnet-4-latest
+/model gemini,gemini-2.5-flash
+/model qwen,qwen-plus
+/model glm,glm-4.6
+/model copilot,copilot
+```
+
+## API Key Setup
+
+| Provider | Link | Notes |
+|----------|------|-------|
+| OpenAI | https://platform.openai.com/api-keys | gpt-4o, o1 models |
+| Anthropic | https://console.anthropic.com/settings/keys | Claude models |
+| Gemini | https://aistudio.google.com/apikey | Google AI models |
+| Qwen | https://dashscope.console.aliyun.com/apiKey | Alibaba Cloud |
+| GLM | https://open.bigmodel.cn/usercenter/apikeys | Zhipu AI |
+| OpenRouter | https://openrouter.ai/keys | Multiple models |
+| GitHub Copilot | https://github.com/settings/tokens | `copilot` scope |
+
+## File Structure
+
+```
+~/.claude-code-router/
+├── config.json          # Provider configuration
+├── intent-router.js     # Routing logic
+└── logs/                # Log files
+```
+
+## Testing
+
+```bash
+# Test different routing scenarios
+claude "Write a Python sorting function"      # → OpenAI
+claude "Explain microservices architecture" # → Anthropic
+claude "Quick summary of REST APIs"        # → Gemini
+claude "List files in current directory"    # → Qwen
+claude "Translate to Chinese: Hello"        # → GLM
+claude "Help me debug this React component" # → GitHub Copilot
+```
+
+## Documentation
+
+- [Complete Documentation](docs/FULL_DOCUMENTATION_EN.md)
+- [Setup Prompt](docs/SETUP_PROMPT_EN.md)
+
+## License
+
+MIT

package/docs/SETUP_PROMPT.md

@@ -0,0 +1,299 @@
+# Claude Code Router - Kurulum Prompt'u
+
+Bu prompt'u başka bir makinede Claude Code Router kurmak için kullanabilirsin.
+Kopyala ve Claude Code'a yapıştır.
+
+---
+
+## KURULUM PROMPT'U
+
+```
+Sen bir DevOps + LLM altyapı uzmanısın.
+
+Görev: Claude Code Router'ı kur ve intent-based routing ile yapılandır.
+
+Gereksinimler:
+- pnpm kullan (npm değil)
+- Model versiyonlarını sabitlemek yerine en güncel/önerilen modelleri kullan
+- macOS/Linux ortamı
+
+Kurulacak Provider'lar:
+1. OpenAI (gpt-4o, o1) - Coding, debugging
+2. Anthropic Claude - Deep reasoning, analysis
+3. Google Gemini - Hızlı cevaplar, uzun context
+4. Alibaba Qwen (DashScope) - Ucuz, basit işler
+5. Zhipu GLM (Z.ai) - Çok dilli, çeviri
+6. OpenRouter - Fallback
+
+Intent-Based Routing Kuralları:
+- Kod yazma/debug → OpenAI (gpt-4o)
+- Mimari/analiz/neden → Anthropic Claude
+- Hızlı/özet/tldr → Gemini Flash
+- Basit/liste/yardım → Qwen (ucuz)
+- Çeviri/çok dilli → GLM
+- Karmaşık algoritma → OpenAI (o1)
+- Eşleşme yok → OpenAI (fallback)
+
+Yapılacaklar:
+1. pnpm ile @musistudio/claude-code-router kur
+2. ~/.claude-code-router/config.json oluştur (tüm provider'lar)
+3. ~/.claude-code-router/intent-router.js oluştur (routing logic)
+4. ~/.zshrc için gerekli env var'ları göster
+
+API Endpoint'leri:
+- OpenAI: https://api.openai.com/v1/chat/completions
+- Anthropic: https://api.anthropic.com/v1/messages (transformer: Anthropic)
+- Gemini: https://generativelanguage.googleapis.com/v1beta/openai/chat/completions (transformer: gemini)
+- Qwen: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
+- GLM: https://api.z.ai/api/paas/v4/chat/completions
+- OpenRouter: https://openrouter.ai/api/v1/chat/completions (transformer: openrouter)
+
+Router Ayarları:
+- default: openai,gpt-4o
+- background: qwen,qwen-turbo
+- think: anthropic,claude-sonnet-4-latest
+- longContext: gemini,gemini-2.5-flash
+- longContextThreshold: 60000
+
+Çıktı:
+1. Kurulum komutları
+2. config.json içeriği
+3. intent-router.js içeriği
+4. .zshrc eklemeleri
+5. Başlatma ve test komutları
+```
+
+---
+
+## HIZLI KURULUM (Manuel)
+
+Eğer prompt kullanmak istemiyorsan, aşağıdaki adımları manuel uygula:
+
+### 1. Kurulum
+
+```bash
+pnpm add -g @musistudio/claude-code-router
+mkdir -p ~/.claude-code-router
+```
+
+### 2. config.json
+
+```bash
+cat > ~/.claude-code-router/config.json << 'EOF'
+{
+  "LOG": true,
+  "LOG_LEVEL": "info",
+  "API_TIMEOUT_MS": 300000,
+  "CUSTOM_ROUTER_PATH": "$HOME/.claude-code-router/intent-router.js",
+
+  "Providers": [
+    {
+      "name": "openai",
+      "api_base_url": "https://api.openai.com/v1/chat/completions",
+      "api_key": "$OPENAI_API_KEY",
+      "models": ["gpt-4o", "gpt-4-turbo", "gpt-4o-mini", "o1", "o1-mini"],
+      "transformer": { "use": [] }
+    },
+    {
+      "name": "anthropic",
+      "api_base_url": "https://api.anthropic.com/v1/messages",
+      "api_key": "$ANTHROPIC_API_KEY",
+      "models": ["claude-sonnet-4-latest", "claude-3-5-sonnet-latest"],
+      "transformer": { "use": ["Anthropic"] }
+    },
+    {
+      "name": "gemini",
+      "api_base_url": "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions",
+      "api_key": "$GEMINI_API_KEY",
+      "models": ["gemini-2.5-flash", "gemini-2.5-pro", "gemini-2.0-flash"],
+      "transformer": { "use": ["gemini"] }
+    },
+    {
+      "name": "qwen",
+      "api_base_url": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions",
+      "api_key": "$QWEN_API_KEY",
+      "models": ["qwen-plus", "qwen-max", "qwen3-coder-plus", "qwen-turbo"],
+      "transformer": { "use": [] }
+    },
+    {
+      "name": "glm",
+      "api_base_url": "https://api.z.ai/api/paas/v4/chat/completions",
+      "api_key": "$GLM_API_KEY",
+      "models": ["glm-4.6", "glm-4.5", "glm-4-plus"],
+      "transformer": { "use": [] }
+    },
+    {
+      "name": "openrouter",
+      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
+      "api_key": "$OPENROUTER_API_KEY",
+      "models": [
+        "anthropic/claude-sonnet-4",
+        "deepseek/deepseek-chat",
+        "google/gemini-2.5-flash",
+        "meta-llama/llama-3.3-70b-instruct"
+      ],
+      "transformer": { "use": ["openrouter"] }
+    }
+  ],
+
+  "Router": {
+    "default": "openai,gpt-4o",
+    "background": "qwen,qwen-turbo",
+    "think": "anthropic,claude-sonnet-4-latest",
+    "longContext": "gemini,gemini-2.5-flash",
+    "longContextThreshold": 60000
+  }
+}
+EOF
+```
+
+### 3. intent-router.js
+
+```bash
+cat > ~/.claude-code-router/intent-router.js << 'EOF'
+const INTENTS = {
+  CODING: {
+    patterns: [
+      /\b(implement|refactor|debug|fix|write|code|function|class|method|bug|error|compile|syntax)\b/i,
+      /\b(typescript|javascript|python|rust|go|java|react|vue|angular|swift|kotlin)\b/i,
+      /\b(api|endpoint|database|query|migration|schema|test|unit test)\b/i,
+      /\b(codex|o1|reasoning)\b/i
+    ],
+    route: "openai,gpt-4o"
+  },
+  REASONING: {
+    patterns: [
+      /\b(architect|design|analyze|plan|strategy|structure|system|trade-?off)\b/i,
+      /\b(why|explain|reason|understand|compare|evaluate|consider|review)\b/i,
+      /\b(decision|approach|best practice|pattern|principle|philosophy)\b/i
+    ],
+    route: "anthropic,claude-sonnet-4-latest"
+  },
+  FAST: {
+    patterns: [
+      /\b(fast|quick|brief|short|summary|tldr|overview|hızlı)\b/i,
+      /\b(scan|check|verify|validate)\b/i
+    ],
+    route: "gemini,gemini-2.5-flash"
+  },
+  SIMPLE: {
+    patterns: [
+      /\b(list|show|what is|simple|basic|help|how to|format)\b/i,
+      /\b(rename|move|delete|create file|mkdir|copy)\b/i,
+      /\b(ucuz|basit|kolay)\b/i
+    ],
+    route: "qwen,qwen-plus"
+  },
+  MULTILINGUAL: {
+    patterns: [
+      /\b(translate|çevir|tercüme|chinese|türkçe|multilingual)\b/i,
+      /[\u4e00-\u9fff]/,
+      /[\u0600-\u06FF]/,
+    ],
+    route: "glm,glm-4.6"
+  },
+  HEAVY_REASONING: {
+    patterns: [
+      /\b(complex algorithm|optimization|performance critical|system design)\b/i,
+      /\b(prove|mathematical|theorem|formal verification)\b/i
+    ],
+    route: "openai,o1"
+  }
+};
+
+function extractContent(req) {
+  const messages = req.body?.messages || [];
+  return messages
+    .filter(m => m.role === "user" || m.role === "system")
+    .map(m => typeof m.content === "string" ? m.content : JSON.stringify(m.content))
+    .join(" ")
+    .slice(0, 3000);
+}
+
+function detectIntent(content) {
+  const scores = {};
+  for (const [intent, config] of Object.entries(INTENTS)) {
+    scores[intent] = config.patterns.reduce((score, pattern) => {
+      const matches = (content.match(pattern) || []).length;
+      return score + matches;
+    }, 0);
+  }
+  const sorted = Object.entries(scores)
+    .filter(([_, score]) => score > 0)
+    .sort((a, b) => b[1] - a[1]);
+  return sorted.length > 0 ? sorted[0][0] : null;
+}
+
+module.exports = async function router(req, config) {
+  const content = extractContent(req);
+  const intent = detectIntent(content);
+  if (intent && INTENTS[intent]) {
+    const route = INTENTS[intent].route;
+    console.log(`[Router] ${intent} → ${route}`);
+    return route;
+  }
+  console.log("[Router] No match → openai,gpt-4o");
+  return null;
+};
+EOF
+```
+
+### 4. .zshrc Eklemeleri
+
+```bash
+cat >> ~/.zshrc << 'EOF'
+
+# ═══════════════════════════════════════════════════
+# Claude Code Router - API Keys
+# ═══════════════════════════════════════════════════
+export OPENAI_API_KEY="sk-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+export GEMINI_API_KEY="AIza..."
+export QWEN_API_KEY="sk-..."
+export GLM_API_KEY="..."
+export OPENROUTER_API_KEY="sk-or-..."
+
+# Router Connection
+export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
+export NO_PROXY="127.0.0.1"
+EOF
+```
+
+### 5. Başlat
+
+```bash
+source ~/.zshrc
+ccr code
+```
+
+---
+
+## TEK SATIRLIK KURULUM
+
+Tüm dosyaları tek seferde oluşturmak için:
+
+```bash
+# 1. Kur
+pnpm add -g @musistudio/claude-code-router && mkdir -p ~/.claude-code-router
+
+# 2. Config'leri indir (bu repo'dan)
+curl -sL https://raw.githubusercontent.com/YOUR_REPO/main/config.json > ~/.claude-code-router/config.json
+curl -sL https://raw.githubusercontent.com/YOUR_REPO/main/intent-router.js > ~/.claude-code-router/intent-router.js
+
+# 3. API key'leri .zshrc'ye ekle (manuel)
+# 4. Başlat
+source ~/.zshrc && ccr code
+```
+
+---
+
+## API KEY ALMA LİNKLERİ
+
+| Provider | Link |
+|----------|------|
+| OpenAI | https://platform.openai.com/api-keys |
+| Anthropic | https://console.anthropic.com/settings/keys |
+| Gemini | https://aistudio.google.com/apikey |
+| Qwen | https://dashscope.console.aliyun.com/apiKey |
+| GLM | https://open.bigmodel.cn/usercenter/apikeys |
+| OpenRouter | https://openrouter.ai/keys |