CC Switch란 무엇인가요? AI 코딩 도구와 모델 공급자를 통합 관리하는 콘솔
CC Switch의 핵심 용도, 적합한 사용자, 설치 방법, 그리고 Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes Agent 등에서의 모델 공급자 관리 기능을 소개합니다.
1. CC Switch란 무엇인가요?
CC Switch, 즉 사람들이 흔히 말하는 cc-switch는 오픈 소스 크로스 플랫폼 데스크톱 앱입니다. 처음에는 Claude Code, Codex, Gemini CLI 같은 AI 코딩 도구의 “모델 스위처”처럼 보이지만, 지금은 점차 더 완성도 높은 AI 도구 통합 관리 콘솔로 발전했습니다.
프로젝트 주소: farion1231/cc-switch.
해결하는 문제는 꽤 구체적이면서도 매우 번거로운 부분입니다. 여러 AI 코딩 도구, 여러 API 공급자, 여러 모델, 여러 key를 동시에 쓰는데 매번 JSON, TOML, YAML, `.env` 같은 설정 파일을 수동으로 수정하고 싶지 않을 때입니다.
하나의 공식 도구, 하나의 공식 계정, 하나의 고정 모델만 쓰는 경우에는 가치가 크게 체감되지 않을 수도 있습니다. 하지만 Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw를 함께 쓰거나, OpenAI, Anthropic, DeepSeek, OpenRouter, Kimi, Qwen, Zhipu 같은 여러 서비스 제공업체를 오가면 CC Switch의 장점이 크게 드러납니다. 설정 변경과 트러블슈팅에 드는 시간을 크게 줄일 수 있습니다.
한 줄로 요약하면, CC Switch가 하는 일은 다음과 같습니다.
여러 AI 도구 + 여러 모델 공급자 + 여러 API 키 + 다양한 설정 형식
↓
하나의 GUI 기반 통합 관리 화면으로 통합2. 왜 필요한가요?
AI 코딩 도구가 점점 늘어나고 있지만, 각 도구의 설정 방식은 모두 다릅니다.
Claude Code는 각자의 설정 방식이 있고, Codex도 각자의 방식이 있습니다. Gemini CLI, OpenCode, OpenClaw, Hermes Agent도 각각 규칙이 다릅니다. 모델을 바꾸고 싶으면 설정 파일을 찾아야 하고, 공급자를 바꾸고 싶으면 base_url, api_key, model을 수정해야 하며, 여러 국내 모델이나 중계/집중 플랫폼을 시험할수록 설정은 더 엉킬 수 있습니다.
개발자에게는 어렵지 않은 일일 수 있지만 귀찮고 반복적인 작업입니다. 비개발자에게는 오히려 진입 장벽이 될 수 있습니다.
제가 처음으로 Claude Code에 서드파티 모델을 수동으로 연결했을 때, 이 불편함을 뼈저리게 느꼈습니다. 문서에서 설정 파일 경로를 찾아가면 base_url, auth_token, model name 같은 필드를 하나씩 직접 채우게 되는데, 필드 자체는 어렵지 않습니다. 하지만 한 글자만 틀려도 바로 오류가 납니다.
더 골치 아픈 점은, 일부 Agent 도구들은 모델 스위치 과정에서 쉽게 꼬일 수 있다는 것입니다. 새 모델을 시험하려고 설정을 조금만 바꿨는데, 결국 도구 자체가 동작하지 않게 되는 경우가 생깁니다. 이런 경험은 꽤 피곤합니다.
CC Switch의 핵심 가치는 바로 이 지점에 있습니다. 이런 설정 파일 뒤의 복잡함을 시각적 인터페이스로 추상화했다는 점입니다.
더 이상 설정 파일을 열어보느라 반복할 필요가 없습니다. 각 도구의 포맷을 외울 필요도 없습니다. 매번 JSON을 복사해 붙여넣을 필요도 없습니다. 인터페이스에서 도구, 공급자, API Key, 모델을 선택하고 저장 및 활성화하면 됩니다.
3. 어떤 도구를 지원하나요?
프로젝트 README, 공식 사이트, 변경 로그 기준으로 CC Switch는 현재 주요하게 다음 AI 도구를 대상으로 합니다.
1. Claude Code 2. Claude Desktop 3. Codex 4. Gemini CLI 5. OpenCode 6. OpenClaw 7. Hermes Agent
즉, 단순히 Claude Code 전용 도구가 아니고, 전통적인 AI CLI 관리자 개념으로도 제한되지 않습니다. Claude Desktop까지 관리 범위에 들어왔기 때문에 더 정확히 말하면 AI 코딩 도구와 데스크톱 AI 워크플로우를 위한 통합 관리 콘솔입니다.
AI 도구 전용의 “모델 구성 콘솔”이라고 이해하면 됩니다. 각 도구 아래에 서로 다른 공급자 구성을 독립적으로 두어 간섭하지 않게 만들 수 있고, 시스템 트레이에서 빠르게 전환할 수 있습니다.
4. 새 버전에서 주목할 변화
이전 버전 CC Switch를 알고 있다면 가장 눈에 띄는 변화는 포지셔닝이 “모델 스위처”에서 “AI 도구 관리 허브”로 확장되었다는 점입니다.
주요 변경 사항은 다음과 같습니다.
1. Claude Desktop을 별도 관리 패널로 편입: Claude Code뿐 아니라 Claude Desktop의 서드파티 공급자 구성도 관리합니다. 2. 모델 매핑 기능 강화: Sonnet, Opus, Haiku 같은 역할을 서드파티 공급자의 실제 모델 ID에 매핑할 수 있습니다. 3. 로컬 라우팅 능력 강화: 프록시 요청, 포맷 변환, 장애 전환, 일부 호환성 처리에 활용됩니다. 4. 사용량/잔액 표시가 더 직관적: 다중 키, 다중 공급자 사용자에게 비용 관리가 쉬워집니다. 5. MCP, Skills, Session 관리가 계속 개선: Agent 워크플로를 설계하는 사용자에게 유용합니다. 6. 라이트 모드가 백그라운드 상시 실행에 더 적합: 항상 메인 창을 열지 않아도 트레이에서 동작합니다. 7. Codex, Gemini, OpenCode 등 도구 호환성 지속 강화: 도구 간 구성 관리가 점점 더 통일됩니다.
그래서 예전에는 “Claude Code용 공급자 전환기”로 보였던 기능을, 이제는 AI 코딩 도구 생태계의 로컬 콘솔로 다시 이해할 수 있습니다.
5. 핵심 기능
1. 시각적 모델 공급자 관리
CC Switch에는 공식 API, 클라우드 업체, 집약형 플랫폼, 커뮤니티 공급자 등을 아우르는 다수의 사전 설정이 내장되어 있습니다. 버전이 올라갈수록 지원 범위와 사전 설정이 계속 확장됩니다.
즉, 처음부터 직접 설정을 작성할 필요가 거의 없습니다. 보통은 공급자를 선택하고, API Key를 입력하고, 모델을 고르는 절차로 충분합니다.
Zhipu, DeepSeek, Qwen, Kimi, MiniMax, DouBaoSeed, Jieyue 또는 OpenAI/Anthropic 호환 인터페이스를 지원하는 기타 공급자를 쓰는 경우에도, 보통 이런 방식으로 연결할 수 있습니다.
다만 공급자별 호환성과 모델 목록 조회 능력은 같지 않습니다. 어떤 것은 모델 목록을 바로 가져오고, 어떤 것은 모델 이름을 직접 입력해야 합니다. 실제로 사용하는 공급자 기준으로 확인해야 합니다.
2. 원클릭 전환과 트레이 빠른 전환
공급자를 구성한 뒤, CC Switch에서 해당 구성을 바로 활성화할 수 있습니다. 해당 구성은 대상 도구의 설정 파일에 기록됩니다.
더 편한 점은 시스템 트레이/메뉴에서 빠르게 전환할 수 있다는 것입니다. 매번 메인 창을 열지 않고도, 메뉴바나 트레이의 CC Switch 아이콘만 눌러 원하는 도구의 공급자 구성을 즉시 바꿀 수 있습니다.
AI 코딩 도구를 자주 쓰는 사용자에게 매우 실용적입니다.
예를 들어, 작은 작업에는 가볍고 응답 빠른 모델을 쓰고, 복잡한 리팩터링이나 긴 컨텍스트 작업에는 더 강한 모델로 바꾸는 식으로 조합합니다. 예전에는 이 과정이 수동 설정 수정이었지만, 이제는 마우스 몇 번으로 끝납니다.
3. Claude Code 지원의 비교적 매끄러운 핫스왑
공식 FAQ에 중요한 설명이 있습니다. 대부분의 도구는 공급자를 바꾼 뒤 터미널/CLI를 재시작해야 적용되는 경우가 많지만, Claude Code는 현재 공급자 데이터의 핫스왑을 지원해 꼭 재시작이 필요하지 않을 수 있습니다.
그래서 CC Switch와 Claude Code 조합을 선호하는 이유가 여기에 있습니다.
단, 주의할 점은: 모델이 응답을 생성 중이거나 도구가 작업을 실행 중일 때 강제로 전환하지 말아야 합니다.
안전하게는 현재 응답 라운드가 끝난 뒤에 전환하세요. 중간에 바꾸면 요청 중단, 세션 이상, 에러가 생길 수 있습니다.
4. Claude Desktop 관리
신규 CC Switch는 Claude Desktop을 독립 관리 패널로 편입했습니다. 로컬 라우팅과 모델 매핑을 통해 Claude Desktop의 서드파티 추론 구성에서 일부 비-Claude 계열 모델의 호환성 문제를 해결하도록 돕습니다.
다만 Claude Desktop의 사용 맥락은 Claude Code와 다릅니다. Claude Code가 주로 CLI 기반 개발·Agent 실행이라면, Claude Desktop은 일상 대화, 자료 정리, 데스크톱 사용 쪽이 더 중심입니다.
그래서 이 글에서는 Claude Desktop을 신규 기능 소개로만 다루고, 접속 튜토리얼은 별도로 작성하지 않습니다. OpenRouter, DeepSeek 등 서드파티 공급자 연동 방식은 다음 전문 글을 참고하세요: 《CC Switch로 Claude Desktop 연동 가이드: 로컬 라우팅으로 OpenRouter와 DeepSeek 전환》.
5. 모델 매핑
모델 매핑은 최신 CC Switch의 핵심 기능 중 하나입니다.
일부 도구는 Sonnet, Opus, Haiku처럼 고정된 모델 역할명만 인식합니다. 그런데 서드파티 공급자는 deepseek-v4-pro, deepseek-v4-flash, inclusionai/ring-2.6-1t 같은 고유 모델 ID를 사용합니다.
CC Switch는 중간에서 매핑 레이어를 둡니다.
도구 측에서 보는 모델 역할 → 서드파티 공급자의 실제 모델 ID이 기능은 Claude Desktop, Claude Code, 일부 서드파티 공급자 호환성에 매우 중요합니다. 이는 모델을 실제로 Claude로 바꾸는 것이 아니라, 도구 측에서 정상적으로 인식해 호출할 수 있게 해주는 것입니다.
6. 사용량 조회 및 비용 통계
CC Switch는 사용량 조회와 통계 기능을 제공합니다. 모델 목록에서 사용량 조회를 설정하면 일부 API Key의 잔액, 소모량, 특정 토큰 플랜의 남은 할당량 등을 확인할 수 있습니다.
이는 여러 공급자를 자주 쓰는 사람에게 특히 유용합니다.
대부분의 경우 우리가 모르는 것은 “어떤 모델이 좋은가”가 아니라 “내가 실제로 얼마를 쓰고 있는가”입니다. CC Switch가 그 정보를 한곳에 모아주면 비용 관리를 훨씬 명확하게 할 수 있습니다.
예를 들면:
- 일상적인 작은 작업에는 저비용 모델 사용
- 긴 문서 정리에 가성비 모델 사용
- 복잡한 코드 리팩터링은 더 강한 모델로 전환
- 새벽에 긴 작업을 돌리기 전 충분한 잔액을 미리 확인
AI 코딩을 많이 쓰는 사용자에게 이 기능은 사소한 부가 기능이 아니라 실전적입니다. Codex를 집중 사용한다면 메뉴바 잔량 표시 도구 CodexBar를 함께 쓰면 잔액을 상시 확인할 수 있습니다.
7. 로컬 라우팅, 장애 전환, 서킷 브레이크
CC Switch의 또 다른 고급 기능은 로컬 라우팅과 장애 전환입니다.
로컬에서 프록시 서비스를 띄워 일부 도구의 요청을 가로채고, 로컬에서 API 형식 변환, 자동 장애 전환, 서킷 브레이크, 공급자 상태 모니터링을 수행할 수 있습니다.
쉽게 말해 다음과 같습니다. 같은 도구에 GLM, DeepSeek, Kimi, MiniMax, OpenRouter 등 여러 공급자를 구성해둘 수 있습니다. 특정 공급자의 잔액이 소진되거나, 장애가 발생하거나, 응답이 지연되거나 일시적으로 사용할 수 없을 때 CC Switch가 다음 사용 가능한 공급자로 전환을 시도해 작업 실패를 줄입니다.
이 기능은 Agent를 장시간 계속 돌리는 사용자가 특히 좋아합니다.
예를 들어, 자정 전 Claude Code로 큰 프로젝트 개편 작업을 돌려놓고 자고 있으면, 밤중에 어떤 공급자의 잔액이 소모되어 끊길 수 있습니다. 장애 전환이 없다면 다음 날 아침엔 작업이 이미 중단된 상태일 수 있습니다. 반면 대체 공급자를 잘 구성해두면 일정 부분 계속 진행될 가능성이 높습니다.
단, 이 기능이 만능은 아닙니다. 모델별 역량, 컨텍스트 길이, 도구 호출 호환성, 출력 스타일은 모두 다르기 때문입니다. 장애 전환으로 안정성은 올라가지만, 모든 작업이 완전히 무중단으로 이관되는 것은 아닙니다.
공식 Claude 모델을 쓸 때는 로컬 라우팅 사용 여부를 신중히 테스트해야 합니다. 제 조언은 먼저 작은 작업으로 안정성을 검증한 뒤 장기 사용 여부를 결정하는 것입니다.
8. MCP, Skills, 프롬프트 관리
새 CC Switch는 더 이상 모델 전환기만 남아 있지 않습니다. 공식 README와 사용자 매뉴얼도 MCP, Skills, Prompts 같은 확장 기능 관리까지 강조합니다.
MCP는 AI 코딩 도구가 외부 도구·서비스를 붙이기 위한 프로토콜 생태계이고, Skills는 재사용 가능한 능력 패키지 또는 워크플로우 자원이며, Prompts는 재사용 가능한 프롬프트나 시스템 지침입니다.
이전에는 이런 것들이 각 도구에 흩어져 있어서 관리가 어렵습니다. CC Switch의 접근 방식은 하나의 패널에서 이런 확장 기능을 묶어 여러 AI 코딩 도구 간 동기화·관리성을 높이는 것입니다.
일반 사용자라면 초반에는 MCP와 Skills를 건드릴 필요가 없습니다. 모델 공급자 전환부터 익히면 충분합니다. 하지만 이미 Claude Code, Codex, OpenCode 등을 활용해 Agent 워크플로를 설계하고 있다면, 나중에 이 영역이 큰 가치를 냅니다.
9. Session 관리
AI 코딩 도구에서는 Session 관리도 중요합니다.
많은 Agent 작업은 한 번의 대화로 끝나지 않고 프로젝트 단위로 계속 이어집니다. Session에는 컨텍스트, 작업 진행률, 도구 호출 흔적, 명령 이력, 현재 목표가 들어가 있을 수 있습니다. 이 데이터가 여러 도구에 흩어져 있으면 나중에 복구가 번거롭습니다.
CC Switch의 Session 관리 지원은 여러 프로젝트/도구를 오가는 사용자에게 적합합니다. 현재 사용 중인 도구, 공급자, 세션, 구성 세트를 더 명확히 파악할 수 있습니다.
10. 클라우드 동기화 및 다중 장치 동기화
CC Switch는 클라우드 동기화도 지원해 Dropbox, OneDrive, iCloud, WebDAV 서버를 통해 장치 간 공급자 데이터를 동기화할 수 있습니다.
이는 다중 장치 사용자에게 적합합니다.
예를 들어 MacBook, Windows 데스크톱, 또는 회사/개인 PC에 유사한 구성이 필요할 때 과거에는 설정 파일을 수동으로 복사해야 했습니다. 이제 동기화 서비스를 통해 공급자 구성을 이동할 수 있습니다.
다만 API Key 동기화는 항상 주의가 필요합니다. 오픈 소스 도구라도 신뢰할 수 있는 장치와 신뢰 가능한 클라우드 서비스에서만 민감한 구성을 동기화하는 편이 좋습니다.
6. 설치 방법
가장 직접적인 설치는 프로젝트 릴리스 페이지에서 OS에 맞는 설치 파일을 받는 방식입니다.
Windows, macOS, Linux 모두 버전이 있습니다. 본인 환경에 맞는 파일을 내려받으시면 됩니다.
macOS 사용자는 Homebrew로도 설치 가능합니다.
brew tap farion1231/ccswitch
brew install --cask cc-switch업데이트는 다음 명령을 사용합니다.
brew update
brew upgrade --cask cc-switch삭제는 다음과 같습니다.
brew uninstall --cask cc-switch
brew untap farion1231/ccswitch다운로드는 공식 사이트 또는 GitHub Releases에서만 받는 것이 좋습니다. 공식 릴리스 페이지도 “CC Switch”라는 명목으로 결제/충전/로그인 자격 증명을 요구하는 사이트나 클라이언트는 주의하라고 안내합니다.
7. Claude Code 연동 모델 기본 흐름
Claude Code를 예로 들어 대략적인 사용 방식을 설명합니다.
1단계: CC Switch 실행
설치를 마치면 CC Switch를 실행하세요. 메인 화면이 열리고, 서로 다른 AI 도구 사이를 전환할 수 있습니다.
Claude Code에 해당하는 관리 페이지로 이동합니다.
2단계: 공급자 추가
추가 버튼을 눌러 연결할 공급자를 선택합니다.
사전 설정된 공급자라면 CC Switch가 일반적으로 인터페이스 주소, 구성 구조, 기본 모델 등 대부분의 필드를 자동으로 채웁니다. 사용자가 입력할 값은 보통 API Key입니다.
3단계: 모델 선택
API Key를 입력한 뒤 모델을 조회하거나 선택할 수 있습니다.
공급자가 모델 목록 조회를 지원하면 목록을 바로 가져옵니다. 지원하지 않으면 모델명을 직접 입력해야 합니다.
가장 많이 실수하기 쉬운 부분이 모델명입니다. 모델명은 공급자 백엔드에서 실제 호출 가능한 이름과 정확히 일치해야 하며, 임의의 약어를 넣으면 안 됩니다.
4단계: 저장 및 활성화
구성이 맞는지 확인한 뒤 저장을 누릅니다. 모델 목록으로 돌아가서 해당 공급자 구성을 활성화합니다.
CC Switch가 이 구성을 Claude Code의 해당 설정 파일에 기록합니다. 이후 Claude Code에서 바로 이 모델을 사용할 수 있습니다.
8. 로컬 라우팅과 장애 전환은 어떻게 이해하면 될까요?
CC Switch를 막 시작한 사용자라면 처음부터 로컬 라우팅을 건드리지 않아도 됩니다. 일반적인 공급자 전환만 먼저 익히면 충분합니다.
이미 여러 공급자를 준비했고, 실패 시 대체 모델로 자동 전환되길 원한다면 이후 로컬 라우팅을 공부하면 됩니다.
대략적인 과정은 다음과 같습니다.
1. 설정 페이지로 이동 2. 라우팅 서비스 찾기 3. 로컬 라우팅 활성화 4. Claude, Codex, Gemini 등 대상 도구의 앱 라우팅 활성화 5. 자동 장애 전환 켜기 6. 백업 공급자 추가 7. 홈 화면에서 드래그로 우선순위 조정 8. 공급자 상태 및 실제 요청 결과 관찰
중요한 작업을 모두 처음부터 맡기지 않는 것이 좋습니다. 간단한 코드 설명, README 생성, 파일 재작성 같은 가벼운 작업으로 먼저 테스트해 보세요. 라우팅, 대체 공급자, 모델 호환성이 안정적인지 확인한 뒤 더 긴 작업에 적용하는 것이 바람직합니다.
9. 보안 및 주의사항
CC Switch는 오픈 소스 프로젝트이며 구성은 기본적으로 로컬에 저장됩니다. 공식 README에서도 SQLite 데이터베이스와 원자적 쓰기를 사용해 구성 파일 손상 위험을 줄인다고 언급합니다.
하지만 API Key가 관련된 한, 결코 안이해서는 안 됩니다.
다음 사항에 유의하세요.
1. API Key를 스크린샷으로 공개 플랫폼에 올리지 마세요. 2. key가 포함된 설정 파일을 GitHub에 커밋하지 마세요. 3. 클라우드 동기화 전에 동기화 서비스와 장치의 신뢰성을 확인하세요. 4. 출처가 불명확한 수정 버전 설치 파일을 설치하지 마세요. 5. 다운로드는 가급적 공식 GitHub Releases 또는 공식 사이트에서 진행하세요. 6. 서드파티 API 공급자 사용 시 과금 규칙, 모델 라우팅 규칙, 개인정보 처리 방침을 확인하세요.
특히 서드파티 중계/집합형 플랫폼은 품질 편차가 큽니다. 가격은 저렴할 수 있으나 안정성, 프라이버시, 과금 투명성, 모델 교체 정책에서 차이가 날 수 있습니다. 싼 가격만 이유로 중요 코드, 민감 데이터, 비즈니스 프로젝트를 전부 투입하지 마세요.
10. 어떤 사람에게 적합한가요?
CC Switch는 특히 아래 사용자군에 잘 맞습니다.
1. Claude Code를 자주 사용하는 사람 2. Claude Desktop 서드파티 공급자 구성을 관리하고 싶은 사람 3. Codex, Gemini CLI, OpenCode, OpenClaw, Hermes Agent를 동시에 쓰는 사람 4. 여러 모델 공급자를 시험하고 싶은 사람 5. 공식 모델, 국산 모델, 통합 플랫폼 사이를 자주 전환하는 사람 6. AI 코딩 비용 관리를 하려는 사람 7. 설정 파일을 손수 수정하기 싫은 비개발자 사용자 8. 나만의 Agent 워크플로를 구축하는 사람
공식 Claude Code를 가끔만 쓰고, 모델/키 전환도 안 하며, 서드파티 서비스를 연결하지 않는다면 큰 도움이 되지 않을 수 있습니다.
하지만 이미 AI 코딩 도구 생태계를 본격적으로 다루기 시작했다면, CC Switch는 “일찍 설치할수록 편해지는” 도구입니다.
11. 내 평가
CC Switch는 처음엔 “모델 스위처”처럼 보였지만, 지금은 점점 AI 도구 관리 센터로 바뀌고 있습니다.
가장 핵심적인 가치는 화려한 기능이 아니라, 흩어지고 오류가 잦던 구성 절차를 비교적 통일된 GUI로 바꿨다는 점입니다.
다양한 모델, 공급자, Agent 도구를 자주 시험하는 제 같은 사용자에게는, 귀찮은 비용이 크게 줄어듭니다.
전에는 모델을 바꾸는 것이 항상 귀찮은 일이었습니다. 설정 파일을 찾고, 필드를 바꾸고, 모델명을 확인하고, 도구를 재시작하고, 오류를 추적하는 작업이 반복되었죠. 이제는 대다수 경우 공급자 선택, key 입력, 모델 선택, 저장·활성화만 하면 됩니다.
이게 CC Switch의 가장 실질적인 가치입니다.
12. 요약
한마디로 정리하면: CC Switch는 AI 코딩을 많이 쓰는 사용자에게 적합한 로컬 관리 콘솔입니다.
CC Switch는 Claude Code, Codex, Gemini CLI, Claude Desktop을 대체하지 않습니다. 대신 이들 위에 통일된 관리 계층을 얹습니다.
도구 관리 + 모델 공급자 관리 + API Key 관리 + 로컬 라우팅 + 사용량 통계 + MCP / Skills / Session 관리따라서 가장 적합한 대상은 AI를 가끔 묻는 일반 사용자가 아니라, AI를 이미 개발·작성·자동화·Agent 워크플로의 진입점으로 사용하고 있는 사람입니다.
자주 묻는 질문
CC Switch는 무료인가요?
CC Switch는 오픈 소스 프로젝트로, 소프트웨어 자체는 무료이며 구성은 주로 로컬 저장소(SQLite와 원자적 쓰기)에서 관리됩니다. 단, 연동되는 서드파티 API 공급자는 사용량에 따라 별도 과금되며, 그 비용은 CC Switch와 무관합니다.
CC Switch는 어떤 AI 도구를 지원하나요?
공식 README 기준으로 현재 Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes Agent 등의 모델 공급자 구성 관리를 주로 지원합니다.
CC Switch는 어떻게 설치하나요?
가장 직접적인 방법은 GitHub Releases에서 OS별(Windows / macOS / Linux) 설치 파일을 내려받는 것입니다. macOS 사용자는 Homebrew를 통해 brew tap farion1231/ccswitch 후 brew install --cask cc-switch로 설치할 수 있습니다. 공식 GitHub Releases 또는 공식 사이트에서 받는 것을 권장하며, 결제나 로그인 자격 증명을 요구하는 “CC Switch” 사이트는 주의하세요.
CC Switch와 Claude Code의 관계는 무엇인가요?
CC Switch는 Claude Code를 대체하지 않으며, 그 위에 모델 공급자 및 구성 관리 계층을 추가합니다. 대부분의 도구는 공급자 변경 후 재시작이 필요하지만, Claude Code는 현재 공급자 데이터 핫스왑을 지원하므로 두 도구를 함께 쓰는 사람이 많습니다. 다만 모델 생성 중에는 강제 전환하지 마세요.
CC Switch로 서드파티 공급자를 연결해도 안전한가요?
구성은 로컬에 저장되더라도 API Key가 관련되면 주의가 필요합니다. key 스크린샷을 외부로 전송하지 않고 GitHub에 커밋하지 말아야 합니다. 클라우드 동기화 전에는 장치와 동기화 서비스를 신뢰 가능한지 확인하고, 서드파티 중계/집적 플랫폼을 쓸 때는 과금, 포워딩, 개인정보 정책을 반드시 확인하세요.
참고 링크
Share