본문으로 건너뛰기

© 2026 Molayo

Qiita헤드라인2026. 05. 20. 08:32

Claude Code v2.1.144~v2.1.145 릴리스 | 매일 Changelog 해설

요약

Claude Code v2.1.144 및 v2.1.145 업데이트를 통해 background session의 통합 관리와 보안 취약점 수정이 이루어졌습니다. `/resume` 명령어를 통해 백그라운드 세션을 쉽게 재개할 수 있으며, Bash 권한 프롬프트 바이패스 버그가 해결되어 보안성이 강화되었습니다.

핵심 포인트

  • background session이 `/resume` picker에 통합되어 `bg` 배지와 함께 식별 가능해짐
  • Bash allowlist 외의 환경 변수 대입 시 권한 프롬프트를 우회하던 보안 허점 수정
  • 세션 목록을 JSON 형식으로 출력할 수 있는 `claude agents --json` 기능 추가
  • API 연결 불가 시 발생하는 75초 지연(hang) 현상을 타임아웃 적용으로 해결
  • MCP prompt의 인자 누락 시 에러 메시지를 더 명확하게 개선

v2.1.144~v2.1.145 총 2개의 버전을 하나로 묶어 해설합니다. background session 주변의 허점을 정리한 회차와, Bash 권한 프롬프트의 바이패스(bypass) 수정을 중심으로 다룬 회차입니다.

/resume가 background sessions에 대응
claude --bg나 agent view 유래의 세션도 resume picker에 나열됨. bg 배지로 식별 가능 (v2.1.144)

Bash 권한 프롬프트의 바이패스 수정
allowlist 외의 환경 변수에 대한 bare 대입이 auto-approve 되던 보안 허점을 차단 (v2.1.145)

동작 중인 세션 목록을 JSON으로 출력. tmux-resurrect나 status bar 연동을 위한 통로가 열림 (v2.1.145)
claude agents --json

현재 세션만 변경됨. 기본 업데이트는 /model이 세션 스코프(session scope)로 변경, d 키 누름으로 분리 (v2.1.144)

기동 시 75초 행(hang) 문제 해결
api.anthropic.com에 도달할 수 없을 때의 side API 호출에 15초 타임아웃을 적용 (v2.1.144)

commands / agents / skills / hooks / MCP / LSP servers의 내용을 확인 가능 (v2.1.145)
/plugin Discover / Browse가 설치 전에 콘텐츠 표시

대상 독자: claude --bg나 agent view로 장시간 태스크를 돌리고 있는 사람

/resume picker에 background session이 나열되게 되었습니다. 이전에는 claude agentsclaude logs <id>를 통해서만 접근할 수 있어, 대화형 세션과 별개의 세계로 나뉘어 있었습니다. v2.1.144부터는 양쪽이 통합되었으며, 각 엔트리에 bg 배지가 붙기 때문에 무엇을 resume 했는지 혼동할 걱정이 없습니다.

claude --bg --name "refactor-auth"
# 나중에 다른 곳에서
claude
...

파생 기능으로, background session에서 fork한 세션도 /resume picker에 나타나게 되었습니다. 완료 알림 부분에도 Agent completed · 3h 2m 5s와 같이 경과 시간이 표시됩니다.

대상 독자: Bash tool의 allowlist로 보안 제어를 하고 있는 모든 사용자

allowlist 외의 환경 변수에 bare 대입을 하는 Bash 명령어가 권한 프롬프트를 스킵하고 auto-approve 되던 버그가 있었습니다. 예를 들어 허가되지 않은 FOO=bar와 같은 단독 대입이 그대로 통과됩니다.

보안 수정 사항이므로, allowlist로 Bash를 제한하고 있는 팀은 v2.1.145까지 업데이트하십시오.

이와 함께, MCP prompt의 slash command에서 필수 인수를 전달하는 것을 잊었을 때, 서버 측 validation error의 raw 데이터를 출력하던 것이 부족한 인수 명칭과 기대되는 usage를 표시하도록 개선되었습니다.

대상 독자: tmux나 status bar, session picker를 직접 제작하고 있는 사람

claude agents의 출력을 JSON으로 가져올 수 있게 되었습니다. 지금까지 TUI를 통해서만 볼 수 있었던 세션 정보가 jq로 파이프(pipe)할 수 있는 소재가 됩니다.

claude agents --json | jq '.[] | select(.status == "awaiting") | .name'

동시에 claude agents의 터미널 탭 타이틀에 "입력 대기 세션 수"가 표시되게 되었습니다. alt-tab으로 다른 창으로 전환해 있더라도, 탭을 보면 어떤 에이전트가 반응을 기다리고 있는지 알 수 있습니다.

OTEL(OpenTelemetry) 측면의 개선도 포함되었습니다. claude_code.tool span에 agent_idparent_agent_id가 붙으며, background subagent의 span이 dispatch 원천인 Agent tool span 아래에 중첩(nest)됩니다. Honeycomb이나 Jaeger에서 트레이스(trace)를 추적하기가 더 쉬워집니다.

버전카테고리변경 사항개요
v2.1.145기능Status line JSONGitHub repo 및 PR 정보 자동 부여
..."extra usage"를 "usage credits"로 명칭 변경 (/extra-usage 도 호환성 유지)
v2.1.144UI/plugin browse플러그인의 최종 업데이트 날짜 표시
v2.1.144UIspinner 경량화VS Code에서의 렌더링 글리치 (rendering glitch) 완화
v2.1.144속도 향상SDK / headless MCP startuppre-wait를 시작과 중첩시켜 최대 2초 단축
v2.1.144속도 향상pre-response stream stall 재시도비스트리밍 (non-streaming)으로 폴백 (fallback)하지 않고 스트리밍 재시도

버그 수정 (전체 버전 통합 접기)

v2.1.145

  • spinner / elapsed-time 표시가 터미널 리사이즈 또는 포커스 변경 후 프리즈(freeze)되어 키 입력 전까지 작동하지 않는 문제
  • cross-project resume hint가 Windows PowerShell 5.1에서 실패하는 문제 (구분자를 ;로 변경)
  • voice push-to-talk가 agent view의 reply pane에서 작동하지 않는 문제
  • 여러 task를 동시에 생성할 때 list 표시 순서가 무작위가 되는 문제
  • "Failed to install Anthropic marketplace" 배너가 이미 설치된 상태에서도 남아있는 문제
  • footer의 PR 배지가 gh pr create 등의 세션 내 명령 실행 후 즉시 업데이트되지 않는 문제
  • Agent Teams에서 teammate 이름이 비 ASCII(non-ASCII)인 경우, 헤더 인코딩(header encoding) 무효화로 인해 API 호출이 실패하는 문제
  • /review가 deprecated된 projectCards GraphQL을 사용하여 Classic Projects를 이용하는 리포지토리에서 에러가 발생하는 문제
  • claude plugin validateskills:의 디렉토리 지정 누락을 감지하지 못하는 문제
  • context: fork의 skill이 무한 자기 재호출(infinite self-recursion)을 하는 케이스

v2.1.144

  • macOS에서 Full Disk Access 보호 폴더 하위의 project인 경우 background session이 "exit 1 before init"으로 크래시(crash)되는 문제 (v2.1.143 회귀 버그)
  • 터미널 창 리사이즈 이벤트를 놓쳤을 때, Ctrl+L을 누르지 않으면 표시가 깨진 상태로 유지되는 문제
  • 장시간 세션 사용 시 stale / garbled glyph가 누적되는 문제
  • 이미지 확장자와 내용이 일치하지 않는 파일(예: HTML을 .png로 저장)을 읽을 때 세션 복구가 불가능해지는 문제
  • head / tail이 read-before-edit 체크를 통과하지 못하는 문제
  • egrep / fgrep / git grep / git diff의 "no matches" (exit 1)를 명령 실패(command failure)로 취급하는 문제
  • /branch가 worktree 이동 후 또는 일부 background session에서 "No conversation to branch"라고 표시되는 문제
  • AskUserQuestion의 notes 필드에서 Escape를 누르면 턴이 중단되는 문제 (본래는 답변 선택 상태로 돌아가야 함)
  • model 변경이 IDE picker 또는 applyFlagSettings 이후에 반영되지 않는 문제
  • resume한 세션이 다른 세션의 /model 선택을 상속받는 문제
  • Bedrock / Vertex에서 "Opus (1M context)"를 선택할 수 없는 문제 (v2.1.129 회귀 버그)
  • forceLoginMethod / forceLoginOrgUUID가 설정된 사용자의 remote-session 로그인 실패 문제
  • MCP server의 tools/list

페이지네이션 (Pagination) 응답에서 1페이지 이외의 데이터가 버려지는 문제 - MCP image의 MIME type 미지원 (SVG 등)으로 인한 세션 복구 불가

  • skill 디렉토리 내 빌드 시 file descriptor 고갈 (.md 이외의 reload 중단)
  • session title이 plugin monitor output으로부터 생성되는 문제
  • Skill tool이 headless mode에서 권한 오류 발생 (v2.1.141 회귀 오류)
  • 자신의 settings에서 활성화한 플러그인이 첫 실행 후 "not cached" 상태가 되는 문제
  • 프로젝트의 .claude/settings.json에서만 활성화된 플러그인에 대해 claude plugin install 힌트를 제공
  • claude mcp list.mcp.json 파싱 실패 시 "서버 없음"이라고 아무런 설명 없이 출력 (VS Code 방식의 "servers" 키 사용 시 등)
  • ANTHROPIC_BASE_URL 커스텀 설정 / Bedrock Mantle에서 background side-query가 Haiku를 선택하지 않는 문제
  • Windows: attached background session에서 PgUp / PgDn / 마우스 휠 / Ctrl+O가 작동하지 않는 문제
  • Windows: background session attach 중 터미널을 닫으면 crash 발생
  • Windows: claude agents에서 ← 키를 누르면 리스트가 키 입력을 받지 않는 문제
  • Windows Terminal의 CJK 콘텐츠에서 Agent View pane 전환 시 왼쪽 끝에 ghost characters가 나타나는 문제
  • /bg와 ←를 통해 detach 시 /add-dir로 추가한 디렉토리가 유실되는 문제
  • detach 직후의 Edit / Write 작업이 "background session hasn't isolated its changes yet" 메시지와 함께 거부되는 문제
  • claude respawn <id>가 stopped 세션에 대해 "stopped" 표시를 유지하며 동작하는 문제
  • /resume picker에 background session에서 fork한 세션이 나타나지 않는 문제
  • background 서비스가 응답하지 않을 때 claude agents / claude logs <id> 실행 시 hang 발생 (10초 타임아웃 추가)
  • subagent가 생성한 background Bash task가 SDK task panel에서 "Running" 상태로 남아있는 문제
  • 완료/정지된 background session이 wake 실패로 인해 startup crash로 처리되는 문제
  • claude agents 첨부 세션에서 markdown link가 plain text로 표시되는 문제
  • spinnerVerbs 커스텀 값이 post-turn duration 메시지에도 적용됨 ("Worked for 5s" 등 과거형 포함 기능 복구)
  • claude agents / --bg 거부 메시지에 구체적인 제약 사항(비 TTY / 환경 변수 / 설정)을 표시
  • claude --bg --name <label>의 이름이 post-spawn 확인 시 표시되지 않는 문제
  • Ctrl+R 리네임 시 attached banner가 즉시 업데이트되지 않는 문제
  • WorktreeCreate hook을 통한 비 git VCS 환경에서 worktree isolation guard가 작동하지 않는 문제
  • Plugin marketplace add / update 시 CLAUDE_CODE_PLUGIN_PREFER_HTTPS를 준수하지 않는 문제
  • /plugin 작업 후 Installed list로 돌아가지 않는 문제
  • /doctor가 command hook의 command 필드 누락 시 exec-form 예시를 보여주지 않는 문제
  • Skill 목록이 잘렸을(truncate) 때의 startup notification을 /doctor 안내로 변경

v2.1.144는 background session 주변의 허점들을 한꺼번에 메운 정리 버전입니다. v2.1.145는 Bash 권한 프롬프트 (Bash permission prompt) 우회 수정과, claude agents --json을 통한 스크립트 작성 가능성 (scriptability) 확보가 눈에 띕니다. allowlist로 Bash를 제어하고 있는 팀은 v2.1.145까지 업데이트해 두는 것이 좋습니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0