메인 콘텐츠로 건너뛰기
이 페이지는 사용 가능한 배포 옵션의 개요를 제공하며 조직에 맞는 올바른 구성을 선택하는 데 도움을 줍니다.

공급자 비교

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

클라우드 공급자

기업 인프라

구성 개요

Claude Code는 다양한 공급자 및 인프라를 결합할 수 있는 유연한 구성 옵션을 지원합니다:
다음의 차이점을 이해하세요:
  • 기업 프록시: 트래픽 라우팅을 위한 HTTP/HTTPS 프록시 (HTTPS_PROXY 또는 HTTP_PROXY를 통해 설정)
  • LLM 게이트웨이: 인증을 처리하고 공급자 호환 엔드포인트를 제공하는 서비스 (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 게이트웨이와 함께 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 게이트웨이와 함께 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 게이트웨이

다음 조직에 최적:
  • 팀 간 사용량 추적이 필요한 경우
  • 모델 간 동적 전환을 원하는 경우
  • 사용자 정의 속도 제한 또는 예산이 필요한 경우
  • 중앙화된 인증 관리가 필요한 경우

디버깅

배포를 디버깅할 때:
  • 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에서는 Claude Code를 신뢰하여 모든 Anthropic 코드베이스 전체에서 개발을 강화합니다. Claude Code를 우리만큼 즐기시길 바랍니다!

다음 단계