Claude Code Third-Party Integrations

Claude Code를 Anthropic 직접 연결이 아닌 third-party Cloud Provider(Amazon Bedrock, Google Vertex AI, Microsoft Foundry)를 통해 사용하는 방법. 기업 환경에서 보안, 비용 관리, 기존 인프라와의 통합을 위해 Cloud Provider를 경유하여 Claude Code를 배포할 수 있다.

해당 개념이 필요한 이유

• 기존 클라우드 인프라 활용: 이미 AWS/GCP/Azure를 사용하는 조직이 기존 결제, IAM, 모니터링 체계 안에서 Claude Code를 운영할 수 있다
• 보안 및 컴플라이언스: 기업 프록시, VPC, 감사 로그 등 조직의 보안 요구사항을 충족할 수 있다
• 비용 관리 일원화: Cloud Provider의 기존 비용 관리 도구(AWS Cost Explorer, GCP Billing 등)로 Claude 사용량을 추적할 수 있다. Cloud Provider를 경유하면 Anthropic에 별도 결제하는 것이 아니라 기존 클라우드 청구서에 합산된다
• 리전 선택: 데이터 주권(data sovereignty) 요구사항에 맞는 리전에서 모델을 실행할 수 있다

비용 청구 구조

Anthropic은 Cloud Provider(AWS/GCP/Azure)에게 모델을 제공하고, Cloud Provider가 최종 사용자에게 재판매하는 구조이다.

배포 방식	돈을 내는 곳	청구서
Anthropic 직접	Anthropic	Anthropic 청구서
Amazon Bedrock	AWS	AWS 청구서 (EC2, S3 등과 합산)
Google Vertex AI	GCP	GCP 청구서
Microsoft Foundry	Azure	Azure 청구서

기업이 이미 AWS에 월 수천만원을 쓰고 있다면, Claude 비용도 같은 AWS 청구서에 포함되어 별도 SaaS 결제 프로세스 없이 기존 재무/구매 체계로 관리할 수 있다.

AS-IS

sequenceDiagram
    autonumber
    participant Dev as Developer
    participant CC as Claude Code
    participant API as Anthropic API

    Dev->>CC: 코드 작성 요청
    CC->>API: 직접 API 호출 (api.anthropic.com)
    API-->>CC: 응답
    CC-->>Dev: 결과 표시

    Note over Dev,API: 단순하지만 기업 보안/비용 관리 체계 밖

TO-BE

sequenceDiagram
    autonumber
    participant Dev as Developer
    participant CC as Claude Code
    participant Proxy as Corporate Proxy / LLM Gateway
    participant Cloud as Cloud Provider (Bedrock/Vertex/Foundry)
    participant Model as Claude Model

    Dev->>CC: 코드 작성 요청
    CC->>Proxy: HTTPS_PROXY 또는 BASE_URL 경유
    Proxy->>Cloud: IAM 인증 + 요청 전달
    Cloud->>Model: 모델 호출
    Model-->>Cloud: 응답
    Cloud-->>Proxy: 응답 전달
    Proxy-->>CC: 응답
    CC-->>Dev: 결과 표시

    Note over Dev,Model: 기업 보안/비용/감사 체계 내에서 운영

5가지 배포 옵션 비교

Feature	Claude for Teams/Enterprise	Anthropic Console	Amazon Bedrock	Google Vertex AI	Microsoft Foundry
Best for	대부분의 조직 (권장)	개인 개발자	AWS 네이티브	GCP 네이티브	Azure 네이티브
과금	$150/seat (Premium)	PAYG	AWS PAYG	GCP PAYG	Azure PAYG
인증	SSO or email	API key	API key / AWS credentials	GCP credentials	API key / Entra ID
비용 추적	Usage dashboard	Usage dashboard	AWS Cost Explorer	GCP Billing	Azure Cost Management
웹 Claude 포함	Yes	No	No	No	No
Prompt Caching	기본 활성화	기본 활성화	기본 활성화	기본 활성화	기본 활성화
엔터프라이즈 기능	SSO, 팀 관리	없음	IAM, CloudTrail	IAM, Audit Logs	RBAC, Azure Monitor

선택 기준: 특별한 인프라 요구사항이 없다면 Claude for Teams/Enterprise가 권장. 기존 클라우드 인프라가 있다면 해당 Cloud Provider 선택.

Amazon Bedrock 설정 방법 (상세)

Step 1: 사전 요구사항

• AWS 계정 + Bedrock access 활성화
• 원하는 Claude 모델(e.g., Claude Sonnet 4.6) Bedrock에서 활성화
• 적절한 IAM 권한
• (선택) AWS CLI 설치

Step 2: Use Case 제출 (최초 1회)

1. Amazon Bedrock 콘솔 접속
2. Chat/Text playground 선택
3. Anthropic 모델을 선택하면 use case form 작성 프롬프트가 나옴
4. 작성 완료 후 모델 사용 가능

Step 3: AWS 자격 증명 설정

5가지 방법 중 선택:

# Option A: AWS CLI
aws configure
 
# Option B: 환경변수 (Access Key)
export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token
 
# Option C: SSO 프로필
aws sso login --profile=<your-profile-name>
export AWS_PROFILE=your-profile-name
 
# Option D: AWS Management Console
aws login
 
# Option E: Bedrock API Key (가장 간단)
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Step 4: Claude Code에서 Bedrock 활성화

# 필수: Bedrock 활성화
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # 필수! .aws config에서 읽지 않음
 
# 선택: Haiku 모델 리전 별도 지정
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

Step 5: 모델 버전 고정 (강력 권장)

# 모델 alias(sonnet, opus 등)가 최신 버전으로 자동 변경되어
# 계정에 활성화되지 않은 모델을 호출할 수 있으므로 반드시 고정
export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-6-v1'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

고정하지 않을 경우 기본값:

모델 타입	기본값
Primary	global.anthropic.claude-sonnet-4-6
Small/fast	us.anthropic.claude-haiku-4-5-20251001-v1:0

Step 6: IAM 정책 설정

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*",
        "arn:aws:bedrock:*:*:foundation-model/*"
      ]
    },
    {
      "Sid": "AllowMarketplaceSubscription",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:CalledViaLast": "bedrock.amazonaws.com"
        }
      }
    }
  ]
}

프록시 및 LLM Gateway 설정

기업 환경에서 추가로 설정할 수 있는 2가지 네트워크 옵션:

Corporate Proxy

조직의 모든 아웃바운드 트래픽이 프록시 서버를 경유해야 하는 경우:

# 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

인증, 라우팅, 사용량 추적을 중앙에서 관리하는 LLM Gateway 사용 시:

# Bedrock + 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  # LLM Gateway가 AWS 인증 처리 시

AWS 자격 증명 자동 갱신

SSO나 기업 ID 제공자를 사용하는 경우, Claude Code 설정 파일에 자동 갱신을 구성할 수 있다:

{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}

• awsAuthRefresh: .aws 디렉토리를 수정하는 명령 (SSO 브라우저 인증 등)
• awsCredentialExport: .aws 수정 불가 시 JSON으로 직접 자격 증명 반환

AWS Guardrails 연동

Bedrock Guardrails로 콘텐츠 필터링 적용:

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: your-guardrail-id\nX-Amzn-Bedrock-GuardrailVersion: 1"
  }
}

조직 배포 베스트 프랙티스

1. CLAUDE.md 문서 투자: 조직/레포지토리 레벨에서 CLAUDE.md 배포로 모든 사용자가 일관된 경험
2. 원클릭 설치 구성: 커스텀 개발 환경에서 간편한 설치 방법 제공
3. 점진적 도입: 코드베이스 Q&A → 작은 버그 수정 → 큰 기능 순으로 도입
4. 모델 버전 고정: Bedrock/Vertex/Foundry 사용 시 반드시 모델 버전 고정
5. MCP 활용: 티켓 관리, 에러 로그 등과의 연동을 위해 .mcp.json 공유

트러블슈팅

문제	해결 방법
리전 관련 에러	aws bedrock list-inference-profiles --region your-region으로 모델 가용성 확인
on-demand throughput 미지원 에러	inference profile ID로 모델 지정
자격 증명 만료	awsAuthRefresh 설정으로 자동 갱신 구성
/login, /logout 동작 안 함	Bedrock 사용 시 비활성화됨 (AWS credentials로 인증)

참고 문서

• Claude Code Third-Party Integrations
• Claude Code on Amazon Bedrock
• AWS Bedrock Documentation
• Bedrock Pricing
• Bedrock Inference Profiles
• Quick Setup Guide (AWS Community)