Claude Code 2.1.162

무엇이 바뀌었나?

Claude Code 2.1.162가 2026년 6월 3일 출시됐습니다. claude agents의 진단 정보와 슬래시 명령, Remote Control UI가 더 명확해졌고, 권한 규칙, MCP 타임아웃, LSP, 백그라운드 세션 영역에서 그동안 누적된 회귀와 모서리 케이스가 한 번에 정리됐습니다.

주요 개선

• claude agents --json에 waitingFor 필드 추가

  기존에는 세션이 대기 상태일 때 무엇 때문에 멈춰 있는지 JSON 출력에서 식별하기 어려웠습니다. 이제 waitingFor 필드가 포함되어 권한 프롬프트 등 대기 원인을 외부 도구에서 바로 확인할 수 있습니다.

• --tools에서 Grep/Glob 명시 지정이 실제로 동작

  이전에는 --tools로 Grep/Glob를 나열해도 임베디드 검색을 가진 네이티브 빌드에서 이름이 조용히 무시되어 전용 검색 도구가 제공되지 않았습니다. 이제 명시적으로 나열하면 전용 Grep/Glob 도구가 정상적으로 노출됩니다.

• /effort가 기본값 유지 여부를 명시적으로 확인

  선택한 effort 레벨이 새 세션의 기본값으로 유지되는지 모호했습니다. 이제 /effort는 선택값이 새 세션에 기본으로 적용될 때 이를 확인 메시지로 알려줍니다.

• 슬래시 명령 자동완성 클릭이 즉시 실행 대신 프롬프트에 채워 넣음

  자동완성 메뉴에서 슬래시 명령을 클릭하면 곧바로 실행되어 의도치 않은 동작이 발생할 수 있었습니다. 이제 클릭하면 프롬프트에 채워지기만 하고, Enter를 눌러야 실행됩니다.

• Remote Control이 고정 풋터 알약으로 표시

  Remote Control 상태가 시작 메시지로 한 번 표시된 후 스크롤 위로 사라져 현재 활성 여부를 확인하기 어려웠습니다. 이제 세션 링크가 달린 고정 풋터 알약 형태로 상시 표시됩니다.

• Windsurf → Devin Desktop으로 이름 변경

  에디터의 리브랜딩에 맞춰 /ide 메뉴, /terminal-setup, /scroll-speed에서 Windsurf 명칭이 Devin Desktop으로 갱신됐습니다.

• 시작 메시지 정리

  공지가 심각도별로 묶이고, 세션 정보와 안내가 시작당 한 줄로 표시되도록 정리됐습니다. 시작 경고도 더 짧고 명확하게 재작성되어 각 항목에 구체적인 해결 방법이 함께 표시됩니다. 딥링크나 사전 입력 프롬프트로 시작할 때 표시되는 경고는 사라지지 않고 입력란 아래에 고정되어 사용자가 처리할 때까지 유지됩니다.

• 실패한 턴이 한 줄 경고로 표시

  기존에는 턴이 실패하면 여러 줄의 빨간색 오류 블록이 표시됐습니다. 이제 컴팩트한 한 줄 경고로 축약되어 화면이 덜 어수선합니다.

• 백그라운드 서비스 시작과 claude update 검증이 보안 스캐닝 대기

  엔드포인트 보안 도구가 새 바이너리를 스캔하는 동안 5초 안에 실패하던 문제가 있었습니다. 이제 스캔이 끝날 때까지 기다리도록 개선되어 보안 솔루션이 도입된 환경에서도 시작과 업데이트가 안정적으로 완료됩니다.

주요 버그 수정

시작, 설정, 권한

• 설정 디렉터리가 읽기 전용이거나 쓰기 불가일 때 발생하던 무음 시작 행 — 이제 메모리 내 설정으로 시작하고 빈 화면 대신 시작 오류를 명시적으로 표시합니다.
• WebFetch 권한 규칙이 빌트인 사전 승인 도메인에 적용되지 않던 문제 — 이제 명시적인 WebFetch(domain:...) deny/ask/allow 규칙이 사전 승인 호스트 자동 허용보다 우선합니다.
• Windows에서 권한 규칙이 백슬래시 표기(~\, \\server\share)나 대소문자 다른 경로와 매칭되지 않던 문제, Read deny 규칙이 Glob/Grep 결과에서 파일을 숨기지 못하던 문제 수정.

API, MCP, 텔레메트리

• api_request, 분류기 서브쿼리, MCP 서버 설명에 절단 경계 부근의 이모지가 있을 때 발생하던 API 400 no low surrogate in string 오류 수정.
• MCP 서버별 timeout 설정값이 1000ms 미만일 때 1초 watchdog에 의해 모든 도구 호출이 중단되던 문제 — 1000ms 미만 값은 이제 무시되고 MCP_TOOL_TIMEOUT 또는 기본값으로 폴백되며, claude mcp get이 이를 별도 표시합니다.

LSP 및 검색 도구

• LSP 도구의 workspaceSymbol 작업이 결과를 반환하지 않던 문제 — 이제 query 파라미터를 받아 언어 서버에 전달합니다.

claude agents 및 세션

• claude agents가 라이브 상태 텍스트(도구 인자, 응답, 프롬프트, 실행 결과)를 와이드 터미널에서 60~120 컬럼으로 자르던 문제 — 이제 상태 디테일이 터미널 전체 너비를 활용합니다.
• claude agents가 긴 세션 이름을 40 컬럼에서 자르던 문제 — 이름 컬럼이 터미널 너비에 맞춰 늘어납니다.
• claude agents 첨부가 백그라운드 서비스 재시작 직후 첫 시도에서 세션 목록으로 다시 튕기던 문제 수정.
• claude agents에서 디스패치 입력란과 세션 응답 박스에 Ctrl+V 이미지 붙여넣기가 작동하지 않던 문제 — 이미지가 없으면 힌트가 표시되도록 변경.
• ←로 세션을 백그라운드 전환할 때 백그라운드 서비스가 시작되지 못하면 대화가 조용히 사라지던 문제 — 이제 세션이 실패 행으로 목록에 남아 Enter로 깨울 수 있습니다.
• 에이전트 뷰에서 전송 실패한 응답이 사라지던 문제 — 이제 다음 세션 시작 시 전달되도록 큐에 적재됩니다.
• CLAUDE_CODE_TMPDIR 또는 $TMPDIR이 깊은 디렉터리를 가리킬 때 세션 간 메시징(SendMessage)이 조용히 끊기던 문제 수정.
• claude agents에서 실행 중인 백그라운드 세션을 열 때 첨부 전에 5초간 멈추던 문제 수정.
• stream-json/SDK 세션에서 턴 시작 직후에 보낸 인터럽트(Esc)가 조용히 무시되어 “Interrupted” 피드백 없이 턴이 계속 실행되던 문제 수정.

알아두면 좋은 점

• WebFetch 권한 규칙 우선순위 변경 — WebFetch(domain:...) deny/ask/allow 규칙이 사전 승인 호스트보다 우선하므로, 사전 승인된 도메인을 차단하거나 추가 확인을 요구하도록 정책을 잠갔던 환경에서는 규칙이 의도대로 작동하는지 한 번 점검하는 것이 좋습니다.
• Windows 권한 규칙 정규화 — 백슬래시, UNC 경로, 대소문자 차이로 우회되던 패턴이 정상 매칭되므로, 보수적으로 작성해 둔 deny 규칙이 이제 실제로 차단을 수행합니다. 정책이 의도보다 넓게 적용되는지 확인하세요.
• MCP 서버 timeout 설정 — 1000ms 미만 값을 사용하던 설정은 이제 무시되고 MCP_TOOL_TIMEOUT 또는 기본값이 적용됩니다. claude mcp get 출력으로 현재 적용된 타임아웃을 확인할 수 있습니다.
• --tools 사용 시 Grep/Glob 명시 — 네이티브 빌드에서 전용 검색 도구가 필요하면 Grep, Glob를 명시적으로 나열해야 합니다. 이번 버전부터 이름이 무시되지 않고 실제 도구가 제공됩니다.
• 슬래시 명령 자동완성 동작 변경 — 메뉴 클릭이 즉시 실행이 아니라 프롬프트 채우기로 바뀌었습니다. 클릭 후 Enter를 눌러야 실행됩니다.
• Windsurf 명칭 변경 — /ide, /terminal-setup, /scroll-speed에서 명칭이 Devin Desktop으로 표시되지만, 동일한 에디터를 가리키므로 별도 설정 변경은 필요하지 않습니다.