musistudio/claude-code-router

어떤 프로젝트인가요?

핵심 기능

• 01여러 코딩 에이전트와 API 클라이언트가 사용할 수 있는 로컬 엔드포인트 하나를 제공합니다.
• 02조건, 접두사, 재작성 규칙에 따라 요청을 라우팅하고 재시도 및 우선순위가 지정된 대체 경로를 지원합니다.
• 03자격 증명 풀과 키 순환을 통해 제공업체와 계정을 관리합니다.
• 04요청마다 확인된 제공업체, 모델, 지연 시간, 토큰 사용량, 예상 비용을 기록합니다.
• 05데스크톱 앱, 웹 UI가 포함된 npm CLI, Docker 배포 방식을 제공합니다.

활용 사례

• Claude Code 또는 Codex에서 Anthropic이나 OpenAI가 아닌 모델 제공업체를 사용하는 경우.
• 제공업체가 요청을 제한하거나 오류를 반환할 때 백업 모델로 전환하는 경우.
• 개발자 컴퓨터에서 여러 코딩 에이전트가 하나의 제공업체 키 세트를 공유하는 경우.
• 여러 코딩 에이전트의 토큰 사용량과 비용을 추적하는 경우.

빠른 시작

1. 1

   npm CLI를 설치합니다(Node.js 22 이상 필요)

   npm install -g @musistudio/claude-code-router
2. 2

   관리 UI를 시작합니다

   ccr ui
3. 3

   UI를 열고 provider를 추가한 다음 Server를 시작하고 Agent Profile을 적용합니다. gateway는 http://127.0.0.1:3456에서 실행됩니다

사용 전 알아둘 점

• !요청을 라우팅하려면 본인의 API 키 또는 provider 계정이 필요합니다.
• !원격으로 Docker를 노출하려면 사용 전에 보안 설정을 신중하게 구성해야 합니다.

토픽

자주 묻는 질문

claude-code-router은(는) 무엇인가요?

Claude Code와 Codex 등 여러 코딩 에이전트가 하나의 엔드포인트를 공유하고 여러 모델 제공업체로 요청을 라우팅하는 로컬 게이트웨이입니다. Claude Code Router (CCR)는 로컬에서 실행되며 Claude Code, Codex, Grok CLI, Kimi CLI, OpenCode, Pi 등의 코딩 에이전트가 연결할 수 있는 안정적인 단일 엔드포인트를 제공합니다. 제공업체, 모델, 계정, 라우팅 규칙을 한곳에서 관리하므로 각 에이전트에 모델 설정을 따로 구성할 필요가 없습니다.

claude-code-router은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

claude-code-router은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

claude-code-router은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. claude-code-router의 마지막 커밋은 2026년 10월 10일입니다.

claude-code-router은(는) 어디에 사용할 수 있나요?

Claude Code 또는 Codex에서 Anthropic이나 OpenAI가 아닌 모델 제공업체를 사용하는 경우. 제공업체가 요청을 제한하거나 오류를 반환할 때 백업 모델로 전환하는 경우. 개발자 컴퓨터에서 여러 코딩 에이전트가 하나의 제공업체 키 세트를 공유하는 경우. 여러 코딩 에이전트의 토큰 사용량과 비용을 추적하는 경우.

claude-code-router는 어떻게 설치하나요?

npm CLI를 설치합니다(Node.js 22 이상 필요): npm install -g @musistudio/claude-code-router 관리 UI를 시작합니다: ccr ui UI를 열고 provider를 추가한 다음 Server를 시작하고 Agent Profile을 적용합니다. gateway는 http://127.0.0.1:3456에서 실행됩니다

claude-code-router은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/musistudio/claude-code-router