엔터프라이즈 배포 개요

Claude Code가 다양한 타사 서비스 및 인프라와 통합하여 엔터프라이즈 배포 요구사항을 충족하는 방법을 알아보세요.

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

제공업체 비교

기능	Anthropic	Amazon Bedrock	Google Vertex AI
지역	지원되는 국가	여러 AWS 지역	여러 GCP 지역
프롬프트 캐싱	기본적으로 활성화됨	기본적으로 활성화됨	기본적으로 활성화됨
인증	API 키	AWS 자격 증명 (IAM)	GCP 자격 증명 (OAuth/Service Account)
비용 추적	대시보드	AWS Cost Explorer	GCP Billing
엔터프라이즈 기능	팀, 사용량 모니터링	IAM 정책, CloudTrail	IAM 역할, 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 사용을 즐기시기 바랍니다!

다음 단계

• AWS 네이티브 배포를 위한 Amazon Bedrock 설정
• GCP 배포를 위한 Google Vertex AI 구성
• 네트워크 요구사항을 위한 엔터프라이즈 네트워크 구성
• 엔터프라이즈 관리를 위한 LLM Gateway 배포
• 구성 옵션 및 환경 변수를 위한 설정