Claude Models on Google Cloud (Anthropic managed)

Claude Models on Google Cloud (Anthropic managed)의 접근 및 청구는 Google Cloud가 처리합니다. 두 가지 Google Cloud 제품을 비교하거나 어떤 제품을 사용하고 있는지 확인하려면 Claude Models on Google Cloud를 참조하세요.

계정 설정

Claude Models on Google Cloud (Anthropic managed)용 계정을 설정하려면 다음이 필요합니다:

• 결제 계정에서 Google Cloud Marketplace 구매 권한
• 프로젝트에서 서비스를 활성화할 수 있는 권한
• 4단계에 필요한 Claude Console을 열 수 있는 IAM 역할

이 단계를 수행하면 Google Cloud 프로젝트용 새 Anthropic 조직이 생성됩니다. 이 조직은 회사에 이미 있는 모든 Anthropic 조직과 별개입니다. 여기에는 Claude Enterprise 조직도 포함됩니다. 기존 조직에서 이전하려면 기존 Anthropic 조직에서 이전하기를 참조하세요.

기존 할인이 있는 경우 이 단계를 시작하기 전에 Anthropic 또는 Google Cloud 계정 담당자에게 문의하세요. 할인은 과거 사용량에 적용할 수 없습니다.

1. 1

   Marketplace에서 구독하기

   1. Google Cloud Marketplace를 열고 Claude Models on Google Cloud (Anthropic managed) 목록을 찾습니다.
   2. Subscribe를 선택하고 구매 절차를 완료합니다.
   3. 목록으로 돌아가 Manage on Console을 선택합니다. 그러면 Google Cloud 콘솔에서 Claude 페이지가 열립니다.

   나중에 Claude 페이지로 돌아가려면 Google Cloud 콘솔에서 프로젝트를 선택하세요. 그런 다음 Agent Platform > Models > Claude Platform으로 이동하여 Anthropic managed를 선택하세요.

2. 2

   서비스 활성화하기

   Claude Models on Google Cloud (Anthropic managed)를 호출하는 모든 프로젝트에서 두 가지 서비스를 활성화하세요:

   • claude.googleapis.com은 Claude Models on Google Cloud (Anthropic managed)의 API를 제공합니다. 이 서비스는 IAM 권한도 정의합니다. 이 서비스가 없으면 호출이 실패합니다.
   • anthropic-managed-claude.cloudpartnerservices.goog는 프로젝트의 사용량을 구독에 귀속시키는 Marketplace 서비스입니다.

   CLI

   

   gcloud services enable claude.googleapis.com \
     anthropic-managed-claude.cloudpartnerservices.goog \
     --project=my-project-id

   my-project-id를 프로젝트 ID로 바꾸세요.

   Claude 페이지나 APIs & Services에서도 두 서비스를 모두 활성화할 수 있습니다. 활성화는 프로젝트마다 한 번만 수행하면 됩니다. 두 서비스가 모두 활성화되었는지 확인하려면 gcloud services list --enabled --project=my-project-id를 실행하고 두 이름을 찾아보세요.

3. 3

   Anthropic 조직 설정하기

   1. Claude 페이지에서 Activate를 선택합니다.
   2. Anthropic 설정 절차에서 연락처 이메일 주소를 입력합니다.
   3. 해당 주소로 전송된 설정 링크를 엽니다.
   4. 조직의 이름, 법인 유형, 국가, 사용 목적을 입력합니다.
   5. Anthropic의 상업 서비스 약관 및 사용 정책에 동의합니다.

   연락처 주소는 설정 및 서비스 공지에만 사용됩니다. 설정 후 사용자가 Claude Console을 여는 방법은 Claude Console 사용하기를 참조하세요.

4. 4

   Claude Console 열기

   Anthropic 조직이 활성화되면 Claude 페이지의 버튼이 Open Claude Console로 바뀝니다. 이 버튼을 선택하세요. Google Cloud가 IAM 접근 권한을 확인합니다. 그런 다음 브라우저를 platform.claude.com으로 리디렉션합니다. 새 조직에 로그인된 상태가 됩니다.

   Claude Console에 있는 동안 워크스페이스 ID를 찾아 복사하세요. Claude Models on Google Cloud (Anthropic managed)를 호출하는 모든 사람에게 이 ID가 필요합니다. 개발자에게 전달하세요.

다른 프로젝트를 추가하려면 해당 프로젝트에서 2단계부터 이 단계를 반복하세요.

계정 설정 문제 해결

Claude Models on Google Cloud (Anthropic managed)를 설정하는 동안 다음 문제 중 하나가 발생하면 해당 해결 방법을 적용하세요:

• gcloud services enable이 anthropic-managed-claude.cloudpartnerservices.goog를 찾을 수 없는 경우: Marketplace 구매를 완료한 계정으로 명령을 실행하거나 Anthropic 계정 담당자에게 문의하세요.
• 첫 번째 API 호출에서 권한 오류가 발생하는 경우: 호출하는 프로젝트에서 claude.googleapis.com이 활성화되어 있는지 확인하세요. 호출자가 해당 프로젝트에서 roles/claude.user 또는 roles/claude.admin을 가지고 있는지 확인하세요. 각 역할이 허용하는 내용은 IAM 역할을 참조하세요. 새로운 권한 부여나 새로 활성화된 서비스가 적용되기까지 잠시 시간이 걸릴 수 있습니다.
• 설정 링크를 따라간 후 "Signed in as a different account"가 표시되는 경우: Log out and continue를 선택하세요. 그런 다음 3단계에서 입력한 이메일 주소를 사용하세요.
• 버튼에 "Open Claude Console" 대신 "Finish Setup"이 표시되는 경우: Anthropic 조직은 존재하지만 설정이 완료되지 않았습니다. 관리자가 조직 세부 정보 양식을 완료해야 합니다.
• 첫 번째 API 호출 후 Usage 페이지에 데이터가 표시되지 않는 경우: 사용량 데이터가 Claude Console에 표시되기까지 몇 분이 걸릴 수 있습니다.

접근 관리

IAM 역할

Claude Models on Google Cloud (Anthropic managed)에는 세 가지 사전 정의된 IAM 역할이 있습니다. 역할은 프로젝트에 부여하세요.

예를 들어, 다음 명령은 서비스 계정이 Claude Models on Google Cloud (Anthropic managed)를 호출할 수 있도록 합니다:

gcloud projects add-iam-policy-binding my-project-id \
  --member="serviceAccount:my-app@my-project-id.iam.gserviceaccount.com" \
  --role="roles/claude.user"

권한, 사전 정의된 역할, 감사 로그 유형은 Claude Models on Google Cloud (Anthropic managed)의 IAM 권한을 참조하세요.

claude.googleapis.com을 활성화하면 프로젝트에 대한 서비스 에이전트가 생성됩니다. 해당 역할 부여를 제거하지 마세요. 제거하면 프로젝트에서 Claude Models on Google Cloud (Anthropic managed)가 작동하지 않습니다.

Claude Console 사용하기

Claude Models on Google Cloud (Anthropic managed)에서는 이메일 주소를 사용하여 Anthropic 조직에 로그인할 수 없습니다. 대신 Google Cloud 콘솔의 Claude 페이지에서 Open Claude Console을 선택하세요. Claude Console을 열 수 있는 사람은 Google Cloud IAM이 제어합니다. 세 가지 사전 정의된 IAM 역할 중 프로젝트의 roles/claude.admin만 Claude Console을 열 수 있게 합니다.

워크스페이스

Claude Models on Google Cloud (Anthropic managed)에서는 설정 시 하나의 워크스페이스인 Default Workspace와 함께 Anthropic 조직이 생성됩니다. 더 많은 워크스페이스를 만들려면 Claude Console을 열고 Settings > Workspaces로 이동하세요. 같은 페이지에서 Default Workspace를 제외한 모든 워크스페이스의 이름을 바꾸거나 보관할 수 있습니다. 각 워크스페이스에는 고유한 워크스페이스 ID가 있습니다. 파일, 스킬, 배치, Claude Managed Agents 세션 및 기타 워크스페이스 리소스는 요청에 설정한 ID의 워크스페이스에 속합니다.

IAM 역할은 프로젝트에 부여하므로 역할은 해당 프로젝트의 모든 워크스페이스에 적용됩니다. 팀별로 별도의 접근 권한이 필요한 경우 각 팀에 고유한 Google Cloud 프로젝트를 제공하세요. 각 프로젝트에는 고유한 Anthropic 조직이 있으므로 각 프로젝트에서 2단계부터 설정 단계를 반복하세요.

API 호출 전 준비 사항

Claude Models on Google Cloud (Anthropic managed)를 호출하려면 다음이 필요합니다:

1. 활성 구독과 설정이 완료된 Anthropic 조직이 있는 Google Cloud 프로젝트. 계정 설정을 참조하세요.
2. 로컬 개발을 위해 설치된 gcloud CLI.
3. 호출을 수행하는 ID에 프로젝트에서 부여된 roles/claude.user 역할.
4. 해당 ID에 대한 Application Default Credentials. 인증을 참조하세요.
5. 프로젝트 ID와 워크스페이스 ID.

로컬 개발을 위해 자신의 계정에 역할을 부여하려면 다음 명령을 실행하세요. 프로젝트의 IAM 정책을 변경할 수 있는 권한이 필요합니다.

gcloud projects add-iam-policy-binding my-project-id \
  --member="user:you@example.com" \
  --role="roles/claude.user"

my-project-id를 프로젝트 ID로 바꾸세요. you@example.com을 Google 계정의 이메일 주소로 바꾸세요. gcloud가 사용 중인 프로젝트를 확인하려면 gcloud config get-value project를 실행하세요. 서비스 계정 및 기타 역할은 IAM 역할을 참조하세요.

워크스페이스 ID 찾기

Claude Models on Google Cloud (Anthropic managed)의 워크스페이스 ID를 찾으려면 Claude Console을 열고 Settings > Workspaces로 이동하세요. ID는 wrkspc_로 시작합니다. Claude Console을 열 수 없는 경우 열 수 있는 사람에게 ID를 보내 달라고 요청하세요.

SDK 클라이언트와 ant CLI가 인식할 수 있도록 프로젝트와 워크스페이스를 환경 변수로 설정하세요:

export ANTHROPIC_GOOGLE_CLOUD_PROJECT="my-project-id"
export ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"

SDK 설치하기

Claude Models on Google Cloud (Anthropic managed)용 SDK 클라이언트는 AnthropicGoogleCloud입니다. 클라이언트는 Google 자격 증명을 확인합니다. 또한 프로젝트, 위치, 워크스페이스 ID로부터 기본 URL을 구성합니다.

클라이언트를 제공하는 패키지를 설치하세요:

pip install -U "anthropic[google_cloud]"

대신 ant CLI를 사용하려면 최신 버전으로 설치하거나 업데이트하세요. Claude Models on Google Cloud (Anthropic managed)를 지원하지 않는 버전은 ANTHROPIC_GOOGLE_CLOUD_* 변수를 무시합니다. 그런 다음 다음 중 하나를 수행합니다:

• 설정한 다른 자격 증명으로 Claude API에 요청을 보냅니다
• 인증 오류로 실패합니다

요청하기

Claude Models on Google Cloud (Anthropic managed)는 프로젝트, 위치, 워크스페이스를 지정하는 기본 URL 아래에서 Claude API 엔드포인트를 제공합니다:

https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke

경로가 /v1/organizations/로 시작하는 조직 수준 경로는 워크스페이스가 없는 기본 URL을 사용합니다:

https://claude.googleapis.com/v1/projects/{project}/locations/global/claudeOrganization/invoke

기본 URL을 설정하지 않으면 SDK 클라이언트가 각 요청에 대해 이 두 가지 중에서 선택합니다.

기본 URL에 Claude API 경로를 추가하세요. 예를 들어, Messages API는 .../invoke/v1/messages에 있습니다. Claude API 요청과 다른 점은 세 가지입니다:

• 기본 URL: https://api.anthropic.com 대신 앞서 보여 준 프로젝트 범위 URL을 사용합니다.
• 인증: Google 액세스 토큰이 포함된 Authorization: Bearer 헤더를 사용합니다. x-api-key 헤더를 보내지 마세요.
• 워크스페이스: 워크스페이스 ID는 URL의 일부입니다. anthropic-workspace-id 헤더를 보내지 마세요.

다음을 포함하여 나머지는 모두 Claude API와 동일합니다:

• anthropic-version 및 anthropic-beta 헤더
• 요청 본문
• 스트리밍
• 응답

이 문서의 다른 곳에 있는 코드 샘플은 Claude API 클라이언트를 생성하고 API 키를 읽습니다. Claude Models on Google Cloud (Anthropic managed)에서 실행하려면 해당 import와 클라이언트 생성자를 다음 예제의 것으로 바꾸세요. cURL 샘플의 경우 앞서 나열한 세 가지 차이점을 적용하세요.

이 예제를 실행하기 전에 API 호출 전 준비 사항의 단계를 완료하세요.

from anthropic import AnthropicGoogleCloud

client = AnthropicGoogleCloud()

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(message)

cURL 예제는 gcloud에 Application Default Credentials 토큰을 요청합니다. 액세스 토큰은 수명이 짧습니다. 토큰을 저장하지 말고 세션마다 새로 생성하세요.

API 모델 ID

Claude Models on Google Cloud (Anthropic managed)는 Claude API와 동일한 모델 ID를 사용합니다(예: claude-opus-5-5). 모델과 해당 ID는 모델 개요를 참조하세요.

Claude Models on Google Cloud (Anthropic managed)에서 Anthropic 조직에서 사용할 수 없는 모델을 요청하면 오류가 반환됩니다. 오류 메시지는 Model {model} is not available for this organization's inference configuration.입니다.

프로젝트, 위치 및 워크스페이스 확인

Claude Models on Google Cloud (Anthropic managed)용 클라이언트는 다음 표의 설정을 사용합니다. 클라이언트를 생성할 때 전달한 값이 환경 변수보다 우선합니다. 프로젝트와 워크스페이스 ID를 명시적으로 설정하려면 project 및 workspace_id를 전달하세요.

위치는 global로 두세요. 위치는 추론이 실행되는 곳과 별개이므로, 미국 전용 추론을 원하면 데이터 레지던시에 설명된 대로 각 요청에 inference_geo: "us"를 설정하세요.

ant CLI는 동일한 설정을 플래그로 받습니다:

• 프로젝트 ID: --google-cloud-project
• 워크스페이스 ID: --google-cloud-workspace-id
• 위치: --google-cloud-location
• 기본 URL: --google-cloud-base-url

CLI는 프로젝트, 워크스페이스 ID 또는 위치가 설정된 경우 Claude Models on Google Cloud (Anthropic managed)를 사용합니다. GOOGLE_CLOUD_PROJECT, 기본 URL 또는 둘 다를 설정하는 것만으로는 충분하지 않습니다.

인증

Claude Models on Google Cloud (Anthropic managed)에 대한 각 요청은 Authorization: Bearer 헤더에 Google OAuth 2.0 액세스 토큰을 포함합니다. 토큰에는 https://www.googleapis.com/auth/cloud-platform 범위가 있습니다.

접근은 Google Cloud가 처리합니다. claude.googleapis.com에 있는 Google Cloud 게이트웨이는 각 요청에 대해 다음을 수행합니다:

1. Google Cloud 자격 증명을 확인합니다.
2. 호출자가 요청에 필요한 IAM 권한을 보유하고 있는지 확인합니다. 보유하지 않은 경우 Google Cloud는 HTTP 403 오류를 반환합니다.
3. 요청을 Anthropic에 전달합니다. Anthropic이 요청을 검증합니다.

권한을 부여하려면 IAM 역할을 참조하세요.

SDK 클라이언트는 Application Default Credentials(ADC)에서 토큰을 가져옵니다. ADC가 지원하는 모든 자격 증명 소스가 작동합니다:

• 로컬 개발: gcloud auth application-default login을 실행하세요.
• Google Cloud에서: 클라이언트는 Compute Engine, GKE 또는 Cloud Run 등에서 워크로드에 연결된 서비스 계정을 자동으로 사용합니다.
• 서비스 계정 키 파일: GOOGLE_APPLICATION_CREDENTIALS를 해당 경로로 설정하세요.
• Workload Identity Federation 및 서비스 계정 가장: 다른 Google Cloud API와 마찬가지로 구성하세요.

ADC가 작동하는지 확인하세요:

gcloud auth application-default print-access-token

Claude Models on Google Cloud (Anthropic managed)는 API 키를 사용하지 않습니다. Claude Console에서는 설정으로 생성된 Anthropic 조직에 대한 API 키를 만들 수 없습니다. Claude Models on Google Cloud (Anthropic managed)용 SDK 클라이언트는 다음 환경 변수를 무시합니다:

• ANTHROPIC_API_KEY
• ANTHROPIC_AUTH_TOKEN
• ANTHROPIC_BASE_URL

자격 증명 우선순위

Claude Models on Google Cloud (Anthropic managed)용 SDK 클라이언트는 다음 순서로 자격 증명을 확인합니다. 클라이언트는 처음 찾은 것을 사용합니다:

1. 클라이언트를 생성할 때 token_provider로 전달하는 토큰 제공자. 액세스 토큰을 반환하는 함수 또는 토큰 소스입니다. 클라이언트는 모든 요청마다 토큰을 요청합니다. 토큰의 캐싱과 갱신은 사용자가 처리해야 합니다.
2. 클라이언트를 생성할 때 credentials로 전달하는 Google 자격 증명 객체. Go SDK에는 이 옵션이 없습니다.
3. Application Default Credentials.

Go와 Java는 다른 SDK와 다릅니다:

• Go: 옵션 1의 경우 클라이언트는 oauth2.TokenSource를 받습니다. 토큰이 만료될 때까지 토큰을 캐시합니다.
• Java: GoogleCloudBackend.fromEnv()를 사용하여 Application Default Credentials와 프로젝트, 위치 및 워크스페이스 확인의 환경 변수를 읽으세요.

클라이언트에는 자격 증명을 위한 자체 환경 변수가 없습니다. 대신 ADC의 GOOGLE_APPLICATION_CREDENTIALS를 사용하세요.

요청이 토큰을 대신 첨부해 주는 프록시를 거치는 경우 skip_auth를 설정하세요. 그러면 클라이언트는 Authorization 헤더를 보내지 않습니다. 이 설정은 앞의 자격 증명 옵션과 함께 사용할 수 없습니다.

ant CLI가 Claude Models on Google Cloud (Anthropic managed)를 사용할 때는 항상 Application Default Credentials에서 토큰을 가져옵니다. 토큰 제공자, 자격 증명 객체 또는 skip-auth 설정을 받지 않습니다.

Claude Models on Google Cloud (Anthropic managed)와 함께 ant를 사용하기 전에 다음 중 어느 것도 설정되어 있지 않은지 확인하세요:

• API 키
• 인증 토큰
• CLI가 인증에 사용할 수 있는 구성 프로필을 지정하는 경우의 --profile 또는 ANTHROPIC_PROFILE
• Anthropic의 페더레이션 변수 중 하나:
  • ANTHROPIC_FEDERATION_RULE_ID
  • ANTHROPIC_ORGANIZATION_ID
  • ANTHROPIC_SERVICE_ACCOUNT_ID
  • ANTHROPIC_IDENTITY_TOKEN
  • ANTHROPIC_IDENTITY_TOKEN_FILE

이 중 하나가 설정되어 있으면 CLI는 워크스페이스 ID 찾기의 Google Cloud 설정 대신 해당 자격 증명을 사용합니다. 페더레이션 변수 중 일부만 설정되어 있으면 CLI는 오류와 함께 중지됩니다. 둘 이상의 자격 증명이 설정되어 있으면 CLI는 사용하는 자격 증명을 알려 주는 메시지를 출력합니다.

또한 ANTHROPIC_WORKSPACE_ID와 --workspace-id 플래그를 설정하지 마세요. CLI는 여전히 해당 값을 anthropic-workspace-id 헤더로 보냅니다. Claude Models on Google Cloud (Anthropic managed)에 대한 요청에는 해당 헤더가 포함되어서는 안 됩니다. 대신 --google-cloud-workspace-id 또는 ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID로 워크스페이스를 설정하세요.

SDK 클라이언트와 마찬가지로 CLI는 Claude Models on Google Cloud (Anthropic managed)에 대한 요청을 --base-url 또는 ANTHROPIC_BASE_URL로 보내지 않습니다.

기능 지원

이 섹션에서는 Claude Models on Google Cloud (Anthropic managed)에서 작동하는 기능과 지원되지 않는 기능을 나열합니다. 모든 Claude API 기능을 나열하지는 않으며, 나열되지 않은 기능이 작동하는지 여부도 명시하지 않습니다.

다음 기능은 Claude Models on Google Cloud (Anthropic managed)에서 Claude API와 동일하게 작동합니다:

• Fast mode: Claude Opus 5.5용 Fast mode.

• 베타 기능: Claude API에서 베타가 선택된 조직으로 제한되는 경우, 설정으로 생성된 Anthropic 조직에도 동일한 접근 권한이 필요합니다.
• 도구: 다음을 포함한 도구 사용:
  • 웹 검색
  • 웹 가져오기
  • 코드 실행
  • 메모리 도구
  • 어드바이저 도구
  • MCP 커넥터
• 스킬 및 파일: Agent Skills 및 Files API.
• 모델 기능:
  • 프롬프트 캐싱
  • 확장 사고
  • 서버 측 폴백
  • 스트리밍
  • 구조화된 출력
  • 토큰 계산
• 배치 및 모델: Message Batches API 및 Models API.

설정으로 생성된 Anthropic 조직에 대해 Compliance API를 켜거나 끄려면 Claude Console을 열고 Settings > Compliance로 이동하여 Compliance API 토글을 사용하세요.

"Customer-managed encryption keys"(고객 관리 암호화 키), 즉 CMEK는 Google Cloud KMS 키와 함께 사용할 수 있습니다. 설정으로 생성된 Anthropic 조직에 대해 CMEK를 활성화하려면 고객 관리 암호화 키를 참조하세요. 키를 설정하려면 CMEK용 Google Cloud KMS 구성을 따르세요. 그런 다음 설정 페이지의 Claude Console 탭에 설명된 대로 Claude Console에서 키를 등록, 확인 및 연결하세요.

Claude Managed Agents

Claude Managed Agents는 다음을 포함하여 Claude Models on Google Cloud (Anthropic managed)를 통해 사용할 수 있습니다:

• 에이전트
• 환경
• 세션
• 자격 증명 볼트
• 메모리 저장소
• 예약된 배포
• 자체 호스팅 샌드박스

접근 권한은 세션이나 배포가 실행되는 동안이 아니라 생성될 때 확인됩니다:

• 실행 중인 세션은 계속 실행됩니다. 세션을 생성한 ID에서 Google Cloud 접근 권한을 취소해도 세션은 중지되지 않습니다. 중지하려면 user.interrupt 이벤트만 단독으로 보내세요. 세션이 idle 상태가 되면 보관하거나 삭제할 수 있습니다.
• 예약된 배포는 계속 실행됩니다. 배포는 예약된 실행마다 생성자의 접근 권한을 다시 확인하지 않습니다. 중지하려면 일시 중지, 업데이트 또는 보관하세요.

사용자를 제거하거나 서비스 계정을 교체할 때는 해당 ID가 생성한 세션과 배포를 검토하세요.

지원되지 않는 기능

다음은 Claude Models on Google Cloud (Anthropic managed)에서 지원되지 않습니다:

• API 키: 인증은 Google Cloud 자격 증명을 통해서만 이루어집니다.
• MCP 터널: MCP 터널은 Claude Models on Google Cloud (Anthropic managed)에서 사용할 수 없습니다.
• 자체 호스팅 환경의 메모리 스토어: 자체 호스팅 환경 세션에서는 메모리 스토어가 지원되지 않습니다.
• 사전 구축된 자체 호스팅 샌드박스 워커: ant CLI와 Python, TypeScript, Go SDK의 자체 호스팅 워커는 Claude Models on Google Cloud (Anthropic managed)를 지원하지 않습니다. 대신 Environments Work 엔드포인트를 직접 호출하는 자체 워커를 구현하세요. 워커에 필요한 역할과 권한은 environments에 대한 IAM 권한을 참조하세요.

컨텍스트 윈도우

Claude Models on Google Cloud (Anthropic managed)의 "context window"(컨텍스트 윈도우) 크기는 Claude API와 동일합니다. 각 모델의 한도는 컨텍스트 윈도우를 참조하세요.

청구, 속도 제한 및 로깅

속도 제한

Claude Models on Google Cloud (Anthropic managed)의 "rate limit"(속도 제한)은 Anthropic이 관리합니다. 더 높은 한도를 요청하려면 Anthropic 계정 담당자에게 문의하거나 영업팀에 문의하세요. 속도 제한이 측정되고 보고되는 방식은 속도 제한을 참조하세요.

청구

Claude Models on Google Cloud (Anthropic managed)는 Google Cloud Marketplace를 통해 청구됩니다. Anthropic이 사용량을 측정합니다. 사용량은 Claude Consumption Units 단위로 Google Cloud에 보고됩니다. 요금은 Google Cloud 청구서에 표시됩니다. Anthropic은 별도의 청구서를 보내지 않습니다.

Claude Console의 Usage 및 Cost 페이지에서 사용량 및 비용 데이터를 확인하세요.

Google Cloud 지출 약정이 있는 경우 사용량은 다른 Marketplace 구매와 동일한 방식으로 약정에 반영됩니다.

데이터 보존

Anthropic은 Claude Models on Google Cloud (Anthropic managed)의 데이터 처리자입니다. Anthropic의 신뢰 및 안전 시스템과 같은 일부 지원 서비스는 Google Cloud 외부에서 데이터를 처리합니다.

Claude Models on Google Cloud (Anthropic managed)는 Claude API와 동일한 데이터 보존 정책을 따릅니다. API 및 데이터 보존을 참조하세요. "Zero Data Retention"(데이터 무보존), 즉 ZDR은 요청 시 사용할 수 있습니다. Anthropic 계정 담당자에게 문의하세요.

다른 Anthropic 조직의 ZDR 계약은 Claude Models on Google Cloud (Anthropic managed)용 조직으로 이전되지 않습니다.

모니터링 및 로깅

Cloud Audit Logs는 프로젝트에서 Claude Models on Google Cloud (Anthropic managed)의 API 활동을 기록합니다. 항목은 claude.googleapis.com 서비스 아래에 표시됩니다. 각 API 경로는 두 가지 로그 유형 중 하나에 속합니다:

• Data Access 로그: 메시지, 배치, 파일, 스킬, 모델 및 대부분의 Claude Managed Agents 리소스를 포함한 대부분의 경로를 다룹니다. 기본적으로 꺼져 있습니다.
• Admin Activity 로그: 암호화 키 경로와 대부분의 자격 증명 볼트 경로를 포함한 나머지 경로를 다룹니다. 예외는 vaults.verify 경로로, 이는 Data Access에 속합니다. Admin Activity 로그는 항상 켜져 있습니다.

요청 기록을 유지하려면 프로젝트의 감사 로그 설정에서 claude.googleapis.com에 대한 Data Access 로그를 켜세요.

경로별 감사 로그 유형은 Claude Models on Google Cloud (Anthropic managed)의 IAM 권한을 참조하세요.

요청 ID

Claude Models on Google Cloud (Anthropic managed)의 성공적인 응답에는 request-id 헤더가 포함됩니다.

기존 Anthropic 조직에서 이전하기

기존 Anthropic 조직을 Claude Models on Google Cloud (Anthropic managed)용 조직으로 전환할 수 없습니다. 여기에는 Claude API와 직접 사용하는 조직도 포함됩니다.

이전은 새 조직으로의 전환으로 계획하세요:

• 먼저 새 조직을 만드세요. 계정 설정을 따르세요.
• 접근 권한과 구성을 다시 만드세요. API 키, 워크스페이스, Claude Console 설정은 이전되지 않습니다. API 키를 만드는 대신 프로젝트에 IAM 역할을 부여하세요. 워크스페이스를 다시 만들려면 워크스페이스를 참조하세요. ZDR 계약은 데이터 보존을 참조하세요.
• 저장된 리소스에 대해 계획하세요. 파일, 스킬, 배치, Claude Managed Agents 리소스는 기존 조직에 남아 있습니다.
• 통합을 업데이트하세요. 변경되는 사항과 동일하게 유지되는 사항은 요청하기를 참조하세요. 지원되지 않는 기능은 지원되지 않는 기능을 참조하세요.
• 원하는 일정에 따라 전환하세요. 두 조직은 독립적이며 트래픽을 병렬로 처리할 수 있습니다. 워크로드를 점진적으로 이전할 수 있습니다. 기존 조직은 현재 청구 방식을 유지합니다. 프로덕션 트래픽을 이전하기 전에 속도 제한을 확인하세요.

Claude Models on Google Cloud (Google managed)에서 마이그레이션하기

Claude Models on Google Cloud (Anthropic managed)로 이전하려면 다음 단계를 완료하세요. ZDR 약정에 의존하는 워크로드를 이전하기 전에 데이터 보존을 참조하세요. 이전 시 달라지는 사항은 두 Google Cloud 제공 방식의 차이점을 참조하세요.

1. 1

   계정 설정하기

   계정 설정하기의 모든 단계를 완료하세요.

2. 2

   액세스 설정하기

   Claude Models on Google Cloud (Anthropic managed)를 호출하는 각 ID에 roles/claude.user를 부여하세요. 프로젝트와 워크스페이스 ID를 환경 변수로 설정하세요. 두 가지 모두 API 호출 전 준비 사항을 참조하세요.

3. 3

   SDK 패키지 설치하기

   Claude Models on Google Cloud (Anthropic managed)용 클라이언트를 제공하는 패키지를 설치하세요. SDK 설치하기를 참조하세요.

4. 4

   import와 클라이언트 교체하기

   클라이언트를 import하고 생성하는 코드를 변경하세요. AnthropicVertex 대신 AnthropicGoogleCloud를 사용하세요. cURL 요청에서는 URL, 헤더, 본문을 변경하세요. 현재 코드는 Claude Models on Google Cloud (Google managed)용 클라이언트를 생성합니다. 예를 들어, 다음 코드는 글로벌 엔드포인트로 해당 클라이언트를 생성합니다:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicVertex
   
   project_id = "MY_PROJECT_ID"
   region = "global"
   
   client = AnthropicVertex(project_id=project_id, region=region)

   다음 코드는 Claude Models on Google Cloud (Anthropic managed)용 클라이언트를 생성합니다:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   새 클라이언트는 워크스페이스 ID 찾기에서 설정한 환경 변수로부터 프로젝트와 워크스페이스 ID를 읽습니다. 클라이언트를 생성할 때 이 값들을 전달하지 않습니다. Messages API 호출은 다음 단계의 모델 ID와 기능을 제외하고 그대로 유지됩니다.

5. 5

   모델 ID와 기능 확인하기

   • 모델 ID: Claude 4.6 이전 모델을 사용하는 경우, ID에서 스냅샷 날짜 앞의 @를 하이픈으로 바꾸세요. 예를 들어, claude-haiku-4-5@20251001은 claude-haiku-4-5-20251001이 됩니다. 모델과 해당 ID는 API 모델 ID를 참조하세요.
   • 기능: 코드에서 사용하는 각 기능에 대해 기능 지원을 확인하세요.
   • 위치: 현재 멀티 리전 또는 리전 엔드포인트를 사용하는 경우, Claude Models on Google Cloud (Anthropic managed)가 어떤 위치를 사용하는지 확인하세요. 프로젝트, 위치 및 워크스페이스 결정을 참조하세요.
6. 6

   테스트 요청 실행하기

   요청 보내기의 요청을 실행하여 설정이 제대로 작동하는지 확인하세요. 그런 다음 자체 코드를 실행하세요. 호출이 권한 오류로 실패하면 계정 설정 문제 해결을 참조하세요. 프로덕션 트래픽을 이전하기 전에 속도 제한을 확인하세요.

다음 단계