Claude Code + 다른 모델 제공자

제공자 정보 준비#

Claude Code를 설치한 다음 제공자의 Anthropic 호환 기본 URL, API 키, 모델 ID를 준비하십시오. OpenAI 호환 엔드포인트만으로는 Claude Code에서 작동하지 않습니다.

이 예제는 Claude · work라는 별도 항목을 만듭니다. 기존 Claude Code 항목의 설정은 그대로 유지됩니다.

1. 제공자 구성 추가#

이 구성을 facade.json에 추가하십시오(에이전트 설정 참조). 예제의 URL, 키, 모델 ID를 제공자에서 받은 값으로 바꿉니다:

{
  "clis": {
    "Claude · work": {
      "type": "claude",
      "model": "YOUR_MODEL_ID",
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.example.com/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_API_KEY": null,
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_SMALL_MODEL_ID"
      }
    }
  }
}

각 별칭에는 제공자가 지원하는 모델을 사용하십시오. Haiku 매핑은 비교적 작은 백그라운드 작업에 사용되며, 기본 모델과 다른 모델을 지정할 수 있습니다.

2. 엔드포인트와 모델 매핑 확인#

예제는 키를 facade.json에 저장합니다. 기존 환경 변수에서 읽으려면 "ANTHROPIC_AUTH_TOKEN": "${env:WORK_API_KEY}"를 사용하십시오. 편집기에는 에이전트를 시작하기 전에 해당 변수가 있어야 합니다.

이 변수는 이 항목으로 시작한 에이전트에만 적용됩니다. 전역 Claude Code 설정을 편집할 필요는 없습니다.

3. 이 구성으로 Claude Code 시작#

facade.json을 저장하고 New Agent를 선택한 뒤 Claude · work를 고릅니다. 프로젝트에서 짧은 작업을 맡기십시오.

제공자가 사용량을 보고한다면 요청이 올바른 계정에 표시되는지 확인합니다. 에이전트가 시작되지 않거나 요청이 실패하면 Show Agent Launch를 실행하고 작업 위치를 선택하십시오. 보고서에서 이 항목을 찾으면 Facade가 해당 항목을 어떻게 시작할지 확인할 수 있습니다.

인증 오류나 모델 누락 오류는 문제 해결을 참조하십시오.

예제: QwenCloud#

QwenCloud Token Plan 키를 사용한다면 기본 URL로 https://token-plan.maas.qwencloudapi.com/apps/anthropic을 사용하십시오. 요금제에서 사용할 수 있는 모델 ID를 선택합니다. 종량제 키는 지역별 엔드포인트를 사용합니다.

QwenCloud의 최신 엔드포인트 및 모델 설정 ↗