Claude Code v2.1.144 업데이트 사항
요약
Claude Code v2.1.144 업데이트를 통해 백그라운드 세션 관리 기능이 강화되고 다양한 터미널 렌더링 및 연결 오류가 수정되었습니다. 특히 /resume 명령어를 통한 세션 재개 지원과 API 타임아웃 최적화, macOS 및 Windows 환경에서의 안정성 개선이 주요 내용입니다.
핵심 포인트
- /resume 명령어를 통한 백그라운드 세션 재개 기능 추가
- API 연결 실패 시 타임아웃 시간을 75초에서 15초로 단축하여 초기 구동 속도 개선
- VS Code 및 Windows 터미널에서의 디스플레이 깨짐, 스크롤 오류, CJK 렌더링 문제 수정
- 이미지 확장자 불일치 시 텍스트로 대체하는 폴백(fallback) 로직 도입
- 모델 선택 방식 개선 및 사용량 명칭을 usage credits로 변경
변경 사항
추가된 기능
- 백그라운드 세션 (background sessions)을 위한 /resume 지원 추가 — claude --bg 또는 agent view를 통해 시작된 세션이 이제 대화형 세션과 함께 표시되며 bg로 표시됩니다.
- 백그라운드 서브에이전트 (subagent) 완료 알림에 경과 시간 추가 (예: "Agent completed · 3h 2m 5s")
- /plugin browse 및 discover 창에 플러그인이 마지막으로 업데이트된 시점이 표시됩니다.
- /model 명령어가 이제 현재 세션에 대해서만 모델을 변경합니다. 모델 선택기(model picker)에서 d를 누르면 새 세션을 위한 기본값(default)을 설정할 수 있습니다.
- CLI 전체에서 "extra usage"를 "usage credits"로 명칭 변경; /extra-usage는 이제 /usage-credits로 변경되었습니다 (기존 명칭도 여전히 작동합니다).
수정된 사항
- api.anthropic.com에 접속할 수 없을 때 (캡티브 포털, 방화벽, VPN 문제 등) 시작 시 최대 75초 동안 멈추던 현상 수정 — 사이드 채널 API 호출이 이제 15초 후에 타임아웃(time out)됩니다.
- 창 크기 조정 이벤트(예: VS Code 분할 창 구분선 드래그)를 놓친 후 터미널 출력이 깨지는 현상 수정 — 이제 Ctrl+L을 누를 필요 없이 다음 프레임에서 스스로 복구됩니다.
- 매우 긴 세션에서 발생할 수 있으며 터미널 크기 조정이나 재시작 시에만 해결되던 점진적인 터미널 디스플레이 손상(오래되거나 깨진 글리프) 현상 수정
- 스피너 애니메이션(spinner animation)의 색상 수를 줄여 VS Code에서의 터미널 렌더링 글리치(glitches) 감소
- 프로젝트가 전체 디스크 접근 권한(Full Disk Access) 보호 폴더 아래에 있을 때 macOS 백그라운드 세션이 "exit 1 before init"과 함께 충돌하던 현상 수정 (2.1.143 버전의 회귀 문제)
- 이미지 확장자가 내용과 일치하지 않는 파일을 읽을 때 발생하는 복구 불가능한 대화(unrecoverable conversation) 문제 수정 (예:
HTML이 .png로 저장된 경우) — 이제 텍스트로 대체(fallback)됩니다. 검색 중 발생하는 불필요한 도구 오류(spurious tool errors) 감소: head / tail 파일 뷰가 이제 수정 전 읽기(read-before-edit) 체크를 통과하며, egrep, fgrep, git grep 또는 git diff의
)"mcpServers" 대신 VS Code의 "servers" 키 사용 — 이제 구성 오류를 표시합니다. 커스텀 ANTHROPIC_BASE_URL 설정 시의 백그라운드 사이드 쿼리(side-queries) 오류 수정. Bedrock Mantle이 Haiku를 사용하지 않는 문제 — 이제 퍼스트 파티 (first-party) API 키가 구성되어 있거나 Haiku 모델이 설정되지 않은 경우 올바르게 폴백 (fallback)됩니다. Windows에서 연결된 백그라운드 세션의 스크롤 오류 수정 — PgUp/PgDn, 마우스 휠, 그리고 Ctrl+O 트랜스크립트 (transcript) 탐색이 이제 정상 작동합니다. 백그라운드 세션에 연결된 상태에서 터미널을 닫을 때 발생하던 크래시 (crash) 수정. 연결된 상태에서 ! <cmd> 실행 세션이 Ctrl+C에 응답하지 않던 문제 — 이제 실행 중인 명령이 중단됩니다. 에이전트 뷰 (agent view)의 셸 명령 (shell-command) 행이 작업 완료 후에도 Working 아래에 남아 있고, 완료된 행에서 Enter를 누르면 출력이 만료된 후 명령이 재실행되던 문제 수정. Windows에서 Claude 에이전트 사용 중 ← 키를 누르면 목록이 키보드 입력에 반응하지 않던 문제 수정. Windows Terminal에서 CJK(한중일) 콘텐츠가 포함된 에이전트 뷰 (Agent View)의 창 전환 시 왼쪽 가장자리에 유령 문자가 나타나던 문제 수정. /bg 및 ← -detach 명령이 /add-dir을 통해 추가된 디렉토리를 이제 보존합니다. 이미 제자리에서 편집 중이던 세션을 분리(detach)한 직후, Edit/Write가 "백그라운드 세션이 아직 변경 사항을 격리하지 않았습니다"라며 거부하던 문제 수정. 중지된 백그라운드 세션에서 claude respawn <id> 실행 시 실행 중 대신 "stopped"라고 표시되던 문제 수정. /resume 피커 (picker)에서 백그라운드 세션으로부터 포크 (forked)된 세션이 표시되지 않던 문제 수정. 백그라운드 서비스가 응답하지 않을 때 Claude 에이전트에서 세션을 열거나 claude logs <id>를 실행하면 멈추던 문제 — 이제 10초 후 타임아웃(timeout)되며 복구 힌트를 제공합니다. 서브 에이전트 (subagent)에 의해 생성된 백그라운드 Bash 작업이 프로세스 종료 후에도 SDK 작업 패널에서 "Running" 상태로 유지되던 문제 수정. 완료되었거나 중지된 백그라운드 세션이 일시적으로 깨어나지 못할 때 영구적으로 시작 크래시 (startup crash)로 표시되던 문제 수정. Claude 에이전트에 연결된 세션의 마크다운 (markdown) 링크가 클릭 가능한 하이퍼링크 대신 일반 텍스트로 렌더링되던 문제 수정. 커스텀 spinnerVerbs가 턴 종료 후 지속 시간 메시지에 적용되던 문제 — "5초 동안 작업함"과 같은 과거형 내장 문구가 해당 위치에 복구되었습니다. claude agents
/ --bg 거부 메시지가 이제 일반적인 메시지 대신 특정 게이트(non-TTY, 환경 변수(env var) 또는 설정)의 이름을 명시합니다. claude --bg --name <label> 명령 시 이제 프로세스 생성 후 확인 단계에서 해당 이름을 출력합니다. claude agents: Ctrl+R을 사용하여 백그라운드 세션의 이름을 변경하면 연결된 세션의 배너가 즉시 업데이트됩니다. 백그라운드 세션의 워크트리(worktree) 격리 보호 기능이 이제 WorktreeCreate 훅(hook)이 구성된 non-git VCS 사용자에게도 적용됩니다. 플러그인 마켓플레이스(Plugin marketplace) 추가/업데이트 시 이제 CLAUDE_CODE_PLUGIN_PREFER_HTTPS 설정을 준수합니다. /plugin 명령은 이제 플러그인을 활성화, 비활성화 또는 삭제한 후 설치된(Installed) 목록으로 돌아갑니다. /doctor 명령은 명령 훅(command hook)에 명령 필드가 누락된 경우 exec-form 예시를 보여줍니다. 기술 목록(Skill-listing) 생략 표시가 더 이상 시작 시 알림으로 나타나지 않습니다 — 전체 내역을 확인하려면 /doctor를 실행하세요. 드문 경우에 발생하는 응답 전 스트림 중단(pre-response stream stalls)으로부터의 복구 기능이 개선되었습니다 — 이제 느린 비스트리밍(non-streaming) 요청으로 전환하는 대신 스트리밍을 한 번 재시도합니다. SDK/headless MCP 시작 기능이 개선되었습니다: pre-wait 단계가 첫 번째 턴(turn) 전에서 차단되는 대신 시작 단계와 겹치도록 하여, 느린 MCP 서버의 경우 최대 2초 더 빨라졌습니다. 설문 조사 후속 힌트가 이제 무시되지 않은 모든 설문 응답 후에 문맥에 맞는 문구와 함께 나타나며, 이를 통해 /feedback을 통해 더 자세한 내용을 공유하기가 더 쉬워졌습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기