Claude Code Router

CCR은 이제 config.json이 아닌 데스크톱 앱입니다. Kunavo를 사용자 지정 API 엔드포인트로 추가한 뒤 라우팅 규칙으로 각 요청 유형을 서로 다른 모델에 보낼 수 있습니다

Providers → Add provider
  Preset provider   Other / custom API endpoint
  Name              Kunavo
  API endpoint      https://api.kunavo.com
  API key           sk-kn-...
  Models            claude-sonnet-5, claude-opus-5, claude-haiku-4-5

Agent Config → Add profile → Claude Code
  Model         Kunavo/claude-sonnet-5
  Opus model    Kunavo/claude-opus-5
  Haiku model   Kunavo/claude-haiku-4-5

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. CCR Desktop에서 Providers → Add provider를 열고, 사전 설정 Other / custom API endpoint를 선택한 다음 Name, API endpoint, API key를 입력하세요.
3. Models 아래에 모델 ID를 추가하세요. Search models를 사용해 카탈로그에서 가져오거나, Custom models에 ID를 직접 입력할 수 있습니다.
4. 2~3개 모델에서 Check Connection을 실행하세요. 실제 요청을 전송하므로 전체 목록이 아닌 확인에 필요한 모델만 선택하세요.
5. Agent Config → Add profile → Claude Code를 열고, Model과 티어별 Opus / Sonnet / Haiku 재정의 값을 설정한 다음 저장하고 CCR에서 Claude Code를 실행하세요.

CCR의 제공자 구성 페이지에서 확인했습니다(2026년 9월 6일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Claude Code Router에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

티어별 매핑이 핵심인 이유

Claude Code는 요청별이 아닌 티어별로 모델을 선택합니다. 기본 루프는 Sonnet 또는 Opus 티어를 요청하고, 하위 에이전트, 검색, 요약 등의 백그라운드 작업은 더 작고 빠른 티어를 요청합니다. CCR의 Agent Config에서는 이 티어들을 별도 필드로 설정할 수 있으므로, 비용이 높은 모델은 필요한 요청만 처리하고 호출량이 많은 티어에는 저렴한 ID를 지정할 수 있습니다. 이 분리가 Claude Code 앞에 라우터를 두는 이유이며, Claude Code 자체 설정에는 표시되지 않습니다.