CC Switch로 Claude Desktop 연동하기: 로컬 라우팅으로 OpenRouter와 DeepSeek 연결
CC Switch를 통해 Claude Desktop의 제3자 공급자 설정을 통합 관리하고, 모델 매핑과 로컬 라우팅으로 OpenRouter, DeepSeek 같은 비 Claude 계열 모델을 접속하는 방법을 설명합니다.
CC Switch v3.15.0부터는 Claude Desktop 독립 관리가 가능해집니다. 핵심 가치는 “껍데기 UI가 하나 더 생긴다”가 아니라, Claude Desktop의 제3자 추론 설정, 모델 매핑, 로컬 라우팅을 하나의 그래픽 패널에 모아 수동 설정, 엔드포인트 입력, 모델 ID 등록의 번거로움을 줄여준다는 점입니다. (CC Switch의 기본 용도와 지원 도구를 아직 모르신다면, 먼저 《CC Switch는 무엇인가? AI 코딩 도구와 모델 공급자를 통합 관리하는 콘솔》를 읽어보세요.)
Claude Desktop은 공식적으로 제3자 추론 진입점을 제공합니다. 일반적인 활성화 경로는 Help → Troubleshooting → Enable Developer Mode이고, 이어서 Developer → Configure third-party inference로 들어갑니다. 문제는 초보자 관점에서 수동 설정이 까다롭다는 것입니다. Gateway 주소, API Key, 인증 방식, 모델 목록 등을 직접 채워야 하므로, 어느 한 항목이라도 잘못되면 연결 실패로 이어질 수 있습니다.
CC Switch의 역할은 이 과정을 하나의 도구로 통합하는 것입니다. 특히 Claude Desktop을 OpenRouter, DeepSeek 같은 비 Claude 계열 모델에 붙일 때, CC Switch의 “모델 매핑”과 “로컬 라우팅”이 특히 유용합니다.
1. 무엇을 해결해 주는가?
Claude Desktop에서 제3자 공급자를 사용할 때는 주로 두 가지가 번거롭습니다.
1. 설정 진입 경로가 깊다: 개발자 모드를 먼저 켜고, 제3자 추론 설정 화면으로 이동해야 합니다. 2. 모델 이름 호환성 문제: Claude Desktop은 보통 Sonnet, Opus, Haiku 같은 Claude 모델 역할을 기준으로 이해하는 반면, 제3자 플랫폼은 각자의 모델 ID를 사용합니다. 예: inclusionai/ring-2.6-1t, deepseek-v4-pro, deepseek-v4-flash.
CC Switch는 중간에 어댑터 레이어를 둡니다.
Claude Desktop → CC Switch 로컬 라우팅 → 제3자 공급자이 레이어는 크게 세 가지를 담당합니다.
- Claude Desktop 요청을 제3자 공급자로 전달
- Sonnet / Opus / Haiku 같은 모델 역할을 실제 모델 ID로 매핑
- Claude Desktop에 필요한 제3자 추론 설정을 자동으로 작성
2. 언제 모델 매핑을 켜야 하나?
판별 기준은 간단합니다.
| 공급자 유형 | 모델 매핑 필요 여부 | 로컬 라우팅 필요 여부 |
|---|---|---|
| Claude 계열 모델(예: 공식 Claude API 또는 Claude 모델만 제공하는 중계) | 보통 불필요 | 보통 불필요 |
| 비 Claude 계열 모델(예: OpenRouter의 Ring, DeepSeek V4) | 필요 | 필요 |
본 글의 두 예시는 모두 비 Claude 계열 모델이므로 두 항목 모두 켜야 합니다.
- “모델 매핑 사용”
- “로컬 라우팅”
비 Claude 계열 모델을 쓰는 한 로컬 라우팅은 계속 실행 상태여야 합니다. CC Switch를 종료하거나 라우팅 스위치를 끄면 Claude Desktop은 제3자 모델 연결이 끊깁니다.
3. 준비 작업
시작 전에 세 가지를 준비합니다.
1. CC Switch v3.15.0 이상 공식 홈페이지: https://ccswitch.io
2. Claude Desktop 공식 다운로드: https://claude.ai/download
3. 제3자 공급자 계정과 API Key 아래 중 하나를 준비하면 됩니다:
- OpenRouter: https://openrouter.ai
- DeepSeek Platform: https://platform.deepseek.com
4. CC Switch 설치 또는 업그레이드
이미 CC Switch를 설치한 사용자는 자동 업데이트를 진행하면 됩니다.
처음 설치하는 경우는 아래를 참고하세요.
## macOS
brew tap farion1231/ccswitch
brew install --cask cc-switchWindows 사용자는 .msi 설치 파일을, Linux 사용자는 배포판에 맞는 .deb, .rpm, .AppImage를 선택해 설치합니다.
설치 후 CC Switch를 실행합니다. 앱 스위처에서 독립된 “Claude Desktop” 항목이 “Claude Code”와 나란히 보이면, Claude Desktop 관리를 지원하는 최신 버전입니다.
5. Claude Desktop 패널로 들어가기
CC Switch의 왼쪽 또는 상단 앱 스위처에서 다음을 선택합니다.
Claude Desktop들어간 뒤 “Add Provider”를 눌러 공급자를 추가하고, 연결할 플랫폼을 선택한 다음 API Key와 엔드포인트를 입력합니다.
아래에 두 가지 일반적인 구성 예시를 제공합니다.
6. 구성 예시 A: OpenRouter + Ring 2.6 1T
OpenRouter는 통합 진입점을 통해 여러 모델을 사용할 수 있는 모델 집계 플랫폼입니다. 무료 모델, 과금 모델, 엔터프라이즈 요금제까지 갖추고 있어 모델을 시험하거나 공급자를 잠시 전환할 때 적합합니다.
1. OpenRouter API Key 생성
OpenRouter를 엽니다.
Keys 페이지에서 API Key를 생성합니다.
2. CC Switch에 OpenRouter 추가
“Add Provider”에서 OpenRouter 프리셋을 선택하고 다음을 입력합니다.
| 필드 | 입력 값 |
|---|---|
| 공급자 이름 | OpenRouter |
| 공식 사이트 | https://openrouter.ai |
| API Key | OpenRouter 키 붙여넣기 |
| 요청 주소 | https://openrouter.ai/api |
| API 형식 | Anthropic Messages (네이티브) |
| 모델 매핑 필요 | 켜기 |
참고: 요청 주소 끝에 /를 붙이지 않는 것이 좋습니다.
3. 모델 매핑 권장 설정
Ring 2.6 1T은 Claude 계열이 아니므로, Claude Desktop의 역할명을 OpenRouter의 실제 모델 ID로 매핑해야 합니다.
다음 세 줄을 추가할 수 있습니다.
| 모델 역할 | 메뉴 표시명 | 실제 요청 모델 | 1M 지원 표시 |
|---|---|---|---|
| Sonnet | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | 체크 안 함 |
| Opus | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | 체크 안 함 |
| Haiku | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | 체크 안 함 |
이는 Claude Desktop에서 Sonnet, Opus, Haiku를 선택해도 결국 OpenRouter의 inclusionai/ring-2.6-1t를 호출한다는 뜻입니다.
7. 구성 예시 B: DeepSeek 공식 V4
DeepSeek 공식 문서는 Anthropic 호환 인터페이스를 제공하며, base URL은 다음과 같습니다.
https://api.deepseek.com/anthropic이는 일부 Anthropic API 생태계 도구와 호환되어 접속 가능함을 의미합니다. DeepSeek 문서에는 deepseek-v4-pro[1m], deepseek-v4-flash 같은 모델명도 포함한 Claude Code 환경변수 예제가 있습니다.
1. DeepSeek API Key 생성
DeepSeek Platform에 접속합니다.
API Keys 페이지에서 Key를 생성하세요. DeepSeek은 보통 API 호출 전에 충전이 필요합니다.
2. CC Switch에 DeepSeek 추가
“Add Provider”에서 DeepSeek 프리셋을 선택하고 다음을 입력합니다.
| 필드 | 입력 값 |
|---|---|
| 공급자 이름 | DeepSeek |
| 공식 사이트 | https://platform.deepseek.com |
| API Key | DeepSeek 키 붙여넣기 |
| 요청 주소 | https://api.deepseek.com/anthropic |
| API 형식 | Anthropic Messages (네이티브) |
| 모델 매핑 필요 | 켜기 |
참고: 여기서는 /anthropic를 사용하며, /v1이 아닙니다.
3. 모델 매핑 권장 설정
“일상 작업은 저렴한 모델, 복잡한 추론은 고성능 모델” 방식으로 매핑할 수 있습니다.
| 모델 역할 | 메뉴 표시명 | 실제 요청 모델 | 1M 지원 표시 |
|---|---|---|---|
| Sonnet | deepseek-v4-flash | deepseek-v4-flash | 체크 |
| Opus | deepseek-v4-pro | deepseek-v4-pro | 체크 |
| Haiku | deepseek-v4-flash | deepseek-v4-flash | 선택 |
따라서 Claude Desktop에서 Sonnet을 선택하면 더 저렴한 deepseek-v4-flash를, Opus를 선택하면 성능이 더 높은 deepseek-v4-pro를 호출합니다.
DeepSeek 문서의 1M 표기법을 쓰고 싶다면 실제 요청 모델에 다음을 넣어 테스트해 볼 수 있습니다.
deepseek-v4-pro[1m]실제 사용 가능 여부는 DeepSeek 공식 문서와 CC Switch 현재 버전 지원 범위로 확인해야 합니다.
8. 로컬 라우팅 활성화
모델 매핑을 설정한 뒤 반드시 로컬 라우팅을 켜야 합니다.
일반적인 경로는 다음과 같습니다.
CC Switch → Settings → Routing두 항목을 모두 켭니다.
1. 라우팅 마스터 스위치: 켜면 상태가 실행 중으로 표시됩니다. 2. Claude 애플리케이션 라우팅: Claude를 체크해서 Claude Desktop 요청이 로컬 라우팅을 거치도록 설정합니다.
기본 서비스 주소는 보통 다음과 같습니다.
http://127.0.0.1:15721대부분은 변경할 필요가 없습니다.
또한 “메인 화면에 로컬 라우팅 토글 표시”를 함께 켜면, 메인 패널에서 라우팅 동작 여부를 빠르게 확인할 수 있습니다.
9. 공급자 활성화 및 Claude Desktop 재시작
구성이 완료되면 Claude Desktop 패널에서 방금 추가한 공급자를 선택하고 “Enable”를 클릭합니다.
그다음 Claude Desktop을 재시작합니다.
중요: 창을 닫는 것이 아니라, 완전히 종료해야 합니다.
- macOS:
Command + Q로 완전 종료 - Windows: 작업 표시줄 트레이에서 Claude 아이콘을 우클릭 후 종료
Claude Desktop을 다시 열고 테스트 문장을 보냅니다.
안녕하세요, 한 문장으로 답변해 주세요.정상 응답이 오면, CC Switch로 돌아가 프록시 트래픽 기록을 확인합니다. 요청 로그가 보이면 연결이 완료된 것입니다.
10. 자주 묻는 질문
1. Claude 공식 계정으로 다시 돌아가고 싶으면?
CC Switch의 Claude Desktop 패널에서 현재 제3자 공급자를 비활성화하거나 공식 설정으로 다시 전환한 뒤 Claude Desktop을 재시작하면 됩니다.
2. 여러 공급자 사이를 어떻게 바꾸나?
Claude Desktop 패널에서 다른 공급자를 선택하고 활성화한 뒤 Claude Desktop을 재시작하세요. 로컬 라우팅은 반복 수정이 필요 없습니다.
3. Claude Code에도 같은 방식으로 연결되나?
가능합니다. CC Switch는 Claude Code와 Claude Desktop을 별도 패널로 관리합니다. 차이는 Claude Code가 보통 명령줄 개발 흐름에 더 적합하고, Claude Desktop은 일상 대화, 자료 정리, 데스크톱 사용에 더 적합하다는 점입니다.
DeepSeek 공식 문서에도 ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL 같은 Claude Code 환경변수 설정 방법이 제시되어 있습니다.
4. 오류는 어떻게 점검하나?
우선 다음 항목을 확인합니다.
1. 요청 주소 끝에 /가 불필요하게 붙어 있지 않은지 2. API Key를 온전히 복사했는지 3. API 형식이 Anthropic Messages로 설정되어 있는지 4. “모델 매핑 필요”가 켜져 있는지 5. 모델 매핑의 실제 모델 ID가 정확한지 6. 로컬 라우팅 마스터 스위치가 실행 중인지 7. Claude 애플리케이션 라우팅이 체크되어 있는지 8. Claude Desktop이 완전히 종료되었다가 재시작되었는지
대부분의 연결 실패는 API Key, 엔드포인트 주소, 모델 ID, 로컬 라우팅 미실행 중 하나에서 발생합니다.
5. CC Switch를 항상 켜 두어야 하나?
비 Claude 계열 모델을 쓰고 모델 매핑에 의존한다면 CC Switch는 백그라운드에서 계속 실행 중이어야 합니다.
Lightweight Mode(경량 모드)를 켜면 메인 창은 닫고 트레이 프로세스만 남기도록 설정할 수 있어, 로컬 라우팅은 계속 동작합니다.
11. 어떤 용도로 쓰는 것이 좋은가?
제 제안은 다음과 같습니다.
- 일상 글쓰기, 웹 콘텐츠 정리: OpenRouter에서 가성비 좋은 모델을 사용
- 중국어 장문 처리, 코드 보조, 복잡한 추론: DeepSeek V4 Pro를 시험
- 저비용 테스트: 저렴한 모델 또는 무료 모델 우선 사용
- 중요한 작업: 여전히 공식 Claude, OpenAI, 안정적인 유료 모델을 백업으로 유지
제3자 공급자의 가장 큰 장점은 유연성과 저렴함이지만, 안정성, 개인정보, 지연, 모델 성능 격차에도 유의해야 합니다. 모든 핵심 워크플로우를 하나의 저가 공급자에 전적으로 묶지 말고, 대체 경로를 함께 유지하는 편이 좋습니다.
12. 마무리
CC Switch v3.15.0의 의미는 Claude Desktop의 제3자 모델 접속을 “수동 설정 입력”에서 “GUI 기반 공급자 전환”으로 바꾼 점에 있습니다.
핵심 절차는 다섯 단계로 요약할 수 있습니다.
CC Switch 설치 → Claude Desktop 패널 진입 → 공급자 추가 → 모델 매핑 구성 → 로컬 라우팅 활성화 및 Claude Desktop 재시작“모델 매핑”과 “로컬 라우팅”의 개념을 이해하면 OpenRouter, DeepSeek와 같은 비 Claude 계열 모델도 비교적 안정적으로 Claude Desktop에 접속할 수 있습니다.
참고 링크
Share