Claude Code 2.1.108 업데이트

💡

세션 복귀 요약(/recap), 빌트인 슬래시 커맨드 자동 탐색, 1시간 프롬프트 캐시 옵션 등 사용성 개선 및 안정성 강화

#Claude Code#업데이트
🔗 공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.108이 2026년 4월 14일에 릴리스되었습니다. 세션에 돌아왔을 때 컨텍스트를 빠르게 파악할 수 있는 Recap 기능, 프롬프트 캐시 TTL 옵션, 그리고 다수의 안정성 개선이 포함된 업데이트입니다.

새 기능

  • /recap — 세션 복귀 요약

    긴 세션을 중단했다가 돌아왔을 때 “어디까지 했더라?”를 파악하기 어려웠습니다. Recap 기능은 세션에 복귀할 때 자동으로 이전 작업 내용을 요약해 줍니다. /config에서 활성화하거나, /recap 명령으로 수동 호출할 수 있습니다. 텔레메트리를 비활성화한 경우 ENABLE_AWAY_SUMMARY 환경변수로 강제 활성화할 수 있습니다.

  • 빌트인 슬래시 커맨드 자동 탐색

    Claude가 /init, /review, /security-review 같은 빌트인 슬래시 커맨드를 Skill 도구를 통해 자동으로 발견하고 호출할 수 있게 되었습니다. 사용자가 직접 명령어를 입력하지 않아도 Claude가 상황에 맞는 빌트인 명령을 스스로 실행할 수 있습니다.

  • 프롬프트 캐시 TTL 옵션

    Claude Code는 매 응답마다 전체 대화 히스토리를 API로 전송합니다. 프롬프트 캐시는 동일한 대화 접두사를 재사용하여 캐시된 토큰을 약 90% 저렴한 비용으로 처리합니다. 기본 캐시 TTL은 5분이라 5분 이상 쉬면 캐시가 만료되어 전체 히스토리를 비캐시 비용으로 다시 처리해야 했습니다. ENABLE_PROMPT_CACHING_1H를 설정하면 캐시 TTL이 1시간으로 연장되어 API 키, Bedrock, Vertex, Foundry 환경에서 비용을 절감할 수 있습니다. 반대로 FORCE_PROMPT_CACHING_5M으로 5분 TTL을 강제할 수도 있습니다.

    설정 방법은 ~/.claude/settings.json의 env 키에 추가합니다:

    {
  "env": {
    "ENABLE_PROMPT_CACHING_1H": "1"
  }
}

  • /undo 별칭

    /rewind 명령의 별칭으로 /undo가 추가되었습니다. 더 직관적인 이름으로 마지막 작업을 되돌릴 수 있습니다.

주요 개선

  • /model 모델 전환 경고

    대화 중간에 모델을 변경하면 다음 응답에서 전체 히스토리를 캐시 없이 다시 읽어야 합니다. 이제 /model로 모델을 전환할 때 이 비용에 대한 경고를 표시하여, 의도하지 않은 비용 증가를 방지합니다.

  • /resume 세션 선택 개선

    세션 재개 picker가 기본적으로 현재 디렉토리의 세션만 표시합니다. 모든 프로젝트의 세션을 보려면 Ctrl+A를 누르면 됩니다. 작업 중인 프로젝트의 세션을 더 빠르게 찾을 수 있습니다.

  • 오류 메시지 세분화

    서버 rate limit과 플랜 사용량 제한이 별도 메시지로 구분됩니다. 5xx/529 오류 시 status.claude.com 링크를 표시하고, 잘못 입력한 슬래시 커맨드는 가장 비슷한 명령어를 제안합니다.

  • 메모리 최적화

    파일 읽기, 편집, 구문 강조에 사용되는 언어 문법을 필요할 때만 로드하도록 변경하여 메모리 사용량이 줄었습니다.

주요 버그 수정

세션 및 캐시

  • 텔레메트리 비활성화 시 캐시 TTL — DISABLE_TELEMETRY 설정 시 구독자임에도 1시간이 아닌 5분 캐시 TTL로 폴백되던 문제가 수정되었습니다.
  • 세션 재개 시 이름 유실 — claude --resume <session-id>로 재개할 때 /rename으로 설정한 세션 이름과 색상이 사라지던 문제가 해결되었습니다.
  • 자기 참조 메시지 잘림 — --resume 시 자기 참조하는 메시지가 포함된 세션이 잘리던 문제가 수정되었습니다.

입력 및 렌더링

  • 로그인 코드 붙여넣기 — /login 코드 입력에서 붙여넣기가 동작하지 않던 2.1.105 회귀 버그가 수정되었습니다.
  • 발음 부호 누락 — language 설정 시 악센트, 움라우트, 세디유 등 발음 부호가 응답에서 누락되던 문제가 해결되었습니다.
  • 터미널 이스케이프 코드 — --teleport 후 프롬프트 입력에 터미널 이스케이프 코드가 깨진 텍스트로 표시되던 문제가 수정되었습니다.

기타

  • Bash 출력 누락 — CLAUDE_ENV_FILE(예: ~/.zprofile)이 # 주석 줄로 끝날 때 Bash 도구 출력이 사라지던 문제가 해결되었습니다.
  • 트랜스크립트 쓰기 실패 — 디스크 용량 부족 등으로 트랜스크립트 저장이 실패할 때 오류가 무시되던 문제가 로그에 기록되도록 변경되었습니다.
  • 정책 관리 플러그인 자동 업데이트 — 초기 설치와 다른 프로젝트에서 실행할 때 자동 업데이트가 되지 않던 문제가 수정되었습니다.

알아두면 좋은 점

  • Recap 기능은 긴 세션을 자주 중단했다 재개하는 워크플로우에서 특히 유용합니다. /config에서 활성화해 보세요.
  • API 키나 Bedrock/Vertex 사용자라면 ENABLE_PROMPT_CACHING_1H 설정으로 캐시 비용을 절감할 수 있습니다.
  • language 설정을 사용하는 비영어권 사용자는 발음 부호 누락 수정의 혜택을 받습니다.