개발자 리소스

CC Switch

CC Switch를 설치하고, RunAPI Claude Code Provider를 추가하고, 모델을 선택하고, 연결을 확인합니다.

개요

CC Switch는 코딩 도구 Provider를 관리하는 데스크탑 애플리케이션입니다. 이 가이드는 셸 프로필이나 프로젝트 파일을 직접 편집하지 않고 Claude Code Provider를 RunAPI에 연결합니다.

Windows, macOS, 또는 Linux용 공식 릴리스에서 CC Switch를 다운로드하세요. macOS에서 Homebrew를 사용하는 경우 다음 명령으로 설치할 수 있습니다:

SHELL

brew install --cask cc-switch

설치 후 CC Switch를 열고 앱 전환기에서 Claude Code를 선택하십시오.

JSON

{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_BASE_URL": "https://runapi.ai"
  }
}

위의 API 키는 플레이스홀더입니다. 실제 키는 인증 가이드를 통해 생성하고 교체하세요.

모델 가져오기는 후보 탐색에만 사용하십시오. 모델이 목록에 없으면 모델 카탈로그에서 식별자를 복사하십시오. 가져오기를 수행해도 Claude Code 요청 역할에 모델이 할당되지는 않습니다.
선택한 식별자를 기본 폴백 모델로 설정한 후 빠른 설정을 선택합니다. 그러면 Sonnet, Opus, Fable, Haiku, Subagent의 모든 실제 요청 모델 행에 해당 식별자가 적용됩니다.
저장하기 전에 모든 행에 의도한 RunAPI 식별자가 표시되어 있는지 확인합니다. CC Switch는 이 매핑을 ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, CLAUDE_CODE_SUBAGENT_MODEL로 저장합니다.
제공자를 저장하고 제공자 목록에서 선택한 후 활성화합니다.

프로젝트 디렉터리에서 새 터미널을 열고 Claude Code를 시작하십시오:

SHELL

claude

활성 모델을 확인하려면 /status를 실행한 후 Describe this repository in one sentence.와 같은 짧은 프롬프트를 전송하세요. 정상적인 응답은 CC Switch가 활성 RunAPI 공급자를 사용하고 있음을 확인합니다.

인증 실패: 활성화된 CC Switch 공급자의 API 키를 확인한 후, 필요하면 인증 가이드에서 새 키를 생성하세요.
예상한 모델을 사용할 수 없음: 모델 선택기를 새로 고침하거나 Model Catalog에서 지원되는 모델 식별자를 복사한 후 기본 대체 모델로 설정하고 Quick Set을 다시 선택하세요.
Claude Code가 여전히 다른 공급자를 사용함: CC Switch에서 RunAPI 공급자를 활성화한 후 새 터미널 세션을 여세요. 환경 충돌 여부는 CC Switch의 공급자 문서를 확인하세요.

프로토콜 선택 및 요청 동작에 대해서는 LLM API 빠른 시작을 참조하세요. 요청 및 응답 필드에 대해서는 Anthropic Messages API 참조를 참조하세요. Claude Code에 RunAPI 도구를 추가하려면 MCP 개요를 계속하세요.