Skip to main content

​
개요

CC Switch는 Tauri 2로 구축된 데스크톱 애플리케이션으로, Claude Code, Codex CLI, Gemini CLI, OpenCode, OpenClaw라는 다섯 가지 AI CLI 도구의 관리를 통합합니다. 더 이상 설정 파일을 수동으로 편집할 필요 없이, 그래픽 인터페이스에서 API 제공자, 모델, 키를 전환할 수 있습니다. APIYI를 제공자로 설정하면 다음과 같은 이점을 얻을 수 있습니다:

🚀 원클릭 전환

모든 CLI 도구 설정을 GUI로 관리하여 더 이상 수동 편집이 필요하지 않습니다

💰 88% 할인

ClaudeCode 그룹으로 token을 생성하면 88% 요율이 적용됩니다

📊 사용량 추적

실시간 지출, 요청, token 추적을 위한 내장 사용량 대시보드

🔄 스마트 장애 조치

핫 전환, 자동 장애 조치, 서킷 브레이커가 있는 로컬 프록시
프로젝트 정보
  • 🔗 저장소: github.com/farion1231/cc-switch
  • 📜 라이선스: MIT
  • 👤 작성자: Jason Young (farion1231)
  • 🏷️ 최신 버전: v3.12.0

​
핵심 기능

​
제공자 관리

  • AWS Bedrock 및 NVIDIA NIM을 포함한 50개 이상의 내장 사전 설정
  • 원클릭 전환, 드래그 앤 드롭 정렬, 가져오기/내보내기
  • 시스템 트레이 빠른 접근

​
MCP 서버 관리

  • 모든 CLI 도구에서 통합된 MCP 서버 설정
  • 양방향 동기화 — 변경 사항이 모든 애플리케이션에 전파됩니다

​
추가 기능

  • 프롬프트 관리: Markdown 편집기 + 앱 간 동기화
  • 스킬 설치: GitHub 저장소 또는 ZIP 파일에서 스킬 설치
  • 세션 브라우저: 대화 기록 보기 및 복원
  • 클라우드 동기화: Dropbox, OneDrive, iCloud, WebDAV 지원
  • 딥 링크: 원클릭 설정 가져오기를 위한 ccswitch:// 프로토콜

​
빠른 시작

​
1단계: CC Switch 설치

Homebrew로 설치합니다:
또는 GitHub Releases에서 DMG 설치 프로그램을 다운로드합니다.
시스템 요구 사항: Windows 10+, macOS 10.15 (Catalina)+, Ubuntu 22.04+ / Debian 11+ / Fedora 34+

​
2단계: APIYI API Key 받기

  1. APIYI 콘솔 - 토큰 페이지를 방문합니다.
  2. 클릭하여 새 token을 생성합니다.
  3. 중요: 【ClaudeCode】그룹을 선택하여 88% 할인을 받습니다.
  4. 생성된 키를 복사합니다(sk-로 시작합니다).
비용 절감: token을 생성할 때【ClaudeCode】그룹을 선택하여 88% 할인된 가격을 적용받으십시오.

​
3단계: CC Switch에서 APIYI 구성하기

  1. CC Switch를 엽니다.
  2. Provider 관리 페이지로 이동하여 추가를 클릭하고 “사용자 지정 게이트웨이”를 선택합니다:
CC Switch Provider 설정 - APIYI를 통합 공급자로 추가
  1. 위에 표시된 대로 다음 정보를 입력합니다:
    • 이름: APIYI
    • API 주소: https://api.apiyi.com
    • API Key: 이전 단계에서 복사한 키를 붙여넣습니다.
    • 활성화된 앱: Claude Code를 활성화합니다(필요에 따라 다른 앱도 활성화합니다).
  2. “Add”를 클릭하여 구성을 저장합니다.

​
4단계: 모델 추가

Provider 구성에 다음 모델을 추가합니다: 표준 모델: 추론 모델(강제 chain-of-thought):
모델 선택 팁: 일상적인 코딩에는 claude-sonnet-4-6를, 복잡한 아키텍처 설계에는 claude-opus-4-6를, 빠른 질의응답에는 claude-haiku-4-5-20251001를 사용합니다. 깊은 추론이 필요할 때는 thinking 변형을 사용합니다.

​
5단계: 원클릭 전환

구성이 끝나면 CC Switch에서 APIYI를 활성 Provider로 선택합니다. 연결된 모든 CLI 도구(Claude Code, Codex CLI 등)는 자동으로 APIYI 구성으로 전환됩니다.

​
사용 가이드

​
여러 CLI 도구 관리

CC Switch는 다음 5개의 AI CLI 도구를 동시에 관리할 수 있도록 지원합니다.
  • Claude Code — Anthropic의 공식 CLI 프로그래밍 어시스턴트
  • Codex CLI — OpenAI의 명령줄 프로그래밍 도구
  • Gemini CLI — Google의 명령줄 AI 어시스턴트
  • OpenCode — 오픈소스 CLI 프로그래밍 도구
  • OpenClaw — 오픈소스 로컬 AI 에이전트
모든 도구는 Provider 설정을 공유하므로 한 번 전환하면 어디서나 적용됩니다.

​
로컬 프록시

CC Switch에는 다음 기능을 갖춘 내장 로컬 프록시 서버가 포함되어 있습니다.
  • Hot-switching: 다시 시작하지 않고 Provider를 전환합니다
  • Auto-failover: 현재 Provider가 중단되면 자동으로 백업으로 전환합니다
  • Circuit breaker: 지속적인 실패 시 요청을 중단하여 리소스 낭비를 방지합니다

​
구성 백업

  • 자동 백업 시스템은 가장 최근 10개 버전을 보관합니다
  • 전체 구성을 가져오기/내보내기 할 수 있습니다
  • Dropbox, OneDrive, iCloud, WebDAV를 통한 클라우드 동기화

​
모델 추천

더 많은 프로그래밍 모델 추천 보기

Claude 시리즈 외에도 APIYI는 400개 이상의 주류 AI 모델을 지원합니다. 프로그래밍 모델에 대한 완전한 추천, 성능 비교, 그리고 사용 시나리오별 제안을 확인해 보시기 바랍니다.

​
자주 묻는 질문

Windows 10+, macOS 10.15 (Catalina)+, 그리고 주요 Linux 배포판(Ubuntu 22.04+, Debian 11+, Fedora 34+, Arch Linux)입니다.
일부 그룹(예: ClaudeCode 그룹)은 APIYI 콘솔에서 token을 생성할 때 할인 요금을 제공합니다. 현재 요율은 콘솔에서 확인하십시오. 여기에 충전 보너스를 더하면 실질 비용을 더 낮출 수 있습니다.
다음을 확인하십시오:
  1. API Key가 올바른지 확인하십시오(sk-로 시작해야 합니다).
  2. Base URL이 https://api.apiyi.com로 설정되어 있는지 확인하십시오.
  3. APIYI 계정 잔액이 충분한지 확인하십시오.
  4. CC Switch가 설정을 Claude Code에 동기화했는지 확인하십시오.
Thinking(reasoning) 모델은 체인 오브 쏘트 모드를 강제하여, 응답하기 전에 심층 추론 분석을 수행합니다. 복잡한 논리, 아키텍처 설계, 심층 사고 시나리오에 적합합니다. 표준 모델은 더 빠르게 응답하며 일상적인 코딩과 간단한 작업에 적합합니다.
CC Switch는 가져오기 기능을 지원하며 기존 환경 변수와 설정 파일을 자동으로 감지할 수 있습니다. 설치 후 앱을 열면 설치된 CLI 도구와 기존 설정을 자동으로 감지합니다.
CC Switch 자체는 완전히 무료이며 오픈소스(MIT License)입니다. 비용이 발생하는 것은 API 호출뿐입니다. APIYI의 ClaudeCode 그룹을 사용하면 88% 할인된 요금이 적용됩니다.

​
모범 사례

효율적인 사용을 위한 팁:
  1. 올바른 그룹으로 token을 생성합니다: 항상 88% 할인 혜택을 받는【ClaudeCode】그룹을 선택합니다
  2. 핫 스위칭을 활용합니다: 작업 간에 provider와 모델을 빠르게 전환합니다
  3. 자동 페일오버를 활성화합니다: 서비스 연속성을 위해 여러 provider를 백업으로 구성합니다
  4. 정기 백업: cloud sync를 사용하여 구성 정보를 정기적으로 백업합니다

​
관련 리소스

Claude Code 설정

자세한 Claude Code 설정 튜토리얼

모델 추천

최신 AI 모델 추천

APIYI 콘솔

API 키를 관리하고 사용량을 확인합니다

기타 프로그래밍 도구

Cursor 같은 다른 도구를 살펴보세요