Claude Code를 Amazon Bedrock으로 사용하기 — Windows / macOS / Linux 환경별 설정 + 서울 리전 모델 + Inference Profile

• Claude Code를 Anthropic API 대신 Amazon Bedrock을 통해 실행하도록 설정, 서울 리전(ap-northeast-2) 사용 가능 모델 목록, Inference Profile 패턴, 환경변수 + settings.json 구성
• 적용 환경: Claude Code 2.1.172+ / Amazon Bedrock / AWS CLI / 1차 검증 시점: 2026-04-22
• GitHub 저장소: https://github.com/20eung/claude-code-use-bedrock

1. 왜 Bedrock 경유로 Claude Code를 쓰는가

이 글의 사연은 회사 내부 AI 워크플로우에서 출발합니다. 사내 AI 개발/응용 도구로 n8n 을 운영하면서 자연스럽게 Bedrock 을 사용하게 되었고, 이미 발급받아 사용 중인 Bedrock 인증 정보(AWS credentials)를 공유받았습니다. 그 다음 자연스러워진 질문은 “이 Bedrock 자격증명을 Claude Code 에서도 그대로 쓸 수 있는가” 였습니다. Claude Code 를 개인 인증으로만 쓰는 경우도 흔하지만, AWS 조직 안에서 Bedrock 계정으로 Claude Code 를 쓰는 사용자를 위한 셋업 절차가 정리된 한국어 자료가 부족해서 직접 검증하고 글로 남기게 되었습니다. 아래 세 가지 이유와 함께, 회사 Bedrock 자격증명을 받아 쓰기 시작할 때 참고할 수 있도록 단계별로 풀어냅니다.

Claude Code는 기본적으로 Anthropic API를 직접 호출하지만, AWS 조직 안에서는 Amazon Bedrock을 통해 호출하는 패턴이 흔합니다. 이유는 크게 세 가지입니다.

• 결제 / 비용 처리 = Anthropic API 직접 결제가 아니라 AWS Billing 으로 통합, 예산/비용 가시성/세금 처리 모두 AWS 단일 창구
• 데이터 주권 / 컴플라이언스 = 모델 호출이 AWS 리전 안에서만 발생, 데이터가 Anthropic 인프라로 나가지 않음 (서울 리전 사용 시 한국 데이터 주권)
• IAM 권한 통합 = 모델 접근 권한을 IAM role/policy 로 제어, 개발자별/프로젝트별로 다른 모델 권한 부여 가능

설정은 3단계로 끝납니다.
1. AWS credentials 등록
2. Bedrock 모델 access 활성화 (use case form)
3. 환경변수 1~3개로 Claude Code에 Bedrock 경로 지정

2. 환경별 AWS Credentials 등록

~/.aws/ 디렉터리에 config + credentials 두 파일을 만듭니다. region은 Bedrock 모델 권한을 받은 리전 (이 글에서는 서울 ap-northeast-2).

2.1 Windows CMD

mkdir "%USERPROFILE%\.aws" 2>NUL

(
echo [default]
echo region = ap-northeast-2
echo output = json
) > "%USERPROFILE%\.aws\config"

(
echo [default]
echo aws_access_key_id = YOUR_ACCESS_KEY_ID
echo aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
) > "%USERPROFILE%\.aws\credentials"

setx AWS_REGION "ap-northeast-2"
setx AWS_PROFILE "default"
setx CLAUDE_CODE_USE_BEDROCK "1"

REM 선택사항 (Anthropic Model 등록)
setx ANTHROPIC_MODEL "global.anthropic.claude-sonnet-4-6"

2.2 Windows PowerShell

New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.aws

@"
[default]
region = ap-northeast-2
output = json
"@ | Set-Content -Path $env:USERPROFILE\.aws\config -Encoding Ascii

@"
[default]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
"@ | Set-Content -Path $env:USERPROFILE\.aws\credentials -Encoding Ascii

setx AWS_REGION "ap-northeast-2"
setx AWS_PROFILE "default"
setx CLAUDE_CODE_USE_BEDROCK "1"

# 선택사항 (Anthropic Model 등록)
setx ANTHROPIC_MODEL "global.anthropic.claude-sonnet-4-6"

PowerShell의 @" ... "@ heredoc은 환경변수 보간 없이 raw 텍스트로 출력해 안전한 설정 파일 생성이 가능합니다.

2.3 macOS / Linux / WSL

mkdir -p ~/.aws

cat <<EOF > ~/.aws/config
[default]
region = ap-northeast-2
output = json
EOF

cat <<EOF > ~/.aws/credentials
[default]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
EOF

chmod 600 ~/.aws/config
chmod 600 ~/.aws/credentials
chmod 700 ~/.aws

cat <<EOF >> ~/.bashrc

# Bedrock 엔진 활성화 (필수 — v2.1.172 이전 버전)
export CLAUDE_CODE_USE_BEDROCK=1

# 리전 설정 (Bedrock 모델 권한을 받은 리전)
export AWS_REGION=ap-northeast-2

# (선택) 프로필 이름이 default가 아니라면 지정
# export AWS_PROFILE=default

# (선택) Anthropic Model 등록
# export ANTHROPIC_MODEL="global.anthropic.claude-sonnet-4-6"
EOF

3. Bedrock 모델 Access 활성화 (use case form)

처음 Bedrock에서 Anthropic 모델을 호출하려면 AWS 콘솔에서 use case form을 한 번 제출해야 합니다. 계정당 1회만 하면 됩니다.

Claude Code 공식 문서 기준 절차:

1. Bedrock 콘솔 접속 → 왼쪽 메뉴 “Model catalog”
2. Anthropic 모델 선택 (예: Claude Sonnet 4.6)
3. “Submit use case details” 클릭
4. use case form 작성 (회사명, 사용 목적, 데이터 처리 방식 등)
5. 제출 즉시 access 부여

AWS Organizations를 쓰는 조직이라면 management account에서 한 번 제출하면 child account에 자동 적용됩니다. API로 자동화할 경우 PutUseCaseForModelAccess 호출 (권한: bedrock:PutUseCaseForModelAccess).

4. Claude Code 설치

환경별 설치 명령:

설치 후 반드시 새 터미널 창을 열어서 환경변수 적용 후 실행해야 합니다.

claude

만약 claude 가 인식 안 되면 PATH 추가:

Windows CMD:

setx PATH "%PATH%;%USERPROFILE%\.local\bin"

Windows PowerShell:

$CurrentPath = [Environment]::GetEnvironmentVariable("Path", "User")
$NewPath = $CurrentPath + ";$env:USERPROFILE\.local\bin"
[Environment]::SetEnvironmentVariable("Path", $NewPath, "User")

5. 서울 리전에서 사용 가능한 Claude 모델 (2026-04-19 기준)

원본 repo의 bedrock-claude-models-2026-04-19.md 파일에서 aws bedrock list-foundation-models --region ap-northeast-2 결과를 정리한 표입니다.

5.1 ACTIVE 모델

5.2 LEGACY 모델 (사용 중단 예정)

6. global. Inference Profile — 직접 모델 ID vs 글로벌 프로파일

Bedrock에서 Claude 모델을 호출할 때 두 가지 방식이 있습니다.

6.1 global. 접두사를 써야 하는 4가지 이유

1. 고가용성 = 단일 리전 용량 부족 또는 장애 시 AWS가 자동으로 다른 리전(us-east-1, eu-west-1)으로 요청을 라우팅
2. 부하 분산 = 여러 리전에 트래픽을 분산해 응답 지연 감소
3. Anthropic 권장 = Bedrock + Claude Code 연동 시 Inference Profile 사용을 공식 권장
4. 비용 동일 = 직접 모델 ID와 동일한 요금 체계 적용

6.2 글로벌 프로파일 목록 (서울 리전 ap-northeast-2)

조회 명령:

aws bedrock list-inference-profiles --region ap-northeast-2 \
  --query "inferenceProfileSummaries[?contains(inferenceProfileId,'claude')].[inferenceProfileId,inferenceProfileName,type]" \
  --output table

6.3 APAC 프로파일 (서울 리전 내 분산)

7. Claude Code 환경변수 설정 예시

global. Inference Profile을 사용하는 환경변수 설정 패턴:

# Opus 4.7 — global. 접두사 필수 (Inference Profile)
export ANTHROPIC_DEFAULT_OPUS_MODEL="global.anthropic.claude-opus-4-7"
export ANTHROPIC_MODEL="global.anthropic.claude-opus-4-7"

# Sonnet 4.6
export ANTHROPIC_DEFAULT_SONNET_MODEL="global.anthropic.claude-sonnet-4-6"

# Haiku 4.5
export ANTHROPIC_DEFAULT_HAIKU_MODEL="global.anthropic.claude-haiku-4-5-20251001-v1:0"

7.1 settings.json 설정

~/.claude/settings.json 에 영구 설정:

{
  "model": "opus",
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "global.anthropic.claude-opus-4-7"
  }
}

8. 자주 발생하는 오류와 해결법

9. 마치며

Claude Code를 Amazon Bedrock으로 실행하는 것은 AWS credentials + 모델 access + 환경변수 3가지로 끝납니다. 서울 리전(ap-northeast-2) 에서는 Opus 4.7 / Sonnet 4.6 / Haiku 4.5 가 ACTIVE 상태로 사용 가능하고, global. Inference Profile을 쓰면 리전 장애에도 자동 failover 됩니다. AWS 조직 안에서 비용/데이터 주권/IAM 권한을 모두 통합 관리할 수 있어, Anthropic API 직접 결제보다 운영상 유리한 점이 많습니다.

추가로, Bedrock 모델 액세스 가능 여부·Inference Profile 신규 리전·Claude Code 의 Bedrock 라우팅 동작(예: CLAUDE_CODE_USE_BEDROCK 플래그)은 양사 모두 자주 갱신됩니다. 글 작성 시점(1차 검증 2026-04-22) 의 옵션이 현재는 다를 수 있으므로 재현 전 Amazon Bedrock User Guide + Claude Code 공식 문서의 Bedrock 섹션 최신판을 확인하시기 바랍니다.