
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 agents나 claude 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_id와 parent_agent_id가 붙으며, background subagent의 span이 dispatch 원천인 Agent tool span 아래에 중첩(nest)됩니다. Honeycomb이나 Jaeger에서 트레이스(trace)를 추적하기가 더 쉬워집니다.
| 버전 | 카테고리 | 변경 사항 | 개요 |
|---|---|---|---|
| v2.1.145 | 기능 | Status line JSON | GitHub repo 및 PR 정보 자동 부여 |
| ... | "extra usage"를 "usage credits"로 명칭 변경 (/extra-usage 도 호환성 유지) | ||
| v2.1.144 | UI | /plugin browse | 플러그인의 최종 업데이트 날짜 표시 |
| v2.1.144 | UI | spinner 경량화 | VS Code에서의 렌더링 글리치 (rendering glitch) 완화 |
| v2.1.144 | 속도 향상 | SDK / headless MCP startup | pre-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된projectCardsGraphQL을 사용하여 Classic Projects를 이용하는 리포지토리에서 에러가 발생하는 문제claude plugin validate가skills:의 디렉토리 지정 누락을 감지하지 못하는 문제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" 표시를 유지하며 동작하는 문제/resumepicker에 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가 즉시 업데이트되지 않는 문제
WorktreeCreatehook을 통한 비 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가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기