Google Cloud의 Claude 모델 (Anthropic 관리형)은 Cloud de Confiance by S3NS에서 Anthropic의 Claude 개발자 플랫폼을 사용할 수 있는 서비스입니다. 이를 사용하여 새 모델 및 연구 프리뷰, Claude Console을 포함한 Anthropic의 최신 기능에 액세스할 수 있습니다.
이 페이지에서는 다음 주제에 대해 설명합니다.
- Google Cloud 기반 Claude 모델 (Anthropic 관리형)의 주요 이점
- Anthropic 관리형 Claude 모델과 Google 관리형 Claude 모델 비교
- 시작하는 방법
- API 호출 방법
주요 이점
Google Cloud에서 Claude 모델 (Anthropic 관리형)을 사용할 때의 주요 이점은 다음과 같습니다.
- 최신 혁신에 대한 액세스: Anthropic의 최신 모델, 기능, 연구 프리뷰, 베타가 출시되는 즉시 액세스할 수 있습니다.
- Cloud de Confiance by S3NS 결제 및 ID 통합: 기존Cloud de Confiance by S3NS 투자를 활용합니다. 이 서비스는 Cloud Billing 및 Identity and Access Management와 통합되며 Google Google Cloud Marketplace 약정 사용 정책에 따라 Cloud de Confiance by S3NS 약정을 사용합니다.
- 통합 지원: Agent Platform 관련 문제에 대해 Cloud de Confiance by S3NS 지원팀의 일선 지원을 받고, 관리형 서비스에 대해 Anthropic의 전문 백라인 지원을 받습니다.
- Anthropic의 기본 제공 환경: Claude 콘솔에 액세스하여 리소스를 관리하고 새로운 기능을 탐색합니다.
Anthropic 관리형 Claude 모델과 Google 관리형 Claude 모델 비교
Google Cloud의 Claude 모델 (Anthropic 관리)과 Agent Platform의 Claude 모델 (Google 관리)은 스택을 운영하는 주체, API 표면, 기능 가용성, 데이터 프로세서가 다릅니다.
Google Cloud의 Claude 모델 (Anthropic 관리) (claude.googleapis.com)을 사용하면 API 및 기본 플랫폼이 Anthropic의 자체 시스템에서 Anthropic에 의해 관리되며, Anthropic이 데이터 프로세서인 데이터 처리 약관을 포함한 Anthropic 상업용 서비스 약관의 적용을 받습니다.
다음 중 하나가 필요한 경우 Google 관리 Claude 모델을 사용해야 합니다.
- Google이 유일한 데이터 프로세서인 Google 운영 추론( Cloud de Confiance by S3NS )
- Cloud de Confiance by S3NS의 보안 경계 내에 유지되는 데이터 및 추론 (VPC 서비스 제어, 고객 관리 암호화 키, 리전별 데이터 레지던시 사용)
- Cloud de Confiance by S3NS 규정 준수 프로그램 (FedRAMP 높음, IL4, IL5, SOC, ISO, HIPAA 자격 요건 포함)에 따른 적용 범위
- 기본 제공 Cloud de Confiance by S3NS 할당량 및 결제
- BigQuery, Model Armor, Agent Engine과 같은 Cloud de Confiance by S3NS 서비스와 기본적으로 통합됩니다.
한눈에 비교하기
다음 표에서는 Anthropic 관리형 Claude 모델과 Google 관리형 Claude 모델의 주요 차이점을 간략하게 설명합니다.
| 모델 유형 | Anthropic 관리형 | Google 관리 |
|---|---|---|
| 스택을 운영하는 주체 | Anthropic | |
| API 노출 영역 | 항목 /v1/messages개에서 claude.googleapis.com 사용 중 |
Agent Platform 예측 엔드포인트, /v1/messages |
| 기능 제공 여부 | 퍼스트 파티 Claude API와 일치하도록 설계됨 | Agent Platform 및 Model Garden 출시 일정에 따름 |
| 베타 기능 | anthropic-beta 헤더로 전달 |
anthropic-beta 헤더 지원은 Model Garden 출시 버전에 따라 다릅니다. |
| 인증 | Cloud de Confiance by S3NS IAM 애플리케이션 기본 사용자 인증 정보, 서비스 계정 또는 gcloud auth print-access-token. x-api-key 없음 |
Cloud de Confiance by S3NS IAM (동일한 사용자 인증 정보 모델) |
| 결제 | Google Cloud Marketplace (CCU) | Cloud de Confiance by S3NS (Agent Platform 결제) |
| 기준 URL | claude.googleapis.com |
REGION-aiplatform.googleapis.com |
| SDK 클라이언트 | 플랫폼별 클라이언트 클래스 (AnthropicGoogleCloud) |
Agent Platform 클라이언트 |
| 콘솔 | IAM, 측정항목, 모니터링을 위한Cloud de Confiance 콘솔, Claude 콘솔 (platform.claude.com, Cloud de Confiance by S3NS를 통해 액세스) |
Cloud de Confiance 콘솔 (Agent Platform 및 Model Garden) |
| 비율 제한 및 할당량 | 할당량 요청은 콘솔을 사용하여 직접 제출할 수 있지만 비율 제한 및 할당량은 Anthropic에서 관리합니다. | Cloud de Confiance by S3NS 에서 관리(Agent Platform 할당량) |
지원되는 API 기능 비교
다음 표에서는 Anthropic 관리형 Claude 모델과 Google 관리형 Claude 모델의 다양한 API 기능에 대한 지원 수준을 비교합니다.
| 기능 | 설명 | Anthropic 관리형 | Google 관리 |
|---|---|---|---|
| 사고 (확장, 적응형) | 답변하기 전에 문제를 추론하여 복잡한 작업의 정확도를 개선합니다. | ||
| 프롬프트 캐싱 (자동 및 명시적) | 반복되는 프롬프트 콘텐츠를 재처리하는 대신 재사용하여 비용과 지연 시간을 줄입니다. 자동으로 적용하거나 캐시할 항목을 선택하세요. | ||
| 작업 예산 (베타) | Claude에 작업에 대한 토큰 허용량을 제공하여 장기 실행 에이전트의 지출을 관리합니다. Claude는 업무의 우선순위를 정하고 마무리하는 데 더 능숙합니다. | ||
| 도구 사용 (클라이언트 정의) | 외부 도구에 연결하여 고객의 자체 함수, API, 시스템을 호출합니다. | ||
| 인용 | 각 주장을 뒷받침하는 정확한 구절을 반환하여 답변을 확인하고 출처를 표시합니다. | ||
| 100만 컨텍스트, 이미지/PDF (지원되는 모델) | 요청당 최대 100만 개의 토큰을 처리할 수 있습니다 (전체 코드베이스 또는 수백 개의 문서에 충분한 양). 이미지와 PDF를 읽습니다. | ||
| 프롬프트 캐싱 (5분, 1시간, 자동) | 캐시된 콘텐츠가 보관되는 기간 (5분, 1시간)을 정의하여 반복적인 작업의 처리 시간과 비용을 줄입니다. | ||
| 구조화된 출력 | 재시도나 파싱 오류 없이 Claude의 대답이 항상 지정된 JSON 스키마 또는 커스텀 도구 정의와 일치하도록 보장합니다. | ||
| 일괄 처리 | 비동기 처리를 위해 여러 요청을 함께 제출합니다. 대량의 데이터, 비용 효율성 최적화, 즉각적인 응답이 필요하지 않은 경우에 유용합니다. | Agent Platform 일괄 추론 사용 | |
| 서비스 등급 | 애플리케이션의 요구사항에 따라 가용성, 성능, 예측 가능한 비용의 균형을 맞출 수 있는 다양한 서비스 등급을 제공합니다. | 우선순위, 표준, 일괄 | 프로비저닝된 처리량, 일괄 |
| 컨텍스트 수정 (베타) | 대화 기록이 늘어남에 따라 특정 콘텐츠를 대화 기록에서 삭제하여 비용을 최적화하고, 한도를 준수하며, 에이전트가 중점을 파악하고 더 오래 실행할 수 있도록 지원합니다. | ||
| Anthropic 정의 도구 | |||
| 웹 검색 | 실시간 웹 액세스를 제공하여 최신 정보를 검색합니다. 대답에 인용이 포함됩니다. | ||
| 웹 가져오기 | 특정 웹페이지 및 PDF에서 콘텐츠를 가져올 수 있도록 실시간 웹 액세스 권한을 부여합니다. | ||
| 원격 MCP (베타) | API에서 직접 원격 MCP 서버를 통해 외부 도구 및 데이터에 연결합니다. | ||
| 메모리 | 대화 전반에 걸쳐 정보를 저장하고 검색하므로 에이전트가 시간이 지남에 따라 지식을 쌓을 수 있습니다. | ||
| Files API | 매번 동일한 콘텐츠를 다시 전송하는 대신 API와 함께 사용할 파일을 한 번 업로드하고 관리합니다. | ||
| Computer Use | Claude에게 데스크톱 환경의 스크린샷, 마우스, 키보드 제어 권한을 부여하여 자율적으로 상호작용할 수 있도록 합니다. | ||
| Skills | Claude에게 도메인별 전문 지식을 제공하는 재사용 가능한 리소스입니다. 범용 에이전트를 전문가로 전환하는 워크플로, 컨텍스트, 권장사항이 포함됩니다. | ||
| 코드 실행 | Claude가 샌드박스 환경에서 코드를 작성하고 실행하여 데이터를 분석하고, 파일을 생성하고, 솔루션을 반복할 수 있도록 허용합니다. | ||
| 관리형 에이전트 (베타) | 관리형 인프라에서 실행되는 사전 빌드된 구성 가능한 에이전트 하네스를 사용합니다. 장기 실행 작업 및 비동기 작업에 가장 적합합니다. | ||
| 어드바이저 도구 (베타) | 더 빠르고 비용이 저렴한 실행자 모델 (Haiku, Sonnet)이 생성 중간에 더 지능적인 자문 모델 (Opus)에 전략적 안내를 요청한 후 작업을 재개할 수 있습니다. | ||
시작하기
Google Cloud 기반 Claude 모델 (Anthropic 관리형)을 시작하려면 다음 단계에 따라 프로젝트에 Google Cloud 기반 Claude 모델 (Anthropic 관리형)을 사용 설정하세요.
Cloud de Confiance 콘솔에서 Claude 모델 페이지로 이동합니다.
관리자 옵션 목록에서 Anthropic 관리를 선택합니다.
프로젝트에 Claude API를 아직 사용 설정하지 않은 경우 Claude API 사용 설정 섹션에서 API 사용 설정을 클릭한 후 안내를 따릅니다.
제품 구매 섹션에서 Marketplace에서 구매하기를 클릭합니다. Marketplace 페이지로 리디렉션됩니다. 정가로 제품을 구매하거나 협상 할인 또는 프라이빗 오퍼를 통해 구매할 수 있습니다. 제품을 구매했으면 콘솔에서 관리를 클릭하여 Model Garden 페이지로 돌아갑니다.
Claude 콘솔 활성화 섹션에서 활성화를 클릭하여 Cloud de Confiance by S3NS 프로젝트에 새 Anthropic 조직을 프로비저닝합니다. 설정 링크를 받을 일회성 연락처 이메일 주소를 입력하고, 해당 받은편지함에서 링크를 열고, 조직 세부정보 양식 (조직 이름, 법인 유형, 국가, 용도)을 작성하고, Anthropic의 상업용 서비스 약관 및 사용 정책에 동의합니다. 이렇게 하면 별도의 Anthropic 조직이 생성됩니다. 기존 퍼스트 파티 Anthropic 조직의 API 키, 작업공간, HIPAA 제어, 제로 데이터 보관(ZDR), 설정은 이월되지 않습니다.
Google Cloud에서 Claude 모델 사용 (Anthropic 관리형)
Claude API를 사용 설정하고 제품을 구매한 후에는 Claude 콘솔을 통해 또는 Claude API를 사용하여 Google Cloud의 Claude 모델 (Anthropic 관리형)을 사용할 수 있습니다.
Claude Console
Claude Console을 사용하려면 다음 안내를 따르세요.
roles/claude.admin(Claude 플랫폼 관리자) 역할 부여: Claude 콘솔을 사용하려면 먼저 프로젝트에roles/claude.admin(Claude 플랫폼 관리자) Identity and Access Management (IAM) 역할을 부여해야 합니다.Cloud de Confiance 콘솔에서 Google Cloud의 Claude 모델 (Anthropic 관리형) 페이지로 이동합니다.
Claude Console 활성화 섹션에서 Claude Console 열기를 클릭합니다.
Claude API
표준 Cloud de Confiance by S3NS인증을 사용하여 Google Cloud (Anthropic 관리형)에서 Claude 모델과 상호작용할 수 있습니다. API 엔드포인트는 https://claude.googleapis.com/입니다.
roles/claude.user(Claude 플랫폼 사용자) 역할 부여: API를 호출하려면 먼저 프로젝트에roles/claude.user(Claude 플랫폼 사용자) Identity and Access Management (IAM) 역할을 부여해야 합니다.Cloud de Confiance by S3NS로 인증: 클라이언트 라이브러리 또는 Google Cloud CLI를 사용하는 경우 인증이 자동으로 처리됩니다. 직접 API 호출의 경우 인증을 완료하고 OAuth 2.0 토큰을 가져올 수 있는지 확인합니다. Google Cloud CLI를 사용하여 토큰을 가져올 수 있습니다.
gcloud auth print-access-tokenMessages API 호출: API 구조는 Anthropic Messages API를 미러링합니다. Anthropic의 Cloud de Confiance by S3NS클라이언트 SDK (
AnthropicGoogleCloud)를 사용하거나https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke/v1/messages에서 작업공간 범위 엔드포인트에 직접 요청할 수 있습니다.다음은 curl을 사용하는 예시입니다.
curl -X POST "https://claude.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/workspaces/${ANTHROPIC_WORKSPACE_ID}/invoke/v1/messages" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-haiku-4-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, Claude"} ] }'
API 참조
메시지, 파일, 기술에 대한 자세한 API 참고 리소스는 Anthropic API 문서를 참조하세요.
작업공간 범위 엔드포인트 (예: /v1/messages, /v1/files, /v1/skills)에 대한 직접 REST 호출의 경우 Anthropic API 경로 앞에 https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke를 기준 URL로 사용합니다 (예: .../invoke/v1/files). 조직 수준 엔드포인트 (예: /v1/organizations/workspaces)의 경우 https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/claudeOrganization/invoke를 기준 URL로 사용합니다.