Claude Code는 Anthropic 직접 연동부터 AWS, GCP, Azure 클라우드 제공업체까지 다양한 배포 옵션을 지원합니다. 이 가이드는 조직의 인프라 요구사항에 맞는 최적의 배포 방식을 선택하고 구성하는 방법을 안내합니다.
배포 옵션 비교
대부분의 조직에는 Claude for Teams 또는 Claude for Enterprise가 최적의 경험을 제공합니다. 팀원들이 단일 구독으로 Claude Code와 웹 Claude 모두에 접근할 수 있으며, 중앙화된 청구 관리와 별도의 인프라 설정이 필요하지 않습니다.
Claude for Teams
셀프서비스 방식으로 협업 기능, 관리자 도구, 청구 관리를 포함합니다. 빠르게 시작해야 하는 소규모 팀에 적합합니다.
- 가격: 시트당 $150/월 (Premium), PAYG 옵션 제공
- 인증: Claude.ai SSO 또는 이메일
- 비용 추적: 사용량 대시보드
- 웹 Claude 포함: 예
Claude for Enterprise
SSO 및 도메인 캡처, 역할 기반 권한, 컴플라이언스 API 접근, 조직 전체 Claude Code 구성을 위한 관리형 정책 설정을 추가로 제공합니다. 보안 및 컴플라이언스 요구사항이 있는 대규모 조직에 적합합니다.
- 가격: 영업팀 문의
- 엔터프라이즈 기능: 팀 관리, SSO, 사용량 모니터링
- 웹 Claude 포함: 예
클라우드 제공업체 옵션
특정 인프라 요구사항이 있는 조직을 위한 클라우드 제공업체 통합 옵션도 제공됩니다.
| 기능 | Anthropic Console | Amazon Bedrock | Google Vertex AI | Microsoft Foundry |
|---|---|---|---|---|
| 최적 대상 | 개인 개발자 | AWS 네이티브 배포 | GCP 네이티브 배포 | Azure 네이티브 배포 |
| 청구 | PAYG | AWS를 통한 PAYG | GCP를 통한 PAYG | Azure를 통한 PAYG |
| 인증 | API 키 | API 키 또는 AWS 자격증명 | GCP 자격증명 | API 키 또는 Microsoft Entra ID |
| 비용 추적 | 사용량 대시보드 | AWS Cost Explorer | GCP Billing | Azure Cost Management |
| 엔터프라이즈 기능 | 없음 | IAM 정책, CloudTrail | IAM 역할, Cloud Audit Logs | RBAC 정책, Azure Monitor |
| 웹 Claude 포함 | 아니오 | 아니오 | 아니오 | 아니오 |
모든 옵션에서 프롬프트 캐싱은 기본적으로 활성화되어 있습니다.
프록시 및 게이트웨이 구성
대부분의 조직은 추가 구성 없이 클라우드 제공업체를 직접 사용할 수 있습니다. 그러나 특정 네트워크 또는 관리 요구사항이 있는 경우 기업용 프록시나 LLM 게이트웨이를 구성해야 할 수 있습니다.
기업용 프록시 vs. LLM 게이트웨이
기업용 프록시: HTTP/HTTPS 프록시를 통해 트래픽을 라우팅합니다. 조직이 보안 모니터링, 컴플라이언스, 또는 네트워크 정책 시행을 위해 모든 아웃바운드 트래픽을 프록시 서버를 통과시켜야 하는 경우 사용합니다.
export HTTPS_PROXY='https://proxy.example.com:8080'
export HTTP_PROXY='https://proxy.example.com:8080'
LLM 게이트웨이: Claude Code와 클라우드 제공업체 사이에서 인증 및 라우팅을 처리하는 서비스입니다. 팀 전반의 중앙화된 사용량 추적, 커스텀 요금 제한 또는 예산, 중앙화된 인증 관리가 필요한 경우 사용합니다.
이 두 구성은 함께 사용할 수 있습니다.
Amazon Bedrock 프록시/게이트웨이 구성
기업용 프록시:
# Bedrock 활성화
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
# 기업용 프록시 구성
export HTTPS_PROXY='https://proxy.example.com:8080'
LLM 게이트웨이:
# 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 인증을 처리하는 경우
Microsoft Foundry 프록시/게이트웨이 구성
기업용 프록시:
# Microsoft Foundry 활성화
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource
export ANTHROPIC_FOUNDRY_API_KEY=your-api-key # Entra ID 인증 시 생략 가능
# 기업용 프록시 구성
export HTTPS_PROXY='https://proxy.example.com:8080'
LLM 게이트웨이:
# Microsoft Foundry 활성화
export CLAUDE_CODE_USE_FOUNDRY=1
# LLM 게이트웨이 구성
export ANTHROPIC_FOUNDRY_BASE_URL='https://your-llm-gateway.com'
export CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1 # 게이트웨이가 Azure 인증을 처리하는 경우
Google 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 활성화
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에서
/status명령을 사용하면 프록시 및 게이트웨이 구성이 올바르게 적용되었는지 확인할 수 있습니다.
조직을 위한 모범 사례
문서화 및 메모리에 투자하기
Claude Code가 코드베이스를 이해할 수 있도록 문서화에 투자하는 것을 강력히 권장합니다. 조직은 여러 수준에서 CLAUDE.md 파일을 배포할 수 있습니다.
조직 전체: 회사 전체 표준을 위해 시스템 디렉터리에 배포합니다.
- macOS:
/Library/Application Support/ClaudeCode/CLAUDE.md
저장소 수준: 프로젝트 아키텍처, 빌드 명령, 기여 가이드라인을 포함하여 저장소 루트에 CLAUDE.md 파일을 생성합니다. 모든 사용자가 혜택을 받을 수 있도록 소스 컨트롤에 체크인합니다.
배포 간소화
커스텀 개발 환경이 있는 경우, 조직 전체의 채택을 늘리는 핵심은 Claude Code를 "원클릭"으로 설치할 수 있는 방법을 만드는 것입니다.
가이드 사용으로 시작하기
새 사용자에게 코드베이스 Q&A나 소규모 버그 수정 및 기능 요청부터 Claude Code를 시도해 보도록 장려합니다. Claude Code에게 계획을 세워달라고 요청하고, 제안 사항을 확인하며 방향이 잘못된 경우 피드백을 제공하세요. 시간이 지남에 따라 사용자들이 이 새로운 패러다임을 더 잘 이해하게 되면, Claude Code를 더 자율적으로 실행하는 데 더 효과적이 됩니다.
클라우드 제공업체의 모델 버전 고정
Bedrock, Vertex AI, 또는 Foundry를 통해 배포하는 경우, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL을 사용하여 특정 모델 버전을 고정하세요. 버전을 고정하지 않으면 Claude Code 별칭이 최신 버전으로 해석되어, Anthropic이 계정에서 아직 활성화되지 않은 새 모델을 출시할 때 사용자에게 문제가 발생할 수 있습니다.
보안 정책 구성
보안 팀은 Claude Code가 허용하거나 허용하지 않을 작업에 대한 관리형 권한을 구성할 수 있으며, 이는 로컬 구성으로 덮어쓸 수 없습니다.
통합을 위한 MCP 활용
MCP는 티켓 관리 시스템이나 오류 로그에 연결하는 등 Claude Code에 더 많은 정보를 제공하는 훌륭한 방법입니다. 한 중앙 팀이 MCP 서버를 구성하고 .mcp.json 구성을 코드베이스에 체크인하여 모든 사용자가 혜택을 받을 수 있도록 권장합니다.
다음 단계
배포 옵션을 선택하고 팀을 위한 접근 권한을 구성한 후:
- 팀에 배포: 설치 지침을 공유하고 팀원들이 Claude Code를 설치하고 자격증명으로 인증하도록 합니다.
- 공유 구성 설정: 저장소에 CLAUDE.md 파일을 생성하여 Claude Code가 코드베이스와 코딩 표준을 이해하도록 돕습니다.
- 권한 구성: 보안 설정을 검토하여 Claude Code가 환경에서 할 수 있는 것과 할 수 없는 것을 정의합니다.
- 클라우드 제공업체 설정: 특정 클라우드 제공업체 통합을 위한 상세 가이드를 참조합니다.