Claude Code 2.1.217

무엇이 바뀌었나?

Claude Code 2.1.217이 2026년 7월 21일 출시됐습니다. 프롬프트 입력창에 이모지 shortcode 자동완성이 추가되고, 트랜스크립트가 조용히 사라지던 상황을 알려주는 경고가 생겼습니다. 이번 릴리스의 큰 축은 서브에이전트 폭주 제어로, 동시 실행 수 상한과 중첩 생성 기본 비활성화, 예산 상한 연동이 함께 들어왔습니다. 그 밖에 Claude Desktop의 사내 네트워크 설정, Bedrock 자동 압축, 메모리 누수 등 엔터프라이즈와 안정성 관련 수정이 다수 포함됐습니다.

새 기능

• 이모지 shortcode 자동완성

  이모지를 넣으려면 입력창 밖에서 문자를 복사해 붙여야 했습니다. 이제 프롬프트 입력창에서 :heart:를 입력하면 ❤️로 바뀌고, :hea처럼 일부만 입력하면 후보가 제안됩니다. 원치 않으면 emojiCompletionEnabled 설정으로 끌 수 있습니다.

• 트랜스크립트 기록 실패 경고

  디스크가 가득 찼거나 상속된 환경변수 때문에 세션 저장이 꺼져 있으면, 트랜스크립트가 저장되지 않는데도 아무 알림 없이 조용히 유실됐습니다. 이제 기록이 실패하거나 세션 저장이 꺼진 상태를 경고로 알려줍니다.

주요 개선

• 동시 실행 서브에이전트 수 상한

  한 메시지가 백그라운드 서브에이전트를 제한 없이 분기시킬 수 있어, 의도치 않게 다수가 동시에 돌 수 있었습니다. 이제 동시 실행 수에 기본 상한(20)이 적용되며, CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS로 조정할 수 있습니다.

• 서브에이전트 중첩 생성 기본 비활성화

  서브에이전트가 다시 서브에이전트를 만드는 중첩 생성이 예기치 않은 확산으로 이어질 수 있었습니다. 이제 기본적으로 서브에이전트는 중첩 서브에이전트를 만들지 않으며, 더 깊은 중첩이 필요하면 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH로 허용해야 합니다.

• --max-budget-usd 상한이 백그라운드 서브에이전트까지 중지

  예산 상한에 도달해도 백그라운드에서 돌던 서브에이전트는 멈추지 않아, 설정한 상한을 넘겨 비용이 발생할 수 있었습니다. 이제 상한에 도달하면 새 생성이 거부되고 실행 중인 백그라운드 에이전트도 함께 중지됩니다.

• 푸터 PR 배지 링크를 하이퍼링크로 표시

  ssh나 tmux처럼 터미널의 하이퍼링크 지원을 감지할 수 없는 환경에서는 푸터의 PR 배지가 클릭되지 않았습니다. 이제 지원 여부를 감지하지 못해도 클릭 가능한 하이퍼링크로 표시되며, 원치 않으면 FORCE_HYPERLINK=0으로 끌 수 있습니다.

• 로그인 만료 경고를 만료 3일 전으로

  로그인 만료 경고가 만료 5일 전부터 표시돼 실제 만료까지 여유가 커 알림 피로가 있었습니다. 이제 만료 3일 전부터 표시됩니다.

• frontend-design 플러그인 추천 팁 노출 제한

  frontend-design 플러그인 추천 팁이 계속 반복해서 표시됐습니다. 이제 계정당 최대 3회까지만 노출됩니다.

주요 버그 수정

세션과 재개

• Bedrock의 Claude Opus 4.8에서 자동 압축이 전혀 동작하지 않고, 한도를 넘긴 뒤에는 /compact도 실패하던 문제 수정.
• 트랜스크립트에 잘못된 형식의 첨부 항목이 있으면 --resume/--continue와 /resume이 TypeError로 실패하던 문제 수정.
• 시작 중인 백그라운드 세션에 attach할 때 트랜스크립트 미리보기가 입력 영역에 바짝 붙어, 세션이 넘겨받는 순간 화면이 밀리던 문제 수정. 이제 실시간 레이아웃과 동일하게 한 줄 간격을 둡니다.

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

• 백그라운드 세션 격리가 심볼릭 링크로 연결된 작업 디렉토리를 정규화하지 않아, 세션이 지정된 작업 폴더 밖으로 벗어날 수 있던 문제 수정.
• 세션을 백그라운드로 보내거나(/background 또는 ←) 부하가 큰 머신에서 세션이 종료될 때 백그라운드 셸을 중지할 수 없게 되던 문제 수정. Windows에서 특히 두드러졌습니다.

엔터프라이즈와 네트워크

• Claude Desktop 세션에서 사내 mTLS, TLS 검증, OAuth 스코프, 프록시 설정이 무시되던 문제 수정.
• 관리형 설정이 지정한 OTEL_EXPORTER_OTLP_ENDPOINT가 일부 신호에만 적용되던 문제 수정. 이제 하위 스코프의 신호별 오버라이드가 텔레메트리를 관리형 엔드포인트 밖으로 돌려보내지 못합니다.

플랫폼과 안정성

• 잘린 MCP 도구 출력이 세션이 끝날 때까지 잘리지 않은 전체 결과를 메모리에 계속 붙들고 있던 메모리 누수 수정.
• Windows 자동 업데이트가 실패하면서 claude.exe가 사라질 수 있던 문제 수정. 실패한 업데이트는 이제 보존해 둔 실행 파일을 자동으로 복구합니다.
• CLAUDE.md나 SKILL.md의 paths frontmatter 값에 중괄호 그룹이 많으면 시작 시 CLI가 OOM으로 종료되거나 멈추던 문제 수정. 이제 중괄호 확장에 예산 상한이 적용됩니다.
• 스크린 리더 모드의 시작 안내가 첫 프롬프트 렌더링에 잘리고, thinking 상태 줄이 경과 시간과 토큰 수를 갱신하느라 몇 초마다 다시 렌더링되던 문제 수정.
• Remote Control 세션에서 권한 프롬프트나 다이얼로그가 뜬 뒤 접속한 뷰어에게 그 대기 중인 프롬프트가 보이지 않던 문제 수정.

알아두면 좋은 점

• 서브에이전트 중첩이 이제 기본으로 꺼집니다 — 2.1.172에서 서브에이전트의 중첩 생성이 최대 5단계까지 열렸지만, 이번 릴리스부터는 기본적으로 중첩 생성을 하지 않습니다. 여러 단계 위임에 의존하던 워크플로가 있다면 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH로 중첩 깊이를 다시 허용해야 합니다.
• 동시 서브에이전트 기본 상한은 20 — 한 메시지가 대규모 병렬 작업을 분기하던 워크플로라면, 이제 동시 실행이 기본 20개로 제한됩니다. 더 많은 병렬 실행이 필요하면 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS를 높이세요.
• 이모지 자동완성 끄기는 emojiCompletionEnabled — :로 시작하는 입력이 이모지 후보로 바뀌는 것이 불편하면 이 설정으로 끌 수 있습니다.
• 엔터프라이즈 환경은 Claude Desktop 네트워크 설정 재확인 권장 — 사내 mTLS, 프록시, OAuth 스코프 설정이 Claude Desktop 세션에서 무시되던 문제가 수정됐으므로, 그동안 우회하던 설정이 있었다면 업데이트 후 동작이 달라질 수 있습니다.