Claude Code v2.1.299에서 유휴 압축, 파일 멘션 제어, 도구 비활성화 추가

Claude Code v2.1.299가 출시되었으며, 핵심 변경 사항은 유휴 컴팩션입니다. 200K 이상의 토큰이 쌓인 대화가 약 54분 동안 유휴 상태이면, 1시간 프롬프트 캐시가 만료되기 직전에 자동으로 컴팩션됩니다. 이는 다음 메시지가 전체 컨텍스트 윈도우를 처음부터 다시 처리하지 않도록 하기 위한 것입니다.

유휴 컴팩션 제어

• CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS는 200K 토큰 최소 임계값을 변경합니다.
• settings.json에서 "idleCompaction": false로 설정하면 완전히 끌 수 있습니다.
• 두 옵션 모두 v2.1.290 이상이 필요합니다.

파일 멘션 및 도구 제어

CLAUDE_CODE_DISABLE_FILE_MENTIONS는 @ 파일 멘션 작동 방식을 변경합니다. 파일 내용을 주입하는 대신 Claude는 경로만 받아 자체 파일 도구로 읽습니다. 파일 본문이 컨텍스트에 덤프되는 것을 원하지 않을 때 유용합니다.

평가 워크플로우의 경우, claude plugin eval이 이제 --disallow-tools와 disallowed_tools 케이스 필드를 받아들여 Agent와 같은 내장 도구를 평가 실행에서 제외할 수 있습니다.

셀프 호스팅 러너 및 훅

claude self-hosted-runner orchestrator에 --shutdown-drain-sec가 추가되었습니다. SIGTERM 수신 시 폴링을 중단하고 진행 중인 폴링과 실행 중인 스폰 훅이 최대 N초 동안 마무리될 시간을 줍니다.

모드 훅에 새로운 기능이 추가되었습니다:

• $.prompt.media를 사용하면 prompt.submit 훅이 첨부된 이미지나 문서의 바이트를 읽을 수 있습니다.
• $.session.identity()는 세션이 어떻게 로그인되었는지, 그리고 forceLoginOrgUUID에 해당 조직이 나열된 경우 조직과 이메일을 노출합니다.
• skill.prompt는 이제 스킬의 프론트매터, 소스, 플러그인 이름, 파일 경로를 받습니다.
• session.append에 queue 도어가 생겨 모드가 전송된 프롬프트와 대화 기록 큐 레코드를 분기할 수 있습니다.
• 모드 Text에 size, weight, mono, tabular가 추가되었으며, bold는 weight로 대체되어 더 이상 권장되지 않습니다. Box에는 xs부터 xl까지 이름이 지정된 간격 단계가 추가되었습니다.

주요 수정 사항

• 커스텀 ANTHROPIC_BASE_URL 뒤의 게이트웨이 전용 모델을 사용하는 세션이 200K 토큰 근처에서 "Prompt is too long · automatic compaction failed" 오류로 종료되던 문제가 해결되었습니다.
• 매 턴 끝에 프롬프트를 제출하는 모드가 헤드리스 실행을 --max-turns, --max-budget-usd, 인터럽트 또는 대화 종료를 넘어서게 만들 수 있던 문제가 수정되었습니다.
• 원격으로 꺼진 설치된 모드가 열린 세션에서 계속 실행되는 대신 턴 사이에 언로드됩니다.
• Cowork 및 claude.ai 클라우드 세션에서 훅 중간에 중지된 메시지에 대한 편집 및 재시도가 실패하던 문제(2.1.296의 회귀)가 수정되었습니다.
• 샌드박스된 셸 명령이 --plugin-dir 폴더에 쓸 수 있었고, Claude Code가 해당 코드를 샌드박스 외부에서 다시 로드하고 실행하던 문제가 이제 차단됩니다.
• 디버그 로깅(--debug, --debug-file)이 더 이상 메모리를 무한정 늘리지 않으며, 로그가 지연된 네트워크나 디스크 마운트에 있을 때 종료 시 멈추지 않습니다.

또한 새로운 기능: CLAUDE_CODE_ATTRIBUTION_HEADER=0은 Claude Code 세션과 Claude Desktop의 Code 탭에서 귀속 블록을 제거하며, /usage는 이제 최대 노력, 워크플로우, 항상 켜진 컨텍스트, 대형 도구 결과에 대해 경고합니다. 에이전트 뷰는 새 세션 기본값을 설정하기 위한 /effort와 /fast를 받습니다.