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

Claude Code 2.1.160

Claude Code 2.1.160은 보안과 워크플로우 트리거 두 축으로 정리되는 릴리스입니다. 셸 시작 파일(`.zshenv`, `.zlogin`, `.bash_login`)과 빌드 도구 설정 파일(`.npmrc`, `bunfig.toml` 등)에 쓰기 전에 확인 프롬프트를 띄워 의도치 않은 명령 실행을 막고, 다이내믹 워크플로우 트리거 키워드가 `workflow`에서 `ultracode`로 바뀌었습니다. 단일 파일 `grep` 사용이 Edit의 read-before-edit 요건을 만족하게 됐고, `claude agents`, 백그라운드 세션 재첨부, Windows/WSL 클립보드, 음성 모드 등 광범위한 버그 수정과 자동 모드 분류기 지연 개선이 포함됩니다.

공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.160은 2026년 6월 2일 출시됐습니다. 이번 릴리스의 큰 줄기는 두 가지입니다. 첫째, 셸 시작 파일과 빌드 도구 설정 파일에 대한 쓰기 보호로 의도치 않은 명령 실행 가능성을 차단합니다. 둘째, 다이내믹 워크플로우 트리거 키워드가 workflow에서 ultracode로 바뀌었습니다. 그 외 단일 파일 grep이 Edit의 read 요건을 만족하게 됐고, claude agents 세션 복원, 백그라운드 세션 재첨부, Windows/WSL 클립보드, 음성 모드 전반의 버그 수정과 자동 모드 분류기 지연 개선이 포함됩니다.

직전 두 버전은 별도 콘텐츠로 등록하지 않습니다. 2.1.158은 Bedrock, Vertex, Foundry에서 Opus 4.7/4.8 자동 모드를 옵트인(CLAUDE_CODE_ENABLE_AUTO_MODE=1)으로 사용 가능하게 한 단일 변경이고, 2.1.159는 사용자에게 영향 없는 내부 인프라 릴리스입니다. 2.1.158의 옵트인 변수는 아래 알아두면 좋은 점에 함께 메모합니다.

주요 개선

  • 셸 시작 파일 쓰기 보호

    이전에는 에이전트가 .zshenv, .zlogin, .bash_login 같은 셸 시작 파일이나 ~/.config/git/에 별도 확인 없이 쓸 수 있어 다음 셸 세션부터 의도치 않은 명령이 실행될 위험이 있었습니다. 이제 이 경로에 쓰기 전에 확인 프롬프트가 뜹니다.

  • acceptEdits 모드의 빌드 도구 설정 파일 보호

    acceptEdits 모드에서는 모든 편집이 자동 승인돼 코드 실행을 부여하는 빌드 도구 설정 파일(.npmrc, .yarnrc*, bunfig.toml, .bazelrc, .pre-commit-config.yaml, .devcontainer/ 등)이 무방비로 변경될 수 있었습니다. 이제 이런 파일은 acceptEdits에서도 쓰기 전에 별도 확인을 받습니다.

  • 단일 파일 grep이 Edit의 read 요건을 만족

    grep/egrep/fgrep으로 단일 파일을 본 뒤 그 파일을 Edit하려면 별도로 Read를 다시 호출해야 했습니다. 이제 단일 파일 grep 명령은 read-before-edit 검증을 통과합니다.

  • 다이내믹 워크플로우 트리거 키워드 workflowultracode

    프롬프트에 workflow라는 단어가 들어가면 의도치 않게 다이내믹 워크플로우가 트리거되는 사례가 있었습니다(2.1.157에서 /config로 끌 수 있게 된 그 동작). 이번에는 트리거 키워드 자체가 ultracode로 바뀌었습니다. “워크플로 만들어줘”처럼 자기 말로 요청하는 방식은 그대로 동작합니다. 프롬프트 입력에서 트리거 키워드는 보라색으로 강조됩니다.

  • 자동 모드 분류기 지연 감소

    자동 모드의 안전 분류기가 일상적인 동작에도 과도한 추론을 돌려 응답이 느려지고 “could not evaluate this action” 차단이 발생할 수 있었습니다. 일상적 동작의 추론량을 줄여 지연을 개선하고 차단 가능성을 낮췄습니다.

  • 백그라운드 세션 정리 시 SIGTERM 선행

    claude rm, stop, 또는 유휴 회수로 백그라운드 세션을 정리할 때 셸 서브프로세스에 바로 SIGKILL을 보내 정리 핸들러가 실행되지 못했습니다. 이제 SIGTERM을 먼저 보내 정리 핸들러를 실행한 뒤 SIGKILL로 진행합니다.

  • 최근 비활성 백그라운드 에이전트 세션 열기 성능 개선

    claude agents에서 최근 비활성 상태였던 백그라운드 에이전트 세션을 다시 열 때 응답이 느려지는 경우가 있었습니다. 성능을 개선했습니다.

주요 버그 수정

claude agents와 백그라운드 세션

  • claude agents에서 완료된 세션을 복원할 때 채팅 히스토리가 사라지고 원래 프롬프트가 재실행되던 문제 — 수정.
  • 밤 사이 회수된 후 재첨부된 백그라운드 세션이 대화를 잃고 원래 프롬프트를 재실행하던 문제 — 수정.
  • 부하가 큰 머신에서 백그라운드 데몬이 콜드 스타트 중일 때 claude --bg가 “socket missing”으로 실패하던 문제 — 수정.
  • 재개된 백그라운드 에이전트가 에이전트 목록의 Completed 아래에 표시되던 문제 — 수정.
  • 자동 업데이터가 매 종료마다 재확인을 돌려 세션 목록으로 돌아갈 때 claude agents가 몇 초간 멈추던 문제 — 수정.
  • claude agents 뷰에서 CJK IME 후보가 입력 캐럿 위치가 아니라 화면 왼쪽 아래에 뜨던 문제 — 수정.
  • 에이전트 목록에서 세션을 막 열었을 때 마우스 휠 스크롤이 트랜스크립트가 아니라 프롬프트 히스토리를 스크롤하던 문제 — 수정.
  • Apple Terminal과 tmux처럼 지원하지 않는 터미널에 백그라운드 에이전트가 sync-output 마커를 보내, 실행 중인 에이전트로 진입할 때 렌더 아티팩트가 생기던 문제 — 수정.

Windows와 WSL

  • WSL에서 copy-on-select가 Windows 클립보드에 안 써지던 문제 — MobaXterm 같은 OSC 52 미지원 터미널을 위해 PowerShell 인터럽으로 전환.
  • 호스트 CPU 부하가 높을 때 백그라운드 세션이나 에이전트 뷰에서 Esc, 화살표 키, 타이핑이 응답하지 않던 문제(Windows) — 수정.
  • claude rm 후에도 백그라운드 데몬이 종료될 때까지 백그라운드 세션이 시작된 디렉터리를 삭제할 수 없던 문제(Windows) — 수정.
  • 하이퍼링크를 지원하는 Windows 터미널에서 정상적인 file:///C:/... 링크가 깨진 경로로 다시 써지던 문제 — 수정.

모드, 모델, 입력

  • 프로젝트 디렉터리나 브랜치 이름에 비ASCII 또는 특수문자가 있으면 음성 모드 연결이 실패하던 문제 — 수정.
  • /effort ultracode가 xhigh를 지원하지 않는 모델에서 다이내믹 워크플로우 설정을 잘못 탓하던 문제 — 수정. ultracode는 지원하지 않는 모델에는 더 이상 제안되지 않습니다.
  • SDK나 CLI 플래그가 적용되지 않는 호스트에서 model-not-found 오류가 --model을 제안하던 문제 — 수정.
  • vim 모드에서 v$로 yank한 레지스터를 p로 붙여넣을 때 커서가 아니라 다음 줄에 붙던 문제 — 수정.
  • brief 모드 세션을 brief 모드를 끈 상태로 재개할 때 Claude의 이전 응답이 스크롤백에서 사라지던 문제 — 수정.
  • 자동 모드를 지원하지 않는 외부 공급자(Bedrock, Vertex, Foundry)에서 표시되던 오류 메시지가 모델을 탓하는 대신 CLAUDE_CODE_ENABLE_AUTO_MODE 옵트인을 안내하도록 수정.

제거

  • CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 환경 변수가 no-op으로 제거됨 — 2.1.154에서 예고한 대로 06/01 제거. Opus 4.6에서 Fast mode를 쓰려면 /model claude-opus-4-6[1m] 전환 후 /fast on을 사용하세요.
  • 시작 시 표시되던 JetBrains 플러그인 설치 제안 제거.

알아두면 좋은 점

  • 건너뛴 버전 안내 — 2.1.158은 Bedrock, Vertex, Foundry에서 Opus 4.7/4.8 자동 모드를 옵트인(CLAUDE_CODE_ENABLE_AUTO_MODE=1)으로 사용 가능하게 한 단일 변경이고, 2.1.159는 사용자에게 영향 없는 내부 인프라 변경이라 별도 콘텐츠로 등록하지 않습니다.
  • 외부 공급자에서 자동 모드 사용 — Bedrock, Vertex, Foundry에서 Opus 4.7/4.8의 자동 모드를 켜려면 CLAUDE_CODE_ENABLE_AUTO_MODE=1을 설정합니다(2.1.158 도입). 2.1.160에서 이 옵트인 안내가 오류 메시지에 정확히 표시됩니다.
  • 워크플로우 트리거 키워드 변경 — 다이내믹 워크플로우 자동 트리거를 받으려면 이제 workflow가 아니라 ultracode 키워드를 써야 합니다. 자기 말로 “워크플로 만들어줘”라고 요청하는 방식은 그대로 동작합니다.
  • acceptEdits에 새 확인 단계.npmrc, bunfig.toml처럼 코드 실행을 부여하는 빌드 도구 설정 파일은 acceptEdits 모드에서도 별도 확인 프롬프트가 뜹니다. 자동화 흐름이 멈춘다면 이 확인 단계 때문일 수 있습니다.