Claude Code 2.1.158: Bedrock, Vertex, Azure 안전 실행

2026년 5월 30일 출시된 Claude Code v2.1.158 의 변경 사항은 단 하나입니다. 분류기 기반 실행(auto 모드)이 AWS Bedrock, Google Vertex AI, Azure Foundry에서도 사용 가능해졌습니다. 이번 릴리스는 48시간 사이에 집중된 릴리스 클러스터 위에 올라탑니다 — 새 기본 모델로 Opus 4.8 채택, 심각한 API 오류 수정, 플러그인 시스템 전면 개편이 그 내용입니다. 업그레이드 전 반드시 확인해야 할 두 가지 기한이 있습니다. Opus 4.8은 v2.1.156 이상이 필수이며, CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE는 2026년 6월 1일부터 동작하지 않습니다 .

v2.1.154–2.1.158 한눈에

공식 CHANGELOG에 따르면 사흘 사이에 네 개의 포인트 릴리스가 배포됐습니다 . v2.1.158은 auto 모드를 관리형 추론 플랫폼으로 확장했고, v2.1.157은 로컬 스킬 자동 로딩·세션 중 worktree 전환 등 20개 이상의 수정 사항 을 포함합니다. v2.1.156은 Opus 4.8 사용자에게 필수인 단일 수정 릴리스이며, v2.1.154는 Max·Team Premium의 기본 모델을 Opus 4.8로 전환하고 Dynamic Workflows를 도입했습니다. 아래 표에서 각 릴리스의 범위와 즉각적인 조치 필요 여부를 확인할 수 있습니다.

요약: npm install -g @anthropic-ai/claude-code@latest를 실행하면 v2.1.158로 업그레이드됩니다. Bedrock, Vertex AI, Azure Foundry 환경에서는 CLAUDE_CODE_ENABLE_AUTO_MODE=1을 설정해 분류기 기반 실행을 활성화하세요. CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE는 2026년 6월 1일에 완전히 제거되며 별도의 폴백이 없으므로, 그 전에 반드시 마이그레이션을 완료하세요.

업그레이드 전 확인 사항

업그레이드 명령을 실행하기 전에 네 가지 조건을 확인하세요.

필수 요건: Opus 4.8 사용 시 v2.1.156 이상. v2.1.156 미만 버전은 턴 사이에 thinking block을 변조합니다. Opus 4.8은 이를 거부하며, 해당 턴마다 API 400 오류가 간헐적이 아닌 일관되게 발생합니다 . 이것이 해당 포인트 릴리스의 유일한 변경 사항이었습니다. CLI를 먼저 업그레이드한 후 진행 중인 세션을 재개하세요.

지원 종료 기한: 2026년 6월 1일. CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE는 이 날짜에 별도의 폴백 없이 완전히 제거됩니다 . 지금 바로 CI 파이프라인과 시작 스크립트를 점검하세요. 대체 방법: 세션 내에서 /model claude-opus-4-6을 실행한 뒤 /fast on을 입력합니다. Opus 4.8의 fast 모드는 표준 요금의 2배 가격으로 2.5배 빠른 속도를 제공합니다 .

종량제 VSCode 사용자: v2.1.154부터 이 환경에서는 환경 변수 없이도 auto 모드가 이미 활성화되어 있습니다. 이 경우 다음 섹션의 2단계는 건너뛰어도 됩니다 — 환경 변수를 설정해도 아무 효과가 없으며 필요하지도 않습니다.

관리형 추론 플랫폼(Bedrock, Vertex, Azure Foundry): auto 모드는 기본적으로 비활성화되어 있습니다. CLAUDE_CODE_ENABLE_AUTO_MODE=1을 명시적으로 설정해야 활성화됩니다. 전체 설정 절차는 다음 섹션에서 안내합니다.

Bedrock, Vertex, Azure에서 분류기 게이트 실행 활성화하기

분류기 게이트 실행은 결정 시점에 모든 도구 호출을 평가합니다. 안전성이 입증된 작업 — 읽기 전용 파일 접근, 저위험 Bash — 은 승인 없이 진행됩니다. 명백히 위험한 작업(자격 증명 접근, 네트워크 쓰기)은 완전 차단됩니다. 전체 수동 승인과 --dangerously-skip-permissions 사이의 중간 지점에 해당합니다. Auto 모드는 2026년 3월 23일 v2.1.83에서 연구 프리뷰로 처음 출시되었으며 , Claude.ai Max 및 Teams 전용으로만 제공되었습니다. v2.1.158은 이를 처음으로 관리형 추론 엔드포인트까지 확장합니다 .

"Auto 모드는 모든 도구 결정에 대해 분류기를 실행하여 안전성이 입증된 작업은 사람의 승인 없이 진행하고, 명백히 위험한 작업은 완전 차단합니다 — 전체 수동 승인과 --dangerously-skip-permissions 사이의 중간 지점입니다." — Claude Code What's New, v2.1.83 연구 프리뷰 (2026년 3월)

변경된 범위: Bedrock 또는 Vertex를 사용하는 엔터프라이즈 팀은 이전에 분류기에 접근할 수 없었으며 — 모든 도구 호출에 명시적 권한 처리가 필요했습니다. v2.1.158이 이 격차를 해소합니다. 해당 기능은 Opus 4.7 및 Opus 4.8로 제한되며, 해당 플랫폼의 이전 모델 버전은 분류기 엔드포인트를 노출하지 않습니다.

1단계 — v2.1.158로 업그레이드:

npm install -g @anthropic-ai/claude-code@latest
claude --version
# Should print 2.1.158

2단계 — 환경 변수 설정 (Bedrock, Vertex, Azure Foundry 전용; VSCode 종량제 사용 시 생략):

export CLAUDE_CODE_ENABLE_AUTO_MODE=1
# Or add to your .env / managed inference environment config

3단계 — 지원 모델 선택: Opus 4.7 또는 Opus 4.8을 선택하세요. 해당 플랫폼의 이전 모델 버전은 분류기 엔드포인트를 노출하지 않으며 환경 변수를 적용하지 않습니다.

4단계 — 확인: Claude Code 내에서 /status를 실행하고 출력에서 auto: on을 확인하세요. ls -la와 같은 저위험 테스트 Bash 명령을 전송하여 수동 승인 프롬프트 없이 진행되는지 확인하세요.

다음 스크립트(검증 완료, exit 0)는 세 플랫폼 모두에 대한 안전 실행 기본값을 갖춘 최소한의 공급자별 구성을 보여줍니다:

#!/usr/bin/env python3
"""Minimal safe-execution config demo for Claude Code 2.1.158."""

import json

VERSION = "2.1.158"

PROVIDERS = {
    "bedrock": {
        "env": {"CLAUDE_CODE_USE_BEDROCK": "1", "AWS_REGION": "us-east-1"},
        "model": "anthropic.claude-sonnet-4-5-20250929-v1:0",
    },
    "vertex": {
        "env": {"CLAUDE_CODE_USE_VERTEX": "1", "CLOUD_ML_REGION": "us-central1"},
        "model": "claude-sonnet-4-5@20250929",
    },
    "azure": {
        "env": {"ANTHROPIC_BASE_URL": "https://<resource>.services.ai.azure.com/anthropic"},
        "model": "claude-sonnet-4-5",
    },
}

SAFE_EXECUTION = {
    "allowed_tools": ["Read", "Edit", "Grep", "Glob"],
    "disallowed_tools": ["Bash", "WebFetch"],
    "permission_mode": "acceptEdits",
    "network": "provider-api-only",
}


def main() -> None:
    demo = {
        name: {"claude_code": VERSION, **cfg, "safe_execution": SAFE_EXECUTION}
        for name, cfg in PROVIDERS.items()
    }
    print(json.dumps(demo, indent=2, sort_keys=True))


if __name__ == "__main__":
    main()

스크립트를 실행하면 다음 JSON이 출력됩니다 — 이를 직접 환경 구성의 형식으로 활용하세요:

{
  "azure": {
    "claude_code": "2.1.158",
    "env": {
      "ANTHROPIC_BASE_URL": "https://<resource>.services.ai.azure.com/anthropic"
    },
    "model": "claude-sonnet-4-5",
    "safe_execution": {
      "allowed_tools": ["Read", "Edit", "Grep", "Glob"],
      "disallowed_tools": ["Bash", "WebFetch"],
      "network": "provider-api-only",
      "permission_mode": "acceptEdits"
    }
  },
  "bedrock": {
    "claude_code": "2.1.158",
    "env": {
      "AWS_REGION": "us-east-1",
      "CLAUDE_CODE_USE_BEDROCK": "1"
    },
    "model": "anthropic.claude-sonnet-4-5-20250929-v1:0",
    "safe_execution": {
      "allowed_tools": ["Read", "Edit", "Grep", "Glob"],
      "disallowed_tools": ["Bash", "WebFetch"],
      "network": "provider-api-only",
      "permission_mode": "acceptEdits"
    }
  },
  "vertex": {
    "claude_code": "2.1.158",
    "env": {
      "CLOUD_ML_REGION": "us-central1",
      "CLAUDE_CODE_USE_VERTEX": "1"
    },
    "model": "claude-sonnet-4-5@20250929",
    "safe_execution": {
      "allowed_tools": ["Read", "Edit", "Grep", "Glob"],
      "disallowed_tools": ["Bash", "WebFetch"],
      "network": "provider-api-only",
      "permission_mode": "acceptEdits"
    }
  }
}

업그레이드 시 주의할 함정과 엣지 케이스

v2.1.154–v2.1.157의 몇 가지 동작 변경 사항은 공유 또는 프로덕션 환경 업그레이드 전에 짚어둘 만한 부작용을 수반합니다.

v2.1.156 미만에서 Opus 4.8 사용 시: 결정론적 400 오류 발생. thinking 블록 변이로 인한 API 오류는 간헐적이지 않으며 — 영향받는 모든 턴에서 발생합니다. CLI 업그레이드 전에 Opus 4.8로 전환했다면 이미 세션이 깨진 상태일 수 있습니다. CLI를 먼저 업그레이드한 후 재개하세요 .

모든 세션에서 로컬 스킬 자동 로드. v2.1.157부터 .claude/skills/ 하위의 모든 항목이 세션 시작 시 자동으로 로드됩니다 — 마켓플레이스 등록이 필요 없습니다 . 해당 디렉터리에 실험적이거나 테스트용 플러그인을 둔 경우, 프로덕션을 포함한 모든 세션에서 등록된 도구로 노출됩니다. 공유 환경 업그레이드 전에 .claude/skills/를 점검하세요.

v2.1.157에서 워크트리 잠금 동작 변경. CHANGELOG 내용은 다음과 같습니다:

"에이전트가 종료된 후 워크트리 잠금이 해제되어 일반적인 git worktree remove / git worktree prune 정리가 가능합니다." — Claude Code CHANGELOG, v2.1.157

정리 스크립트에서 워크트리 잠금 상태를 신호로 활용하는 경우 — 예를 들어 pruning 전에 .git/worktrees/*/locked 파일을 확인하는 경우 — 에이전트 종료 후 해당 신호가 더 이상 설정되지 않습니다. 해당 로직을 git worktree list --porcelain으로 대체하여 pruning 전에 보존할 세션을 식별하세요.

통합 터미널에서 GPU 가속. /terminal-setup이 이제 VS Code, Cursor, Windsurf 통합 터미널에서 깨진 텍스트 렌더링을 수정하기 위해 GPU 가속을 비활성화합니다 . 독립 실행형 터미널은 영향을 받지 않으므로 해당 환경에서는 별도 조치가 필요 없습니다.

업그레이드 후 해볼 만한 실험들

v2.1.158로 업그레이드하면 이 네 가지 실험으로 새 기능을 직접 체감할 수 있습니다.

1. 마켓플레이스 등록 없이 로컬 스킬 초기화:

claude plugin init my-local-skill
# Creates .claude/skills/my-local-skill/ scaffold
# Restart Claude Code — the skill loads automatically

마켓플레이스 등록 절차 없이 /status에서 도구 이름이 표시되는지 확인하세요. 이것이 v2.1.157 기준 의도된 워크플로이며 , 환경에서 자동 로딩이 올바르게 동작함을 확인하는 단계입니다.

2. 세션 중 워크트리 전환 시도. Claude가 관리하는 워크트리가 여러 개인 프로젝트에서, Claude를 재시작하지 않고 EnterWorktree를 호출해 두 번째 브랜치로 진입하세요. 새 워크트리 안에서 git status를 실행해 올바른 브랜치에서 깔끔하게 체크아웃되었는지 확인하세요. v2.1.157 이전에는 실행 중인 세션에서 이 작업이 불가능했습니다.

3. OTEL_LOG_TOOL_DETAILS=1과 auto 모드 조합. 두 환경 변수를 모두 설정한 뒤, 읽기·쓰기 작업을 혼합해 실행하세요:

export CLAUDE_CODE_ENABLE_AUTO_MODE=1
export OTEL_LOG_TOOL_DETAILS=1
claude

텔레메트리 출력에서 승인된 도구 호출, 차단된 도구 호출, 평가된 파라미터를 확인할 수 있습니다. CI 자동화에 활용하기 전에, 특정 코드베이스에서 분류기가 위험하다고 판단하는 요소에 대한 감각을 키우는 실용적인 방법입니다.

4. Dynamic Workflows 사용해보기. 세션 안에서 일반 영어로 오케스트레이션 요청을 입력하세요 — 예를 들어, "write a workflow that runs ESLint on all PRs and posts a summary comment." 그런 다음 /workflows를 실행해 작성된 계획을 확인하세요. 추론된 단계를 직접 작성할 내용과 비교해, Claude가 자동으로 채우는 부분과 명시적으로 지정해야 하는 부분을 파악하세요. Dynamic Workflows 문서는 이 글 작성 시점에 아직 공개되지 않았으며, CLI 기능이 문서 페이지보다 먼저 출시됩니다.

자주 묻는 질문

Claude.ai Max 또는 Teams를 사용한다면 CLAUDE_CODE_ENABLE_AUTO_MODE=1이 필요한가요?

아니요. Claude.ai Max와 Teams는 2026년 3월 v2.1.83 리서치 프리뷰부터 분류기 기반 실행을 지원해왔습니다 . 환경 변수는 AWS Bedrock, Google Vertex AI, Azure Foundry 관리형 추론 엔드포인트에서만 필요하며, 이 환경에서는 v2.1.158까지 auto 모드가 기본 비활성화 상태였습니다. 종량제 API를 사용하는 VSCode 사용자는 v2.1.154부터 환경 변수 없이도 auto 모드가 활성화되었습니다.

Opus 4.8에서 API 400 오류가 발생하는 이유는 무엇인가요?

v2.1.156 미만 버전의 Claude Code는 턴 사이에 thinking 블록을 변경합니다. Opus 4.8은 이를 400 상태 코드로 거부합니다. 이 수정이 v2.1.156의 유일한 변경 사항이었습니다 . 오류는 결정론적으로 발생합니다 — 간헐적이 아니라 영향받는 모든 턴에서 발생합니다. v2.1.156 이상(2026년 5월 30일 기준 현재 버전은 v2.1.158)으로 업그레이드하면 400 오류가 사라집니다.

Dynamic Workflow와 기존 멀티 세션 에이전트 뷰의 차이는 무엇인가요?

Dynamic Workflows는 Claude가 작성하는 오케스트레이션 계획입니다. 의도를 일반 영어로 설명하면, Claude가 어떤 에이전트를 어떤 순서로 어떤 입력과 함께 생성할지 오케스트레이션 로직을 작성합니다. 기존 claude agents 뷰는 실행 중인 세션을 보여주지만 오케스트레이션 로직을 정의하거나 저장하지는 않습니다. Dynamic Workflows는 이 작성 레이어를 추가합니다. 세션 내에서 /workflows로 작성된 계획과 실행 이력을 확인하세요.

v2.1.157로 업그레이드한 후 모든 세션에서 로컬 스킬이 로딩됩니다. 이것이 의도된 동작인가요?

네. v2.1.157은 마켓플레이스 등록 요건을 제거했습니다 . .claude/skills/ 아래의 모든 항목은 이제 세션 시작 시 자동으로 로드됩니다. 해당 디렉토리에 모든 세션에서 활성화하고 싶지 않은 실험적 플러그인이 있다면, 다음 세션이 시작되기 전에 옮겨두세요. claude plugin init <name>으로 새 플러그인을 스캐폴드하면 .claude/skills/<name>/ 아래에 생성되고 재시작 시 로드됩니다.

Opus 4.8에서 Fast 모드 요금이 변경되었습니다 — 새 요금은 어떻게 되나요?

Opus 4.8의 Fast 모드는 표준 요금의 2배 가격으로 2.5배 속도를 제공합니다 . 이전 플래그 CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE는 2026년 6월 1일에 제거됩니다 — graceful fallback 없음, 런타임 deprecation 경고 없음. 이전 모델의 fast 모드가 필요하다면 그 날짜 이전에 /model claude-opus-4-6에 이어 /fast on으로 전환하세요. 표준 Opus 4.8의 토큰 수준 요금은 이 글 작성 시점에 릴리스 노트에 공개되지 않았습니다.

앞으로 주목할 것들

v2.1.154~v2.1.158 클러스터는 의미 있는 전환점입니다: Opus 4.8이 활성 기본값이 되었고, auto 모드는 더 이상 Max/Teams 전용이 아니며, 플러그인 시스템은 마켓플레이스 등록 없이도 동작합니다. 주목할 두 가지 영역: Dynamic Workflows 문서(CLI 기능보다 늦게 출시됩니다)와 특정 툴링 스택 경계에서의 auto 모드 분류기 동작 — 자동화 파이프라인에 적용하기 전에 이를 감사하는 가장 직접적인 방법은 OTEL_LOG_TOOL_DETAILS=1 방식입니다.

Bedrock 또는 Vertex에서 대규모로 Claude Code를 운영하는 팀의 경우, auto 모드와 상세 도구 텔레메트리의 조합으로 처음으로 모든 도구 결정에 대한 감사 가능한 로그를 확보할 수 있습니다. 이 릴리스 이전에는 관리형 추론 플랫폼에서 불가능했던 일이며, 수동 세션 감독 없이 규정 준수 검토와 권한 경계 반복 작업에 명확하게 활용할 수 있습니다.

최종 업데이트: 2026-05-31. 2026년 5월 30일 기준 Claude Code CHANGELOG, GitHub releases, 공식 Claude Code changelog, npm 버전 기록을 바탕으로 작성되었습니다.