Claude Code Router의 개요
Claude Code Router(CCR)는 코딩 에이전트가 제공업체 API 대신 대화하는 로컬 게이트웨이를 실행합니다. 그 뒤에 OpenAI, Gemini, OpenRouter, DeepSeek, Moonshot, Z.AI, Mistral 같은 제공업체와 함께 라우팅 규칙, 재시도, 대체 모델, 키 순환을 설정합니다.
Claude Code를 다른 모델로 돌리는 수단으로 시작했지만, 이제 Codex, OpenCode, Kimi CLI, Grok CLI, Kilo Code 등의 앞단도 맡습니다. Electron 데스크톱 앱, npm CLI(Node.js 22 이상), Docker로 배포됩니다. 게이트웨이는 127.0.0.1:3456에서 수신하며, 요청마다 경로, 지연 시간, 토큰, 추정 비용을 기록합니다.
대체로 메인테이너 한 명이 후원금으로 운영하는 프로젝트이며, v3.1.3은 2026년 10월 9일에 나왔습니다.
Claude Code Router, 쓸 만한 가치가 있습니까?
CCR은 약속한 일을 합니다. 에이전트 10개 중 어느 것이든 가리킬 수 있는 로컬 엔드포인트 하나를 두고, 그 뒤에서 제공업체, 모델, 대체 체인을 고릅니다. GitHub 스타 약 37,800개로 Claude Code용 자체 호스팅 라우터 가운데 가장 많이 쓰이며, 2026년 10월 9일의 v3.1.3은 프로젝트 CDN에서 매시간 갱신되는 모델 카탈로그를 추가했습니다.
비용 논거는 실재합니다. Anthropic은 Claude Sonnet 5.5를 입력 100만 토큰당 $2, 출력 100만 토큰당 $10로 표시하고, DeepSeek은 V4.1 Flash를 비수기 시간대에 $0.15와 $0.60로 표시합니다. 200만 토큰을 읽고 100,000토큰을 쓰는 긴 에이전트 세션은 캐싱 전 기준으로 Sonnet에서 약 $5, Flash에서 $0.40 미만입니다. 백그라운드 호출과 요약 호출만 저렴한 모델로 보내도 그 절감분 대부분이 남습니다.
주의할 점은 품질과 지원입니다. Claude Code의 프롬프트와 편집 형식은 Claude에 맞춰져 있으며, 커뮤니티 가이드들은 DeepSeek, Qwen, GLM에서 편집 실패가 더 많다고 보고합니다. Anthropic의 게이트웨이 문서는 어떤 게이트웨이를 통해서든 Claude Code를 Claude가 아닌 모델로 라우팅하는 것을 지원하지 않으며, 새 요청 기능을 전달하지 못하는 게이트웨이는 그 기능을 망가뜨린다고 분명히 말합니다. 따라서 Claude Code가 새로 나올 때마다 무언가 멈출 가능성이 있습니다.
보안은 로컬 도구치고 더 깊이 생각해 볼 만합니다. CCR은 모든 제공업체 키를 갖고 있고, 브라우저 로그인 상태를 가져올 수 있으며, Docker 가이드는 기본 3458 포트 매핑이 모든 인터페이스에서 수신한다고 적습니다. 2025년 8월의 권고는 키를 다른 웹사이트로 유출할 수 있는 CORS 결함을 보여 줬고, v1.0.34에서 고쳐졌습니다. 주 메인테이너 한 명에 열린 이슈와 풀 리퀘스트가 1,159개이므로, 회사 전체 배포보다는 개인 노트북용 도구입니다. 회사 배포라면 LiteLLM이나 Anthropic 자체 게이트웨이가 감사 로그와 사용자별 자격 증명을 제공합니다.
제 역할을 하는 곳
Claude Code API 사용료를 직접 내는 프리랜서 개발자
긴 리팩터링 세션의 토큰 청구액 줄이기
백그라운드 요청과 긴 컨텍스트 요청은 비수기 입력 100만 토큰당 $0.15인 DeepSeek V4.1 Flash로 보내고, 주 모델은 Claude로 둡니다. 라우팅한 호출에서는 90% 넘게 절약할 수 있지만, 저렴한 모델이 실제 변경을 맡으면 편집 실패가 늘어납니다.
에어갭 워크스테이션을 쓰는 방산 업체의 엔지니어
코드가 머신 밖으로 나가지 않도록 로컬 모델로 Claude Code 인터페이스 쓰기
사용자 정의 제공업체를 Ollama나 vLLM 같은 로컬 OpenAI 호환 서버로 지정하고 Claude Code 프로필을 적용합니다. 청구되는 것은 없지만, models.ccrdesk.top에서 매시간 모델 카탈로그를 갱신하는 작업은 오프라인에서 실패할 것으로 예상해야 하며, 편집 품질은 전적으로 로컬 모델에 달려 있습니다.
개발자 5명과 여러 에이전트를 시험하는 팀 리드
머신마다 다시 설정하지 않고 같은 제공업체에서 Codex, OpenCode, Claude Code 비교하기
CCR 인스턴스 하나가 키를 갖고, 개발자마다 토큰 한도가 있는 CCR 클라이언트 키를 발급하며, 로그가 요청별 비용을 보여 줍니다. 시험용으로는 괜찮지만, 회사 전체 배포에 필요한 SSO나 중앙 감사 기록은 없습니다.
도입 전 확인할 점
- 설정
- macOS, Windows, Linux용 데스크톱 앱을 내려받거나, npm install -g @musistudio/claude-code-router(Node.js 22+) 후 ccr ui를 실행합니다. 제공업체와 키를 추가하고 127.0.0.1:3456에서 서버를 시작한 뒤 에이전트 프로필을 적용하면, 몇 분 만에 첫 라우팅 요청이 됩니다.
- 연동
- 에이전트: Claude Code, Claude Design, Codex, Grok CLI, Kimi CLI, Kilo Code, OpenCode, Pi, ZCode, WorkBuddy. 프로토콜: OpenAI Chat과 Responses, Anthropic Messages, Gemini, 그리고 OpenRouter, DeepSeek, SiliconFlow, Moonshot, Mistral, Z.AI, Bailian 프리셋. 해당 기능이 없는 모델에 웹 검색, MCP 도구, 비전을 더합니다.
- 데이터와 개인정보
- 프롬프트는 라우팅한 제공업체로 가며 그 제공업체의 보존 조건을 따릅니다. CCR은 제공업체 키, 클라이언트 키, 요청 로그를 로컬 SQLite 파일에 저장하고, 시작할 때와 매시간 models.ccrdesk.top에서 모델 카탈로그를 가져옵니다. 공개된 권고는 1건으로, 키를 노출할 수 있는 CORS 설정 오류이며 v1.0.34에서 고쳐졌습니다.
- 대규모 사용 시 비용
- MIT로 무료이며, 제공업체에 직접 비용을 냅니다. Claude Sonnet 5.5는 입력/출력 100만 토큰당 $2/$10이고 DeepSeek V4.1 Flash는 비수기에 $0.15/$0.60이므로, 절감액은 Claude에서 얼마나 많은 요청을 감히 떼어 내느냐에 달려 있습니다.
- 제한
- Anthropic이 지원하지 않으며, Claude Code 업데이트로 CCR이 따라잡을 때까지 전달이 깨질 수 있습니다. 열린 이슈와 풀 리퀘스트 1,159개, 상당수가 특정 제공업체의 매개변수에 관한 것입니다. CCR을 다른 프록시 뒤에 겹쳐 두면 장애 추적이 어려워집니다.
좋은 점
- 엔드포인트 하나 뒤에 에이전트 10개와 제공업체 프로토콜 십여 개
- 대체 모델, 재시도, 자격 증명 풀
- 요청별 비용, 토큰, 지연 시간 로그
- 만료와 토큰 한도가 있는 클라이언트 키
아쉬운 점
- Anthropic은 Claude 외 모델 라우팅을 지원하지 않음
- Claude 외 모델은 Claude Code 편집에 더 자주 실패
- Docker 기본 포트가 모든 인터페이스에서 수신
- 대체로 1인 메인테이너 프로젝트에 열린 이슈 1,159개
추천 대 상
Claude Code나 다른 에이전트를 더 저렴한 모델이나 로컬 모델로 돌리고 싶은 개발자.
Claude Code Router 대안
Claude Code Router: 자주 묻는 질문
- Claude Code Router, 쓸 만한 가치가 있습니까?
- 코딩 에이전트를 더 저렴한 모델로 돌리기 위한 쓸 만한 로컬 교환대입니다. 다만 Anthropic이 그 결과를 지원하지 않고 편집 품질이 떨어진다는 점을 받아들여야 합니다. 평점은 5점 만점에 4.0점입니다.
- Claude Code Router의 가격은 얼마입니까?
- 무료 오픈소스(MIT)입니다. 라우팅하는 각 모델 제공업체에 비용을 냅니다.
- Claude Code Router의 단점은 무엇입니까?
- Anthropic은 Claude 외 모델 라우팅을 지원하지 않음; Claude 외 모델은 Claude Code 편집에 더 자주 실패; Docker 기본 포트가 모든 인터페이스에서 수신; 대체로 1인 메인테이너 프로젝트에 열린 이슈 1,159개.
- Claude Code Router에 적합한 사람은 누구입니까?
- Claude Code나 다른 에이전트를 더 저렴한 모델이나 로컬 모델로 돌리고 싶은 개발자.
- 팀이나 프로덕션 환경에서 Claude Code Router의 비용은 얼마입니까?
- MIT로 무료이며, 제공업체에 직접 비용을 냅니다. Claude Sonnet 5.5는 입력/출력 100만 토큰당 $2/$10이고 DeepSeek V4.1 Flash는 비수기에 $0.15/$0.60이므로, 절감액은 Claude에서 얼마나 많은 요청을 감히 떼어 내느냐에 달려 있습니다.
- Claude Code Router에 회사 데이터를 맡겨도 안전합니까?
- 프롬프트는 라우팅한 제공업체로 가며 그 제공업체의 보존 조건을 따릅니다. CCR은 제공업 체 키, 클라이언트 키, 요청 로그를 로컬 SQLite 파일에 저장하고, 시작할 때와 매시간 models.ccrdesk.top에서 모델 카탈로그를 가져옵니다. 공개된 권고는 1건으로, 키를 노출할 수 있는 CORS 설정 오류이며 v1.0.34에서 고쳐졌습니다.
- Claude Code Router의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 ccusage, Codex plugin for Claude Code 및 rtk (Rust Token Killer)입니다.
답변 확인일: 2026년 10월 26일.
Claude Code Router 개발사입니까? 이 평점을 사이트에 표시하십시오
