ai2saveai2save

ChatGPT/Claude 데스크톱

CC Switch는 Claude Code, Codex 및 Gemini 공급자 구성을 통합 관리하는 데 적합합니다. Claude Code는 https://ai2save.com를 사용하고, Codex / OpenAI Compatible는 https://ai2save.com/v1를 사용합니다. 이 튜토리얼은 "클라이언트 다운로드 → API Key 생성 → 구성 가져오기 → 테스트 및 활성화" 순서로 진행되며, 그림과 본문은 현재 사이트 서버에서 제공합니다.

1. 클라이언트 다운로드

Windows 일반 PC는 x64 설치 프로그램을 선택하고, ARM 아키텍처 장치는 arm64를 선택하세요. macOS는 칩에 맞는 DMG/ZIP을 선택합니다. 설치 후 CC Switch를 실행합니다.

단계 스크린샷 01

2. 콘솔에서 API Key 생성

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

단계 스크린샷 02 단계 스크린샷 03 단계 스크린샷 04 단계 스크린샷 05 단계 스크린샷 06

3. CC Switch로 원클릭 가져오기

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

단계 스크린샷 07 단계 스크린샷 08 단계 스크린샷 09

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

단계 스크린샷 10 단계 스크린샷 11 단계 스크린샷 12

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에서 활성화를 클릭하고 클라이언트를 다시 열세요.