musistudio/claude-code-router

Claude Code Router (CCR)

무엇인가요 – 여러 개의 코딩 중심 AI 에이전트(Claude Code, Claude Design, Codex, Grok CLI, Kimi CLI, Kilo Code, OpenCode, Pi, ZCode, WorkBuddy 등)를 하나의 API처럼 다룰 수 있게 해주는 로컬 게이트웨이 및 컨트롤 플레인 데스크톱(및 CLI) 앱입니다. OpenAI, Anthropic, Gemini, Moonshot, Kimi, Mistral, 사용자 정의 엔드포인트 등 프로바이더를 한 번 설정하면, 지원되는 모든 클라이언트가 http://127.0.0.1:3456에 연결할 수 있습니다.

왜 주목해야 할까요

• API 키, 모델 선택, 라우팅 규칙의 단일 진실원 제공.
• 코드 없이 프로바이더 전환 가능 – 각 에이전트 설정을 수정하지 않고 모델이나 백업 프로바이더를 변경 가능.
• 신뢰성 기능 – 자동 재시도, 자격 증명 풀, 키 회전, 순차적 백업.
• 관찰 가능성 – 실시간 로그로 해결된 프로바이더, 모델, 토큰 사용량, 지연 시간, 비용 추정치, 도구 호출을 확인 가능.
• 확장성 – "Fusion" 비전 모델, 웹 검색, 사용자 정의 도구, 추가 기능을 위한 "ToolHub"를 플러그인 가능.
• 다중 플랫폼 – Windows/macOS/Linux용 Electron 데스크톱 앱, 순수 Node CLI(npm i -g @musistudio/claude-code-router), Docker Compose 배포 제공.

작동 방식(고수준 흐름)

[에이전트 (Claude Code, Codex 등)] → CCR 게이트웨이 (localhost:3456)
    ├─ 프로필 – 에이전트별 설정 (모델, 환경, 범위)
    ├─ 라우팅 – 조건부 재작성, 재시도, 백업
    ├─ 자격 증명 – 프로바이더 프리셋, 키 풀
    └─ 도구 – Fusion 비전, 웹 검색, 사용자 정의 플러그인
        ↓
[선택된 프로바이더 엔드포인트] (OpenAI, Anthropic, Kimi 등)

시작하기

1. GitHub 릴리스 페이지에서 OS용 데스크톱 바이너리(Windows .exe, macOS .dmg, Linux .AppImage)를 다운로드.
2. 앱을 열고 프로바이더 프리셋 또는 사용자 정의 엔드포인트를 추가하고 API 키를 붙여넣고 저장.
3. Server → Start 클릭 – 게이트웨이가 127.0.0.1:3456에서 시작됨.
4. Agent Config에서 원하는 에이전트(예: Claude Code)를 선택하고 모델 프로필을 선택.
5. 에이전트를 일반적으로 실행하면 CCR가 요청을 라우팅하고 세부 정보를 로그에 기록합니다.

CLI 대안 – npm i -g @musistudio/claude-code-router 후 ccr ui 실행으로 동일한 웹 UI 시작(기본 http://127.0.0.1:3458). Docker 사용자는 docker compose up -d로 UI와 게이트웨이를 동시에 실행 가능.

주요 기능

영역	제공 기능
에이전트	10개 이상의 코딩 에이전트용 사전 구성 프로필, 모델 오버라이드, 멀티 인스턴스 워크플로우
프로바이더	OpenAI, Anthropic, Gemini, Moonshot, Kimi, Mistral, OpenRouter, DeepSeek 등 내장 프리셋; 사용자 정의 엔드포인트 지원
라우팅	조건부 라우팅 규칙, 요청/응답 재작성, 재시도 정책, 순차적 백업
도구 및 확장	Fusion 비전 모델, 웹 검색, 브라우저 자동화, Chrome 로그인 가져오기, 플러그인 아키텍처
관찰 가능성	요청별 로그로 프로바이더, 모델, 토큰 수, 지연 시간, 추정 비용, 도구 호출 확인
접근 제어	할당량, 만료일, 요청당 제한이 있는 로컬 클라이언트 키
AgentClaw	에이전트를 채팅 플랫폼(WeChat, Slack, Discord, Telegram, LINE, Feishu, DingTalk)으로 리레이

문서 및 지원 – 완전한 가이드, API 참조, 문제 해결은 ccrdesk.top 에서 제공. README에 Discord 커뮤니티 및 후원 링크 포함.

라이선스 – 리포지토리는 MIT 라이선스 하에 배포됩니다.

---

위 정보는 프로젝트의 README에서 직접 인용되었으며, 추가 기능은 추정되지 않았습니다.