데이터 레지던시

데이터 레지던시 제어를 사용하면 데이터가 처리되고 저장되는 위치를 관리할 수 있습니다. 두 가지 독립적인 설정이 이를 제어합니다:

• Inference geo: 요청별로 모델 추론이 실행되는 위치를 제어합니다. inference_geo API 파라미터를 통해 설정하거나 워크스페이스 기본값으로 설정합니다.
• Workspace geo: 저장 데이터(data at rest)가 저장되는 위치와 엔드포인트 처리(이미지 트랜스코딩 및 코드 실행 등)가 이루어지는 위치를 제어합니다. Claude Console에서 워크스페이스 수준으로 구성됩니다.



Inference geo

inference_geo 파라미터는 특정 API 요청에 대해 모델 추론이 실행되는 위치를 제어합니다. 모든 POST /v1/messages 호출에 추가하세요.



API 사용법

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

for block in response.content:
    if block.type == "text":
        print(block.text)
# 추론이 실제로 실행된 위치 확인
print(f"Inference geo: {response.usage.inference_geo}")



응답

응답의 usage 객체에는 추론이 실행된 위치를 나타내는 inference_geo 필드가 포함됩니다:

{
  "usage": {
    "input_tokens": 25,
    "output_tokens": 150,
    "inference_geo": "us"
  }
}



모델 가용성

inference_geo 파라미터는 Claude 4.6 이상 모델에서 지원됩니다. Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5 또는 이전 모델에서 inference_geo를 포함한 요청은 400 오류를 반환합니다.



워크스페이스 수준 제한

워크스페이스 설정은 사용 가능한 inference geo를 제한하는 기능도 지원합니다:

• allowed_inference_geos: 워크스페이스가 사용할 수 있는 geo를 제한합니다. 요청이 이 목록에 없는 inference_geo를 지정하면 API가 오류를 반환합니다.
• default_inference_geo: 요청에서 inference_geo가 생략된 경우 사용되는 대체 geo를 설정합니다. 개별 요청은 inference_geo를 명시적으로 설정하여 이를 재정의할 수 있습니다.

이러한 설정은 Console 또는 Admin API의 data_residency 필드를 통해 구성할 수 있습니다.



Workspace geo

Workspace geo는 워크스페이스를 생성할 때 설정되며 이후에는 변경할 수 없습니다. 현재 "us"가 유일하게 사용 가능한 workspace geo입니다.

Workspace geo를 설정하려면 Console에서 새 워크스페이스를 생성하세요:

1. Settings > Workspaces로 이동합니다.
2. 새 워크스페이스를 생성합니다.
3. Workspace geo를 선택합니다.



가격 책정

데이터 레지던시 가격은 모델 세대에 따라 다릅니다:

• Claude 4.6 이상 모델: 미국 전용 추론(inference_geo: "us")은 모든 토큰 가격 카테고리(입력 토큰, 출력 토큰, 캐시 쓰기, 캐시 읽기)에서 표준 요금의 1.1배로 책정됩니다.
• 글로벌 라우팅(inference_geo: "global"): 표준 가격이 적용됩니다.
• 이전 모델: inference_geo를 지원하지 않습니다(모델 가용성 참조). 표준 가격이 적용됩니다. 해당 파라미터를 포함한 요청은 400 오류를 반환합니다.

이 가격은 Claude API(퍼스트파티) 및 Claude Platform on AWS에 적용됩니다. Claude in Microsoft Foundry에서는 US Data Zone Standard 배포 유형을 사용하는 Azure 호스팅 배포에 동일한 1.1배 배수가 적용됩니다. 파트너 운영 플랫폼(Bedrock 및 Google Cloud)은 자체 리전별 가격을 적용합니다. 자세한 내용은 데이터 레지던시 가격을 참조하세요.

동일한 배수가 Claude Managed Agents에도 적용됩니다. 에이전트의 모델 구성에서 inference_geo를 "us"로 고정하면 해당 에이전트를 실행하는 세션의 모델 요청은 표준 요금의 1.1배로 책정됩니다.



Batch API 지원

inference_geo 파라미터는 Batch API에서 지원됩니다. 배치의 각 요청은 자체 inference_geo 값을 지정할 수 있습니다.



레거시 옵트아웃에서 마이그레이션

조직이 이전에 추론을 미국 내에 유지하기 위해 글로벌 라우팅을 옵트아웃한 경우, 워크스페이스가 자동으로 allowed_inference_geos: ["us"] 및 default_inference_geo: "us"로 구성되었습니다. 코드 변경이 필요하지 않습니다. 기존 데이터 레지던시 요구 사항은 새로운 geo 제어를 통해 계속 적용됩니다.



변경된 사항

레거시 옵트아웃은 모든 요청을 미국 기반 인프라로 제한하는 조직 수준 설정이었습니다. 새로운 데이터 레지던시 제어는 이를 두 가지 메커니즘으로 대체합니다:

• 요청별 제어: inference_geo 파라미터를 사용하면 각 API 호출에서 "us" 또는 "global"을 지정할 수 있어 요청 수준의 유연성을 제공합니다.
• 워크스페이스 제어: Console의 default_inference_geo 및 allowed_inference_geos 설정을 통해 워크스페이스의 모든 키에 걸쳐 geo 정책을 적용할 수 있습니다.



워크스페이스에 적용된 변경 사항

워크스페이스가 자동으로 마이그레이션되었습니다:

워크스페이스의 키를 사용하는 모든 API 요청은 계속해서 미국 기반 인프라에서 실행됩니다. 현재 동작을 유지하기 위해 별도의 조치가 필요하지 않습니다.



글로벌 라우팅을 사용하려는 경우

데이터 레지던시 요구 사항이 변경되어 더 나은 성능과 가용성을 위해 글로벌 라우팅을 활용하려는 경우, 워크스페이스의 inference geo 설정을 업데이트하여 허용된 geo에 "global"을 포함하고 default_inference_geo를 "global"로 설정하세요. 자세한 내용은 워크스페이스 수준 제한을 참조하세요.



가격 영향

레거시 모델은 이 마이그레이션의 영향을 받지 않습니다. 최신 모델의 현재 가격은 가격 책정을 참조하세요.



현재 제한 사항

• 공유 속도 제한: 속도 제한은 모든 geo에서 공유됩니다.
• Inference geo: "us"와 "global"만 사용할 수 있습니다.
• Workspace geo: 현재 "us"만 사용할 수 있습니다. Workspace geo는 워크스페이스 생성 후 변경할 수 없습니다.



다음 단계