CC Switch
코딩 에이전트의 프로바이더 설정을 바꿔 끼우는 앱
brew install --cask cc-switchClaude Code 와 Codex CLI 의 프로바이더 설정을 통째로 바꿔 끼우는 데스크톱 앱입니다. 설정 파일을 직접 고치는 대신 목록에서 골라 전환하고, 계정과 키를 프로필로 나눠 둡니다. Rust 와 Tauri 로 만들었습니다.
판단
이럴 때 씁니다
- 여러 프로바이더 설정을 자주 오가며 써야 할 때
- 설정 파일을 손으로 고치다 실수한 적이 있을 때
- 계정이나 키를 프로필로 나눠 두고 필요할 때만 꺼내 쓰고 싶을 때
- 팀원에게 설정 전환 방법을 GUI 로 안내하고 싶을 때
이럴 땐 쓰지 마세요
- 프로바이더를 하나만 고정해 쓸 때
- 데스크톱 앱을 설치할 수 없는 서버 환경일 때
- 설정을 스크립트로 관리하는 흐름이 이미 잡혀 있을 때
차별점
- Claude Code 와 Codex CLI 설정을 GUI 에서 프로필 단위로 전환합니다.
- Rust 와 Tauri 로 만들어 앱 크기가 작습니다.
- 여러 계정을 프로필로 분리해 함께 둘 수 있습니다.
- 릴리스 주기가 짧아 대상 도구 변경에 빠르게 대응합니다.
워크플로
- 01Homebrew cask 나 릴리스 페이지에서 앱을 설치합니다.
- 02프로바이더별 설정을 프로필로 등록합니다.
- 03작업에 맞는 프로필을 골라 전환하면 설정 파일이 교체됩니다.
- 04전환 뒤에는 실제로 원하는 프로바이더로 붙었는지 한 번 확인합니다.
주요 명령
| 명령 | 설명 |
|---|---|
brew install --cask cc-switch | macOS 에서 설치합니다. |
함정
설치 전에 확인하세요
- 열려 있는 미해결 이슈가 이천 건을 넘습니다. 스타 대비 이슈가 많은 저장소이므로 사용 전 최근 이슈를 훑어보는 편이 좋습니다.
- Codex CLI 처럼 대상 도구가 설정 형식을 바꾸면 전환이 깨질 수 있습니다. 실제로 0.149 대응이 별도 릴리스로 나갔습니다.
- 설정 파일을 통째로 바꾸는 방식이라 앱이 비정상 종료하면 백업본이 남을 수 있습니다.
- README 와 릴리스 노트 상당 부분이 중국어입니다.
비교
셸 별칭이나 스크립트로도 설정 전환은 됩니다. 이 앱의 값어치는 어떤 프로필이 지금 적용돼 있는지 눈으로 확인하게 해 주는 데 있습니다. 반대로 설정을 코드로 관리하는 팀이라면 GUI 가 오히려 흐름을 끊습니다.
최근 변경
v3.20.1 은 Codex CLI 0.149 대응이 중심입니다. 0.149 부터 달라진 인증 처리 때문에 서드파티 프로바이더로 전환하면 인증 키 누락 오류가 나던 문제를 설정 파일 방식으로 바꿔 해결했습니다. 같은 팀 워크스페이스의 여러 계정이 함께 있을 때 충돌하던 문제와, 비정상 종료로 남은 백업 항목이 활성 설정을 덮던 문제도 고쳤습니다.