ChatGPT/Claude 데스크톱
CC Switch는 Claude Code, Codex 및 Gemini 공급자 구성을 통합 관리하는 데 적합합니다. Claude Code는 https://ai2save.com를 사용하고, Codex / OpenAI Compatible는 https://ai2save.com/v1를 사용합니다. 이 튜토리얼은 "클라이언트 다운로드 → API Key 생성 → 구성 가져오기 → 테스트 및 활성화" 순서로 진행되며, 그림과 본문은 현재 사이트 서버에서 제공합니다.
1. 클라이언트 다운로드
- Codex 공식 클라이언트: https://developers.openai.com/codex/app
- Claude 공식 클라이언트: https://claude.com/download
- CC Switch 출시 페이지: https://github.com/farion1231/cc-switch/releases
Windows 일반 PC는 x64 설치 프로그램을 선택하고, ARM 아키텍처 장치는 arm64를 선택하세요. macOS는 칩에 맞는 DMG/ZIP을 선택합니다. 설치 후 CC Switch를 실행합니다.

2. 콘솔에서 API Key 생성
- 현재 사이트 콘솔에 로그인 후 오른쪽 상단 사용자 메뉴에서 "API 키"를 엽니다.
- "키 생성"을 클릭하고 식별하기 쉬운 이름을 입력합니다.
- 사용할 그룹 선택: Codex는 Codex 그룹, Claude Code는 Claude 그룹 선택.
- 생성 후 즉시 전체 Key 복사. 전체 Key는 일반적으로 한 번만 표시되므로 비밀번호 관리자에 저장하세요.

3. CC Switch로 원클릭 가져오기
- API 키 목록에서 방금 생성한 Key를 찾아 "CCS로 가져오기" 클릭.
- CC Switch 가져오기 확인 창에서 공급자, Base URL 및 기본 모델 확인.
- 가져오기 확인 후 공급자 목록으로 돌아가기.
- 해당 공급자의 "활성화"를 클릭하고, "테스트"를 클릭하여 요청 성공 여부 확인.

환경 변수를 수동으로 수정하고 싶지 않은 경우 먼저 "CCS로 가져오기"를 사용하세요. API Key와 엔드포인트 주소를 CC Switch에 바로 작성하므로 처음 구성할 때 적합합니다.

4. 수동 구성 참고
Claude Code
Base URL: https://ai2save.com
API Key: 사용자의 API Key
Codex / OpenAI Compatible
Base URL: https://ai2save.com/v1
API Key: 사용자의 API Key
Claude Code의 주소에는 일반적으로 /v1를 추가하지 마세요; Codex와 OpenAI Compatible 클라이언트에는 일반적으로 /v1가 필요합니다.
자주 묻는 질문
- 401 / invalid_api_key:
sk-로 시작하는 키를 다시 복사하고, 키가 속한 그룹이 클라이언트 프로토콜과 일치하는지 확인하세요. - 404 또는 연결 실패:Base URL를 확인하세요. Claude 주소에는
/v1를 추가하지 말고, Codex 주소에는/v1가 필요합니다. - model not exist:콘솔이나 CC Switch에서 현재 그룹에서 사용할 수 있는 실제 모델 ID를 다시 선택하세요.
- 활성화 후 효과 없음:Claude Code, Codex 또는 데스크톱 클라이언트를 완전히 종료한 후, CC Switch에서 활성화를 클릭하고 클라이언트를 다시 열세요.