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

Claude Code 2.1.187

보안과 안정성 위주의 릴리스입니다. 샌드박스 명령이 자격 증명 파일과 비밀 환경변수를 읽지 못하게 막는 sandbox.credentials 설정, 조직이 지정한 모델 제한을 모델 피커와 --model, /model, ANTHROPIC_MODEL에 적용하는 기능, 전체 화면 모드 선택 메뉴의 마우스 클릭 지원이 추가됐습니다. 응답 없이 5분간 멈추던 원격 MCP 도구 호출이 무한 대기 대신 오류로 중단되도록 바뀌었고, 한국어/CJK 붙여넣기가 깨지던 문제, --resume가 빈 -p 실행에서 실패하던 문제 등 재개, 원격, 터미널 관련 수정이 다수 포함됐습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.187이 2026년 6월 23일 출시됐습니다. 샌드박스 자격 증명 보호와 조직 모델 제한 같은 보안 통제가 추가되고, 응답 없이 멈추던 원격 MCP 도구 호출과 한국어/CJK 붙여넣기 깨짐, --resume 실패 등 재개, 원격, 터미널 안정성 관련 수정이 대거 정리됐습니다.

새 기능

  • sandbox.credentials 설정

    샌드박스에서 실행되는 명령도 자격 증명 파일이나 비밀 환경변수를 그대로 읽을 수 있어, 민감한 값이 명령에 노출될 여지가 있었습니다. 새 sandbox.credentials 설정으로 샌드박스 명령이 자격 증명 파일과 비밀 환경변수를 읽지 못하게 막을 수 있습니다.

  • 조직이 지정한 모델 제한 적용

    조직에서 허용 모델을 정해도 모델 선택 경로마다 제한이 일관되게 걸리지 않았습니다. 이제 조직이 지정한 모델 제한이 모델 피커, --model, /model, ANTHROPIC_MODEL에 적용되며, 제한된 모델을 선택하면 “restricted by your organization’s settings” 메시지가 표시됩니다.

  • 전체 화면 모드 선택 메뉴의 마우스 클릭 지원

    전체 화면 모드에서는 권한 프롬프트, /model, /config 같은 선택 메뉴를 키보드로만 조작할 수 있었습니다. 이제 이런 선택 메뉴에서 마우스 클릭으로 항목을 고를 수 있습니다.

주요 개선

  • /install-github-app 워크플로 설정 선택화

    /install-github-app은 GitHub App 설치와 GitHub Actions 워크플로 설정을 한 묶음으로 진행해, App만 필요한 사용자에게도 워크플로와 시크릿 단계가 강제됐습니다. 이제 워크플로 설정이 선택 사항이 되어, GitHub App만 설치하고 워크플로, 시크릿 단계는 건너뛸 수 있습니다.

  • /btw 답변 탐색

    /btw로 이전 답변을 다시 살펴보기 어려웠습니다. 이제 ←/→ 화살표로 앞선 답변을 단계별로 넘겨볼 수 있습니다.

  • /plugin에서 미사용 플러그인 정리 지원

    오래 쓰지 않은 플러그인을 따로 찾아 정리하기 번거로웠습니다. 이제 /plugin이 최근에 사용하지 않은 플러그인을 함께 보여줘 정리하기 쉬워졌습니다.

주요 버그 수정

세션과 재개

  • --resume가 “No conversation found”로 실패하던 문제 — 원래 -p 실행이 모델 턴을 하나도 만들지 않았을 때 발생했습니다. 이제 정상적으로 재개됩니다.
  • [VS Code] 큰 세션을 재개할 때 확장이 응답하지 않던 문제 수정.

에이전트와 구조화 출력

  • --json-schema와 워크플로 agent({schema}) 구조화 출력 문제 — 성공한 호출 이후에도 모델이 StructuredOutput을 무한 재호출할 수 있었고, 후속 턴이 구조화 출력을 안정적으로 반환하지 못했습니다. 둘 다 수정됐습니다.
  • agents view의 백그라운드 작업이 “working”으로 무한 멈추던 문제 — 에이전트가 구조화 출력 없이 턴을 끝냈을 때 발생했습니다. 수정됨.
  • 서브에이전트 깊이 추적 문제 수정 — 재개된 서브에이전트가 원래 spawn 깊이를 복원하고, 포크된 서브에이전트가 깊이 한도에 포함됩니다.
  • 종료된 에이전트가 남긴 잠긴 .git/worktrees/ 항목이 정리되지 않던 문제(worktree 등록 누수) 수정 — 이제 자동으로 정리됩니다.

원격과 MCP

  • 응답 없이 5분간 멈추던 원격 MCP 도구 호출 — 무한 차단 대신 오류로 중단됩니다(CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT로 조정 가능).
  • 에이전트 프록시 CA 시스템 신뢰 설치가 추가된 뒤 Claude Code Remote 세션 시작이 ~2.7초 느려지던 문제 수정.
  • 시작 시 신뢰 다이얼로그가 표시될 상황에서 Remote Control로 /update가 멈추던 문제 수정.
  • agents view로 이동했다 돌아오거나 /bg, /tui, /update 후 채널 연결이 끊기던 문제 수정.

알림과 터미널

  • 에이전트 종료 알림이 누가 에이전트를 멈췄는지 정확히 표시하지 못하던 문제 수정. 표현도 개선됐습니다(“came to rest” 대신 “finished”/“stopped”).
  • 붙여넣기를 바이트 단위 extended-key 이벤트로 전달하는 터미널에서 한국어/CJK 붙여넣기가 깨지던(mojibake) 문제 수정.
  • macOS Ghostty 전체 화면 모드에서 Cmd+클릭으로 URL이 열리지 않던 문제 수정.
  • claude --help가 --bg/--background 플래그를 표시하지 않던 문제 수정.
  • /share 업로드 중 Esc, Ctrl-C, Ctrl-D가 동작하지 않던 문제 수정.

알아두면 좋은 점

  • sandbox.credentials는 opt-in 설정 — 샌드박스 명령이 자격 증명 파일과 비밀 환경변수를 읽지 못하게 막으려면 이 설정을 직접 켜야 합니다.
  • 원격 MCP 도구 타임아웃 조정 — 응답 없는 호출을 끊는 5분 기본값은 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT 환경변수로 바꿀 수 있습니다.
  • 한국어/CJK 붙여넣기 깨짐 해소 — 일부 터미널에서 붙여넣은 한글이 깨지던 문제가 수정됐습니다. 그동안 우회하던 사용자는 업데이트 후 정상 동작을 확인할 수 있습니다.
  • --bg/--background 플래그 확인 — claude --help에 누락돼 있던 백그라운드 실행 플래그가 이제 목록에 표시됩니다.