터미널 하나에서 Claude Code를 돌리고, 옆 창에서 Codex를 실행하는 게 요즘 AI 개발자들의 일상이다. CLI 두 개, 설정 디렉터리 두 개, API Key 두 벌. Provider 하나 바꾸려면 파일을 손으로 고치거나 세션을 재시작해야 한다. cc-switch가 하려는 일은 단순하다. 이 모든 걸 GUI 창 하나에 모아두고 클릭 한 번으로 전환하는 것.
GitHub에서 스타 12.8만개를 기록하며, AI 개발자 도구 카테고리에서 상위권에 올라 있다.
해결하려는 문제
Claude Code, Codex, OpenCode 같은 CLI를 동시에 쓰면 설정이 ~/.claude/, ~/.codex/ 등 여기저기 흩어져 있다. API Key도 도구마다 따로 놀고, Provider를 바꾸려면 파일을 직접 수정하거나 세션을 재시작해야 한다. cc-switch는 이런 작업을 GUI 창 하나로 통합한다.
한국 개발자에게도 실제적인 문제다. Claude, GPT 등 해외 서비스는 중계 프록시를 거쳐야 하고, 공식 계정에 중계 계정, 서로 다른 요금제의 Key까지 직접 관리해야 한다. settings.json의 ANTHROPIC_BASE_URL을 매번 손으로 바꿔야 하는데, 한 달만 해도 질린다.
사용 방법
공식 사이트에서 설치 패키지를 받는다. macOS / Windows / Linux 모두 지원한다 (원본 링크 https://ccswitch.io는 원문에서 확인되지 않으므로 게시 전 확인 필요).
실행하면 왼쪽에 지원하는 CLI 목록이 표시된다 (레포지토리 README 기준):
- Claude Code
- Codex
- OpenCode
- 기타 (지속 추가 중)
Claude Code를 클릭하면 현재 적용된 Provider, API Key, Base URL이 보인다. 「Provider 추가」를 눌러 이름, Key, Base URL을 입력하고 저장한다. 다음에 Claude Code CLI를 실행하면 새 설정이 바로 반영되며, ~/.claude/settings.json을 만질 필요가 없다.
전 과정이 코딩 없이 GUI로 끝난다.
동작 방식 (추측)
Rust로 만든 데스크톱 앱이고, 설치 패키지 용량(약 200MB)으로 보면 Tauri(프론트엔드 Webview + Rust 백엔드)로 짠 확률이 높다. Electron이면 최소 400MB부터 시작하기 때문이다. 아래 아키텍처는 유사 도구의 일반적인 설계에 기반한推测이며, 구체적 구현은 소스 코드를 직접 확인해야 한다.
핵심 설계 포인트:
- Adapter 추상화 계층: 각 CLI 도구마다 adapter가 하나씩 대응하며, 자신의 설정 디렉터리를 읽고 쓴다. ClaudeAdapter는
~/.claude/settings.json구조를 알고, CodexAdapter는~/.codex/config.toml스키마를 안다. - Provider 모델: 사용자가 만드는 「Provider」는 Key + Base URL + 모델명으로 구성된 설정 템플릿이다. 전환 = 템플릿을 대상 CLI의 설정 파일 포맷으로 렌더링.
- 핫 스위치: 설정을 바꾼 뒤 실행 중인 CLI 프로세스에 reload 시그널을 보낸다. 흔히 쓰는 방식은 SIGUSR1을 보내거나, 파일 변경 감지용 inotify 메커니즘을 활용하는 것이다.
의사 코드 예시 (추측):
// 의사 코드: Provider 전환의 핵심 흐름
fn switch_provider(cli: CliType, provider: Provider) -> Result<()> {
// 1. 현재 설정 백업
let config_path = cli.config_path(); // e.g. ~/.claude/settings.json
backup(config_path)?;
// 2. Provider 템플릿을 대상 CLI 설정으로 기록
let adapter = cli.adapter(); // ClaudeAdapter / CodexAdapter / ...
let target_config = adapter.render(provider)?;
fs::write(config_path, target_config)?;
// 3. 실행 중인 CLI 프로세스에 reload 알림
notify_process(cli.process_name(), Signal::Reload)?;
Ok(())
}
CLI마다 adapter 하나씩 두고, 스키마가 다른 설정을 Provider 객체로 추상화한 점 — 이것이 여러 CLI를 하나의 GUI에 담을 수 있는 핵심이다.
장점 / 단점
괜찮은 점:
- macOS / Windows / Linux 모두 지원하는 크로스 플랫폼
- Rust로 작성되어 실행이 빠르고 메모리 사용량이 낮음
- GUI 기반이라 진입장벽이 낮음, shell을 모르는 사람도 사용 가능
- 여러 주요 AI CLI를 지원하며 계속 추가 중
- 레포지토리 farion1231/cc-switch가 활발히 유지보수되고 있음
아쉬운 점:
- dotfiles / shell alias에 익숙한 파워 유저에게는 GUI가 오히려 번거로움
- CLI의 설정 스키마가 바뀔 때마다 adapter를 유지보수해야 해서, CLI 업데이트가 빠르면 버그가 생기기 쉬움
- 데스크톱 바이너리가 오픈소스가 아니라 코드 로직을 볼 수 없으며, 보안 감사는 작성자를 믿어야 함
유사 도구와 비교:
vs aider의 --model 전환 — 커맨드라인에서 모델명만 바로 바꾸는 단순한 방식이지만, 모델 전환만 해결하지 Key / Base URL 전환은 해결하지 못한다.
vs 환경변수 전환용 shell function을 직접 작성 — 유연하되 본인이 직접 관리해야 하며, CLI 하나일 때나 적합하다. CLI와 Key가 여러 개로 늘어나면 금방 엉망이 된다.
cc-switch의 포지셔닝은 「다중 Key · 다중 계정 · 다중 CLI의 중앙 집중 관리」다. 커맨드라인보다 무겁지만, dotfiles를 손으로 관리하는 것보다는 훨씬 편하다.
이런 사람에게 추천
적합한 대상:
- 2개 이상의 AI CLI를 동시에 사용하는 개발자
- 여러 API Key / 중계 프록시를 관리해야 하는 사람
settings.json을 손으로 수정하는 게 귀찮은 사람- 팀원 중 커맨드라인이 익숙하지 않아 GUI가 필요한 사람이 있는 경우
비적합한 대상:
- Claude Code만 단독으로 사용하는 경우
- 순수 CLI파, shell alias만으로 충분한 사람
- 오픈소스가 아닌 바이너리가 불안한 사람 (커뮤니티에서 완전 오픈소스 대안을 기다릴 것)
- Key가 하나뿐이라 전환할 일이 없는 사람 — 대포로 모기 잡기
한마디
cc-switch 같은 도구의 존재는 하나의 사실을 보여준다. AI 코딩 도구는 아직 「설정 지옥」 단계에 있다는 것. CLI마다 설정 체계가 다르고, 스키마가 제각각이며, 전환 경험이 좋지 않다. 도구 수가 5~6개를 넘어서면 설정 관리 자체가 별개의 문제가 된다.
단기적으로 이런 「설정 집계기」는 수요가 있을 것이다. 장기적으로는 두 가지 길 중 하나다. CLI 도구들이 설정 포맷을 표준화하거나(예: ~/.config/ai/ 아래의 공통 규약), IDE / 에디터가 설정 계층을 흡수하거나(Cursor, Windsurf처럼). 어느 쪽이든 cc-switch 같은 중간 계층은 결국 대체될 수 있다.
다만 그것은 나중의 이야기고, 당장은 — Claude Code와 Codex를 동시에 돌리고 있다면 한 번 받아볼 만하다. 레포지토리는 farion1231/cc-switch, 다운받기 전에 README부터 확인할 것.