musistudio /claude-code-router

One local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.

★ 38,166⑂ 3,207👁 133⑃ 497● 1,420▤ 27
TypeScriptMITCreated 2025-02-25ccrdesk.top/
Download: v3.1.3v3.1.3 ↓3.1.32026-10-09
+16
Daily
+106
Weekly
38,166
stars
3,207
forks
133
watchers
497
prs
1,420
issues
27
releases

README

Claude Code Router

 Manage every agent and provider from one place.

Connect Claude Code, Claude Design, Codex, Grok CLI, Kimi CLI, Kilo Code, OpenCode, Pi, ZCode, WorkBuddy, and compatible API clients to the providers you choose—then route, fail over, extend, and observe every request from one app.


  
  
  



  
  
  
  








 Why use Claude Code Router?

Claude Code Router (CCR) is a local model gateway and control plane for coding agents. It gives Claude Code, Claude Design, Codex, Grok CLI, Kimi CLI, Kilo Code, OpenCode, Pi, ZCode, WorkBuddy, and compatible API clients one stable local endpoint, while you manage the providers, models, accounts, routing rules, and tools behind it from one place.

Use CCR to:

- Manage all agents and providers together instead of maintaining a separate model configuration for every client.
- Switch providers or models without changing your workflow or repeatedly editing agent configuration files.
- Keep requests running with retries, credential pools, key rotation, and ordered fallback models.
- Add capabilities to existing models with Fusion vision, web search, MCP tools, and ToolHub.
- See what actually happened through request logs, resolved routes, latency, token usage, cost estimates, and account status.

CCR supports OpenAI Chat / Responses, Anthropic Messages, Gemini Generate Content / Interactions, OpenRouter, DeepSeek, SiliconFlow, Moonshot, Kimi Code, Mistral, Z.AI, Bailian, and custom compatible providers.


Supported Agents




  
    
      
        
        
        Claude Code (CLI & APP)
      
    
    
      
        
        
        Codex (CLI & APP)
      
    
    
      
        
        
        Grok CLI (CLI)
      
    
    
      
        
        
        Kimi CLI (CLI)
      
    
    
      
        
        
        Kilo Code (CLI)
      
    
  
  
    
      
        
        
        OpenCode (CLI & APP)
      
    
    
      
        
        
        Pi (CLI)
      
    
    
      
        
        
        ZCode (APP)
      
    
    
      
        
        
        Claude Design (APP)
      
    
    
      
        
        
        WorkBuddy (APP)
      
    
  






 Quick Start

 Desktop app (recommended)

1. 
   Download Claude Code Router for macOS, Windows, or Linux, then launch the app.

   

   
     
       
         
           
           
           Windows
         
       
       
         
           
           
           Linux
         
       
       
         
           
           
           macOS (Apple Silicon)
         
       
       
         
           
           
           macOS (Intel)
         
       
     
   

   

   

2. Open Providers → Add Provider. Choose a built-in preset or a custom endpoint, enter the API key, select the protocol and models, then save.
3. Open Server and click Start. The local model gateway listens on http://127.0.0.1:3456 by default.
4. Open Agent Config, choose Claude Code, Claude Design, Codex, Gr

Top issues

Discussions

Latest release

v3.1.3 v3.1.3 2026-10-09
Highlights

- Rebuild the bundled model catalog and publish it to models.ccrdesk.top. The catalog refreshes from the CDN at startup and hourly, with bundled and cached data available offline.
- Improve routing script token estimation, gateway restart recovery, and raw trace delivery.
- Fix Codex session affinity, protocol-specific provider aliases, and upstream streaming resets.
- Add the Y-API provider preset and bound OpenRouter catalog requests with a timeout.

 What's Changed
 fix(gateway): propagate upstream stream resets instead of crashing the core by @Louayzouaoui1 in https://github.co

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON