## 변경된 사항 - `CLAUDE_CODE_DISABLE_FILE_MENTIONS` 환경 변수 추가: 이제 Claude는 파일 내용이 아닌,

변경된 사항

• CLAUDE_CODE_DISABLE_FILE_MENTIONS 환경 변수 추가: 이제 Claude는 파일 내용이 아닌, 파일 도구를 사용하여 읽을 @ 파일 언급의 경로를 받습니다.

• 터미널에 유휴(idle) 압축 기능 추가: 약 54분 동안 유휴 상태로 방치된 200K 토큰 이상의 대화는 한 시간짜리 프롬프트 캐시가 만료되기 전에 압축되며, 따라서 다음 메시지를 보낼 때 전체 내용을 다시 처리하지 않습니다.

• 유휴 압축의 최소 토큰 수(200K)를 변경하는 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 추가; settings.json에서 "idleCompaction": false로 설정하면 비활성화됩니다. 두 기능 모두 v2.1.290 이상이 필요합니다.

• $.prompt.media 추가: 관리 설정으로 설치된 모드의 prompt.submit 훅이 프롬프트에 첨부된 이미지나 문서의 바이트를 읽을 수 있게 되었습니다.

• 관리 설정으로 설치된 모드를 위해 $.session.identity() 추가: 세션이 어떻게 로그인되었는지, 그리고 관리되는 forceLoginOrgUUID가 해당 조직의 정보와 이메일을 제공합니다.

• 모드의 Text에 size, weight, mono, tabular가 추가되었고, Box에는 명명된 간격 단계(xs부터 xl)가 추가되었습니다. bold는 weight로 대체되어 사용이 중단(deprecated)됩니다.

• claude self-hosted-runner orchestrator에 --shutdown-drain-sec 추가: SIGTERM 수신 시 폴링을 중지하고, 진행 중인(in flight) 및 실행 중인 스폰 훅이 해당 초만큼 완료될 시간을 갖도록 합니다.

• 모드의 skill.prompt 훅이 받는 정보에 스킬의 프런트매터(frontmatter), 소스, 플러그인 이름 및 파일 경로가 추가되었습니다.

• 에이전트(agent) 보기에서 새로운 세션 시작 설정을 위해 /effort와 /fast가 추가되었습니다. 이제 빈 /model, /effort 또는 /fast는 선택기(picker)를 엽니다.

• --safe-mode로 시작된 백그라운드 세션에 대해 에이전트 보기의 미리보기 패널에 "안전 모드(safe mode)" 라인이 추가되었습니다.

• 플랜 모드에서 우회 권한(bypass permissions)이 사용 가능한 경우, 대부분의 편집 또는 명령 전에 알림을 요청하지 않는다는 안내 문구가 추가되었습니다.

• claude plugin eval에 --disallow-tools와 disallowed_tools 케이스 필드가 추가되어, 에이전트(Agent)와 같은 특정 내장 도구가 평가 실행(eval runs)에서 제외되도록 합니다.

• Claude Desktop의 Code 탭에서 출처 표기(attribution block) 비활성화 지원 추가: Claude apps gateway의 code 정책의 env에 CLAUDE_CODE_ATTRIBUTION_HEADER=0 설정

• Claude apps gateway 뒤의 Claude Code 세션의 출처 표기 블록에 필드 추가; CLAUDE_CODE_ATTRIBUTION_HEADER=0으로 블록 제거

• session.append mod hook에 queue 도어 추가, 이를 통해 모드가 전사 기록(transcript)의 큐 레코드를 전송된 프롬프트와 다르게 만들 수 있게 함

• /plugin 및 claude plugin validate에서 조직이 Claude Code를 관리하는 경우 건너뛰는 모드의 hook을 명시하는 주석 추가

• 최대 노력(max effort), 워크플로우, 항상 켜짐 컨텍스트(always-on context) 및 대형 도구 결과에 대한 /usage 경고 추가

• apiKeyHelper의 키가 사용될 때 잘못된 조직을 가리킬 수 있는 거부된 클라우드 세션 오류 수정

• 사용자 지정 ANTHROPIC_BASE_URL로 끝나는 게이트웨이별 모델 이름의 세션에서 요청 전

• 느린 연결 상태에서 대량의 이벤트가 업로드되지 못할 때 Remote Control 또는 클라우드 세션의 claude.ai 뷰가 멈추는 문제 수정

• 샌드박스화된 셸 명령이 --plugin-dir 폴더에 쓰기 할 수 있어, Claude Code가 해당 코드를 리로드하고 샌드박스 외부에서 실행하는 문제 수정

• 과도한 디버그 로깅(--debug, --debug-file) 시 메모리 증가 및 디버그 로그가 쓰기를 거부하는 디스크나 네트워크 마운트에 있을 때 종료 시 멈추는 문제 수정

• 디버그 출력이 stderr로 가고 부모 프로세스가 이를 읽지 않을 때 무한정 메모리가 증가하던 문제 수정

• 셸 -c 스크립트에서 rm을 실행하지 않는 경우의 rm 프롬프트가 발생하는 문제 수정. Claude Code가 읽을 수 없는 런타임에 빌드된 rm은 이제 CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1이 아니면 프롬프트를 표시하지 않음

• 전체 화면 모드에서 확장된 스크립트 행의 단어를 더블 클릭할 때, 단어 선택 대신 해당 행이 접히던 문제 수정

• claude mcp list, claude doctor, 그리고 /status가 빈 .mcp.json을 유효하지 않은 것으로 보고하던 문제 수정

• 전체 화면에서 스크롤된 상태로 요청할 때 /btw가 스크립트를 하단으로 이동시키던 문제 수정

• 샌드박스화된 명령이 Windows 드라이브에 쓸 수 있을 때 WSL2에서 bwrap: Can't mkdir /mnt/c/Program Files/ClaudeCode 오류를 내며 실패하던 문제 수정

• Agent SDK, IDE 및 claude remote-control 세션에서 백그라운드 작업이 실행되는 동안 예약된 깨우기(ScheduleWakeup)가 작동하지 않던 문제 수정

• 이미지가 붙여넣어졌거나 읽을 수 없는 이미지인 일부 프롬프트의 경우, 모드의 prompt.submit 리라이트가 조용히 누락되어 프롬프트를 입력한 대로 전송되던 문제 수정

• 동일 배치 내에서 다른 대기 중인 프롬프트가 전달에 실패했을 때 Remote Control 프롬프트가 손실되던 문제 수정

• 훅(hooks)을 통과했던 Remote Control 프롬프트가 Stop이 다음 대기 중인 프롬프트의 훅을 방해할 때 프롬프트 기록에서 사라지던 문제 수정

• 샌드박스화된 명령이 설정 디렉터리에 빈 .config.json을 남긴 후 Linux에서 로그인, MCP 서버 및 프로젝트 트러스트가 손실되어 보이던 문제 수정

• 프로젝트 폴더가 쓰기 가능하지 않아 설정을 저장할 수 없을 때 /sandbox가 성공했다고 보고하는 문제를 수정했습니다. 이제는 변경된 내용이 없다는 메시지와 그 이유를 표시합니다.
• 호스트가 자동 모드(auto mode)를 지원하지 않는 모델로 전환한 후에도 SDK 및 헤드리스 세션이 계속 자동 모드에 머무르던 문제를 수정했습니다.
• MCP 설정에서 이름이 constructor 또는 prototype인 MCP 서버가 연결되지 않던 문제를 수정했습니다.
• 이름이 constructor 또는 toString인 MCP 서버의 도구가 자동 모드 및 권한 우회(bypass permissions mode)에서 권한을 요청하던 문제를 수정했습니다.
• 다른 Claude Code 프로세스가 claude.ai-synced 플러그인을 업데이트한 직후에 발생하는 허위 "synced[0] commands path not found" 플러그인 시작 오류를 수정했습니다.
• 커넥터 또는 기타 접근을 요청하는 게시가 서버나 프록시(HTTP 403)에 의해 거부되었을 때 Artifact 도구가 재시도를 권장하던 문제를 수정했습니다. 이제는 상황과 사용자에게 전달할 내용을 명확히 알려줍니다.
• 플러그인 재로드 중 시간 초과가 발생했거나 최근 동기화(sync)를 재사용하는 재시작 후에도 Cowork 클라우드 세션이 이전 계정 플러그인에 머무르던 문제를 수정했습니다.
• Claude가 작업하는 동안 사용자가 보낸 메시지에서 문서 블록이 누락되던 문제를 수정했습니다.
• 브라우저가 연결되지 않았는데도 Chrome의 Claude가 권한을 요청하던 문제를 수정했습니다. 이제는 확장 프로그램이 연결되어 있지 않다고 표시합니다.
• 전체 화면의 "설치 업데이트(Update installed)" 알림이 비활성 상태의 "/clear to save tokens" 힌트 뒤에 숨겨지던 문제를 수정했습니다. 이제는 해당 힌트 옆에 표시됩니다.
• 호출 외부에서 작업을 수행하는 다른 모드의 노드(noun)를 기다릴 때, .catch 유무와 관계없이 모드 훅이 끝없이 다시 실행되던 문제를 수정했습니다.
• 정책의 availableModelsMatch: exact 또는 deniedModels가 차단하는 모델을 Claude 앱 게이트웨이가 제공하던 문제를 수정했습니다. 이제는 400 응답을 반환하고 해당 모델들을 모델 목록에서 제외합니다.
• 관리 설정 파일이 ANTHROPIC_BASE_URL을 설정할 때, 서버에서 Anthropic으로 전송되는 설정 요청에 타사 게이트웨이의 API 키가 포함되던 문제를 수정했습니다.

• 커스텀 ANTHROPIC_BASE_URL을 통해 스트림이 180초 후 데이터 없이 중단되는 문제 수정; 이제 기능 플래그 로드 여부와 관계없이 300초 동안 대기합니다.

• 모드의 tool.describe 또는 prompt.section 답변이 $.ui.invalidate 이후 Claude에 도달했을 때 변경되던 문제 수정; 새로운 답변은 다음 턴에 전송됩니다.

• 설정 파일이 enabledMcpjsonServers 또는 disabledMcpjsonServers가 단일 서버 이름(문자, 숫자, -, 또는 _)을 일반 문자열로 가질 때 무시되던 문제 수정

• claude plugin test가 호출한 서비스된 $ 메서드가 답변 후 계속해서 $ 호출을 하는 동안 훅의 시간 예산이 일시 중지되던 문제 수정

• 많은 서브 에이전트를 실행했던 클라우드 또는 원격 제어 세션 재개 후 높은 메모리 사용량 문제가 수정되었습니다.

• 모드가 매우 깊게 중첩된 도구 입력이나 메시지를 next()로 전달할 때 플러그인 훅이 건너뛰기 되던 문제 수정

• 모드의 훅이 next()에 전달하거나, 반환하거나, $ 메서드에 보내는 값이 게터 중 하나가 RangeError를 발생시킬 때 전체가 거부되던 문제 수정; 이제 해당 키만 거부됩니다.

• /usage, 접근 임계값 경고(터미널 및 VS Code), 그리고 상태 표시줄이 때때로 100% 초과 사용량을 보여주던 문제 수정 (#92238)

• CJK 또는 이모지를 라틴어 단어와 혼합한 텍스트가 일부 터미널 너비에서 마지막 줄을 잃거나 빈 행을 남기던 문제 수정

• 클라우드 세션이 권한 프롬프트나 질문에 대한 답변을 제공하는 동안 해당 세션의 워커가 교체될 때 때때로 답변을 무시하던 문제 수정

• 굵게, 기울임꼴 및 기타 중첩된 텍스트 스타일이 테이블 경계를 넘어 흐르거나 줄 바꿈되는 행에서 손실되던 문제 수정

• Cowork 클라우드 세션이 다른 장치에서 변경, 제거 또는 비활성화된 계정 플러그인의 이전 버전을 실행하던 문제 수정; 이제 세션 재시작 시까지 유지됩니다.

• MCP 서버(mcp__<server>)에 대한 거부 및 요청 규칙이 서버의 정규화된 이름에 이중 언더스코어가 포함될 때 적용되지 않던 문제 수정

• API에서 대용량 이미지가 거부된 후, 이후 모든 턴(turn)에서 길게 진행되는 대화 중 새로 첨부된 이미지를 잃어버리는 문제 수정

• 플러그인의 훅(hooks)이 훅 모듈인 경우 plugin_loaded 원격 측정 이벤트가 has_hooks를 false로 보고하는 문제 수정 (내장 플러그인 포함)

• Claude가 작업 중일 때 첨부된 이미지가 전체 크기로 전송되어 장시간 대화에서 반복적인 이미지 오류를 유발하던 문제 수정 (VS Code, 데스크톱 앱, SDK)

• 최신 모델에서 근사 정사각형의 큰 이미지에 대한 이미지 좌표 힌트가 누락되거나 약간 어긋나던 문제 수정

• 기능 플래그(feature flag), 시작(startup), 빠른 모드(fast mode), 프로필 및 Anthropic으로 보내는 피드백 요청이 타사 게이트웨이에 설정된 API 키(ANTHROPIC_BASE_URL)를 포함하던 문제 수정. (Anthropic API 키는 여전히 전송됨)

• 모드가 실패한 리로드 직후 저장된 수정 사항을 무시하던 문제 수정; 변경하지 않고 모드 파일을 저장해도 더 이상 모드가 리로드되지 않음

• 훅이 다른 파일에서 가져온 함수 선언에 $를 전달할 때 소스 파일에서 로드되는 모드가 거부되던 문제 수정

• 2.1.296 버전의 회귀(regression) 수정: 클라우드 및 헤드리스 세션에서 재시작 후 새 메시지가 도착하면 승인된 도구 호출을 두 번 실행할 수 있던 문제

• 예약 작업이 잘못된 분에 공지되던 문제 수정: 스케줄링 도구가 이제 각 작업의 실제 다음 실행 시간을 보고함

• 모드의 훅이 __proto__ 키를 가진 값들을 전달받을 때 해당 값이 조용히 제거되어, 다른 모드가 수행한 도구 호출의 tool.check 가드를 건너뛸 수 있던 문제 수정

• 설정 파일이 유효성 검사에 실패할 때 claude -p가 아무것도 출력하지 않던 문제 수정: 이제 텍스트 출력은 stderr에 파일과 유효하지 않은 항목을 나열함

• 브래킷 처리된 붙여넣기(bracketed paste) 없이 터미널에서 긴 내용을 붙여넣을 때, 비가시 제어 문자(예: 잘못 디코딩된 중괄호 따옴표) 이후의 모든 텍스트를 잃어버리던 문제 수정

• MDM 또는 관리 설정 파일이 forceLoginOrgUUID를 설정한 장치에서 저장된 로그인 플랜이 로컬로 변경되었을 때 관리되는 설정 및 조직 정책이 가져와지지 않던 문제 수정

• MCP 연결이 HTTP를 통해 30초 동안 대기하다가 서버가 알림(notification)의 본문을 끝내지 않을 때 실패하던 문제 수정 (#99014)

• 실행 중인 헤드리스 또는 SDK 세션에 추가된 MCP 서버가 일부 정책 검사(policy checks)를 실행하기 전에 연결되던 문제 수정; 이제 차단된 서버는 연락을 시도하지 않고 실패로 보고됩니다

• claude mcp list, claude mcp get 및 서브 에이전트 MCP 서버가 정책 검사에 의해 차단되는 서버를 시작하던 문제 수정; 이제 시작되지 않고 차단됨으로 보고됩니다

• /reload-plugins 실행 시 직전에 다른 터미널에서 설치된 플러그인이 로드되지 않던 문제 수정

• 매우 좁은 터미널에서 CJK 및 이모지 텍스트가 한 셀에 압축될 때, 그 아래에 빈 행이 나타나던 문제 수정

• 와이드 문자 옆의 텍스트가 중간에 잘리면서 셀을 사용하지 않거나 두 번 잘리던 문제, 그리고 색상이 변경된 내부에서 이모지가 사라지던 문제 수정