Claude Code 공식문서 리뷰-Deployment[2] : Amazon Bedrock의 Claude Code(Claude Code on Amazon Bedrock)

안녕하세요! 갓대희입니다. 

Claude Code Docs 공식 문서 >> Deployment 섹션의 내용 중 [Amazon Bedrock의 Claude Code]를 살펴 보려고 합니다.

이번 섹션 부터는 영문, 한글번역본이 모두 공식문서로 존재하는 섹션이니 한글 문서를 편하게 참고 하셔도 될 것 같습니다.

https://code.claude.com/docs/ko/amazon-bedrock

Amazon Bedrock의 Claude Code - Claude Code Docs

 

이 카테고리의 글은 편하게 공식 문서 위주의 내용을 눈으로 쭉 살펴 보고 넘어가는 목적을 갖고 시작 하게 되었습니다.

저도 초심으로 돌아가 기초적읜 글을 살펴보다보니, 지금와서 클로드에서 강조 하고자 하는 원칙이 어떤건지 되돌아볼 수 있는 계기가 되기도 하는 것 같아, 다른 분들도 꼭 한번 눈으로라도 이해 하고 넘어가는것이 좋다고 생각하여 공식 문서의 내용을 억지로 리뷰해보게 되었습니다. 

 

 

이미 AWS를 쓰고 있는가?

회사에서 AWS 인프라를 쓰고 있다면, Claude Code를 Bedrock으로 연동하는 것이 가장 자연스러운 선택이다. 기존 AWS 계정, IAM 정책, SSO 인증을 그대로 활용할 수 있고, AWS 콘솔에서 비용과 사용량을 통합 관리할 수 있다.

Amazon Bedrock이란?
AWS에서 제공하는 완전 관리형 AI 서비스다. Claude를 포함한 여러 AI 모델을 AWS 인프라 내에서 사용할 수 있어서, 회사의 보안 정책을 그대로 적용할 수 있다.

Bedrock을 선택하면 좋은 경우

• 회사에서 이미 AWS를 주력 클라우드로 사용 중
• AWS IAM과 SSO로 팀 권한을 관리하고 있음
• AWS Cost Explorer로 비용을 통합 관리하고 싶음
• VPC, 프라이빗 서브넷 등 AWS 보안 정책 준수 필요

 

시작하기 전에 준비할 것들

걱정할 필요 없다! 대부분 AWS 사용자라면 이미 갖춰져 있을 항목들이다. 체크리스트처럼 하나씩 확인해 보자.

필수 항목

• AWS 계정 - Bedrock 서비스를 사용할 수 있는 계정
  → AWS 콘솔에서 Bedrock 메뉴가 보이면 OK
• Claude 모델 접근 권한 - Bedrock에서 Claude Sonnet 4.5 또는 Haiku 4.5 사용 승인
  → 처음이라면 1단계에서 사용 사례 제출 필요 (계정당 1회만)
• IAM 권한 - Bedrock API를 호출할 수 있는 권한
  → 자세한 설정은 아래 "IAM 구성" 섹션 참고

선택 항목 (있으면 편리)

• AWS CLI - 터미널에서 aws configure로 쉽게 인증 설정 가능
• AWS SSO 설정 - 회사에서 SSO 쓴다면 더 편리하게 로그인 가능

 

설정 프로세스

1단계: 사용 사례 세부 정보 제출

처음 Bedrock에서 Claude를 쓰는가?
걱정할 필요 없다! AWS 계정당 딱 한 번만 하면 되는 간단한 절차다. AWS에서 "어떤 용도로 Claude를 쓸 건지" 확인하는 과정이다.

진행 순서

1. IAM 권한 확인
   → 자신의 AWS 계정에 Bedrock 접근 권한이 있는지 확인 (보통 관리자 권한이면 OK)
2. Amazon Bedrock 콘솔로 이동
   → AWS 콘솔 검색창에 "Bedrock" 입력
3. Chat/Text playground 선택
   → 왼쪽 메뉴에서 "Playgrounds" → "Chat" 클릭
4. Anthropic 모델 선택 후 사용 사례 양식 작성
   → 모델 선택 시 Claude Sonnet 4.5를 선택하면 간단한 양식이 나온다
   → "개발 도구로 사용", "코드 작성 지원" 등 실제 사용 목적을 적으면 된다

이미 승인받았는지 확인하는 방법

Bedrock 콘솔에서 모델을 선택했을 때 "사용 사례 제출" 화면이 안 나오고 바로 테스트할 수 있다면, 이미 승인된 것이다!

2단계: AWS 자격 증명 구성 - 나에게 맞는 방법 선택하기

 어떤 방법을 선택해야 할까?

Claude Code는 AWS SDK 표준 자격 증명 체인을 사용한다. 각자의 상황에 맞는 방법을 아래에서 선택하자!

상황 1: "AWS CLI가 이미 설정되어 있어요"

개인 개발자이거나 이미 로컬에서 AWS CLI를 쓰고 있다면 가장 간단한 방법이다.

설정 방법

aws configure

→ Access Key ID와 Secret Key를 입력하면 ~/.aws/credentials에 저장된다.

상황 2: "회사에서 AWS SSO를 사용해요"

회사에서 Okta, Azure AD 같은 SSO로 AWS에 로그인한다면 이 방법을 쓰자. 매번 비밀번호 입력 없이 자동으로 인증된다.

설정 방법

# SSO 로그인
aws sso login --profile=my-company-profile

# 프로필 환경 변수 설정
export AWS_PROFILE=my-company-profile

→ 회사 SSO 로그인 페이지가 열리고, 인증 후 자동으로 자격 증명이 갱신된다.

상황 3: "CI/CD 파이프라인에서 사용해요"

GitHub Actions, GitLab CI, Jenkins 같은 자동화 환경에서 사용할 때 적합하다.

설정 방법

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  # 임시 자격증명 사용 시

💡 보안 팁: GitHub Secrets, AWS Secrets Manager를 사용해서 키를 안전하게 관리하자.

상황 4: "Bedrock API 키를 발급받았어요"

AWS에서 Bedrock 전용 API 키를 발급받은 경우 (드문 경우)

설정 방법

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

상황 5: "일단 빠르게 테스트해보고 싶어요"

AWS 콘솔에서 빠르게 로그인하여 테스트할 때

설정 방법

aws login

→ AWS 콘솔 로그인 페이지가 열린다. 로그인하면 임시 자격 증명이 생성된다.

 

고급: SSO 자격 증명 자동 갱신

이런 경험 있는가?

Claude Code 쓰다가 "자격 증명이 만료되었습니다" 에러를 보고, 매번 aws sso login을 수동으로 실행하는 게 번거로웠는가? 자동 갱신 설정을 해두면 Claude Code가 알아서 자격 증명을 갱신해 준다!

Claude Code 설정 파일(~/.claude/config.json)에 다음 내용을 추가하자:

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

이렇게 동작한다

1. Claude Code가 API 호출을 시도한다
2. 자격 증명이 만료되었다면 awsAuthRefresh 명령을 자동 실행
3. SSO 로그인 페이지가 열리고, 로그인하면 자격 증명 갱신 완료
4. 자동으로 API 호출을 재시도한다

 

설정 옵션 비교

옵션	언제 사용하는가?
awsAuthRefresh	AWS SSO 사용 시 (권장) ~/.aws/credentials 파일을 수정하는 명령어 실행
awsCredentialExport	커스텀 인증 시스템 사용 시 자격 증명을 JSON으로 직접 반환하는 명령어 실행 (고급 사용자용)

 

3단계: Claude Code가 Bedrock을 쓰도록 설정

이 단계에서 하는 일

Claude Code는 기본적으로 Anthropic API를 직접 호출한다. Bedrock을 사용하려면 "Bedrock을 통해 호출하라"고 명시적으로 알려줘야 한다.

 

셸 설정 파일(~/.zshrc 또는 ~/.bashrc)에 다음을 추가하자:

# Bedrock 통합 활성화 (필수)
export CLAUDE_CODE_USE_BEDROCK=1

# AWS 리전 설정 (필수)
export AWS_REGION=us-east-1  # 또는 원하는 리전

# 선택: Haiku 모델을 다른 리전에서 사용하고 싶을 때
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

각 설정의 의미

CLAUDE_CODE_USE_BEDROCK=1	Claude Code에게 "Bedrock API를 써라"고 알려준다
AWS_REGION=us-east-1	어느 AWS 리전의 Bedrock을 쓸지 지정. 반드시 필요하다! ( ~/.aws/config에서 자동으로 읽지 않음)
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION	Haiku 같은 작은 모델만 다른 리전에서 쓰고 싶을 때 (선택 사항)

⚠️ 알아두자

• Bedrock 사용 시 Claude Code의 /login, /logout 명령은 비활성화된다
  → AWS 인증 방식으로만 로그인하기 때문
• AWS_PROFILE 같은 민감한 환경 변수는 셸 설정 파일보다 Claude Code 설정 파일(~/.claude/config.json)에 넣는 것이 안전하다
  → 다른 프로그램으로 변수가 유출되는 것을 방지

 

4단계: 모델 구성 - 작업에 맞는 모델 선택하기

🤔 Sonnet vs Haiku, 어떤 걸 써야 할까?

Claude Code는 상황에 따라 두 가지 모델을 자동으로 전환한다. 직접 선택할 필요는 없지만, 어떻게 동작하는지 알아두면 유용하다.

기본 모델 설정 (자동 선택)

Sonnet 4.5 기본 모델 (복잡한 작업)	언제 사용? 코드 작성, 리팩토링, 복잡한 분석 기본값: global.anthropic.claude-sonnet-4-5-20250929-v1:0
Haiku 4.5 소형/빠른 모델 (빠른 작업)	언제 사용? 파일 탐색, 간단한 검색, 빠른 응답 필요 시 기본값: us.anthropic.claude-haiku-4-5-20251001-v1:0

💡 사용 예시

• Sonnet 사용: "이 함수를 리팩토링해줘", "새로운 API 엔드포인트를 만들어줘"
• Haiku 사용: "이 에러 메시지를 찾아줘", "프로젝트 구조를 보여줘"

 

커스터마이징: 필요시 모델 변경하기

대부분의 경우 기본 설정으로 충분하다!

하지만 다음과 같은 경우 모델을 직접 지정할 수 있다:

• 특정 리전의 모델을 사용하고 싶을 때
• 회사에서 특정 추론 프로필 ARN을 지정했을 때
• 비용 절감을 위해 항상 Haiku를 쓰고 싶을 때

# 방법 1: 추론 프로필 ID 사용 (일반적)
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-5-20250929-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

# 방법 2: 애플리케이션 추론 프로필 ARN 사용 (회사에서 지정한 경우)
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

# 선택: 프롬프트 캐싱 비활성화 (캐싱 비용을 피하고 싶을 때)
export DISABLE_PROMPT_CACHING=1

각 설정의 의미

ANTHROPIC_MODEL	메인 모델 지정 (복잡한 작업용 Sonnet)
ANTHROPIC_SMALL_FAST_MODEL	빠른 작업용 모델 지정 (Haiku)
DISABLE_PROMPT_CACHING	프롬프트 캐싱 끄기 (비용 예측 가능하게 하려면 1로 설정)

 Haiku 3.5 → 4.5 업그레이드 주의

Claude Code는 Haiku 3.5에서 4.5로 자동 업그레이드하지 않는다. 수동으로 업그레이드하려면 다음을 설정하자:

export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

 

5단계: 출력 토큰 구성 - 안정적인 동작 보장하기

이런 경험 있는가?

Claude Code가 코드를 작성하다가 갑자기 멈추거나, "응답이 잘렸습니다"라는 메시지를 본 적이 있는가? 대부분 토큰 제한 때문이다. 출력 토큰 설정을 제대로 하면 이런 문제를 예방할 수 있다.

권장 설정

# ~/.zshrc 또는 ~/.bashrc에 추가
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096
export MAX_THINKING_TOKENS=1024

 각 설정의 의미

CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096

왜 4096인가?
Bedrock의 내부 스로틀링 로직이 최소 4096 토큰을 요구한다. 이보다 낮게 설정하면:

• 비용이 줄지 않음 (어차피 4096 토큰만큼 과금)
• 긴 코드 생성이 중간에 잘림
• 에이전트가 "작업을 완료하지 못했습니다" 에러 발생

실전 예시: 200줄짜리 파이썬 파일을 생성하라고 했는데 100줄에서 멈춤 → 토큰 제한 때문

MAX_THINKING_TOKENS=1024

왜 1024인가?
Claude가 내부적으로 "생각"하는 데 사용하는 토큰이다. 이 값을 적절히 설정하면:

• 복잡한 문제를 단계적으로 분석 가능
• 도구 사용(파일 읽기, 검색 등)이 잘리지 않음
• 코딩 작업에 집중된 추론 유지

실전 예시: 복잡한 버그 수정 시 Claude가 "먼저 에러 로그를 확인하고, 관련 코드를 찾고, 원인을 분석한 뒤..." 같은 단계적 사고를 할 수 있음

⚠️ 흔한 실수

• "비용 절감을 위해 2048로 줄여야지!"
  → Bedrock은 어차피 4096 기준으로 과금한다. 오히려 작업이 중간에 잘려서 재시도하느라 비용이 더 들 수 있다.
• "MAX_THINKING_TOKENS는 뭐지? 설정 안 해야겠다"
  → 설정하지 않으면 기본값이 너무 낮아서 복잡한 작업에서 에러가 발생할 수 있다.

정리: 대부분의 경우 위 권장 설정을 그대로 쓰자

특별한 이유가 없다면 CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096과 MAX_THINKING_TOKENS=1024를 그대로 사용하자. 이 설정은 Bedrock의 특성에 최적화되어 있으며, 대부분의 코딩 작업에서 안정적으로 동작한다.

 

 IAM 권한 설정 - Claude Code가 Bedrock에 접근하려면?

왜 IAM 설정이 필요한가?

Claude Code가 AWS Bedrock API를 호출하려면 "이 계정/사용자가 Bedrock을 쓸 권한이 있다"는 것을 AWS에 증명해야 한다. IAM 정책은 바로 이 권한을 정의하는 것이다.

필요한 권한 두 가지

1. Bedrock 모델 사용 권한	Claude 모델을 호출하고, 스트리밍 응답을 받고, 사용 가능한 모델 목록을 확인하는 권한
2. AWS Marketplace 권한	Bedrock이 내부적으로 Marketplace를 통해 모델을 불러올 때 필요 (자동으로 처리됨)

 

IAM 정책 생성 방법

아래 JSON을 복사해서 IAM 콘솔에 붙여넣으면 된다. AWS 콘솔 → IAM → Policies → Create policy → JSON 탭에 붙여넣기

{
  "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"  // Bedrock을 통한 호출만 허용
        }
      }
    }
  ]
}

보안 팁: 권한을 더 제한하고 싶다면?

위 정책은 모든 Bedrock 모델에 접근할 수 있다. 특정 모델만 허용하고 싶다면 Resource 부분을 특정 ARN으로 변경하자.

// 예: Claude Sonnet 4.5만 허용
"Resource": "arn:aws:bedrock:us-east-1:*:inference-profile/global.anthropic.claude-sonnet-4-5*"

회사에서 사용하는가? 전용 AWS 계정 추천

Claude Code용 AWS 계정을 별도로 만들면 이런 장점이 있다:

• 비용 추적: Claude Code 비용만 따로 확인 가능
• 보안 격리: 다른 AWS 리소스와 분리되어 더 안전
• 권한 관리: Bedrock만 접근 가능하도록 최소 권한 적용

→ AWS Organizations를 쓰고 있다면 멤버 계정 하나를 Claude Code 전용으로 할당하는 것도 좋은 방법이다.

 

문제 해결 - 자주 겪는 문제와 해결 방법

💡 문제 해결 팁

대부분의 Bedrock 연동 문제는 리전 설정, 모델 ID, 또는 권한 문제다. 아래 체크리스트를 순서대로 확인해 보자!

문제 1: "모델을 찾을 수 없습니다" / 리전 관련 에러

증상

• "Could not find model..." 에러 발생
• "Model not available in this region" 메시지
• Claude Code가 시작은 되는데 응답이 안 옴

원인

모든 AWS 리전에서 Claude 모델을 쓸 수 있는 게 아니다! 특정 리전만 지원하는데, 설정한 리전이 지원 리전인지 확인이 필요하다.

해결 방법

1단계: 현재 리전에서 사용 가능한 모델 확인

# 현재 리전에서 사용 가능한 모델 목록 확인
aws bedrock list-inference-profiles --region us-east-1

# 또는 다른 리전 확인
aws bedrock list-inference-profiles --region ap-northeast-2  # 서울

2단계: 지원 리전으로 변경

# ~/.zshrc 또는 ~/.bashrc에 추가
export AWS_REGION=us-east-1  # 대부분의 모델 지원

# 터미널 재시작 후 확인
echo $AWS_REGION

💡 추천 리전

• us-east-1 (버지니아): 대부분의 모델 지원, 가장 안정적
• us-west-2 (오레곤): 미국 서부, 빠른 응답
• ap-northeast-1 (도쿄): 한국에서 가까움 (일부 모델만 지원)

문제 2: "On-demand throughput isn't supported" 에러

증상

• "The on-demand throughput isn't supported for this model" 에러
• 모델 호출 시 바로 실패

원인

모델 ID를 직접 지정하면 (예: anthropic.claude-sonnet-4-5) Bedrock이 "예약 용량(provisioned throughput)"을 찾으려고 해서 실패한다. 추론 프로필 ID를 써야 한다!

해결 방법

ANTHROPIC_MODEL 환경 변수를 추론 프로필 ID로 변경하자:

# 잘못된 예 (직접 모델 ID)
export ANTHROPIC_MODEL='anthropic.claude-sonnet-4-5-20250929-v1:0'

# 올바른 예 (추론 프로필 ID)
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-5-20250929-v1:0'
#                        ^^^^^^^ 앞에 'global.' 또는 'us.' 붙음

💡 추론 프로필 ID 구분하는 법

• global.로 시작: 여러 리전에서 자동 라우팅
• us.로 시작: 특정 리전 고정 (Haiku 등)
• 점(.) 없이 시작: 일반 모델 ID (Bedrock에서 에러 발생!)

 문제 3: "Access Denied" / 권한 에러

증상

• "AccessDeniedException" 에러
• "User is not authorized to perform: bedrock:InvokeModel"

해결 방법

위 "IAM 권한 설정" 섹션의 정책이 제대로 적용되었는지 확인하자.
특히 다음을 체크:

1. IAM 정책이 현재 사용자/역할에 연결되어 있는지
2. bedrock:InvokeModel 권한이 포함되어 있는지
3. 리소스 ARN이 너무 제한적이지 않은지

문제 4: 자격 증명 만료 / SSO 로그인 필요

증상

• "Credentials have expired" 에러
• "The security token included in the request is expired"

해결 방법

SSO 사용 중이라면 자동 갱신 설정을 적용하자 (위 "2단계" 참고).
당장 해결하려면:

aws sso login --profile=your-profile-name

알아두면 좋은 제한사항

Claude Code와 Bedrock API

• 사용 API: Bedrock Invoke API
  → 스트리밍, 도구 사용(Tool Use), 프롬프트 캐싱 모두 지원
• 지원하지 않는 API: Bedrock Converse API
  → Claude Code는 Converse API를 사용하지 않는다 (Invoke API면 충분)
• 프롬프트 캐싱: 일부 리전에서만 지원
  → 캐싱 에러 발생 시 export DISABLE_PROMPT_CACHING=1로 비활성화

 

더 알아보기 - 유용한 자료 모음

💡 각 상황에 맞는 자료를 찾아보자

설정 중 막히거나, 더 깊이 알고 싶을 때 참고할 수 있는 공식 문서들이다.

리소스	언제 유용한가?
Bedrock 문서 AWS 공식 가이드	이럴 때 보자: • Bedrock이 처음이라 전반적으로 이해하고 싶을 때 • 모델 목록과 각 모델의 성능 비교가 필요할 때 • 보안 설정, VPC 연동 등 심화 내용을 알고 싶을 때
Bedrock 가격 요금 계산기	이럴 때 보자: • Claude Code 도입 전 예상 비용을 계산하고 싶을 때 • Sonnet vs Haiku 비용 차이를 비교하고 싶을 때 • 프롬프트 캐싱 사용 시 비용 절감 효과를 확인하고 싶을 때
Bedrock 추론 프로필 지원 가이드	이럴 때 보자: • "추론 프로필 ID"가 무엇인지 자세히 알고 싶을 때 • 각 리전에서 어떤 모델이 지원되는지 확인하고 싶을 때 • 크로스 리전 추론(Cross-Region Inference) 설정이 필요할 때
빠른 설정 가이드 Claude Code Bedrock	이럴 때 보자: • 위 가이드가 너무 길어서 핵심만 빠르게 보고 싶을 때 • 복사-붙여넣기로 5분 안에 설정을 끝내고 싶을 때 • 기본 설정만으로 충분하고 세부 설명은 필요 없을 때
모니터링 구현 GitHub 예제	이럴 때 보자: • 팀에서 Claude Code 사용량을 추적하고 싶을 때 • 비용을 실시간으로 모니터링해야 할 때 • CloudWatch나 로그 분석 시스템을 연동하고 싶을 때

도움이 더 필요한가?

• AWS Support: Bedrock 관련 기술 문제는 AWS Support 티켓으로 문의
  → 리전 이슈, IAM 권한 문제 등
• Claude Code GitHub: Claude Code 자체의 버그나 기능 요청
  → https://github.com/anthropics/claude-code
• 커뮤니티: Reddit, Stack Overflow에서 다른 사용자들의 경험 공유
  → 실전 팁, 비용 절감 노하우 등

 

핵심 요약 - 설정 체크리스트

빠르게 확인하자!

아래 항목들이 제대로 설정되어 있다면 Claude Code를 Bedrock에서 사용할 준비가 완료된 것이다.

항목	설정 내용
Bedrock 활성화	export CLAUDE_CODE_USE_BEDROCK=1 → ~/.zshrc 또는 ~/.bashrc에 추가
리전 설정	export AWS_REGION=us-east-1 (필수!) → 사용할 AWS 리전 지정
AWS 인증	다음 중 하나 선택: • AWS CLI (aws configure) • 환경 변수 (ACCESS_KEY_ID, SECRET_ACCESS_KEY) • SSO (aws sso login) • Bedrock API 키
기본 모델	• Sonnet 4.5: 복잡한 코딩 작업 • Haiku 4.5: 빠른 검색/탐색 → 자동 선택되므로 별도 설정 불필요
권장 토큰 설정	export CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096 export MAX_THINKING_TOKENS=1024 → 안정적인 동작을 위해 꼭 설정하자!
IAM 권한	• bedrock:InvokeModel • bedrock:InvokeModelWithResponseStream → 위 IAM 구성 섹션의 정책 사용

다음 단계

모든 설정이 완료되었다면 터미널을 재시작하고 Claude Code를 실행해 보자!

# 터미널 재시작 후
claude

# 또는
claude "간단한 Python 함수를 작성해줘"

→ 정상적으로 응답이 오면 성공!
→ 에러가 발생하면 위 "문제 해결" 섹션을 참고하자.

AWS Bedrock으로 Claude Code를 더 안전하고 효율적으로 사용하자!

기존 AWS 인프라와의 통합, IAM 권한 관리, 비용 통합 추적 등의 장점을 누릴 수 있다.