비교 · 2026-11-03 확인

Claude Code Router: 오픈소스 claude-code-router와 CodeRouter 비교

"Claude Code router"라는 이름으로 불리는 것은 서로 다른 두 가지입니다. claude-code-router(CCR)는 musistudio가 만든 무료 오픈소스 프로젝트로, 내 컴퓨터에서 직접 실행하는 게이트웨이입니다. 공급자 키는 직접 준비하고 라우팅 규칙도 직접 작성합니다. 이 사이트인 CodeRouter는 호스팅형 라우터입니다. Claude Code를 URL 하나에 연결하면, 각 요청을 어떤 모델이 처리할지 CodeRouter가 결정하고 그 비용을 청구합니다. 오픈소스 프로젝트를 찾아오셨다면 github.com/musistudio/claude-code-router에서 확인할 수 있습니다.

고지: CodeRouter는 저희 제품입니다. claude-code-router는 저희와 관계없는 독립 프로젝트이며, 아래 설명은 2026-11-03에 확인한 해당 프로젝트의 README와 문서를 바탕으로 작성했습니다.

한눈에 비교

claude-code-router (musistudio)CodeRouter
제품 유형코딩 에이전트용 오픈소스(MIT) 로컬 모델 게이트웨이이자 컨트롤 플레인호스팅형 라우팅 서비스
실행 위치내 컴퓨터나 서버: 데스크톱 앱(macOS, Windows, Linux), npm CLI 또는 Docker, 게이트웨이 기본 주소 127.0.0.1:3456저희 서버, Claude Code가 https://www.coderouter.io와 통신
모델 공급자공급자와 내 API 키를 직접 추가: OpenAI, Anthropic, Gemini, OpenRouter, DeepSeek, Moonshot/Kimi, Z.AI 및 기타 호환 엔드포인트, 키 풀과 로테이션 지원공급자 계정 불필요: CodeRouter 키 하나, 청구서 하나
모델 선택 주체사용자가 직접 선택: 에이전트 프로필별 모델, 요청 헤더나 본문 필드를 매칭하는 규칙, 재작성(rewrite), 재시도, 순서가 정해진 폴백, 또는 Node.js 스크립트. Claude Code 서브에이전트는 사용자가 설명해 둔 모델 중에서 고를 수 있습니다CodeRouter가 요청마다 선택: 작은 판단 모델이 최신 메시지와 도구 출력을 읽고 코딩 단계, 난이도, 직전 턴의 실패 여부를 판단하며, 티어는 코드가 결정합니다
상위 티어로 올림직접 구성한 폴백(오류 발생 시)Claude Code 세션은 시작할 때 티어가 정해집니다. 쉬운 작업은 Claude Haiku 5.5, 어려운 계획 작업으로 확실히 판단되면 Claude Opus 5.5(종량제, Team), 그 밖에는 Claude Sonnet 5.5입니다. 코드 변경이 실패하거나 에이전트가 진척을 보이지 않으면 상위 티어로 올립니다(해당 티어가 Haiku에서 15단계, Sonnet에서 25단계를 처리한 뒤 최근 10단계 동안 소스 수정이 없거나, 같은 명령을 세 번 실행한 경우)
지원 에이전트Claude Code, Codex, Grok CLI, Kimi CLI, Kilo Code, OpenCode, Pi, ZCode, WorkBuddy, Claude DesignClaude Code, Cursor, Aider, Cline, Continue.dev, OpenClaw, OpenAI SDK, LiteLLM을 통한 GitHub Copilot
가격무료 소프트웨어, 각 공급자에 직접 비용 지불무료 체험(7일 동안 사용량 $5), 이후 모델 정가 +8%의 종량제로 월 요금 없음, 스마트 라우팅 또는 Direct 모드, Team은 개발자당 $19 + 사용량 정가 +8%
팀 기능만료일과 로컬 요청·토큰·이미지 한도를 설정할 수 있는 별도 클라이언트 키엔지니어마다 키 하나, 멤버·프로젝트·회사별 예산, 80% 도달 시 알림, 100% 도달 시 하위 모델 전환 또는 일시 중지, 관리자에게는 지출만 공개(프롬프트는 비공개)
모니터링확정된 공급자와 모델, 지연 시간, 토큰, 예상 비용이 기록되는 요청 로그요청별 비용 대시보드, X-CodeRouter-Model, X-CodeRouter-Tier, X-CodeRouter-Cost 등의 응답 헤더
부가 기능Fusion 비전, 웹 검색, MCP 도구(ToolHub), 브라우저 자동화, 플러그인, 채팅 앱 릴레이프롬프트 캐시가 유지되도록 세션을 한 모델에 고정하는 세션 고정(stickiness), 공개된 벤치마크
데이터 처리요청이 내 컴퓨터에서 직접 구성한 공급자로 바로 전달요청이 CodeRouter를 거침, 라우팅 개선을 위해 짧은 발췌문을 최대 180일 보관(팀 관리자가 끌 수 있음). 개인정보 처리방침 참고

어느 쪽을 선택해야 합니까?

claude-code-router가 적합한 경우

  • 모든 것을 로컬에서 무료로 운영하고 싶고, 사용할 공급자의 계정을 이미 갖고 있다면 잘 맞습니다.
  • 어떤 종류의 요청을 어떤 모델이 처리할지 라우팅을 직접 정하고 계속 조정하고 싶은 경우에 적합합니다.
  • 여러 에이전트(Codex, OpenCode, Kimi CLI…)를 쓰면서 모델 관리를 로컬의 한곳에서 하고 싶을 때 좋습니다.
  • 비전이나 웹 검색이 없는 모델에 이를 덧붙이는 기능, MCP 도구, 플러그인 같은 확장 기능이 필요한 경우에 적합합니다.

CodeRouter가 적합한 경우

  • 라우팅 규칙을 작성하거나 유지보수하고 싶지 않다면 적합합니다. 라우터가 요청마다 결정하고, 실패하면 상위 티어로 올립니다.
  • 공급자마다 계정과 잔액을 관리하는 대신 키 하나, 청구서 하나로 끝내고 싶은 경우에 적합합니다.
  • 팀을 운영하면서 개발자별 지출, 알림이 있는 예산, 그리고 강제 중단 대신 하위 모델 전환이 필요하다면 적합합니다(CodeRouter for Teams).
  • 개발자 컴퓨터마다 무언가를 설치하거나 계속 실행해 둘 필요가 없기를 바란다면 적합합니다.

정액 Claude 요금제에 만족하며 그 한도 안에서 쓰는 개인 개발자에게는 둘 다 맞지 않습니다. 구독이 더 유리한 경우는 Claude Code 요금 페이지를 참고하십시오.

CodeRouter로 Claude Code 설정하기

Claude Code는 Anthropic Messages API를 사용하며, CodeRouter는 이 API를 그대로 받습니다. 대시보드에서 키를 만든 뒤(cr_로 시작하며 한 번만 표시됩니다) 다음과 같이 설정하십시오.

# Claude Code → CodeRouter(이번 세션만) export ANTHROPIC_BASE_URL=https://www.coderouter.io export ANTHROPIC_AUTH_TOKEN=cr_... # CodeRouter 키(ANTHROPIC_API_KEY 아님) export ANTHROPIC_MODEL=auto claude
// ~/.claude/settings.json: 영구 설정 { "env": { "ANTHROPIC_BASE_URL": "https://www.coderouter.io", "ANTHROPIC_AUTH_TOKEN": "cr_...", "ANTHROPIC_MODEL": "auto" } }
  • ANTHROPIC_API_KEY가 아니라 ANTHROPIC_AUTH_TOKEN을 사용하십시오. Claude Code 헤더에 API 사용량 과금 대신 여전히 Claude 구독이 표시된다면 claude logout을 실행한 뒤 다시 시작하십시오.
  • ANTHROPIC_MODEL=auto로 두면 라우터가 모델을 고릅니다. 스마트 라우팅에서는 명시한 모델 이름이 무시되며, Direct 모드에서는 대신 정확한 모델 이름을 지정합니다.
  • 각 응답에는 X-CodeRouter-Model, X-CodeRouter-Tier, X-CodeRouter-Cost 헤더가 포함되므로, 무엇이 요청을 처리했는지 확인할 수 있습니다.

비교를 위해, claude-code-router를 실행하는 과정은 다음과 같습니다.

# claude-code-router(README 기준, Node.js 22 이상) npm install -g @musistudio/claude-code-router ccr ui # 관리 UI는 http://127.0.0.1:3458, 게이트웨이는 :3456

그다음 UI에서 공급자와 키를 추가하고, 서버를 시작하고, Claude Code 프로필을 적용합니다. 자세한 내용은 해당 프로젝트의 README와 라우팅 문서를 참고하십시오.

CodeRouter 키 받기: $5 무료, 카드 불필요설정 가이드

자주 묻는 질문

CodeRouter와 claude-code-router는 같은 것입니까?

아닙니다. claude-code-router(CCR)는 GitHub에 공개된 musistudio의 오픈소스 프로젝트로, 직접 실행하는 로컬 게이트웨이입니다. 공급자 API 키와 라우팅 규칙은 직접 준비합니다. CodeRouter는 다른 팀이 운영하는 호스팅 서비스로, Claude Code를 https://www.coderouter.io에 연결하면 요청마다 모델을 선택합니다. 두 프로젝트는 서로 관련이 없습니다.

claude-code-router는 무료입니까?

네. claude-code-router는 MIT 라이선스이며, 데스크톱 앱, npm CLI, Docker 중 어느 방식으로든 무료로 실행할 수 있습니다. 연결한 모델 공급자에는 직접 비용을 지불합니다.

CodeRouter로 Claude Code를 쓰려면 어떻게 해야 합니까?

ANTHROPIC_BASE_URL=https://www.coderouter.io, ANTHROPIC_AUTH_TOKEN에 cr_ 키(ANTHROPIC_API_KEY가 아님), ANTHROPIC_MODEL=auto를 설정한 뒤 claude를 시작하십시오. Claude Code에 API 사용량 과금 대신 여전히 Claude 구독이 표시된다면 claude logout을 실행하고 다시 시작하십시오.

어느 쪽이 비용을 더 줄여 줍니까?

작성하는 규칙과 선택하는 공급자에 따라 다릅니다. claude-code-router에서는 각 공급자의 가격대로 비용을 내고, 어떤 요청을 어떤 모델에 보낼지 직접 정합니다. CodeRouter는 모델 정가 +8%를 청구하고 요청마다 모델을 결정합니다. TokenWatt의 176개 과제 벤치마크(TokenWatt는 CodeRouter와 같은 팀이 운영하는 측정 프로젝트입니다)에서 라우팅된 요청은 여러 차례의 실행에서 과제의 96–100%를 해결했고, 비용은 모든 요청을 Opus로 보낼 때보다 56–70% 적었습니다.

CodeRouter 라우팅의 측정 방법: 벤치마크 방법론과 결과(CodeRouter와 같은 팀이 운영하는 측정 프로젝트인 TokenWatt가 측정).