Claude Code 2.1.196

무엇이 바뀌었나?

Claude Code 2.1.196이 2026년 6월 29일 출시됐습니다. 조직 기본 모델 지정, 세션 기본 이름, 채팅 파일 첨부를 Finder/탐색기에서 열기 같은 새 기능이 추가됐고, 백그라운드 세션과 에이전트가 프로세스 중지, 재시작, 업데이트에도 작업을 이어가도록 안정성이 개선됐습니다. 스트리밍 유휴 감시(watchdog)가 모든 프로바이더에서 기본 활성화됐고, 백그라운드 작업과 claude agents 패널, 권한 관련 회귀가 대거 정리됐습니다.

새 기능

• 조직 기본 모델 지정

  지금까지 모델 기본값은 사용자마다 직접 골라야 했고, 조직 차원에서 표준 모델을 정해줄 방법이 없었습니다. 이제 관리자가 조직 콘솔에서 기본 모델을 설정할 수 있고, 사용자가 직접 모델을 고르지 않은 경우 /model에 “Org default”(또는 “Role default”)로 표시됩니다.

• 세션 기본 이름 자동 부여

  세션이 처음에는 식별자가 없어 어느 세션인지 구분하거나 메시지를 보내기 어려웠습니다. 이제 세션 시작 시 읽기 쉬운 기본 이름이 부여돼 구분과 메시지 전송이 쉬워졌습니다.

• 채팅 파일 첨부를 Finder/탐색기에서 열기

  채팅에 첨부된 파일이 실제 디스크 어디에 있는지 바로 확인할 수 없었습니다. 이제 첨부 파일을 Cmd/Ctrl-클릭하면 Finder/탐색기에서 해당 파일 위치가 열립니다.

주요 개선

• 백그라운드 세션 안정성 강화

  세션 프로세스가 중지, 재시작, 업데이트되면 진행 중이던 장기 실행 명령이나 워크플로가 끊겼습니다. 이제 이런 작업이 프로세스 변경에도 살아남으며, Windows에서도 백그라운드 셸을 종료하지 않고 인계(hand off)합니다.

• 백그라운드 에이전트 자동 재개

  데몬이 재시작되면 그때 실행 중이던 워커가 종료되고 작업이 사라졌습니다. 이제 데몬 재시작으로 종료된 워커는 다음에 agents view를 열 때 중단된 지점부터 자동으로 재개됩니다.

• 보안: 자가 승인된 .mcp.json 서버 실행 차단

  리포가 커밋된 .claude/settings.json으로 스스로 승인한 .mcp.json 서버를 claude mcp list/get이 그대로 실행할 수 있어, 신뢰하지 않은 워크스페이스에서도 서버가 떠버렸습니다. 이제 두 명령은 이런 서버를 실행하지 않으며, 신뢰하지 않은 워크스페이스에서는 ⏸ Pending approval로 표시됩니다.

• 스트리밍 유휴 감시(watchdog) 기본 활성화

  응답 스트림이 멈춰버려도 이를 감지해 끊고 재시도하는 장치가 일부 환경에만 적용됐습니다. 이제 모든 프로바이더에서 스트리밍 유휴 감시가 기본 활성화돼, 5분 동안 스트림에 이벤트가 없으면 자동으로 중단하고 재시도합니다. CLAUDE_ENABLE_STREAM_WATCHDOG=0으로 끌 수 있습니다.

• /code-review 토큰 사용량 약 25% 절감

  /code-review가 정리(cleanup) 관련 검사를 다섯 개의 별도 finder로 나눠 실행해 토큰을 많이 썼습니다. 다섯 개를 하나로 통합해 토큰 사용량을 약 25% 줄였습니다.

• 터미널 렌더링 작업 감소

  스트리밍 중 변하지 않는 화면 영역까지 매 프레임 다시 순회했습니다. 변화 없는 하위 트리(subtree) 순회를 건너뛰어 프레임당 렌더링 부담을 줄였습니다.

주요 버그 수정

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

• 백그라운드 작업을 깨울 때 대화가 영구 삭제되던 문제 — transcript 점검 로직이 정상 transcript를 잘못 읽어 대화를 삭제하고 원래 프롬프트를 다시 실행했습니다. 이제 해당 파일은 따로 보관되며 삭제되지 않습니다.
• 백그라운드 세션의 한 턴 뒤에 recap 줄이 중복 표시되던 문제 수정. 스키마에서 거부된 StructuredOutput 시도가 재시도 결과와 나란히 렌더링되지 않습니다.
• claude agents 사이드 패널의 여러 문제 수정 — 에이전트를 열 때 키보드 포커스가 고정되던 문제, 패널을 열 때마다 백그라운드 작업이 서브에이전트 유형을 잃던 문제, 실제로는 실행 중인 세션이 잘못된 상태로 표시되던 문제.
• claude agents --dangerously-skip-permissions가 bypass 안내 없이 조용히 auto 모드로 떨어지던 문제 수정. 이제 bypass 고지가 표시되고 생성되는 에이전트에도 bypass 모드가 적용됩니다.
• Remote 세션의 턴 도중 크래시 복구 문제 수정 — 서버 재시작으로 중단된 세션이 다음 워커에서 자동으로 재개됩니다.
• claude agents 세션 상태 표시 문제 수정 — 완료된 행이 “Done”과 “Needs your input”을 오가지 않고, 멈춘 에이전트는 “Needs attention”으로 표시되며, PR을 언급하는 결과에는 클릭 가능한 링크가 붙습니다.

모델과 컨텍스트

• Bedrock에서 /context가 모든 도구 그룹을 0 토큰으로 표시하던 문제 수정.
• 병렬 요청 중 사용량 한도에 도달했을 때 rate-limit 경고가 깜빡이며 사라지고 텔레메트리가 과다 집계되던 문제 수정.

셸과 플러그인

• PowerShell에서 git diff/git grep, egrep/fgrep, |를 포함한 따옴표 검색 패턴이 종료 코드 1로 끝나면 실패로 보고되던 문제 수정. 이제 Bash와 동일하게 처리됩니다.
• claude plugin validate가 소스가 ”.”인 로컬 플러그인을 건너뛰고 첫 오류 부류에서 멈추던 문제 수정.
• 마켓플레이스를 git 리포 기반 로컬 폴더 경로로 추가했을 때 플러그인 의존성 버전 고정(version pin)이 지켜지지 않던 문제 수정.

인증과 기타

• MCP OAuth가 scope를 지정하지 않으면 인증 서버의 전체 scopes_supported 목록을 요청해 GitLab 셀프호스트 등 엔터프라이즈 IdP에서 invalid_scope로 실패하던 문제 수정.
• 유휴 프롬프트에서 Esc Esc로 rewind 메뉴가 열리지 않던 회귀 수정. 백그라운드 에이전트 중지는 Ctrl+C 또는 Ctrl+X Ctrl+K를 사용합니다.
• /deep-research가 검증자(verifier) 실패를 unverified가 아니라 “all claims refuted”로 잘못 보고하던 문제 수정.
• /cd로 옮긴 세션이 비정상 종료 후, 이전 경로에 특수문자가 있으면 옛 디렉토리의 resume 목록에 다시 나타나던 문제 수정.
• 음성 모드에서 매우 빠르게 타이핑할 때 음성 받아쓰기가 공백을 삼키거나 녹음이 잘못 시작되던 문제 수정.

알아두면 좋은 점

• 스트리밍 유휴 감시 끄기 — 모든 프로바이더에서 기본 활성화됐으며, 5분 무이벤트 시 중단 후 재시도합니다. 동작을 원치 않으면 CLAUDE_ENABLE_STREAM_WATCHDOG=0으로 끌 수 있습니다.
• Anthropic 외 호스트에서 Remote Control 비활성화 — ANTHROPIC_BASE_URL이 Anthropic이 아닌 호스트를 가리키면 Remote Control이 비활성화됩니다. 기존 CLAUDE_CODE_USE_BEDROCK/_VERTEX/_FOUNDRY 동작과 일치합니다.
• agents view 열기 단축키 변경 — 포그라운드 세션에서 agents view를 열 때 ←를 두 번이 아니라 한 번만 누르면 됩니다. 백그라운드 세션과 동일한 동작입니다.
• 조직 기본 모델은 관리자 설정 — 조직 콘솔에서 관리자가 지정하며, 사용자가 직접 고른 모델이 없을 때만 /model에 “Org default”로 적용됩니다.