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

Claude Code 2.1.176

세션 제목이 대화에 사용한 언어로 생성되고, `footerLinksRegexes` 설정으로 푸터에 정규식 매칭 링크 배지를 추가할 수 있습니다. Bedrock 자격 증명은 고정 1시간 대신 실제 만료 시각까지 캐시됩니다. `ANTHROPIC_DEFAULT_*_MODEL`로 차단된 모델을 우회하던 문제, Opus 4.8이 없는 조직에서 Fable 5 auto 모드가 실패하던 문제, `Edit(src/**)` 같은 훅 `if` 경로 조건이 매칭되지 않던 문제와 함께 Remote Control, 백그라운드 세션, 에이전트 영역의 회귀가 폭넓게 정리되었습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.176이 2026년 6월 12일(현지 시간) 릴리스되었습니다. 세션 제목을 대화 언어로 생성하고 푸터 링크 배지를 정규식으로 정의할 수 있게 하는 두 가지 추가와 함께, 모델 정책, 훅, 샌드박스, Remote Control, 백그라운드 세션, 에이전트 영역의 회귀를 폭넓게 정리한 릴리스입니다. 차단된 모델로 우회 전환이 가능하던 문제, Opus 4.8이 없는 조직에서 auto 모드가 Fable 5에서 실패하던 문제, 문서화된 훅 if 경로 조건이 실제로 매칭되지 않던 문제처럼 정책과 자동화에 직접 영향을 주는 결함이 다수 포함되어 있습니다.

새 기능

  • 세션 제목을 대화 언어로 생성

    세션 제목이 대화에 사용한 언어와 무관하게 생성되어 비영어권 사용자에게는 어색하게 보일 수 있었습니다. 이제 대화에서 사용한 언어로 세션 제목이 생성되며, 특정 언어로 고정하고 싶다면 language 설정을 지정하면 됩니다.

  • footerLinksRegexes — 푸터 링크 배지를 정규식으로 정의

    푸터 행에 표시되는 링크 배지를 사용자가 직접 정의할 방법이 없었습니다. 새 footerLinksRegexes 설정으로 정규식에 매칭되는 링크를 배지로 표시할 수 있으며, 사용자 설정 또는 관리(managed) 설정에서 구성할 수 있습니다.

주요 개선

  • Bedrock 자격 증명 캐시를 실제 만료 시각 기준으로 변경

    awsCredentialExport로 가져온 자격 증명을 항상 1시간 고정으로 캐시해, 실제 만료(Expiration)가 더 길어도 1시간마다 불필요하게 재발급하거나 만료 시각 관리가 어긋날 수 있었습니다. 이제 자격 증명에 명시된 Expiration 시각까지 캐시합니다.

  • 자동 업데이트 이후 백그라운드 세션 안내 개선

    자동 업데이트를 가로질러 열려 있던 창이 응답을 제출하지 못할 때 원인을 알기 어려웠습니다. 이제 더 명확한 안내가 표시되고, claude daemon status가 버전 차이(version-skew) 상황의 동작을 설명합니다.

주요 버그 수정

모델, 정책

  • ANTHROPIC_DEFAULT_*_MODEL 환경변수로 별칭(alias) 모델 선택을 차단된 모델로 우회 전환할 수 있던 문제 수정. 이제 availableModels 허용 목록이 강제되며, /fast도 허용 목록 밖 모델로 전환되는 경우 토글을 거부합니다.
  • Opus 4.8이 활성화되지 않은 조직에서 auto 모드가 Fable 5에서 실패하던 문제 — 이제 분류기가 사용 가능한 최선의 Opus 모델로 폴백합니다.

훅, 샌드박스

  • Read/Edit/Write 도구 경로에 대한 훅 if 조건이 매칭되지 않던 문제 수정 — Edit(src/**), Read(~/.ssh/**), Read(.env)처럼 문서화된 패턴이 이제 정상적으로 매칭됩니다.
  • .claude/settings.json이 절대 경로를 가리키는 심볼릭 링크일 때 Linux 샌드박스가 시작되지 않던 문제 수정.

Remote Control

  • 웹/모바일에서 Remote Control로 접속하면 세션 모델이 조용히 전환되던 문제 수정.
  • Remote Control 연결 해제 알림이 사람이 읽을 수 있는 사유 대신 숫자 코드만 표시하고, 연결 실패가 대화 기록에 중복 줄을 추가하던 문제 수정.
  • 다른 계정으로 로그인해도 기존 Remote Control 세션이 연결 해제되지 않던 문제 수정.

백그라운드 세션, 에이전트

  • claude agents에서 한 창에서 뒤로 가기를 누르면 같은 세션에 연결된 다른 창까지 분리되던 문제 수정.
  • 턴 도중 /bg로 백그라운드 전환했으나 이어갈 작업이 없던 세션이 계속 “Working” 상태로 남던 문제 수정.
  • 예약 깨우기 중이거나 작업이 차단된 동안 열린 PR이 claude agents 검색에 나타나지 않던 PR URL 검색 문제 수정.
  • Windows에서 에이전트 화면 입력란에 텍스트 커서가 보이지 않던 문제 수정.
  • claude --bg -cn <name>이 세션 이름을 시드(seed)하지 못하던 문제 수정.
  • 백그라운드 세션 재시작 시 저장된 상태의 Windows 네트워크 경로가 그대로 남던 문제 — 이제 재시작 전에 무력화(neutralize)합니다.
  • 손상된 상태 파일의 잘못된 형식의 resume ID 때문에 백그라운드 세션 재시작이 거부되던 문제 수정.
  • ~/.claude/daemon에 읽기 전용(ReadOnly) 속성이 설정되면 Windows 백그라운드 서비스 데몬이 시작되지 않던 문제 수정.
  • 클라우드 세션이 클레임되기 전에 너무 오래 유휴 상태로 있으면 “Could not resolve authentication method” 오류로 실패하던 문제 수정.

클립보드, 디렉터리

  • SSH로 접속한 tmux 안에서 /copy와 마우스 선택 복사가 시스템 클립보드에 도달하지 않고, 3.2 미만 버전에서 tmux 붙여넣기 버퍼가 로드되지 않던 문제 수정.
  • /cd와 워크트리 이동 후에도 세션이 이전 디렉터리의 git 브랜치를 보고하던 문제 수정.

알아두면 좋은 점

  • 차단된 모델로의 우회 전환 차단 — ANTHROPIC_DEFAULT_*_MODEL 환경변수로 별칭 모델을 허용 목록 밖 모델로 바꿔치기할 수 있었습니다. 이번 릴리스에서 availableModels 허용 목록이 강제되므로, 모델 접근을 정책으로 제한하는 조직은 업데이트가 권장됩니다.
  • 훅 if 경로 조건 수정 — Edit(src/**), Read(~/.ssh/**), Read(.env) 같은 문서화된 경로 패턴에 의존하는 훅을 운영 중이었다면, 이번 버전에서 매칭이 정상화되었으므로 의도대로 동작하는지 확인해 두는 것이 좋습니다.
  • Bedrock 자격 증명 캐싱 — awsCredentialExport로 자격 증명을 주입하는 Amazon Bedrock 환경은 이제 자격 증명의 Expiration까지 캐시되어, 만료 시각이 1시간보다 길거나 짧은 경우 모두 더 정확하게 처리됩니다.
  • 세션 제목 언어 고정 — 세션 제목을 항상 특정 언어로 생성하고 싶다면 language 설정으로 고정할 수 있습니다.
  • footerLinksRegexes — 푸터에 노출할 링크 배지를 정규식으로 정의하려면 사용자 또는 관리 설정에 이 키를 추가합니다.