CC-Switch 원클릭 설정 튜토리얼(초보자 권장)

초보자에게 가장 먼저 권장합니다!

CC-Switch는 완전 초보 사용자를 위해 설계된 원클릭 설정 도구입니다. 설정 파일을 직접 수정할 필요 없이 그래픽 인터페이스로 조작하며, 십여 초 만에 채널 전환이 완료됩니다.

설정 단계

1. CC-Switch 다운로드 및 설치

• Windows: CC-Switch GitHub Releases에서 .msi 설치 패키지를 다운로드하세요
• macOS(Homebrew):

brew tap farion1231/ccswitch
brew install --cask cc-switch

• Linux: Releases 페이지에서 .deb 패키지를 다운로드하여 설치하세요

다운로드 후 로컬에서 설치를 완료하세요.

2. 프로그램을 열고 설정할 CLI 선택

CC-Switch를 실행하고 메인 화면에서 설정할 도구(예: Claude Code, Codex 등)를 선택한 뒤, '공급자 추가'를 클릭하여 설정을 진행하세요.

3. 공급자 정보 입력

• 공급자 이름: NextHub를 입력하세요
• 요청 주소: Claude Code는 https://api.nexthub.cc, Codex는 https://api.nexthub.cc/v1를 입력하세요
• API 형식: 선택한 CLI 유형에 따라 설정하세요
• API Key: 콘솔에서 생성한 API 키를 입력하세요

요청 주소에 /v1을 붙여야 하나요?

Claude Code는 Anthropic 프로토콜을 사용하며 주소 뒤에 자동으로 /v1/messages를 붙이므로 루트 도메인만 입력하면 됩니다. Codex는 OpenAI Responses 프로토콜(/v1/responses)을 사용하므로 요청 주소에 /v1이 포함되어야 합니다.

입력이 완료되면 오른쪽 하단의 '추가' 버튼을 클릭하여 설정을 저장하세요.

4. 채널이 적용되었는지 확인

메인 화면으로 돌아가 현재 사용 중인 채널을 확인하고, 방금 설정한 NextHub 채널로 전환되었는지 확인하세요.

5. Claude Code 최초 설치 확인 건너뛰기(선택 사항)

메인 화면에서 '설정' 버튼을 클릭하여 일반 설정 페이지로 이동한 뒤, 'Claude Code 최초 설치 확인 건너뛰기'를 찾아 이 옵션이 켜져 있는지 확인하세요.

6. 터미널에서 실행하여 검증

터미널을 열고 claude 또는 codex를 실행하여 간단한 대화를 시도하고, 설정이 정상인지 확인하세요. 응답을 받으면 설정이 성공한 것입니다 🎉

claude

Claude Desktop도 설정할 수 있습니다

CC-Switch에는 Claude Desktop 패널이 내장되어 있어 Claude Code에 이미 등록된 공급자를 클릭 한 번으로 가져올 수 있습니다. 전환한 뒤에는 Claude Desktop을 완전히 재시작해야 합니다. 자세한 단계는 Claude Desktop 설정 튜토리얼을 참고하세요.

CC-Switch 주요 기능

클릭 한 번으로 API 설정 전환, 시각화된 설정 관리, MCP 서버 관리, 시스템 트레이 빠른 작업, 로컬 프록시 핫 스위칭 지원, 전자동 채널 페일오버.