Claude Code 2.1.211

무엇이 바뀌었나?

Claude Code 2.1.211이 2026년 7월 15일 출시됐습니다. 새 기능은 서브에이전트 출력을 stream-json으로 넘기는 플래그 하나지만, 나머지는 안정화에 집중한 릴리스입니다. Bedrock, Vertex 계열의 프롬프트 캐싱 청구 회귀, auto 모드와 훅 권한 충돌, 백그라운드 에이전트의 재생성, 삭제, 결과 보고 문제가 대거 정리됐고, always allow 승인이 worktree 간에 유지되도록 저장 위치가 바뀌었습니다.

새 기능

• --forward-subagent-text로 서브에이전트 출력을 stream-json에 포함

  stream-json 출력에는 서브에이전트의 텍스트와 thinking이 포함되지 않아, 스크립트나 자동화에서 서브에이전트가 무엇을 하고 있는지 실시간으로 볼 수 없었습니다. 이제 --forward-subagent-text 플래그와 CLAUDE_CODE_FORWARD_SUBAGENT_TEXT 환경변수로 서브에이전트의 텍스트와 thinking을 stream-json 출력에 포함할 수 있습니다.

주요 개선

• always allow 권한 규칙을 리포지토리 루트에 저장

  git worktree에서 always allow로 승인해도 그 worktree 안에서만 적용돼, 다른 세션이나 worktree에서는 같은 도구를 다시 승인해야 했습니다. 이제 규칙이 리포지토리 루트에 저장돼 한 번 준 승인이 세션과 worktree 전체에서 유지됩니다.

• 백그라운드 에이전트 결과 보고 개선

  아직 실행 중인 백그라운드 에이전트에 대해 Claude가 완료된 것처럼 결과를 지어내 보고하는 경우가 있었습니다. 이제 실행 중인 에이전트의 상태를 그대로 보고하고, 실제 완료 시점까지 기다립니다.

• 정수 환경변수에 과학적 표기, 자리 구분자 허용

  타임아웃, 토큰 예산, 재시도 횟수 같은 정수 환경변수는 순수 숫자 표기만 받았습니다. 이제 1e6, 64_000 같은 과학적 표기와 자리 구분자 표기도 받습니다.

• 메모리 인덱스 초과 경고를 로드된 콘텐츠만 기준으로 측정

  메모리 인덱스 한도 초과 경고가 frontmatter와 HTML 주석까지 크기에 포함해, 실제로 로드되지 않는 부분 때문에 경고가 뜨기도 했습니다. 이제 실제로 로드되는 콘텐츠만 측정합니다.

• /usage-credits 요청 전 확인 — 조직 관리자에게 요청을 보내기 전에 확인을 묻습니다.

• Vim 모드 s, S를 NORMAL 모드에서 동작 — 문자, 행 치환(substitute)이 vim 동작과 일치하도록 NORMAL 모드에서 작동합니다.

• Claude in Chrome 스크린샷 save_to_disk 동작 — 스크린샷 액션의 save_to_disk가 이전에는 아무 동작도 하지 않았으나, 이제 실제로 이미지를 디스크에 쓰고 경로를 반환합니다.

• 기타 — 터미널 레이아웃, 렌더링 성능 개선, 문서 링크를 현재 docs 사이트로 갱신, [VS Code] Remote Control 배너가 기능을 설명하도록 갱신, Windows에서 동기화된 skill/plugin 디렉토리 이름 처리 강화(및 /clear 후에도 CCR 웹 fetch/search 프록시 유지).

주요 버그 수정

보안과 권한

• 채팅 채널로 전달되는 권한 미리보기의 위장 문자 — 양방향 재정의(bidirectional-override), 폭 0(zero-width), 유사 따옴표 문자를 중화하지 않아 도구 입력이 승인 메시지를 시각적으로 변조할 수 있던 문제 수정.
• auto 모드가 PreToolUse 훅의 ask 결정을 덮어쓰던 문제 — 샌드박스 밖 Bash에서 auto 모드가 훅의 ask를 무시했습니다. 이제 훅의 ask가 최소한 프롬프트로 보장됩니다.
• 파일 업로드 검증 — .prn 같은 DOS 장치 접미사나 끝에 점이 붙은 파일명이 이제 허용되고, 하드 링크가 여러 개인 파일은 거부됩니다.
• Claude in Chrome 파일 업로드 경로 검증 강화.

모델과 캐싱

• Bedrock, Vertex, Mantle, Foundry 프롬프트 캐싱 회귀 — 맨 뒤 시스템 컨텍스트 블록을 매 요청마다 새 입력 토큰으로 청구하던 문제 수정.
• Vertex, Bedrock에서 모델을 명시적으로 지정했는데도 시작 시 기본 Opus 모델을 시도하고 잘못된 폴백 안내를 출력하던 문제 수정.
• 명시적 모델 오버라이드로 생성한 서브에이전트가 재개되거나 후속 메시지를 받으면 부모의 모델로 되돌아가던 문제 수정.

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

• 여러 세션이 하나의 자격 증명 저장소를 공유할 때, 절전 복귀 후 병렬 세션이 동시에 로그아웃되던 문제 수정.
• 유휴 웹 세션이 깨어난 뒤 플러그인 MCP 서버가 재연결되지 않아 다음 메시지 전까지 MCP 호출이 실패하던 문제 수정.
• 방금 중지한 백그라운드 세션을 agents view에서 다시 열면 같은 세션 ID로 빈 대화가 시작되던 문제 수정.
• /loop를 한 번 사용하면 그 세션이 /resume 목록에서 사라지던 문제 수정.
• LLM 게이트웨이 인증(ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL) 백그라운드 작업이 데몬 재생성 후 “Not logged in”으로 돌아오던 문제 수정.
• git이 worktree를 더 이상 인식하지 못할 때 claude agents 작업이 영구히 삭제 불가능해지던 문제 — 이제 조용히 다시 나타나는 대신 삭제가 거부된 이유를 행에 표시합니다.
• 프롬프트에 링크가 들어 있으면 agents view의 백그라운드 세션 제목이 이름 생성 모델의 거부 텍스트를 보여주던 문제 수정.
• 사용자가 종료한 백그라운드 에이전트가 자동으로 다시 살아나고, 되살아난 에이전트가 이전 세션의 오래된 프롬프트를 재실행하던 문제 수정.
• 일정 없는 routine이 다음 실행 시각을 1년(year 1)으로 보고하던 문제 수정.

설정과 메모리

• 설정 소스가 프로젝트 설정을 제외해도 중첩된 .claude/rules/*.md 파일이 로드되던 문제 수정.
• /clear가 세션 비용 카운터를 초기화하지 않던 문제 — 이제 /clear 후 상태줄의 비용이 $0부터 시작합니다.

터미널과 플랫폼

• 원격, CLI 세션에서 Claude in Chrome으로의 파일 업로드 수정.
• 입력을 ”?”로 남기는 편집이 조용히 삼켜지고 단축키 패널을 토글하던 문제 수정.
• Claude in Chrome 확장이 켜져 있지만 Chrome이 실행 중이 아닐 때 시작이 멈추던 문제 수정.
• 비동기 콘텐츠(Settings 탭, Stats, diff 뷰 등 로딩 상태)가 나타나기까지 300ms 지연되던 문제 수정.
• 스크린 리더 사용자가 /terminal-setup이나 온보딩 터미널 설정 후 터미널 벨 소리를 잃던 문제 수정.
• Windows에서 Claude in Chrome 설정 페이지가 브라우저에서 열리지 않던 문제 수정.
• Windows에서 stdin을 읽을 수 없을 때 헤드리스 print 모드 세션이 크래시하거나 조용히 종료되던 문제 수정.

알아두면 좋은 점

• 버그 수정 중심 릴리스 — 새 기능은 --forward-subagent-text 하나이고, 나머지는 신뢰성, 안정화 수정입니다.
• Bedrock, Vertex 계열 청구 확인 — 프롬프트 캐싱 회귀 수정으로, 맨 뒤 시스템 컨텍스트 블록이 매 요청마다 새 입력 토큰으로 중복 청구되던 문제가 해소됩니다. Bedrock, Vertex, Mantle, Foundry 사용자는 업데이트 후 토큰 청구를 확인해 두면 좋습니다.
• always allow 승인 위치 변경 — 승인이 이제 리포지토리 루트에 저장됩니다. 여러 worktree를 쓰는 경우 한 번의 승인이 전체에 적용되므로, 이전과 다른 곳에 규칙이 저장된다는 점을 알아두면 좋습니다.