이 페이지는 사용 가능한 배포 옵션에 대한 개요를 제공하고 조직에 적합한 구성을 선택하는 데 도움을 줍니다.

​
제공업체 비교

기능AnthropicAmazon BedrockGoogle Vertex AI
지역지원되는 국가여러 AWS 지역여러 GCP 지역
프롬프트 캐싱기본적으로 활성화됨기본적으로 활성화됨기본적으로 활성화됨
인증API 키AWS 자격 증명 (IAM)GCP 자격 증명 (OAuth/Service Account)
비용 추적대시보드AWS Cost ExplorerGCP Billing
엔터프라이즈 기능팀, 사용량 모니터링IAM 정책, CloudTrailIAM 역할, Cloud Audit Logs

​
클라우드 제공업체

Amazon Bedrock

IAM 기반 인증 및 AWS 네이티브 모니터링을 통해 AWS 인프라를 통해 Claude 모델 사용

Google Vertex AI

엔터프라이즈급 보안 및 규정 준수를 통해 Google Cloud Platform을 통해 Claude 모델에 액세스

​
기업 인프라

엔터프라이즈 네트워크

조직의 프록시 서버 및 SSL/TLS 요구사항과 함께 작동하도록 Claude Code 구성

LLM Gateway

사용량 추적, 예산 책정 및 감사 로깅을 통한 중앙 집중식 모델 액세스 배포

​
구성 개요

Claude Code는 다양한 제공업체와 인프라를 결합할 수 있는 유연한 구성 옵션을 지원합니다:

다음의 차이점을 이해하세요:

  • 기업 프록시: 트래픽 라우팅을 위한 HTTP/HTTPS 프록시 (HTTPS_PROXY 또는 HTTP_PROXY를 통해 설정)
  • LLM Gateway: 인증을 처리하고 제공업체 호환 엔드포인트를 제공하는 서비스 (ANTHROPIC_BASE_URL, ANTHROPIC_BEDROCK_BASE_URL 또는 ANTHROPIC_VERTEX_BASE_URL을 통해 설정)

두 구성 모두 함께 사용할 수 있습니다.

​
기업 프록시와 함께 Bedrock 사용

기업 HTTP/HTTPS 프록시를 통해 Bedrock 트래픽 라우팅:

# Bedrock 활성화
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# 기업 프록시 구성
export HTTPS_PROXY='https://proxy.example.com:8080'

​
LLM Gateway와 함께 Bedrock 사용

Bedrock 호환 엔드포인트를 제공하는 게이트웨이 서비스 사용:

# Bedrock 활성화
export CLAUDE_CODE_USE_BEDROCK=1

# LLM 게이트웨이 구성
export ANTHROPIC_BEDROCK_BASE_URL='https://your-llm-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1  # 게이트웨이가 AWS 인증을 처리하는 경우

​
기업 프록시와 함께 Vertex AI 사용

기업 HTTP/HTTPS 프록시를 통해 Vertex AI 트래픽 라우팅:

# Vertex 활성화
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

# 기업 프록시 구성
export HTTPS_PROXY='https://proxy.example.com:8080'

​
LLM Gateway와 함께 Vertex AI 사용

중앙 집중식 관리를 위해 Google Vertex AI 모델과 LLM 게이트웨이 결합:

# Vertex 활성화
export CLAUDE_CODE_USE_VERTEX=1

# LLM 게이트웨이 구성
export ANTHROPIC_VERTEX_BASE_URL='https://your-llm-gateway.com/vertex'
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1  # 게이트웨이가 GCP 인증을 처리하는 경우

​
인증 구성

Claude Code는 필요할 때 Authorization 헤더에 ANTHROPIC_AUTH_TOKEN을 사용합니다. SKIP_AUTH 플래그 (CLAUDE_CODE_SKIP_BEDROCK_AUTH, CLAUDE_CODE_SKIP_VERTEX_AUTH)는 게이트웨이가 제공업체 인증을 처리하는 LLM 게이트웨이 시나리오에서 사용됩니다.

​
올바른 배포 구성 선택

배포 접근 방식을 선택할 때 다음 요소들을 고려하세요:

​
직접 제공업체 액세스

다음과 같은 조직에 가장 적합:

  • 가장 간단한 설정을 원하는 경우
  • 기존 AWS 또는 GCP 인프라가 있는 경우
  • 제공업체 네이티브 모니터링 및 규정 준수가 필요한 경우

​
기업 프록시

다음과 같은 조직에 가장 적합:

  • 기존 기업 프록시 요구사항이 있는 경우
  • 트래픽 모니터링 및 규정 준수가 필요한 경우
  • 모든 트래픽을 특정 네트워크 경로를 통해 라우팅해야 하는 경우

​
LLM Gateway

다음과 같은 조직에 가장 적합:

  • 팀 간 사용량 추적이 필요한 경우
  • 모델 간 동적 전환을 원하는 경우
  • 사용자 정의 속도 제한 또는 예산이 필요한 경우
  • 중앙 집중식 인증 관리가 필요한 경우

​
디버깅

배포를 디버깅할 때:

  • claude /status 슬래시 명령을 사용하세요. 이 명령은 적용된 인증, 프록시 및 URL 설정에 대한 가시성을 제공합니다.
  • 요청을 로그하려면 환경 변수 export ANTHROPIC_LOG=debug를 설정하세요.

​
조직을 위한 모범 사례

​
1. 문서화 및 메모리에 투자

Claude Code가 코드베이스를 이해할 수 있도록 문서화에 투자할 것을 강력히 권장합니다. 조직은 여러 수준에서 CLAUDE.md 파일을 배포할 수 있습니다:

  • 조직 전체: 회사 전체 표준을 위해 /Library/Application Support/ClaudeCode/CLAUDE.md (macOS)와 같은 시스템 디렉토리에 배포

  • 저장소 수준: 프로젝트 아키텍처, 빌드 명령 및 기여 가이드라인을 포함하는 저장소 루트에 CLAUDE.md 파일 생성. 모든 사용자가 혜택을 받을 수 있도록 소스 제어에 체크인

    자세히 알아보기.

​
2. 배포 간소화

사용자 정의 개발 환경이 있는 경우, Claude Code를 설치하는 “원클릭” 방법을 만드는 것이 조직 전체에서 채택을 늘리는 핵심입니다.

​
3. 가이드된 사용으로 시작

새로운 사용자가 코드베이스 Q&A 또는 작은 버그 수정이나 기능 요청에 Claude Code를 시도하도록 권장하세요. Claude Code에게 계획을 세우도록 요청하세요. Claude의 제안을 확인하고 잘못된 방향으로 가고 있다면 피드백을 주세요. 시간이 지나면서 사용자가 이 새로운 패러다임을 더 잘 이해하게 되면, Claude Code가 더 자율적으로 실행되도록 하는 데 더 효과적이 될 것입니다.

​
4. 보안 정책 구성

보안 팀은 Claude Code가 할 수 있는 것과 할 수 없는 것에 대한 관리 권한을 구성할 수 있으며, 이는 로컬 구성으로 덮어쓸 수 없습니다. 자세히 알아보기.

​
5. 통합을 위한 MCP 활용

MCP는 티켓 관리 시스템이나 오류 로그에 연결하는 것과 같이 Claude Code에 더 많은 정보를 제공하는 좋은 방법입니다. 중앙 팀이 MCP 서버를 구성하고 모든 사용자가 혜택을 받을 수 있도록 .mcp.json 구성을 코드베이스에 체크인하는 것을 권장합니다. 자세히 알아보기.

Anthropic에서는 모든 Anthropic 코드베이스에서 개발을 지원하기 위해 Claude Code를 신뢰합니다. 저희만큼 Claude Code 사용을 즐기시기 바랍니다!

​
다음 단계