CC Switch로 Claude Code와 Codex 설정 관리하기
CC Switch는 공식 계정, AI API 중계 서비스, 로컬 모델, 여러 AI 코딩 CLI를 오갈 때 유용합니다. 먼저 Base URL과 API 키가 수동 설정으로 동작하는지 확인한 뒤에 쓰세요.
설치와 다운로드
GitHub Releases에서 최신 Windows, macOS, Linux 빌드를 받습니다. macOS는 README에 Homebrew 설치도 안내되어 있습니다.
brew install --cask cc-switch프로바이더를 추가하거나 바꾼 뒤에는 터미널이나 대상 CLI를 다시 시작해, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw가 새 설정을 읽게 하세요. Linux에서는 .deb, .rpm, AppImage처럼 배포판에 맞는 릴리스 파일을 고르세요.
주요 기능
프로젝트 README는 CC Switch를 Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw용 크로스 플랫폼 데스크톱 관리 도구로 설명합니다.
핵심 기능은 프로바이더 관리, 원클릭 전환, 50개 이상 프로바이더 프리셋, 가져오기/내보내기, 시스템 트레이 빠른 전환, 일부 앱의 공통 프로바이더 동기화입니다.
MCP, 프롬프트, 스킬, 사용량과 비용 추적, 세션 탐색, 클라우드 동기화, 로컬 프록시 모드, 장애 조치, 자동 백업도 다룹니다.
중계 서비스 설정 전 확인
중계 서비스를 추가하기 전에, CC Switch 없이 대상 CLI에서 Base URL, API 키, 모델 이름이 동작하는지 확인하세요.
코딩 CLI 프로필을 바꾸기 전에, 서비스가 OpenAI 호환 채팅, Anthropic 호환 호출, 도구 고유 형식 중 무엇을 요구하는지 확인하세요.
전환이 반영되지 않으면 먼저 터미널이나 CLI를 다시 시작하세요. CC Switch README도 프로바이더를 바꾼 뒤에는 대부분의 도구를 다시 시작해야 한다고 적습니다.
이런 때 유용합니다
- Claude Code, Codex, Gemini CLI, OpenCode 같은 도구를 함께 씁니다.
- 공식 API, OpenAI 호환 AI API 중계 서비스, 로컬 모델 엔드포인트를 자주 바꿉니다.
- 서비스를 바꿀 때마다 셸 프로필, 설정 파일,
config.toml을 손으로 고치고 싶지 않습니다. - 이미 동작하는 설정을 확인했고, 이제 더 안전하게 전환하고 정리하고 싶습니다.
