CC-Switch Claude Code
이 가이드는 CC Switch에서 제공업체(Provider)를 추가하거나 선택한 후 Claude Code에 적용하는 방법만 설명합니다. Claude Code 설정을 직접 수정하는 튜토리얼이 아니므로, 설정 파일을 직접 수정하려면 Claude Code CLI 설정 가이드를 확인하세요.
공식 정보 다운로드 및 문서는 공식 사이트를 기준으로 합니다.
이 문서에서 설명하는 내용
CC Switch의 목적은 제공업체(Provider)를 중앙에서 통합 관리하고 타겟 도구에 설정을 동기화하도록 돕는 것입니다. Claude Code의 경우 Claude / Anthropic 프로토콜, Key, 모델명을 꼼꼼히 확인해야 합니다. 제공업체에서 Claude Code를 지원한다고 명시하지 않은 한 OpenAI 호환 주소를 Claude 주소로 직접 사용하지 마세요.
시작 전 확인 사항
| 확인 항목 | 확인 방법 | 이유 |
|---|---|---|
| Claude Code 실행 가능 여부 | 터미널 또는 클라이언트에서 Claude Code가 정상적으로 실행되는지 확인 | CC Switch는 설정 전환만 처리하며, Claude Code 설치는 처리하지 않음 |
| 제공업체의 Claude Code 지원 여부 | 관리자 페이지나 문서에서 Claude / Anthropic / Claude Code 관련 안내 확인 가능 | OpenAI 호환 인터페이스만 제공하는 업체는 Claude Code에서 사용할 수 없을 수 있음 |
| Key 및 모델명 사용 가능 여부 | 관리자 페이지에서 토큰, Key, 모델 목록 또는 지원 모델 안내 확인 가능 | 모델명을 잘못 입력하면 즉시 model not found 오류가 발생함 |
| 처음에는 하나의 타겟 도구만 변경 | 초기에는 Claude Code만 선택 | 문제 발생 시 원인이 되는 항목을 쉽게 파악할 수 있음 |
입력 필드 작성 방법
| 설정 항목 | 입력 방법 | 초보자 주의사항 |
|---|---|---|
| Provider Name | 알아보기 쉬운 이름 입력 | 예: '메인 제공업체 Claude', 단순 숫자만 입력하지 말 것 |
| Target Tool / Preset | Claude Code 또는 Claude 관련 프리셋 선택 | Codex, OpenAI, Gemini 등을 선택하지 말 것 |
| Base URL | 제공업체 관리자 페이지에서 제공하는 Claude / Anthropic 전용 API 주소 복사 | 모든 제공업체가 OpenAI와 동일한 Base URL을 사용하는 것은 아님 |
| API Key | 관리자 페이지에서 생성된 전체 Key 복사 | 토큰(Token), Key, 시크릿 키 등으로도 불림 |
| Model Name | 관리자 페이지에서 지원하는 Claude 모델명을 정확하게 복사 | 임의로 축약하거나 표시용 이름을 모델명 자리에 넣지 말 것 |
제공업체 관리자 페이지에서 프로토콜별 주소를 구분하는 경우, Claude Code는 Claude / Anthropic 그룹 주소를 사용해야 합니다. 관리자 페이지에서 'Claude Code에 OpenAI 호환 주소 사용'이라고 명시한 경우에만 해당 지침에 따라 입력하세요.
Claude Code에 적용하기
- CC Switch를 열고 Provider 관리 화면으로 이동합니다.
- 새 Provider를 추가하거나 이미 생성된 제공업체 설정을 선택합니다.
- 타겟 도구에서 Claude Code 관련 프리셋을 선택합니다.
- Provider 이름, Base URL, API Key, 모델명을 순서대로 입력합니다.
- 저장 후 Apply / Switch를 실행하여 현재 Provider를 Claude Code에 적용합니다.
- 터미널이나 타겟 도구를 재시작해야 한다는 안내가 표시되면 현재 Claude Code 세션을 종료한 후 다시 엽니다.
정상 작동 테스트
테스트 시에는 실제 프로젝트를 바로 열지 말고 아주 간단한 질문을 먼저 전송해 보세요. 정상적으로 응답이 반환되면 Key, Base URL, 모델명 및 타겟 도구 동기화가 정상적으로 작동함을 의미합니다.
Claude Code 최소 테스트
claude "Please reply only: CC-Switch Claude Code is active"테스트에 실패한 경우 다음 순서로 확인하세요: 타겟 도구가 잘못 선택되었는지, Base URL이 Claude / Anthropic 전용인지, Key가 온전하게 복사되었는지, 관리자 페이지에 표시된 모델명을 정확히 복사했는지 확인합니다.