claudekit / updates / claude-code-2-1-154
[ PATCH · ]

Claude Code 2.1.154

Claude Code 2.1.154는 Opus 4.8(기본 high effort, 가장 어려운 작업엔 `/effort xhigh`)과 다이내믹 워크플로우(`/workflows`)를 Claude Code에 들여온 릴리스입니다. Opus 4.8 Fast mode가 표준 요금 2배에 속도 2.5배로 제공되고, lean 시스템 프롬프트가 대부분 모델의 기본값이 됐습니다. 그 밖에 `claude agents`의 `! <command>` 백그라운드 셸 실행, 플러그인 `defaultEnabled: false`, `/simplify`의 정리 전용 리뷰 전환, 백그라운드 세션, 보안, 터미널 UI 전반의 버그 수정이 포함됩니다.

공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.154는 2026년 5월 28일 출시됐습니다. 이번 릴리스의 핵심은 Opus 4.8과 다이내믹 워크플로우가 Claude Code에 도입된 것입니다. Opus 4.8은 기본 effort가 high로 설정되고 가장 어려운 작업에는 /effort xhigh를 쓸 수 있으며, “워크플로우를 만들어줘”라고 요청하면 Claude이 백그라운드에서 수십에서 수백 개의 에이전트로 작업을 오케스트레이션합니다(/workflows로 실행 현황 확인). 그 밖에 Fast mode 가격 인하, lean 시스템 프롬프트 기본화, claude agents의 백그라운드 셸 실행 등 다수의 개선과 버그 수정이 포함됩니다.

새 기능

  • 다이내믹 워크플로우 (/workflows)

    복잡한 작업을 한 세션에서 순차로만 처리해 폭넓은 작업이 느렸습니다. 이제 “워크플로우를 만들어줘”라고 요청하면 Claude이 백그라운드에서 수십에서 수백 개의 에이전트로 작업을 분산해 더 크고 복잡한 작업을 처리하고, /workflows로 실행 현황을 볼 수 있습니다.

  • claude agents의 백그라운드 셸 세션 (! <command>)

    백그라운드에서 셸 명령을 돌리고 다시 붙기 번거로웠습니다. claude agents에서 ! <command>를 입력하면 명령을 백그라운드 세션으로 실행해 붙였다 뗐다 할 수 있고, claude --bg --exec '<command>'로도 동일하게 동작합니다.

  • 플러그인 기본 비활성화 옵션 (defaultEnabled: false)

    설치만으로 모든 플러그인이 켜져 원치 않는 동작이 따라붙는 경우가 있었습니다. 이제 plugin.json 또는 마켓플레이스 항목에 defaultEnabled: false를 선언할 수 있고, /plugin이나 claude plugin enable로 켭니다. 활성화된 플러그인의 의존 플러그인은 자동으로 함께 켜집니다.

  • /plugin Discover 탭의 디렉터리 추천

    현재 작업 디렉터리와 관련 신호가 맞는 플러그인을 찾기 어려웠습니다. Discover 탭이 해당 플러그인을 “suggested for this directory” 표시와 함께 상단에 고정합니다.

  • Claude in Chrome 브라우저 선택

    연결된 브라우저가 여러 개일 때 어느 것을 쓸지 고를 수 없었습니다. /chrome → “Select browser…”로, 또는 브라우저 동작이 실행될 때 채팅에서 직접 선택할 수 있습니다.

주요 개선

  • Opus 4.8 도입과 effort 기본값

    Claude Code가 Opus 4.8을 지원합니다. 기본 effort가 high이며, 가장 어려운 작업에는 /effort xhigh를 사용합니다.

  • Opus 4.8 Fast mode 가격 인하

    이전 모델의 Fast mode는 비용 부담이 컸습니다. Opus 4.8 Fast mode는 표준 요금의 2배로 속도 2.5배를 제공해 이전보다 크게 저렴해졌습니다.

  • lean 시스템 프롬프트 기본화

    Haiku, Sonnet, 그리고 Opus 4.7 이하를 제외한 모든 모델에서 lean 시스템 프롬프트가 기본값이 됐습니다.

  • 불필요한 객관식 질문 감소

    Claude이 충분한 맥락이 있는데도 객관식 질문을 띄우는 경우가 있었습니다. 이제 스스로 판단할 수 없는 결정에만 객관식 프롬프트를 사용합니다.

  • /simplify가 정리 전용 리뷰로 변경

    /simplify/code-review --fix의 버그 헌팅까지 함께 돌렸습니다. 이제 재사용, 단순화, 효율, 추상화 수준(altitude) 정리만 검토하고 수정을 적용합니다.

  • /effort 슬라이더 라벨 변경

    “Speed”/“Intelligence” 라벨이 모호했습니다. “Faster”/“Smarter”로 바꿔 의미를 명확히 했습니다.

  • 에이전트 뷰와 스트리밍 도구 실행의 환경 확대

    에이전트 뷰(←←)와 스트리밍 도구 실행이 Bedrock, Vertex, Foundry, 텔레메트리 비활성화 환경에서 동작합니다. 스트리밍 도구 실행은 기능 플래그 뒤에 있다가 항상 켜지도록 바뀌었습니다.

  • MCP 동작 개선

    Stdio MCP 서버 서브프로세스가 CLAUDE_CODE_SESSION_IDCLAUDECODE=1 환경 변수를 받습니다. claude mcp list/get은 출력이 파이프될 때 승인되지 않은 .mcp.json 서버를 자동 승인하지 않고 ⏸ Pending approval로 표시합니다.

  • claude agents 로그아웃과 Remote Control 안내

    claude agents에서 /logout이 백그라운드 세션으로 넘어가지 않고 실제로 로그아웃하도록 바뀌었고, /remote-control 자동완성은 이미 활성화된 경우 “Disconnect Remote Control”을 표시합니다.

  • /claude-api 스킬에 Opus 4.8 지원 추가

    /claude-api 스킬에 Opus 4.8 지원과 4.7 → 4.8 마이그레이션 안내가 추가됐습니다.

  • 자동 모드 분류기의 데이터 유출 탐지 강화

    자동 모드 분류기가 데이터 유출, 특히 저장소 콘텐츠의 대량 전송을 더 잘 탐지하도록 개선됐습니다.

주요 버그 수정

보안 및 안전

  • rm -rf $HOMEHOME에 끝 슬래시가 있을 때 위험 경로로 차단되지 않던 문제 — 차단되도록 수정.
  • $TMPDIR이 같은 세션 안에서 샌드박스/비샌드박스 Bash 명령마다 다른 디렉터리로 해석되던 문제 — 일관되게 해석.
  • 안전 분류기가 추론 중 출력 토큰을 소진하면 자동 모드가 “could not evaluate this action”으로 동작을 잘못 차단하던 문제 — 수정.
  • managed settings의 allowedMcpServers/deniedMcpServers 항목 하나가 잘못되면 전체 정책이 폐기되던 문제 — 잘못된 항목만 버리고 claude doctor 경고를 표시.

백그라운드 세션

  • 일부 1M 컨텍스트 모델에서 백그라운드 에이전트 완료 알림이 조기 “out of context” 동작을 유발하던 문제 — 수정.
  • 예약된 /command가 실행될 때 백그라운드 세션 분류기가 사용자 목표를 잃던 문제 — 수정.
  • 업데이트 후 고정된 백그라운드 세션이 매분 재생성돼 알림과 프로세스가 반복되던 문제 — 수정.
  • “blocked”, “running”, “working” 상태에 멈춘 백그라운드 세션이 유휴 유예 시간 후에도 정리되지 않던 문제 — 정리되도록 수정.
  • 백그라운드 세션의 서브에이전트가 워크트리 격리를 우회해 공유 체크아웃에 쓰던 문제 — 수정.
  • macOS에서 데몬 종료 후 고아 claude --bg-pty-host 프로세스가 CPU 100%로 도는 문제 — 수정.
  • 연결된 워크트리 안에서 서브에이전트를 띄우거나 EnterWorktree를 호출할 때 worktree.baseRef: "head"가 현재 워크트리가 아닌 메인 체크아웃의 HEAD로 해석되던 문제 — 수정.

터미널 및 UI

  • claude agents에서 테마가 터미널 배경과 맞지 않을 때 강조된 행 텍스트가 보이지 않던 문제 — 수정.
  • 옵션 다이얼로그에서 구분선 아래 옵션에 숫자 키 단축키가 동작하지 않던 문제 — 수정.
  • 이전 줄이 터미널 너비에 정확히 맞을 때 줄바꿈된 줄 앞에 공백이 끼던 문제 — 수정.
  • VS Code에서 thinking 스피너가 만드는 색상 수를 제한해 간헐적 렌더링 깨짐을 해결.
  • 화면에 들어가는 짧은 ANSI 색상 줄에 “ctrl+o to expand” 힌트가 잘못 표시되던 문제 — 표시되지 않도록 수정.
  • 워크플로우만 실행 중일 때 작업 패널에 선택할 수 없는 “main” 행이 표시되던 문제 — 수정.
  • plan 모드 프롬프트가 붙여넣은 이미지나 텍스트로 시작할 때 plan 파일 이름에 [Image #N]/[Pasted text #N] 자리표시자가 들어가던 문제 — 수정.
  • 단축키 도움말 패널에서 오래된 ”& for background” 힌트 제거.

MCP 및 모델

  • MCP 서버의 도구 이름이 길거나 여러 줄이거나 설명이 길 때 /mcp 도구 목록과 상세 렌더링이 깨지던 문제 — 수정.
  • CLAUDE_CODE_ALWAYS_ENABLE_EFFORT가 설정됐을 때 effort 파라미터를 지원하지 않는 모델에서 API 400 오류가 나던 문제 — 수정.
  • Fast mode가 켜져 있을 때 API 종량제 사용자에게 /model 선택기의 Default 옵션에 Fast mode 가격이 보이지 않던 문제 — 수정.

VS Code 및 Windows

  • [VS Code] 자동 모드가 모드 선택기에 나타나려면 bypass-permissions 설정이 필요하던 제약을 제거하고, 처음 활성화될 때 자동 모드를 설명하는 닫을 수 있는 안내를 추가.
  • [Windows] claude.exe가 사용 중이라 업데이트가 실패할 때 일반 오류 대신 다른 세션을 닫고 재시도하라는 안내를 표시.

알아두면 좋은 점

  • Opus 4.8과 다이내믹 워크플로우는 별도 소식 참고 — 두 기능의 자세한 내용은 각각의 소식에서 다룹니다. 이 글은 Claude Code 2.1.154 릴리스 관점의 요약입니다.
  • CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 지원 종료(deprecated) — 2026년 6월 1일 제거 예정입니다. Opus 4.6에서 Fast mode를 쓰려면 /model claude-opus-4-6[1m]으로 전환한 뒤 /fast on을 사용하세요.
  • /simplify 동작 변경 주의 — 이제 버그를 찾지 않고 정리(재사용, 단순화, 효율, altitude)만 적용합니다. 버그 헌팅은 /code-review --fix를 사용하세요.