수록 현황:307 건의 뉴스/102 개의 AI 도구/391 개의 오픈소스 프로젝트/73 개의 학습 자료
홈뉴스오픈소스모델AI 도구학습 자료
홈 / 오픈소스 / cc-switch

cc-switch

Claude Code, Codex 등 8가지 AI 코딩 도구의 프로바이더, MCP, 프롬프트, 스킬 구성을 통합 관리하는 크로스 플랫폼 데스크톱 앱입니다.

RustMITApplication
⭐ GitHubhttps://github.com/farion1231/cc-switch
126,499
스타 수
+0
스타 증가율
2026년 8월 11일
최근 업데이트
1
클릭 수

1. 프로젝트 개요

CC Switch는 Claude Code, Claude Desktop, Codex 등 8가지 인기 AI 코딩 도구의 프로바이더, MCP, 프롬프트, 스킬 구성을 통합 관리하는 크로스 플랫폼 데스크톱 애플리케이션입니다. 흩어져 있는 설정 파일을 수동으로 수정하는 번거롭고 오류가 잦은 작업을 하나의 시각적 인터페이스로 대체합니다.

2. 배경 및 포지셔닝

Claude Code, Codex, Gemini CLI 같은 AI 코딩 어시스턴트는 각자 고유한 설정 파일과 형식으로 API 키, 모델 엔드포인트, 프로바이더 설정을 저장합니다. 여러 도구를 병행해서 사용하거나 비용, 지연 시간, 가용성 등의 이유로 여러 API 프로바이더를 전환하는 개발자는 프로바이더를 바꿀 때마다 JSON/TOML 파일을 직접 수정하고 터미널을 재시작해야 했습니다. CC Switch는 이러한 불편을 해소하기 위해 만들어졌습니다. 프로바이더 프리셋, MCP 서버, 프롬프트, 스킬을 SQLite 기반 저장소 하나에 중앙 집중화하고 각 도구에 맞는 형식으로 자동 변환하여 전달합니다.

환경 변수나 단일 설정 파일만 교체하는 단순한 셸 스크립트 기반 "프로파일 스위처"와 달리, CC Switch는 50개 이상의 내장 프로바이더 프리셋으로 8가지 도구를 동시에 지원하고, 시스템 트레이 빠른 전환이 가능한 네이티브 GUI를 제공하며, 자동 장애 조치와 회로 차단 기능이 있는 로컬 프록시 계층을 추가하고, 크로스 디바이스 동기화(Dropbox/OneDrive/iCloud/WebDAV)를 지원하여 개발자가 여러 기기에서도 동일한 프로바이더 설정을 사용할 수 있게 합니다.

3. 기능 분류

  • 🔌 프로바이더 관리 — "8개 지원 도구, 50개 이상의 프리셋"에 걸친 프리셋 제공, 가져오기, 드래그 앤 드롭 재정렬, Claude Code, Codex, Gemini CLI 등에서 원클릭 프로바이더 전환. 목적: 각 도구의 프로바이더 설정을 수동으로 편집할 필요를 없앱니다.
  • 🔄 통합 설정 동기화 — 저장된 하나의 설정을 Claude Code, Codex, Gemini CLI에 동시에 동기화할 수 있습니다. 목적: 여러 CLI 도구 간 일관성을 유지하고 설정 불일치를 방지합니다.
  • 🛡️ 프록시 및 장애 조치 — 요청 형식 변환, 자동 장애 조치, 회로 차단기, 프로바이더 상태 확인을 지원하는 로컬 프록시. 목적: 프로바이더 성능 저하 또는 중단 시에도 코딩 세션이 계속 실행되도록 유지합니다.
  • 🧩 MCP / 프롬프트 / 스킬 관리 — Model Context Protocol 서버, 프롬프트 라이브러리, 스킬을 위한 전용 패널, 크로스 애플리케이션 동기화 및 딥링크 가져오기 지원. 목적: 도구별로 관리하는 대신 한 번만 확장 기능을 관리합니다.
  • 🕘 세션 및 기록 탐색 — 지원되는 세션 소스에서 대화 기록을 탐색, 검색, 복원할 수 있습니다. 목적: 도구나 기기를 전환할 때 연속성을 유지합니다.
  • 📊 사용량 추적 — 지출, 토큰 소비, 요청 수에 대한 대시보드와 추세 차트 및 상세 로그. 목적: API 비용과 사용 패턴을 파악할 수 있게 합니다.
  • ☁️ 클라우드 동기화 — Dropbox, OneDrive, iCloud 또는 사용자 지정 WebDAV 서버를 통한 설정 동기화. 목적: 여러 기기에서 동일한 프로바이더/도구 설정을 유지합니다.

4. 주요 특징

  • 8가지 도구, 하나의 인터페이스 — Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes를 8개의 개별 설정 파일 대신 동일한 앱에서 모두 구성할 수 있습니다.
  • 시스템 트레이 빠른 전환 — 전체 창을 열지 않고 트레이 메뉴에서 프로바이더를 전환할 수 있으며, Claude Code는 재시작 없이 핫 스위칭을 지원합니다.
  • 장애 조치 지원 로컬 프록시 — 내장 프록시가 프로바이더 간 형식 변환을 수행하고, 프로바이더가 비정상 상태가 되면 회로 차단기 보호와 함께 자동으로 장애 조치합니다.
  • SQLite 단일 진실 공급원 — 프로바이더, MCP 설정, 프롬프트, 스킬이 하나의 데이터베이스(~/.cc-switch/cc-switch.db)에 원자적 쓰기와 뮤텍스로 보호되는 동시 접근으로 저장되어 설정 손상을 방지합니다.
  • 자동 백업 — 앱은 최근 10개의 데이터베이스 백업과 제거 전 최대 20개의 스킬 스냅샷을 유지하므로 설정 실수를 복구할 수 있습니다.
  • 네이티브, 코드 서명 빌드 — Tauri 2 + Rust로 작고 네이티브한 바이너리를 생성하며, macOS 빌드는 Apple의 코드 서명 및 공증을 거칩니다.

5. 역할별 사용 사례

  • 일반 개발자 — 두 개 이상의 AI 코딩 어시스턴트(예: Claude Code와 Codex 또는 Gemini CLI)를 사용하는 모든 사용자는 도구별로 설정 파일을 편집하는 대신 하나의 프로바이더 목록을 유지하고 즉시 전환할 수 있습니다.
  • DevOps / 인프라 중심 엔지니어 — 프록시의 장애 조치 및 회로 차단 기능은 프로바이더 중단이나 요청 속도 제한 시 AI 지원 워크플로우를 탄력적으로 유지하는 데 도움이 됩니다.
  • 여러 LLM 프로바이더를 평가하는 팀 — 50개 이상의 프리셋과 원클릭 전환으로 각 CLI 도구를 수동으로 재구성하지 않고도 비용, 지연 시간, 출력 품질 측면에서 프로바이더를 A/B 테스트하기 쉽습니다.
  • 여러 기기에서 작업하는 개발자 — 클라우드 동기화(Dropbox/OneDrive/iCloud/WebDAV)로 노트북과 데스크톱 간 프로바이더 및 MCP 설정을 일관되게 유지합니다.

6. 시작하기

필요한 것 찾기 — 앱 내 내장 프리셋과 기능 패널(프로바이더, MCP, 프롬프트, 스킬, 세션, 사용량)을 탐색하거나, 저장소 내 사용자 매뉴얼과 README에서 기능 세부 정보를 확인하세요.

설치 / 통합:

# macOS (Homebrew)
brew install --cask cc-switch

# Linux (Arch, AUR 헬퍼 사용)
paru -S cc-switch-bin

Windows 사용자 및 기타 Linux 배포판은 릴리스 페이지에서 MSI, 휴대용 ZIP, DEB, RPM 패키지를 다운로드할 수 있습니다.

기여:

pnpm install
pnpm dev              # 핫 리로드로 개발 모드 시작
pnpm typecheck        # TypeScript 검증
pnpm format:check     # 포맷 검사
pnpm test:unit        # 프론트엔드 단위 테스트
cargo fmt && cargo clippy && cargo test   # Rust 백엔드 검사

기능 제안은 먼저 GitHub 이슈로 논의하세요. 풀 리퀘스트는 제출 전에 타입 검사, 포맷, 단위 테스트를 통과해야 합니다.

7. 프로젝트 구조

cc-switch/
├── src/            # React + TypeScript 프론트엔드 (UI, 패널, 상태)
├── src-tauri/      # Rust + Tauri 백엔드 (IPC 명령, 프록시, SQLite 접근)
├── package.json    # 프론트엔드 의존성 및 pnpm 스크립트
└── README.md       # 기능 개요 및 설정 지침

프론트엔드(React 18, Vite, TailwindCSS, shadcn/ui)는 IPC를 통해 Rust/Tauri 백엔드와 통신하며, 백엔드는 ~/.cc-switch/cc-switch.db의 SQLite 데이터베이스를 소유하여 프로바이더, MCP 서버, 프롬프트, 스킬의 단일 진실 공급원 역할을 합니다.

8. 관련 생태계

CC Switch는 관리 대상인 AI 코딩 도구(Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes) 및 외부 도구 서버를 위한 Model Context Protocol(MCP) 생태계와 통합되어 함께 작동합니다. 네이티브 데스크톱 패키징을 위해 Tauri 프레임워크에 의존하고, 크로스 디바이스 동기화를 위해 클라우드 스토리지 제공업체(Dropbox, OneDrive, iCloud, WebDAV)에 의존합니다.

9. 라이선스

  • ✅ 상업적 또는 개인적으로 소프트웨어를 사용, 수정, 배포할 수 있습니다 (MIT 라이선스)
  • ✅ 자체 코드를 오픈소스로 공개하지 않고 독점 프로젝트에 포함할 수 있습니다
  • ❌ 소프트웨어 사용으로 인한 손해에 대해 저자에게 책임을 물을 수 없습니다
  • ℹ️ 소프트웨어의 사본 또는 상당 부분에 원본 저작권 고지 및 라이선스 텍스트를 유지해야 합니다

10. FAQ

Q: CC Switch는 어떤 AI 코딩 도구를 지원하나요?
A: Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes를 지원합니다.

Q: 프로바이더를 전환한 후 터미널을 재시작해야 하나요?
A: 대부분의 도구는 새 구성을 적용하려면 CLI를 재시작해야 하지만, Claude Code는 재시작 없이 핫 스위칭을 지원합니다.

Q: 구성 데이터는 어디에 저장되나요?
A: ~/.cc-switch/ 아래의 로컬 SQLite 데이터베이스와 JSON 설정 파일에 저장되며, 자동 백업 순환이 적용됩니다.

Q: 타사 프로바이더 대신 공식 Claude/Codex 로그인을 계속 사용할 수 있나요?
A: 네, "공식 로그인" 프리셋을 추가하면 도구의 기본 인증으로 돌아갈 수 있습니다.

Q: 패키지 관리자가 없는 Windows 또는 Linux 배포판에 CC Switch를 어떻게 설치하나요?
A: 릴리스 페이지에서 MSI, 휴대용 ZIP, DEB, RPM 또는 AppImage 빌드를 다운로드하세요.

11. 빠른 링크

12. 요약

CC Switch는 여러 AI 코딩 어시스턴트를 사용하는 개발자의 실질적인 문제를 해결합니다. 8가지 다른 도구의 설정 파일을 수동으로 편집하는 대신, 프로바이더, MCP 서버, 프롬프트, 스킬, 사용량 추적을 위한 하나의 네이티브 크로스 플랫폼 인터페이스를 제공하며, 탄력적인 로컬 프록시와 크로스 디바이스 동기화로 뒷받침합니다. AI 프로바이더를 정기적으로 전환하거나 두 개 이상의 코딩 어시스턴트를 사용하는 개발자와 팀에게 가장 유용하며, 작업하는 모든 곳에서 설정이 안정적이고 백업되며 일관되게 유지되도록 합니다.