Claude Code Router: Claude Code Backend를 갈아끼우는 34.7k Stars 오픈소스

## Claude Code Router란

Claude Code Router (34.7k stars, MIT)는 Anthropic의 Claude Code CLI를 프록시 형태로 가로채서, 실제로는 DeepSeek, Gemini, Ollama, OpenRouter 등 다른 모델이 응답하도록 라우팅해주는 Node.js 도구다. Claude Code의 UX와 도구 체계는 그대로 쓰면서 백엔드 모델만 갈아끼울 수 있다.

## 동작 구조

로컬에서 HTTP 프록시 서버를 띄운다. Claude Code CLI의 API 요청 (ANTHROPIC_BASE_URL)을 이 프록시로 돌리면, Router가 설정 파일에 따라 적절한 provider/model로 요청을 변환(transform)해서 전달한다.

```
Claude Code CLI -> CCR Proxy -> Transformer -> DeepSeek/Ollama/Gemini API
```

핵심은 Messages API 형식을 각 provider의 API 형식으로 변환하는 Transformer 시스템이다. OpenRouter용, DeepSeek용, Gemini용 등 built-in transformer가 있고 직접 작성도 가능하다.

## 왜 34.7k 스타인가

1. **비용 절감**: Claude Code는 Anthropic API 키가 필요하고 토큰 사용량만큼 과금된다. DeepSeek나 로컬 Ollama로 돌리면 비용이 1/10 이하다.

2. **모델 선택권**: Claude Code의 에이전트 시스템 (파일 편집, 터미널 실행, Git 조작)은 정말 좋지만 백엔드 모델은 고정되어 있다. Router로 Claude Code 도구 + DeepSeek 추론 같은 하이브리드가 가능하다.

3. **중국 생태계**: GitHub Actions 예제, Volcengine/ModelScope/DashScope provider 지원을 보면 중국 개발자 타겟이 명확하다. 중국에서 Anthropic API를 직접 쓰기 어렵기 때문에 대안 모델 수요가 엄청나다.

4. **확장성**: Custom Transformer로 rate limiting, 캐싱, 로깅 등 인프라 계층 기능을 추가할 수 있다.

## 아키텍처

Monorepo 구조: ccr-server (프록시 서버), ccr-preset (설정 관리), ccr-ui (웹 UI).

Transformer는 adapter 패턴의 전형적인 구현이다. 각 provider가 Messages API 스키마를 provider의 스키마로 매핑한다. 예를 들어 Gemini transformer는 system instruction을 변환하고 tool calls를 functionCalling 형식으로 바꾼다.

tooluse transformer가 인상적이다. DeepSeek 같은 모델은 tool calling이 완벽하지 않은데, 이 transformer가 tool_choice 파라미터를 최적화해서 안정성을 높인다. 모델이 부족한 부분을 인프라에서 보완하는 접근이다.

## Subagent Routing

서브에이전트 프롬프트에 CCR-SUBAGENT-MODEL 태그를 넣으면 그 서브에이전트만 다른 모델로 실행된다. Plan 모드는 Sonnet, File Edit은 Haiku, Code Review는 DeepSeek Reasoner 같은 분할이 가능하다.

## 한계

- **API 호환성**: Messages API와 각 provider 형식이 완전히 일치하지 않는다. Tool calling과 streaming에서 미묘한 차이가 있다.
- **보안**: 프록시 서버가 0.0.0.0으로 열리면 외부 접근 가능. APIKEY 설정 권장.
- **업데이트 지연**: Claude Code가 업데이트되면서 API가 바뀌면 Router도 따라 업데이트되어야 한다.
- **사용량 추적**: 각 provider의 사용량을 별도로 관리해야 한다.

## 결론

Claude Code Router는 AI 코딩 도구의 UX와 백엔드 모델을 분리하겠다는 발상의 전환을 실제로 구현했다. 34.7k 스타는 이 아이디어에 공감하는 개발자가 그만큼 많다는 증거다.

단순히 "Claude Code를 공짜로 쓰자"를 넘어서, AI 코딩 도구 아키텍처에 대한 중요한 시사점을 던진다: 모델은 교체 가능해야 하고, 도구 체계는 모델에 종속되지 않아야 한다.

Claude Code Router: Claude Code Backend를 갈아끼우는 34.7k Stars 오픈소스

// COMMENTS

ON THIS PAGE