엔터프라이즈 배포 개요

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

​

제공업체 비교

​

클라우드 제공업체

​

기업 인프라

​

구성 개요

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

​

기업 프록시와 함께 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 및 Proxy-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 파일(메모리라고도 함)을 저장소의 루트에 만듭니다. 이 파일은 일반적으로 모든 사용자가 혜택을 받을 수 있도록 소스 제어에 체크인됩니다. 자세히 알아보기.
2. 사용자 정의 개발 환경이 있는 경우, Claude Code를 설치하는 “원클릭” 방법을 만드는 것이 조직 전체에서 채택을 늘리는 핵심이라는 것을 발견했습니다.
3. 새로운 사용자가 코드베이스 Q&A나 작은 버그 수정 또는 기능 요청에 Claude Code를 시도해보도록 권장하세요. Claude Code에게 계획을 세우도록 요청하세요. Claude의 제안을 확인하고 잘못된 방향으로 가고 있다면 피드백을 주세요. 시간이 지나면서 사용자가 이 새로운 패러다임을 더 잘 이해하게 되면, Claude Code가 더 에이전트적으로 실행되도록 하는 데 더 효과적이 될 것입니다.
4. 보안 팀은 Claude Code가 할 수 있는 것과 할 수 없는 것에 대한 관리 권한을 구성할 수 있으며, 이는 로컬 구성으로 덮어쓸 수 없습니다. 자세히 알아보기.
5. MCP는 티켓 관리 시스템이나 오류 로그에 연결하는 등 Claude Code에 더 많은 정보를 제공하는 좋은 방법입니다. 한 중앙 팀이 MCP 서버를 구성하고 모든 사용자가 혜택을 받을 수 있도록 .mcp.json 구성을 코드베이스에 체크인할 것을 권장합니다. 자세히 알아보기.

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

​

다음 단계

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