CC Switch - AI CLI 통합 관리 도구

CC Switch 튜토리얼 — 크로스플랫폼 AI CLI 관리 도구로, Claude Code, Codex, Gemini CLI의 Provider 설정, MCP 서버, 시스템 프롬프트를 통합 관리합니다. MoleAPI와 연동해 원클릭으로 입력할 수 있습니다.

🔀 CC Switch는 오픈소스 크로스플랫폼 AI CLI 통합 관리 도구로, Claude Code, Codex, Gemini CLI의 Provider 설정 원클릭 전환, MCP 서버 통합 관리, 시스템 프롬프트(Prompts) 관리 및 Skills 확장 관리 기능을 지원하며, 여러 AI 코딩 어시스턴트 사이를 자유롭게 전환할 수 있게 해주므로 설정 파일을 직접 수정할 필요가 없습니다.

GitHub 저장소: https://github.com/farion1231/cc-switch
다운로드 주소: GitHub Releases

핵심 기능

🔌 Provider 관리

원클릭 전환 — Claude Code, Codex, Gemini의 API 설정 간을 원클릭으로 전환할 수 있으며, 환경 변수나 설정 파일을 수동으로 수정할 필요가 없습니다
다중 엔드포인트 지원 — 각 Provider에 여러 엔드포인트를 설정할 수 있으며, API Key 관리 및 지연 시간 측정을 지원합니다
4단계 모델 설정 — Haiku / Sonnet / Opus / Custom의 4단계 모델 세분화 설정을 지원합니다

🛠️ MCP 서버 관리

애플리케이션 간 통합 관리 — 단일 패널에서 Claude / Codex / Gemini 3개 애플리케이션의 MCP 서버를 관리합니다
세 가지 전송 유형 — stdio, HTTP, SSE(Server-Sent Events)를 지원합니다
자동 동기화 — 통합 가져오기/내보내기 + 양방향 동기화

💬 Prompts 관리

다중 프리셋 시스템 프롬프트 — 무제한 프리셋, 빠른 전환
애플리케이션 간 지원 — Claude(CLAUDE.md), Codex(AGENTS.md), Gemini(GEMINI.md)
Markdown 편집기 — CodeMirror 6 + 실시간 미리보기

🌐 멀티플랫폼 지원

데스크톱 애플리케이션 — Windows, macOS, Linux 네이티브 설치 패키지
Web 버전 — 헤드리스 서버 / SSH 원격 환경에 적합한 브라우저 접속 방식
CLI 버전 — 명령줄 대화형 모드와 명령 모드를 모두 지원

MoleAPI 연동 방법

CC Switch는 ccswitch:// Deep Link 프로토콜을 지원하며, MoleAPI Token 관리 페이지에서 Provider 설정을 원클릭으로 가져올 수 있습니다.

설정 단계

MoleAPI Token 관리 페이지에서 해당 Token의 드롭다운 메뉴를 클릭합니다 메뉴에서 CC Switch 옵션을 선택하면 시스템이 자동으로 CC Switch 애플리케이션을 실행하고 설정 팝업을 표시합니다.
팝업에서 설정을 완료합니다

팝업의 각 필드 설명:
- 애플리케이션: 상단에서 애플리케이션 유형 전환 — Claude / Codex / Gemini, 필요에 따라 대상 애플리케이션을 선택합니다
- 이름: 이 설정의 이름을 입력합니다(예: My Claude). 이후 CC Switch에서 식별하고 전환하기 편리합니다
- 주 모델(필수) — 기본으로 사용하는 메인 모델
- Haiku 모델 — 경량 고속 모델
- Sonnet 모델 — 균형형 모델
- Opus 모델 — 최고 성능 모델
모든 모델은 드롭다운 선택 방식이며, 선택하지 않은 경우 「모델을 선택해 주세요」가 표시됩니다.
설정 완료 **「CC Switch 열기」**를 클릭하면 설정이 CC Switch로 가져와져 바로 사용할 수 있습니다. **「취소」**를 클릭하면 이번 작업을 포기합니다.

설치 방법

macOS(Homebrew 권장)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

Releases에서 .msi 설치 패키지 또는 포터블 .zip을 다운로드합니다.

Linux

Releases에서 .deb 패키지 또는 .AppImage를 다운로드합니다.

ArchLinux 사용자:

paru -S cc-switch-bin

Web 버전(헤드리스 / SSH 서버)

wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-web

기본 포트는 17666이며, 브라우저에서 http://localhost:17666으로 접속합니다.