엔터프라이즈 배포·서드파티 통합 개요
기준일: 2026-07-26
난이도: 중급
공식 기준: Enterprise deployment overview
조직은 Claude Code를 Anthropic 직접 또는 클라우드 프로바이더를 통해 배포할 수 있습니다. 이 페이지는 배포 옵션 비교, 프록시/게이트웨이 설정, 조직 모범 사례를 다룹니다.
개요
대부분 조직에는 Claude for Teams / Enterprise가 가장 적합합니다. 단일 구독으로 Claude Code + 웹 Claude, 중앙 청구, 인프라 설정 불필요.
| 플랜 | 특징 |
|---|---|
| Teams | 셀프서비스, 협업·관리·청구. 빠른 시작 소규모 팀 |
| Enterprise | SSO·도메인 캡처, RBAC, 컴플라이언스 API, managed policy로 조직 전역 Claude Code 설정 |
조직 전체 배포·SSO·중앙 청구는 Contact sales / Pricing.
핵심 개념 — 배포 옵션 비교
| 기능 | Teams/Enterprise | Anthropic Console | Amazon Bedrock | Claude Platform on AWS | Google Cloud Agent Platform (구 Vertex AI) | Microsoft Foundry |
|---|---|---|---|---|---|---|
| 최적 | 대부분 조직(권장) | 개인 개발자 | AWS 네이티브 | AWS Marketplace 청구 + Claude API 기능 | GCP 네이티브 | Azure 네이티브 |
| 청구 | Teams: $150/seat(Premium)+PAYG / Enterprise: 영업 | PAYG | AWS PAYG | AWS Marketplace PAYG | GCP PAYG | Azure PAYG |
| 지역 | 지원 국가 | 동일 | 다수 AWS 리전 | 다수 AWS | 다수 GCP | 다수 Azure |
| Prompt caching | 기본 on | 기본 on | 기본 on | 기본 on | 기본 on | 기본 on |
| 인증 | Claude.ai SSO/email | API key | API key 또는 AWS 자격 증명 | 동일 | GCP 자격 증명 | API key 또는 Entra ID |
| 비용 추적 | Usage dashboard | Usage dashboard | Cost Explorer | Cost Explorer | GCP Billing | Azure Cost Management |
| Claude 웹 포함 | 예 | 아니오 | 아니오 | 아니오 | 아니오 | 아니오 |
| 엔터프라이즈 기능 | 팀 관리, SSO, 사용량 모니터링 | 없음 | IAM, CloudTrail | IAM, CloudTrail | IAM, Audit Logs | RBAC, Azure Monitor |
기능 가용성 세부: Feature availability.
설정 문서 링크
- Teams/Enterprise 인증
- Anthropic Console
- Claude apps gateway — Bedrock/Platform/Agent Platform/Foundry/API 앞 IdP
- Amazon Bedrock
- Claude Platform on AWS
- Google Cloud Agent Platform
- Microsoft Foundry
Bedrock·Vertex: claude 실행 후 로그인 프롬프트에서 3rd-party platform 선택 시 인터랙티브 위저드.
상세 — 프록시와 게이트웨이
| 구성 | 용도 | 환경 변수 |
|---|---|---|
| Corporate proxy | 아웃바운드 전부 프록시(보안 모니터링·정책) | HTTPS_PROXY / HTTP_PROXY |
| LLM Gateway | 인증·라우팅·사용량·예산 중앙화 | ANTHROPIC_BASE_URL, ANTHROPIC_BEDROCK_BASE_URL, ANTHROPIC_AWS_BASE_URL, ANTHROPIC_VERTEX_BASE_URL, ANTHROPIC_FOUNDRY_BASE_URL |
둘을 함께 쓸 수 있습니다. 네트워크 상세: Enterprise network configuration, LLM gateways.
Amazon Bedrock
Corporate proxy:
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export HTTPS_PROXY='https://proxy.example.com:8080'
LLM Gateway:
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-llm-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1 # 게이트웨이가 AWS auth 처리 시
Microsoft Foundry
# proxy
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'
# gateway
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_BASE_URL='https://your-llm-gateway.com'
export ANTHROPIC_FOUNDRY_API_KEY=your-gateway-key # x-api-key
Google Cloud Agent Platform
# proxy
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'
# gateway
export CLAUDE_CODE_USE_VERTEX=1
export ANTHROPIC_VERTEX_BASE_URL='https://your-llm-gateway.com/vertex'
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
export CLOUD_ML_REGION=us-east5
검증: 세션에서 /status — 예) API provider: Amazon Bedrock, Bedrock base URL, Proxy 줄 확인.
상세 — 조직 모범 사례
문서·메모리 투자
- 조직 전역: macOS
/Library/Application Support/ClaudeCode/CLAUDE.md, Linux/WSL/etc/claude-code/CLAUDE.md, WindowsC:\Program Files\ClaudeCode\CLAUDE.md - 저장소 루트
CLAUDE.md(아키텍처·빌드·기여 가이드)를 소스 관리 - Memory
- 조직 전역: macOS
원클릭 설치 — 커스텀 환경일수록 설치 경로를 단순화해 채택 촉진
가이드 사용으로 시작 — 코드 Q&A, 작은 버그픽스, 계획 요청 후 피드백. 에이전틱 자율 확대는 이해 이후
클라우드 프로바이더 모델 버전 pin
ANTHROPIC_DEFAULT_FABLE_MODEL,ANTHROPIC_DEFAULT_OPUS_MODEL,ANTHROPIC_DEFAULT_SONNET_MODEL,ANTHROPIC_DEFAULT_HAIKU_MODEL
pin 없으면 alias가 프로바이더별 내장 기본(최신보다 늦을 수 있음)으로 해석. Model config보안 정책 — managed permissions로 로컬이 덮어쓸 수 없는 허용/거부. Security
MCP 통합 — 중앙 팀이
.mcp.json을 체크인해 티켓·에러 로그 등 공유. MCP
체크리스트
- Teams/Enterprise vs 클라우드 프로바이더 중 배포 경로를 골랐다
- 프록시/게이트웨이 필요 여부를 네트워크 정책과 맞춰 설정했다
-
/status로 provider·base URL·proxy를 확인했다 - 조직/저장소 CLAUDE.md와 managed permissions를 준비했다
- 서드파티 배포 시 모델 pin 전략을 정했다
다음 단계
공식 원문: https://code.claude.com/docs/en/third-party-integrations