Context Vault

Claude Code Router — Claude Code 모델 라우팅 프록시

2 min read

Claude Code Router

Claude Code 요청을 다양한 모델로 라우팅하고, 요청/응답을 커스터마이즈하는 프록시 도구. Anthropic 업데이트를 누리면서 모델 선택의 자유를 누릴 수 있다.

Key Points

  • Claude Code를 기반으로 한 코딩 인프라 프록시
  • 요청을 다양한 모델(DeepSeek, Ollama, Gemini, OpenRouter 등)로 라우팅
  • /model 명령으로 동적 모델 전환
  • Transformer 플러그인으로 요청/응답 변환 지원
  • GitHub Actions 연동
  • ⭐ 31.5k stars, 🍴 2.5k forks

Features

  • Model Routing: 백그라운드, 사고, 긴 컨텍스트 등 용도별 모델 라우팅
  • Multi-Provider Support: OpenRouter, DeepSeek, Ollama, Gemini, Volcengine, SiliconFlow, ModelScope, DashScope, AIHubMix 등
  • Request/Response Transformation: Transformer로 프로바이더별 요청/응답 커스터마이즈
  • Dynamic Model Switching: /model 명령으로 실시간 모델 전환
  • CLI Model Management: ccr model 명령으로 터미널에서 모델 관리
  • GitHub Actions Integration: CI/CD에서 Claude Code 태스크 실행
  • Plugin System: 커스텀 Transformer 플러그인 확장

Installation

npm install -g @anthropic-ai/claude-code
npm install -g @musistudio/claude-code-router

Configuration

~/.claude-code-router/config.json 설정:

  • Providers: 모델 프로바이더별 API URL, 키, 모델 목록, Transformer 구성
  • Router: default, background, think, longContext, webSearch 등 용도별 라우팅 규칙
  • APIKEY: 인증 키 (미설정 시 localhost만 접근)
  • PROXY_URL: 프록시 설정
  • NON_INTERACTIVE_MODE: CI/CD 환경 호환 모드
  • 환경변수 보간($VAR_NAME)으로 API 키 관리

라우팅 예시

{
  "Router": {
    "default": "deepseek,deepseek-chat",
    "background": "ollama,qwen2.5-coder:latest",
    "think": "deepseek,deepseek-reasoner",
    "longContext": "openrouter,google/gemini-2.5-pro-preview",
    "longContextThreshold": 60000,
    "webSearch": "gemini,gemini-2.5-flash"
  }
}

실행

ccr code

기술 스택

  • TypeScript (Node.js)
  • Pino 로깅
  • 플러그인 아키텍처 (Transformer 시스템)

그래프 뷰