---
title: 호스팅 서비스와의 차이점
url: https://platform.claude.com/docs/ko/managed-agents/self-hosted/differences
description: 자체 호스팅 Claude Managed Agents에만 있는 기능, 자체 호스팅 Claude Managed Agents에 없는 호스팅 기능, 다르게 동작하는 기능, 그리고 먼저 서버 설정이 필요한 기능을 확인하세요.
---

<Note>
  자체 호스팅 Claude Managed Agents에 대한 접근 권한을 요청하려면 Anthropic 계정 팀에 문의하세요.
</Note>

자체 호스팅 Claude Managed Agents 서버는 이 페이지에 설명된 차이점을 제외하면 Anthropic의 호스팅 [Managed Agents](https://platform.claude.com/docs/ko/managed-agents/overview) 서비스와 동일한 API를 제공합니다. 표에는 각 차이점에 대해 어떻게 대응해야 하는지가 나와 있습니다. 애플리케이션을 서버로 옮기기 전에 표를 확인하세요. 세션 기록을 포함하여 호스팅 서비스에서 복사되는 것은 없습니다. 에이전트, 스킬, 볼트 자격 증명, 메모리 스토어를 사용자 서버에서 다시 생성하세요.

## 사용자 서버에만 있는 기능

| 기능         | 하는 일                                                                                                         | 설정 방법                                                                                                   |
| ---------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
| 추론 공급자 선택  | 서버는 모델 호출을 Claude API 대신 클라우드 공급자 또는 사용자의 자체 모델 게이트웨이로 보낼 수 있습니다.                                            | [추론 공급자](https://platform.claude.com/docs/ko/managed-agents/self-hosted/inference-provider)             |
| 싱글 사인온     | 사용자는 OpenID Connect ID 공급자에서 발급한 토큰으로 서버를 호출합니다. 서버는 토큰에 포함된 그룹을 기반으로 각 호출자에게 역할을 부여합니다. 서버 API 키는 계속 작동합니다. | [싱글 사인온](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configure#single-sign-on)       |
| 자체 시크릿 매니저 | 서버는 각 새 볼트 자격 증명의 시크릿을 자체 데이터베이스 대신 사용자의 시크릿 매니저에 저장할 수 있습니다.                                                | [시크릿 매니저](https://platform.claude.com/docs/ko/managed-agents/self-hosted/agent-identity#secret-manager) |
| 에이전트 신원    | 서버는 수명이 짧은 토큰에 서명하여 MCP 서버에 대한 에이전트의 호출과 함께 보낼 수 있습니다. MCP 서버 또는 게이트웨이는 사용자가 게시한 공개 키로 토큰을 검증합니다.            | [에이전트 신원](https://platform.claude.com/docs/ko/managed-agents/self-hosted/agent-identity#agent-identity) |

## 사용할 수 없는 기능

| 기능                                                                                                                                                   | 발생하는 일                                                                    | 대신 할 일                                                                                                                                                                                                    |
| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [클라우드 환경](https://platform.claude.com/docs/ko/managed-agents/environments)                                                                           | `self_hosted` 환경만 존재합니다. 클라우드 환경 요청은 `400` 오류를 반환합니다.                     | 모든 환경에 대해 [자체 호스팅 워커를 배포하세요](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes-workers).                                                                                           |
| [Messages API](https://platform.claude.com/docs/ko/build-with-claude/working-with-messages) 및 Models API 등 Claude API의 나머지 부분                        | 서버는 이를 제공하지 않습니다. SDK의 `/v1/messages` 및 `/v1/models` 호출은 `404` 오류를 반환합니다. | 사용자 서버를 가리키지 않는 클라이언트에서 해당 요청을 Claude API 또는 사용자의 공급자로 보내세요.                                                                                                                                              |
| [파일 세션 리소스](https://platform.claude.com/docs/ko/managed-agents/files) 및 Files API                                                                    | 서버는 `file` 리소스를 거부하며, `/v1/files`는 존재하지 않습니다. `memory_store` 리소스는 작동합니다.  | 파일을 워커의 작업 디렉터리에 넣으세요. [세션 안팎으로 데이터 이동하기](https://platform.claude.com/docs/ko/managed-agents/self-hosted/call-the-api#move-data-in-and-out-of-a-session)를 참조하세요. 모델에 이미지나 PDF를 보여주려면 메시지에 `base64`로 보내세요. |
| [`mcp_oauth` 볼트 자격 증명](https://platform.claude.com/docs/ko/managed-agents/vaults)                                                                    | 서버에는 토큰을 갱신할 OAuth 흐름이 없으므로, 생성 시 이를 거부합니다.                               | 토큰을 `static_bearer` 자격 증명으로 저장하세요. 기존 토큰이 만료되기 전에 새 토큰으로 자격 증명을 업데이트하세요.                                                                                                                                  |
| [사전 빌드된 `docx`, `pdf`, `pptx`, `xlsx` 스킬](https://platform.claude.com/docs/ko/managed-agents/skills)                                                 | 서버는 이를 선언한 에이전트를 거부합니다. 사용자가 업로드한 스킬만 존재합니다.                              | [스킬 저장소](https://github.com/anthropics/skills)에서 해당 소스를 다운로드하여 커스텀 스킬로 업로드하세요.                                                                                                                            |
| [예약된 배포](https://platform.claude.com/docs/ko/managed-agents/scheduled-deployments) 및 [드림](https://platform.claude.com/docs/ko/managed-agents/dreams) | 서버에 해당 라우트가 없습니다.                                                         | cron 작업과 같은 자체 스케줄러에서 세션을 시작하세요. 드림에는 대체 수단이 없습니다.                                                                                                                                                        |
| [웹훅](https://platform.claude.com/docs/ko/managed-agents/webhooks)                                                                                    | 서버는 webhook을 보내지 않으므로, webhook으로 시작되는 워커는 절대 시작되지 않습니다.                   | 세션의 [이벤트 스트림](https://platform.claude.com/docs/ko/managed-agents/events-and-streaming)을 통해 세션을 추적하거나, 이벤트 목록을 조회하세요. 워커가 폴링할 수 있도록 계속 실행해 두세요.                                                            |

## 다르게 동작하는 기능

| 기능                                                                                            | 차이점                                                                                                                                                                                                                                                                                                                 | 할 일                                                                                                                                                                                                                                                                                              |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Claude Console                                                                                | platform.claude.com에 있는 Claude Console에는 사용자 서버에 있는 내용이 표시되지 않습니다.                                                                                                                                                                                                                                                  | [사용자 서버의 콘솔](https://platform.claude.com/docs/ko/managed-agents/self-hosted/console)을 사용하세요.                                                                                                                                                                                                     |
| 도구 호출                                                                                         | 세션의 모델 턴은 해당 환경을 폴링하는 워커가 없어도 실행됩니다. 그러면 첫 번째 도구 호출은 워커가 이를 실행할 때까지 오류 없이 대기합니다.                                                                                                                                                                                                                                    | 세션이 도구 호출에서 멈추면 워커가 해당 환경을 폴링하고 있는지 확인하세요.                                                                                                                                                                                                                                                       |
| [메모리 스토어](https://platform.claude.com/docs/ko/managed-agents/memory)                          | API는 완전히 지원됩니다. 서버가 아닌 워커가 연결된 각 스토어를 샌드박스로 복사하고 변경 사항을 다시 씁니다. [자체 호스팅 샌드박스의 메모리 스토어](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes-memory)를 참조하세요.                                                                                                                                     | 쓰기 가능한 `/mnt/memory` 디렉터리와 함께 [`ant`의 최신 버전](https://platform.claude.com/docs/ko/cli-sdks-libraries/cli/quickstart#installation)으로 워커를 실행하세요.                                                                                                                                                    |
| [커스텀 스킬](https://platform.claude.com/docs/ko/managed-agents/skills#create-a-custom-skill) 업로드 | 서버는 zip 아카이브의 압축을 풀지 않습니다. zip 아카이브를 업로드하면 `SKILL.md not found in uploaded files`라는 `400` 오류가 반환됩니다.                                                                                                                                                                                                                | `ant apply` 및 Python SDK의 `files_from_dir` 헬퍼는 그대로 작동합니다. 그 밖의 경우에는 스킬의 파일을 개별 파트로 업로드하고, `my-skill/SKILL.md`처럼 각 파트의 파일 이름을 스킬 폴더로 시작하세요.                                                                                                                                                       |
| [멀티에이전트 오케스트레이션](https://platform.claude.com/docs/ko/managed-agents/multiagent-orchestration) | 에이전트는 사용자가 나열한 서브에이전트에만 위임할 수 있습니다. 동적 워크플로, 어드바이저, 에이전트가 직접 정의하는 서브에이전트는 사용할 수 없습니다. 서버는 `type`이 `coordinator`인 경우에만 `multiagent` (csharp, go: `Multiagent`) 블록을 수락합니다. 멀티에이전트 오케스트레이션의 예제는 `type`을 `multiagent_20261001`로 설정하며, 이는 `400` 오류를 반환합니다. `advisor` (csharp, go: `Advisor`) 설정이 있는 블록도 `400` 오류를 반환합니다. | `multiagent` (csharp, go: `Multiagent`)를 `{"type": "coordinator", "agents": [...]}`로 설정하세요. `agents` (csharp, go: `Agents`)에는 1\~20개의 에이전트를 나열하세요. 각 항목은 [사전 정의된 에이전트의 형식](https://platform.claude.com/docs/ko/managed-agents/multiagent-orchestration#predefined-and-inline-agents) 중 하나를 따릅니다. |
| [GitHub 저장소](https://platform.claude.com/docs/ko/managed-agents/github) 세션 리소스                | 서버는 설정에 해당 Git 호스트를 나열할 때까지 `github_repository` 리소스를 거부합니다. 서버는 저장소의 `.claude/skills` 디렉터리에서 스킬을 찾지 않으므로, 스킬을 에이전트에 연결하세요.                                                                                                                                                                                          | [Git 저장소에는 허용 목록 항목이 필요합니다](https://platform.claude.com/docs/ko/managed-agents/self-hosted/differences#git-repositories-need-an-allowlist-entry)를 참조하세요.                                                                                                                                         |
| [MCP 서버](https://platform.claude.com/docs/ko/managed-agents/mcp-connector)                    | 서버는 설정에 나열한 MCP 호스트에만 연결합니다.                                                                                                                                                                                                                                                                                        | [MCP 서버에는 허용 목록 항목이 필요합니다](https://platform.claude.com/docs/ko/managed-agents/self-hosted/differences#mcp-servers-need-an-allowlist-entry)를 참조하세요.                                                                                                                                               |
| [웹 도구](https://platform.claude.com/docs/ko/managed-agents/tools-web-restrictions)             | `web_search` 및 `web_fetch` 도구는 서버 설정에서 켤 때까지 꺼져 있습니다.                                                                                                                                                                                                                                                               | [웹 도구에는 서버 설정이 필요합니다](https://platform.claude.com/docs/ko/managed-agents/self-hosted/differences#web-tools-need-a-server-setting)를 참조하세요.                                                                                                                                                        |
| [`environment_variable` 볼트 자격 증명](https://platform.claude.com/docs/ko/managed-agents/vaults)  | 서버는 샌드박스와 인터넷 사이의 프록시인 이그레스 게이트웨이를 켤 때까지 이를 거부합니다.                                                                                                                                                                                                                                                                  | [환경 변수 자격 증명](https://platform.claude.com/docs/ko/managed-agents/self-hosted/agent-identity#environment-variable-credentials)을 참조하세요. 게이트웨이 없이 사용하려면 자체 도구를 통해 샌드박스에 필요한 CLI 및 API 자격 증명을 제공하세요.                                                                                                 |
| 커스텀 도구 결과                                                                                     | 서버는 커스텀 도구 결과의 전체 텍스트를 모델에 보냅니다. 결과가 모델의 “context window”(컨텍스트 윈도우)에 비해 너무 크더라도 서버는 여전히 `200`으로 응답하며, 이후 세션은 `session.error`와 함께 종료됩니다.                                                                                                                                                                             | 긴 결과는 보내기 전에 클라이언트에서 줄이세요.                                                                                                                                                                                                                                                                       |
| MCP 도구 결과                                                                                     | 서버는 `mcp.max_result_bytes` 설정(기본값 100 KiB)보다 큰 결과를 자릅니다. 서버는 결과가 잘렸다는 사실을 모델에 알리며, 나머지 부분은 손실됩니다. 호스팅 서비스도 긴 결과를 자르지만, 클라우드 샌드박스의 세션에 대해서는 [전체 결과를 파일로 저장](https://platform.claude.com/docs/ko/managed-agents/mcp-connector#mcp-tool-output-handling)할 수 있습니다.                                                      | 제한을 변경하려면 [설정 파일](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configuration-reference#where-settings-go)에서 `mcp.max_result_bytes`를 설정하세요.                                                                                                                                     |
| URL로 보낸 이미지 및 문서                                                                              | 서버는 `url` 소스를 가진 `image` 또는 `document` 블록을 수락하지만, 모델은 이를 전혀 보지 못하며 오류도 발생하지 않습니다. `file` 소스를 가진 `image` 블록에도 동일한 일이 발생합니다.                                                                                                                                                                                          | 데이터를 `base64`로 보내거나, 문서의 경우 `text`로 보내세요.                                                                                                                                                                                                                                                        |
| `rescheduling` 세션 상태                                                                          | 서버는 일시적인 이유로 실패한 모델 호출을 재시도하고, 호스팅 서비스와 마찬가지로 각 시도를 이벤트 스트림에 보고합니다. 시도 사이에 세션 상태는 `running`으로 유지되므로, `statuses[]=rescheduling` 필터는 어떤 세션과도 일치하지 않습니다.                                                                                                                                                               | 이벤트 스트림에서 재시도를 확인하세요.                                                                                                                                                                                                                                                                            |
| 모델 게이트웨이 사용 시 세션 메타데이터                                                                        | 서버의 `inference.credentials.assertion.forward_metadata` 설정에 세션 메타데이터 키가 나열되어 있으면, 해당 키 중 하나를 추가, 제거 또는 변경하는 업데이트는 `400` 오류를 반환합니다.                                                                                                                                                                                   | 세션을 생성할 때 해당 키를 설정하세요. 설정에 대해서는 [단기 게이트웨이 토큰](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configuration-reference#short-lived-gateway-tokens)을 참조하세요.                                                                                                                         |

## 서버 설정이 필요한 기능

이 기능들은 서버의 [설정 파일](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configuration-reference#where-settings-go)을 변경할 때까지 꺼져 있거나 모든 호스트를 거부합니다.

### MCP 서버에는 허용 목록 항목이 필요합니다

서버는 [설정 파일](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configuration-reference#where-settings-go)의 `mcp.allowed_hostnames` 아래에 호스트가 나열된 MCP 서버에만 연결합니다:

```yaml
mcp:
  allowed_hostnames:
    - mcp.example.com
```

호스트는 와일드카드나 하위 도메인 없이 정확히 일치해야 하며, 목록은 기본적으로 비어 있습니다. MCP 서버의 호스트가 목록에 추가될 때까지 사용자 서버는 해당 MCP 서버를 지정한 에이전트의 저장을 거부합니다.

사설 네트워크 내부의 MCP 서버에는 [MCP 터널](https://platform.claude.com/docs/ko/agents-and-tools/mcp-tunnels/overview)이 필요하지 않습니다. [MCP 커넥터](https://platform.claude.com/docs/ko/managed-agents/mcp-connector)에 설명된 대로 에이전트 정의에 해당 URL을 넣고 허용 목록에 호스트를 추가하세요. URL에는 두 가지 규칙이 적용됩니다:

* MCP 서버가 루프백 주소에 있지 않은 한 `https`를 사용해야 합니다.
* 호스트가 사설 주소 또는 예약된 주소로만 확인되는 이름인 경우, 사용자 서버는 기본적으로 연결을 거부합니다. 상황에 맞는 해결 방법을 선택하세요:

| 상황                                                                                   | 해결 방법                                                              |
| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
| 주소가 `10.0.0.0/8`, `172.16.0.0/12` 또는 `192.168.0.0/16`에 있고 해당 이름의 DNS 레코드를 직접 제어하는 경우 | 이름을 유지하고, 설정 파일의 `mcp.private_hostnames`에도 해당 이름을 나열하세요.           |
| 그 밖의 모든 경우                                                                           | URL과 허용 목록에서 이름 대신 IP 주소를 사용하세요. MCP 서버의 인증서에 해당 주소가 명시되어 있어야 합니다. |

### Git 저장소에는 허용 목록 항목이 필요합니다

호스팅 서비스에서는 [자체 호스팅 샌드박스](https://platform.claude.com/docs/ko/managed-agents/self-hosted-sandboxes#session-resources)를 사용하는 세션에 `github_repository` 리소스를 사용할 수 없습니다. 사용자 서버에서는 세션에 이를 사용할 수 있습니다. 서버는 [설정 파일](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configuration-reference#where-settings-go)에 해당 Git 호스트를 나열할 때까지 이러한 리소스를 거부합니다. 에이전트는 사용자가 나열한 브랜치에만 푸시할 수 있습니다:

```yaml
git:
  allowed_hostnames:
    - github.com
  allowed_push_refs:
    - refs/heads/agent/
```

다음 사항에 유의하세요:

* **URL:** 호스트가 `github.com`일 필요는 없지만, URL은 HTTPS를 사용해야 합니다.
* **토큰:** Git 트래픽이 토큰을 추가하는 사용자 서버를 거치므로, 클라이언트가 보내는 토큰은 샌드박스에 절대 도달하지 않습니다.
* **브랜치:** 에이전트에게는 브랜치 목록이 알려지지 않으므로, 프롬프트에서 브랜치 이름을 지정하세요.
* **강제 푸시:** 서버는 강제 푸시를 거부하지 않으므로, 에이전트는 사용자가 나열한 모든 브랜치를 덮어쓸 수 있습니다. 강제 푸시를 거부하려면 Git 호스트에서 해당 브랜치를 보호하세요.

[GitHub 액세스하기](https://platform.claude.com/docs/ko/managed-agents/github)에는 요청과 토큰을 교체하는 방법이 나와 있습니다. 클론이 실패하면 세션은 원인을 명시하는 `session.error` 이벤트를 받습니다. 푸시를 확인하려면 Git 호스트에서 해당 브랜치를 찾아보세요. 서버의 로그는 호스트가 거부한 푸시에 대해서도 `ok`라고 표시합니다.

### 웹 도구에는 서버 설정이 필요합니다

`web_search` 및 `web_fetch` 도구는 기본적으로 꺼져 있습니다. 이를 켜려면 서버의 [설정 파일](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configuration-reference#where-settings-go)에 다음을 추가하세요:

```yaml
web_tools:
  enabled: true
```

이 설정만 있으면 호스팅 서비스와 마찬가지로 각 에이전트 자체의 도메인 목록과 콘텐츠 제한이 적용됩니다.

모든 에이전트의 도구를 제한하려면 `web_tools.allowed_domains`, `web_tools.blocked_domains` 또는 `web_tools.max_content_tokens`를 설정하세요. 이 설정들은 각각 도구를 켜기도 합니다. 서버는 이 설정이 허용하는 것보다 더 많은 것을 요청하는 에이전트의 저장을 거부합니다. 예를 들어 `web_tools.allowed_domains` 밖의 도메인을 허용하거나 더 큰 콘텐츠 제한을 설정한 에이전트를 거부합니다. 그러한 에이전트가 이미 존재하는 경우, 업데이트할 때까지 세션을 시작할 수 없습니다.

도구가 꺼져 있는 동안 에이전트에 발생하는 일은 도구 세트의 `web_search` 및 `web_fetch` 항목에 따라 달라집니다:

| 도구 세트에 있는 항목                                                 | 발생하는 일                                |
| ------------------------------------------------------------ | ------------------------------------- |
| 두 도구 중 어느 것에 대한 항목도 없음                                       | 에이전트는 해당 도구 없이 실행되며, 이를 알리는 오류는 없습니다. |
| `{"name": "web_fetch", "enabled": false}`처럼 해당 도구를 끄기만 하는 항목 | 동일합니다.                                |
| 해당 도구를 켜 두거나, 도메인 목록, 콘텐츠 제한 또는 위치를 설정하는 항목                  | 서버는 에이전트의 저장이나 해당 에이전트의 세션 시작을 거부합니다. |

어떤 웹 도구가 존재하는지도 [추론 공급자에 따라 달라집니다](https://platform.claude.com/docs/ko/managed-agents/self-hosted/differences#differences-that-depend-on-your-inference-provider).

## 추론 공급자에 따라 달라지는 차이점

일부 기능은 서버의 `inference.provider` 설정이 특정 값일 때만 작동합니다. 표에는 다른 값에서 어떤 일이 발생하는지 나와 있습니다. 이러한 경우 중 일부는 오류를 반환하지 않습니다.

`web_search` 및 `web_fetch` 행은 [웹 도구를 켠](https://platform.claude.com/docs/ko/managed-agents/self-hosted/differences#web-tools-need-a-server-setting) 후에 적용됩니다. 그 전까지는 어떤 공급자에서도 두 도구 모두 작동하지 않습니다.

| 기능                                                                      | `inference.provider`가 다음 값일 때 작동 | 다른 값에서                                                                                                                                                                                                                | 할 일                                                                                                                                                                                |
| ----------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `web_search` 도구                                                         | `anthropic`, `vertex`, `foundry` | 서버는 모델에 이 도구를 제공하지 않습니다. 에이전트는 여전히 저장되고 실행되며 도구도 계속 나열되지만, 모델은 이를 호출할 수 없습니다.                                                                                                                                         | 에이전트에 검색을 수행하는 커스텀 도구나 MCP 서버를 제공하세요.                                                                                                                                              |
| `web_fetch` 도구                                                          | `anthropic`, `foundry`           | `web_search`와 동일합니다.                                                                                                                                                                                                  | 에이전트에 페이지를 가져오는 커스텀 도구나 MCP 서버를 제공하세요.                                                                                                                                             |
| `inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`) | `anthropic`                      | 서버는 이를 설정한 에이전트의 저장을 거부합니다.                                                                                                                                                                                           | 에이전트에서 `inference_geo` (java, php: `inferenceGeo`; csharp, go: `InferenceGeo`)를 제거하세요.                                                                                             |
| Fast mode (`speed: "fast"`)                                             | 공급자와 에이전트의 모델에 따라 달라짐            | 이를 설정한 에이전트는 두 가지 검사를 통과해야 합니다.<br />**에이전트를 저장할 때:** 서버의 모델 카탈로그에 에이전트의 모델이 fast mode를 수락하는 모델로 나열되어 있어야 합니다. 그렇지 않으면 서버는 에이전트의 저장을 거부합니다.<br />**각 턴에서:** 공급자가 해당 모델 또는 배포에 대해 fast mode를 제공하지 않으면 턴은 오류와 함께 종료됩니다. | 에이전트에서 `speed` (csharp, go: `Speed`)를 제거하세요. [fast mode를 수락하는 모델](https://platform.claude.com/docs/ko/managed-agents/self-hosted/differences#models-that-accept-fast-mode)을 참조하세요. |

`anthropic`에서는 서버가 기본적으로 Claude API의 [서버 측 폴백](https://platform.claude.com/docs/ko/build-with-claude/refusals-and-fallback#server-side-fallback)을 요청합니다. 그러면 안전 분류기가 요청을 거절할 때, 다른 Claude 모델(성능이 더 낮은 모델일 수도 있음)이 응답할 수 있습니다. 모델은 Anthropic이 선택하며, 변경을 알리는 이벤트는 없지만 세션을 조회하면 해당 모델의 ID가 표시됩니다. 폴백을 끄려면 `inference.model_fallback: false`를 설정하세요. 다른 공급자에서는 이러한 요청이 거절과 함께 턴을 종료합니다.

각 기능을 지원하는 모델과 리전은 공급자의 문서에서 확인할 수 있습니다. 커스텀 도구, MCP 도구, 그리고 워커가 실행하는 도구는 모든 공급자에서 동일합니다.

### fast mode를 수락하는 모델

기본적으로 서버의 모델 카탈로그에는 Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.6의 네 가지 모델이 fast mode를 수락하는 모델로 나열됩니다. Claude Opus 4.6에서는 Claude API가 요청을 수락하지만 [표준 속도로 실행합니다](https://platform.claude.com/docs/ko/build-with-claude/fast-mode#checking-which-speed-was-used). 다음 `inference.provider` 값은 예외입니다:

* **`foundry`:** 카탈로그에는 Claude Opus 5.5만 나열됩니다.
* **`format: vertex-raw-predict`를 사용하는 `gateway`:** 카탈로그에는 어떤 모델도 나열되지 않습니다.
* **`vertex`:** 카탈로그에는 어떤 모델도 나열되지 않으며, 어떤 설정으로도 이를 변경할 수 없습니다.

카탈로그에 나열되는 항목을 변경하려면 [모델 항목](https://platform.claude.com/docs/ko/managed-agents/self-hosted/configuration-reference#model-entries)을 참조하세요.

## 이미 자체 호스팅 샌드박스를 실행 중인 경우

워커 소프트웨어가 동일하므로 워커를 서버에 연결할 수 있습니다. [자체 워커 실행하기](https://platform.claude.com/docs/ko/managed-agents/self-hosted/call-the-api#point-a-worker-at-your-server)에는 폴링하는 프로세스에 필요한 세 가지 값과 먼저 변경해야 할 사항이 나와 있습니다. webhook으로 시작되는 워커는 여기서 작동하지 않습니다.
