Claude 공식 릴리스 노트의 새 항목을 AI가 분석·정리한 글입니다. 정확한 내용은 하단 원문에서 확인해 주세요.
🤖 AI 분석 (Claude)
터미널에서 200K 토큰 이상인 대화를 약 54분 동안 방치하면, 프롬프트 캐시가 만료되기 전에 자동으로 압축(idle compaction)되도록 바뀌었습니다. 그래서 다음 메시지를 보낼 때 전체 대화를 다시 처리하지 않습니다. 이 최소 기준은 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 환경 변수로 바꿀 수 있고, settings.json에서 idleCompaction을 false로 두면 기능을 끌 수 있습니다. 두 설정은 v2.1.290 이상에서 쓸 수 있습니다.
@ 파일 멘션에 대해서는 CLAUDE_CODE_DISABLE_FILE_MENTIONS 환경 변수가 추가되었습니다. 이 값을 설정하면 Claude는 파일 내용 대신 멘션된 파일의 경로를 받아, 파일 도구로 직접 읽게 됩니다. 이 밖에도 agent view에 /effort와 /fast가 추가되었고, claude self-hosted-runner orchestrator에는 --shutdown-drain-sec 옵션이 생겼습니다.
왜 중요한가
긴 대화를 잠시 멈췄다가 다시 이어서 쓸 때, 대화 전체를 다시 처리하지 않도록 돕는 변경입니다. 파일 멘션 환경 변수를 쓰면 Claude가 파일 내용 대신 경로만 받아 필요한 파일을 직접 읽도록 선택할 수 있습니다.
이전과 다른 점
agent view에서 인자 없이 입력한 /model, /effort, /fast는 이제 선택 창을 엽니다. 모드 개발용 Text의 bold 속성은 weight로 대체되어 deprecated 처리되었습니다.
실제로 써보려면
CLAUDE_CODE_DISABLE_FILE_MENTIONS 환경 변수를 설정하면 @ 파일 멘션 동작이 바뀌고, agent view에서 /effort와 /fast를 사용할 수 있습니다. 유휴 압축은 settings.json의 idleCompaction 또는 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS로 조정하며, v2.1.290 이상이 필요합니다.
⚠️ AI가 원문을 바탕으로 생성한 분석입니다. 사실 확인은 아래 원문에서 해 주세요.
변경 내용 (원문)
- Added `CLAUDE_CODE_DISABLE_FILE_MENTIONS` environment variable: Claude gets the paths of `@` file mentions to read with its file tools, not the files' contents - Added idle compaction in the terminal: a 200K+ token conversation left idle for about 54 minutes is compacted before its one-hour prompt cache expires, so your next message doesn't reprocess it all - Added `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` to change idle compaction's 200K-token minimum; `"idleCompaction": false` in settings.json turns it off. Both need v2.1.290 or later - Added `$.prompt.media` so a `prompt.submit` hook of a mod installed by managed settings can read the bytes of an image or document attached to the prompt - Added `$.session.identity()` for mods installed by managed settings: how the session is signed in, and its organization and email when managed `forceLoginOrgUUID` lists that organization - Added `size`, `weight`, `mono` and `tabular` to a mod's `Text` and named spacing steps (`xs` to `xl`) to its `Box`; `bold` is deprecated in favor of `weight` - Added `--shutdown-drain-sec` to `claude self-hosted-runner orchestrator`: on SIGTERM it stops polling and gives the poll in flight and running spawn hooks up to that many seconds to finish - Added the skill's frontmatter, source, plugin name and file path to what a mod's `skill.prompt` hook receives - Added `/effort` and `/fast` in agent view to set what new sessions start with; a bare `/model`, `/effort` or `/fast` there now opens a picker - Added
출처: Claude Code 변경로그 (원문 보기)