본문으로 건너뛰기
PromptQuorum인간을 위해 설계. AI를 위해 구조화.
홈/고급 로컬 LLM
Overview & Reference

CC Switch 리뷰: AI 코딩 도구용 제공업체 관리 앱

·8분 읽기 저 · PromptQuorum 창립자 · 오픈 웨이트·오픈소스 AI 디스커버리 엔진

CC Switch는 Claude Code, Codex, Gemini CLI 등 AI 코딩 도구의 API 제공업체를 전환하는 Windows·macOS·Linux용 무료 MIT 라이선스 데스크톱 앱입니다. 설정과 라우팅을 담당하는 계층일 뿐 AI 모델이 아니며, PromptQuorum은 마지막 업데이트 시점에 ccswitch.io와 저장소 파일 어디에서도 개인정보 처리방침을 찾지 못했습니다.

핵심 요점

  • 지원 범위: README는 Claude Code와 Codex부터 OpenCode, Pi, Kimi Code까지 관리 대상 도구 12개를 나열하고, 공식 사이트는 16개를 나열합니다
  • README에 따르면 전환할 때는 엔드포인트, 키, 모델만 교체되며 플러그인, 훅, MCP 서버, 주석은 그대로 유지됩니다
  • 세 가지 모드: 직접 연결, 라우팅(형식 변환과 장애 조치), 통합(여러 제공업체의 모델을 한 목록으로 표시)
  • MCP 서버, Skills, 프롬프트는 한 번 추가하면 선택한 도구에 동기화됩니다
  • 모델은 포함되어 있지 않습니다. 직접 연결 모드에서는 요청이 추가한 제공업체로 가지만 라우팅 모드는 다른 제공업체로 보낼 수 있으며, 앱은 가격 데이터도 가져옵니다

📍 한 문장으로

CC Switch는 API 제공업체를 전환하고 Claude Code, Codex, Gemini CLI 같은 AI 코딩 도구의 MCP 서버, Skills, 프롬프트를 관리하는 무료 MIT 라이선스 데스크톱 앱입니다.

💬 쉽게 말하면

제공업체 프리셋을 고르고 키를 입력한 뒤 「Enable」을 누르면 도구가 해당 제공업체와 통신합니다. 선택형 로컬 라우팅은 내 컴퓨터에서 API 형식을 변환하므로, 특정 제공업체용으로 만든 도구에서도 다른 제공업체를 쓸 수 있습니다.

CC Switch(ccswitch.io, 소스 코드는 github.com/farion1231/cc-switch)는 Claude Code, Codex, Gemini CLI 같은 AI 코딩 도구의 API 제공업체, MCP 서버, Skills, 프롬프트를 관리하는 Windows·macOS·Linux용 무료 오픈소스 데스크톱 앱입니다. 이 리뷰는 기능, 설치 방법, 라이선스, 프라이버시와 관련된 프로젝트의 설명, 디렉터리에서 다른 라우터·게이트웨이와 비교한 위치를 다룹니다. PromptQuorum은 이 앱을 직접 사용해 테스트하지 않았으며, 모든 서술은 공식 사이트, GitHub 저장소와 최신 릴리스를 근거로 2026년 11월 19일에 확인한 내용입니다.

CC Switch 리뷰: AI 코딩 도구용 제공업체 관리 앱

CC Switch란 무엇입니까?

GitHub README는 CC Switch를 AI 코딩 도구용 「All-in-One Manager」라고 부르며, JSON·TOML·YAML 설정 파일을 직접 편집하지 않고 한 번의 클릭으로 제공업체를 전환할 수 있다고 설명합니다. 별도로 설치한 도구의 설정을 편집하고, 선택에 따라 프록시 역할도 하는 데스크톱 애플리케이션입니다.

  • 현재 버전 계열: 프로젝트는 버전 4이며 최신 GitHub 릴리스는 v4.0.35입니다. 최근 릴리스 세 개가 연이은 날짜에 공개되었습니다
  • 문서: 제공업체, 라우팅, MCP, Skills, 세션에 관한 가이드는 공식 문서에 있습니다
  • 작성자: LICENSE에는 Jason Young이 명시되어 있으며, 저장소 파일과 사이트 어디에도 회사 이름은 나오지 않습니다
  • 아닌 것: AI 모델도, 호스팅형 API도, 팀용 게이트웨이도 아닙니다

CC Switch가 할 수 있는 것

README에 따르면 기능은 제공업체, 라우팅, 공유 리소스, 사용량, 세션, 동기화를 아우릅니다.

  • 제공업체 — AWS Bedrock, NVIDIA NIM, 커뮤니티 릴레이를 포함한 90개 이상의 프리셋 또는 사용자 지정 설정. Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build는 시스템 트레이에서 전환할 수 있습니다
  • 라우팅 — Anthropic Messages, OpenAI Chat Completions, OpenAI Responses, Gemini Native 형식 사이를 변환하여 Claude Code에서 GPT를, Codex에서 Claude를 사용할 수 있습니다. 요청이 실패하면 서킷 브레이커가 있는 장애 조치 큐가 다음 제공업체로 넘어갑니다
  • 통합 — Claude Code와 Codex에서 여러 제공업체의 모델을 한 목록에 표시하고, 각 요청은 선택한 모델의 제공업체로 전달됩니다. README에 따르면 이 모드에는 장애 조치가 없습니다
  • 공유 리소스 — 선택한 도구에 동기화되는 MCP 서버, skills.sh나 GitHub에서 설치하는 Skills, 도구별 프롬프트 파일(CLAUDE.md, AGENTS.md, GEMINI.md), 전체 구성을 한 번에 전환하는 저장된 프로젝트
  • 사용량과 세션 — 라우팅을 쓰지 않아도 로컬 세션 로그에서 토큰, 비용, 캐시 적중 통계를 읽고, 제공업체 카드에 남은 할당량을 표시하며, 검색과 Markdown 내보내기를 갖춘 세션 기록 보기 화면을 제공합니다
  • 동기화와 링크 — 선택형 WebDAV 또는 S3 동기화, 제공업체를 가져오는 ccswitch:// 딥링크, 8개 언어 인터페이스

CC Switch 받기

가장 쉬운 방법은 GitHub Releases 페이지에서 내 운영체제용 설치 파일을 받거나 macOS에서 Homebrew를 사용하는 것입니다. 공식 사이트도 같은 릴리스로 연결됩니다.

옵션
받는 방법
Windows(가장 쉬움)Releases의 CC-Switch-v4.0.35-Windows.msi 또는 포터블 ZIP
macOSReleases의 .dmg 또는 brew install --cask cc-switch
Linux.deb, .rpm, .AppImage(x86_64 및 ARM64). Arch: paru -S cc-switch-bin
웹사이트ccswitch.io
문서ccswitch.io/en/docs
소스 코드(GitHub)farion1231/cc-switch

현재 버전은 4.0.35이며 2026년 11월 18일에 릴리스되었고, 마지막 업스트림 업데이트는 2026년 11월 19일의 최신 커밋입니다(GitHub, 2026년 11월 19일 확인). README는 Windows 10 이상, macOS 12 이상, glibc 2.35+와 WebKitGTK 4.1을 갖춘 Linux를 요구합니다(RHEL, Rocky, Alma 8–9는 아직 지원되지 않음). macOS 빌드는 코드 서명과 공증이 되어 있다고 밝히지만 PromptQuorum은 이를 확인하지 않았습니다. 설치 파일은 실행하지 않았습니다.

설치와 첫 단계

이 단계는 README의 Quick Start를 따르며 2026년 11월 19일에 확인했습니다. PromptQuorum은 이 단계를 직접 실행하지 않았습니다.

  1. 1
    앱 설치하기
    Why it matters: 내 운영체제용 설치 파일을 실행하거나 macOS에서는 `brew install --cask cc-switch`를 실행합니다.
  2. 2
    기존 설정 가져오게 하기
    Why it matters: README에 따르면 처음 실행할 때 CC Switch는 기존 Claude Code, Codex, Gemini CLI, Grok Build 설정을 `default`라는 제공업체로 가져오고 각 도구에 공식 제공업체를 추가합니다.
  3. 3
    제공업체 추가하기
    Why it matters: 사이드바에서 도구를 선택하고 「+」를 눌러 프리셋 또는 사용자 지정 설정을 고른 뒤 키를 입력합니다.
  4. 4
    전환 후 재시작하기
    Why it matters: 제공업체에서 「Enable」을 누릅니다. Claude Code는 재시작이 필요 없지만 Codex, Gemini CLI, Grok Build는 새 터미널이나 CLI 세션이 필요합니다.

가격, 라이선스, 프라이버시

CC Switch는 무료 오픈소스입니다. README와 공식 사이트에 유료 요금제는 나와 있지 않으며, 사용 요금은 추가한 제공업체가 청구합니다.

  • 라이선스: 저장소에 따르면 MIT이며 저작권 표기는 2025 Jason Young입니다
  • 데이터 흐름: SECURITY.md는 CC Switch를 프로젝트가 운영하는 클라우드 백엔드가 없는 로컬 데스크톱 애플리케이션이라고 설명합니다. 라우팅한 요청은 선택한 제공업체나 릴레이로 전달되며 그쪽에서 내용을 볼 수 있습니다
  • 로컬 프록시: 같은 파일에 따르면 수신 주소와 포트는 설정할 수 있고 루프백이 아닌 인터페이스에 바인딩될 수 있으므로, 외부에 열기 전에 이 설정을 확인해야 합니다
  • 원격 데이터: SECURITY.md에 따르면 앱은 모델 가격 JSON과 제공업체 아바타를 가져옵니다(해당 파일에서 v3.18.0 기준으로 확인)
  • 동기화: WebDAV 또는 S3 동기화는 선택 사항이며 README에 따르면 사용자가 고른 저장소에 기록합니다
  • 구독: README는 ChatGPT, Copilot, Grok 구독을 공식 클라이언트 밖에서 사용하면 공급업체의 이용 약관을 위반할 수 있다고 경고하며 위험은 직접 판단하라고 안내합니다
  • 스폰서: README에는 제3자 릴레이 서비스의 배너와 할인 코드가 실려 있습니다. PromptQuorum은 그중 어느 것도 평가하지 않았습니다

CC Switch는 누구에게 적합합니까?

CC Switch는 이미 AI 코딩 CLI를 사용하고 있으며 자신의 API 키를 추가할 수 있는 개발자에게 맞습니다.

다음과 같다면 CC Switch를 사용하세요

  • 여러 AI 코딩 도구나 API 제공업체를 오가며 설정 파일을 직접 편집하고 있다
  • Claude Code에서 GPT를, Codex에서 Claude를 쓰거나 제공업체 간 자동 장애 조치를 원한다
  • MCP 서버와 Skills를 한곳에서 관리하고 싶다

다음과 같다면 다른 대안을 찾으세요

  • 개인정보 처리방침을 공개한 회사를 데이터 처리자로 두어야 한다
  • 팀이 함께 쓰는 게이트웨이 서버가 필요하다(SECURITY.md에는 다중 사용자 모델이 설명되어 있지 않습니다)
  • README가 지원하지 않는다고 밝힌 RHEL, Rocky, Alma 8–9를 사용한다

CC Switch와 다른 라우터·게이트웨이 비교

CC Switch는 한 대의 컴퓨터에서 코딩 도구의 설정을 관리하지만, 아래 도구들은 게이트웨이 서버입니다. 전체 카탈로그는 로컬 AI 디렉터리를 참고하세요.

  • LiteLLM — 100개 이상의 제공업체 API를 라우팅과 비용 추적과 함께 묶는 OpenAI 호환 단일 게이트웨이로, 애플리케이션이나 팀을 위해 직접 운영하는 서버입니다. LiteLLM 리뷰를 참고하세요.
  • ClawRouter — 어떤 모델을 호출할지 로컬에서 결정하는 자율 에이전트용 셀프호스팅 라우터로, 저희 리뷰에서는 GUI 데스크톱 앱이 아니라 로컬 Node.js 프록시와 CLI로 설명합니다. ClawRouter 리뷰를 참고하세요.
  • AIClient2API — Gemini CLI, Codex, Grok, Kiro, Antigravity의 클라이언트 프로토콜을 하나의 OpenAI 호환 API로 변환하는 셀프호스팅 프록시입니다. 구독을 이 방식으로 사용하기 전에 「가격, 라이선스, 프라이버시」의 제공업체 약관 경고를 확인하시기 바랍니다. AIClient2API 리뷰를 참고하세요.

디렉터리에서 비교

자주 묻는 질문

CC Switch에 AI 모델이 포함되어 있습니까?

아니요. 다른 도구의 설정을 편집하고 중계할 뿐이며, 모델과 과금은 공식 API, AWS Bedrock 같은 클라우드 플랫폼, 릴레이 등 추가한 제공업체에서 제공됩니다.

제공업체를 전환하면 플러그인과 훅이 덮어써집니까?

README에 따르면 엔드포인트, 키, 모델 이름, 프로토콜 같은 핵심 항목만 교체되고 플러그인, 훅, 권한, MCP, 주석은 유지됩니다. 처음 다시 쓰기 전에 각 설정 파일을 ~/.cc-switch/backups/live-first-write/에 백업하기도 합니다.

통합한 모델이 Codex에 보이지 않는 이유는 무엇입니까?

Codex는 시작할 때만 모델 목록을 읽으므로 통합 설정을 바꾼 뒤에는 Codex를 완전히 재시작해야 합니다. README에 따르면 하나의 백그라운드 데몬을 공유하므로 터미널을 닫는 것만으로는 충분하지 않습니다.

어느 웹사이트가 공식 사이트입니까?

README와 공식 llms.txt는 ccswitch.io를 유일한 공식 웹사이트로 명시하며, 같은 이름을 쓰는 다른 도메인은 프로젝트와 무관하다고 밝힙니다.

출처

← 고급 로컬 LLM으로 돌아가기

MCP