# Claude Code + 다른 모델 제공자

Claude Code를 CLI로 유지하면서 하나의 실행 구성을 다른 Anthropic 호환 모델 제공자에 연결합니다.

## 제공자 정보 준비

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

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

## 1. 제공자 구성 추가

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

```json
{
  "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. 엔드포인트와 모델 매핑 확인

| 설정 | 역할 |
| --- | --- |
| `ANTHROPIC_BASE_URL` | Claude Code의 요청을 제공자의 Anthropic 호환 API로 라우팅합니다. |
| `ANTHROPIC_AUTH_TOKEN` | 제공자의 토큰을 제공합니다. |
| `ANTHROPIC_API_KEY: null` | 이 구성에서 상속된 Anthropic API 키를 제거합니다. |
| `model` | 이 항목의 시작 모델을 설정합니다. |
| `ANTHROPIC_DEFAULT_…_MODEL` | Opus, Sonnet, Haiku 요청을 제공자가 제공하는 ID에 매핑합니다. |

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

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

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

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

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

인증 오류나 모델 누락 오류는 [문제 해결](https://facadecode.com/ko/docs/troubleshooting/)을 참조하십시오.

## 예제: QwenCloud

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

[QwenCloud의 최신 엔드포인트 및 모델 설정 ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/claude-code)