## 변경된 내용 - `managed.policies[]`에 `code` 키를 추가했습니다
요약
Claude Desktop 및 관련 에이전트 기능에 대한 대규모 업데이트가 이루어졌습니다. 관리형 정책, 서브 에이전트의 자동 압축 로직 개선, 그리고 다양한 환경 변수 추가를 통해 개발 워크플로우의 안정성과 유연성이 크게 향상되었습니다. 또한, 파일 읽기(Read) 도구의 용량 제한을 완화하고 여러 세션 및 훅 관련 버그들을 수정하여 전반적인 사용 경험이 개선되었습니다.
핵심 포인트
- `managed.policies[]`에 `code` 키가 추가되어 CLI와 Code 탭에서 일관되게 적용됩니다.
- 서브 에이전트의 자동 압축 로직(`autoCompactWindow`)을 정의할 수 있게 되어 워크플로우 관리가 용이해졌습니다.
- Read 도구에 `allow_large` 옵션이 추가되어 대용량 파일도 한 번에 읽을 수 있습니다.
- 다양한 환경 변수 및 버그 수정으로 에이전트와 훅(hook) 기반의 안정성이 크게 향상되었습니다.
변경된 내용
-
managed.policies[]에code키를 추가했습니다. 이 설정은cli와 동일하며, Claude Desktop의 Code 탭에서도 적용됩니다. 또한,desktop옆에 위치하여 Claude Desktop의 게이트웨이 모드를 활성화합니다. -
서브 에이전트 프런트매터(frontmatter) 및
--agents정의에autoCompactWindow를 추가했습니다. 이를 통해 서브 에이전트가 메인 대화 창보다 더 일찍 자동 압축될 수 있습니다. -
모든 워크플로우 에이전트를 하나의 모델에서 실행하고 다른 서브 에이전트는 자체 모델을 유지하도록
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL을 추가했습니다. -
오버로드된(529) 요청 재시도 시 백오프(backoff)에 대한 최대 지연 시간을 더 길게 설정할 수 있도록 환경 변수
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS를 추가했습니다. -
플러그인 훅(hooks)이 다른 활성화된 플러그인과 이름이 같아서 제외된
/plugin에 대한 참고 사항을 추가했습니다. -
Read 도구에
allow_large옵션을 추가하여, Claude가 전체 파일을 필요로 하고 컨텍스트 공간이 충분할 때 일반적인 크기 제한을 넘어선 텍스트 파일도 한 번의 호출로 읽을 수 있게 했습니다. -
관리형 설정(managed settings)에서 `
-
재개된 서브 에이전트가 세션 종료로 인해 중단된 도구 호출을 사용자가 거부했다고 통보받는 문제 수정
-
훅(hook) 출력에 플러그인 힌트 태그와 유사한 텍스트가 포함될 때 변경되는 문제 수정
-
공유 트랜스크립트 및 디버그 로그에서 키 값 없이 값이 뒤따르는 경우, 특히 셸 문자열 내부에 작성된 JSON의 일부 값이 누락되던 비밀 정보 마스킹(secret redaction) 기능 수정
-
MATE Terminal과 같은 구형 VTE 기반 터미널에 복사 후 화면에 출력되는 불필요한
52;c;…이스케이프 시퀀스 문제 수정 -
/diff패널 또는 대화 상자가 열려 있는 동안 토스트 및 알림이 보이지 않게 기다리던 문제 수정 -
헤드리스 세션 중
UserPromptSubmit훅이나 모드의prompt.submit훅에서 Esc 키를 누르거나 인터럽트가 발생할 경우, 헤드리스 세션을 종료하거나 입력된 프롬프트를 지우거나 검증되지 않은 프롬프트를 통과시키던 문제 수정 -
헤드리스 세션 시작 후 로드되는 플러그인의
SessionStart훅이 동일한 이름이나 다른 철자로 이미 실행된 다른 플러그인 때문에 건너뛰어지던 문제 수정 -
등록 거부 시
claude self-hosted-runner가 오해의 소지가 있는 오류를 출력하던 문제 수정: 이제 조직 관리자 설정 이름을 명시하거나 재시작된 온디맨드 러너에 새 작업 지시서가 필요하다고 안내함 -
동일한 저장소의 다른 세션이
--capacity가 1보다 큰 러너에서 시작될 때, 자가 호스팅 러너(self-hosted runner) 세션의 git fetch, pull 및 push가 실패하던 문제 수정 -
워크플로우 스크립트가 약 20,000 레벨보다 깊은 곳에 중첩된 결과, 에이전트 옵션 및 기타 값을 조용히 잘라내리거나(truncating) 매우 깊게 중첩된 결과를 거대한 작업 출력 파일로 작성하던 문제 수정
-
플러그인이 제공하는
$메서드가 호출한 에이전트의 작업 디렉터리가 아닌 메인 세션의 작업 디렉터리에서 실행되고, 해당 호출 훅이 가지고 있는 턴을 무시하던 문제 수정 -
모드(mod)가 다시 로드되거나 제거된 후에도 여전히 실행 중인 모드의 훅에서
$.agent.register가 성공하던 문제 수정: 이제 이 호출은 거부됨 -
모드 내의
$.http.fetch가 응답이 4 MiB 본문 제한을 초과한다고 선언할 때HEAD요청을 거부하던 문제 수정 -
claude plugin marketplace add,marketplace update및plugin install시constructor와 같은 이름의 마켓플레이스에서 내부 오류가 발생하는 문제 수정; 이제add는 그러한 이름을 명확하게 거부합니다. -
플러그인 비밀(secret) 이름이
constructor또는prototype일 때, 해당 플러그인의 옵션을 다음 저장 시 삭제되던 문제 수정 -
기능 플래그가 로드되지 않은 상태에서 저장된 권한이 허용하는 Chrome 액션의 Claude 클라우드 세션이 자동 모드의 확인 절차를 건너뛰던 문제 수정
-
MCP 도구 결과로 인해 해당 턴(turn)이 종료되었을 때,
CLAUDE_CODE_RESUME_INTERRUPTED_TURN이 재시작 후 완료된 턴을 다시 실행하던 문제 수정 -
Bash 권한 확인 시
BASH_ARGV0셸 변수를 할당하고 이를 사용하는 일부 명령어를 자동 승인하던 문제 수정; 이제 이러한 명령어는 승인을 요청합니다. -
Edit 및 NotebookEdit이 유효하지 않은 UTF-8 파일(Windows-1252, Shift-JIS, GBK)의 모든 비-ASCII 문자를 대체하던 문제 수정; 이제 그러한 편집은 거부됩니다.
-
←실행 직후 전경에서 보이지 않는 곳에 프롬프트가 두 번 전송되던 문제 수정 (백그라운드 서비스 응답이 느릴 때 발생) -
세션 시작 후크(SessionStart hooks)가 아직 실행 중일 때 전송된 프롬프트가
←로 세션을 백그라운드로 이동시키면 사라지던 문제 수정; 여전히 전송되지 않지만, 이제↑를 누르면 복구됩니다. -
로딩이 늦은 플러그인의 SessionStart 후크 출력이 헤드리스(headless) 세션에서
/clear이후 새로운 대화에 도달하던 문제 수정 -
PowerShell 명령어가 후크가 CLAUDE_ENV_FILE에 작성한 변수를 인식하지 못하던 문제 수정 (파일이 단순 할당만 포함할 경우)
-
Claude가 클라우드 세션을 비대화형으로 호출하고 MCP 서버 인증이 필요할 때
/mcp또는claude mcp를 제안하던 문제 수정 -
/code-review가 클라우드 세션, Agent SDK 및 IDE 통합에서 원시 JSON 배열로 끝났던 문제 수정; 이제 발견된 사항들이 번호가 매겨진 목록으로 출력됩니다. -
자동 모드가 실제로 변경되지 않았음에도 불구하고 아티팩트(artifact)의 업데이트 중 한 가지를 가끔 거부하며 공유가 변경되었다고 알리던 문제 수정
-
여러 세션이 구성 디렉터리를 공유할 때 claude.ai에서 동기화된 스킬이 설치를 완료하지 못하고 매번 재다운로드되던 문제 수정
-
claude.ai에서 동기화된 플러그인이 해당 플러그인이 선언하는 마켓플레이스 종속성도 claude.ai에서 동기화되었을 때 비활성화되던 문제 수정
-
Linux 장치에서 복사된 플러그인 경로가 /home 아래를 가리킬 때 macOS에서 발생하는 시작 지연(hang) 문제 수정
-
Workflow 도구가 Windows에서 체크아웃된 파일과 같은 CRLF 줄 바꿈 방식을 가진 스크립트 파일을 거부하던 문제 수정
-
git commit -q또는git -C <dir> commit후 OpenTelemetry의tool_result이벤트가git_commit_id를 누락시키던 문제 수정 -
텍스트에 유니코드 줄 또는 단락 구분자(U+2028, U+2029)가 포함된 경우
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC가 저장된 스크립트에서 메시지를 삭제하던 문제 수정 -
텍스트에 유니코드 줄 또는 단락 구분자(U+2028, U+2029)가 포함된 경우
claude purge가 히스토리 파일에 프롬프트를 남기던 문제 수정 -
Windows: 1KB보다 긴 PowerShell 명령어가 항상 권한을 요청하던 문제 수정. 이제 규칙 허용 및 읽기 전용 감지가 최대 32KB까지 적용됨
-
Windows: stdio MCP 서버가 종료 시 강제 종료되던 문제 수정; 이제 stdin이 먼저 닫히고, 서버가 300ms 후에 여전히 실행 중일 경우에만 프로세스 트리가 종료됨
-
Windows: GitHub SSH 키가 없는 장치에서 GitHub
owner/repo플러그인 소스를 위해claude plugin install이 실패하던 문제 수정; 이제 HTTPS를 통해 클론을 재시도함 -
Windows: Git Bash에서
rm -rf /c/Users/<name>명령어가 바이패스 권한 모드에서 경고 메시지를 표시하지 않던 문제 수정 -
전체 화면 모드 개선: 마우스 포인터 아래의 링크가 열 수 있음을 보여주기 위해 밑줄이 그어지도록 변경됨
-
코드 중심 대화에서 트랜스크립트 토글(ctrl+o) 응답성 개선: 구문 강조된 코드 블록을 캐싱하여 처리 속도를 높임
-
Claude 앱 게이트웨이를 통해 제공되는 Claude 데스크톱의 Code 탭 개선: 세션 시작에 실패할 경우, 게이트웨이의
code설정이 되어 있지 않은 장치에서도 이유가 답장으로 표시됨 -
클라우드 세션 거부 오류 개선: 이제 조직 정책이 로드되지 않은 이유를 명시하고, claude.ai 로그인 설정을 재정의할 수 있는 API 키 또는 인증 토큰 이름을 알려줍니다.
-
--debug출력을 개선하여 커스텀 에이전트 파일에서 인식되지 않은 프론트매터 필드를 이름과 함께 표시하며, 예상되는 오타에 대한 힌트를 제공합니다. -
자동 모드(auto mode) 개선: 자동 모드의 확인 절차 때문에 실행되지 못한 도구 호출은 이제 빨간색 오류 대신 흐릿한 '실행 안 함(Not run)' 행으로 표시됩니다.
-
후크(
hooks)에 대한--debug출력 개선: 도구 호출, 프롬프트, SessionStart 및 Stop에 대한 명령 후크가 완료될 때 해당 명령어, 플러그인, 결과 및 지속 시간을 기록하여 느린 후크를 식별할 수 있게 되었습니다. -
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC개선: 대용량 스크립트 파일의 경우, 10% 미만을 해제하는 경우에는 더 이상 재작성되지 않습니다. -
/cost, 상태 표시줄,--max-budget-usd및 SDK 비용 수치를 업데이트하여 Sonnet 5.5 캐시 읽기 비용을 백만 토큰당 $0.20에서 $0.10으로 책정했습니다. -
번들된 dataviz 스킬 업데이트: 라이트 모드에서는 일곱 번째 시리즈에 연한 보라색을, 다크 모드에서는 더 부드러운 기본 텍스트를 적용했으며, y축 레이블은 1K와 같이 간결하게 변경되었습니다.
-
MCP 도구 설명의 기본 제한을 전송 및 MCP 서버 지침에서 2,048자에서 4,096자로 변경했습니다.
-
←: 세션이 백그라운드로 이동하는 동안 시작된 방향키 또는!명령어는 이제 완료되는 대신 중지됩니다. -
[VSCode] 확장 프로그램 설정에서 누락되었던
claudeCode.spinnerVerbs를 수정하여, settings.json이 이를 완성하고 유효성 검사하도록 했습니다. 따라서 잘못된 값으로 인해 채팅 패널이 깨지는 일이 더 이상 없습니다. -
[VSCode] Chrome의 Claude가
@browser와 연결된 세션을 포함하여 모든 브라우저 작업 전에 질문하도록 변경되었으며, 이는 터미널과 동일합니다. 사이트에서 세션이 중지되면 반복적인 질문을 할 필요가 없어집니다. -
[VSCode] C:\repo\file.ts 또는 file:///C:/repo/file.ts와 같이 전체 Windows 경로로 작성된 채팅 링크가 Windows에서 파일을 열지 않도록 수정했습니다.
-
[VSCode] OS에서 저전력 모드(reduced motion)를 켰을 때 VS Code 내 또는
prefersReducedMotion설정을 사용했을 때 작동 표시기(working indicator)가 계속 애니메이션되는 문제 수정 -
[VSCode] 패널이 메시지를 지연해서 받아온 후, 예를 들어 화면이 꺼졌거나 원격 창이 재연결된 경우 프롬프트 캐시 시계가 잘못 읽히던 문제 수정
-
[Cloud sessions] 관리 설정의 세션(Sessions) 및 러너(Runners) 목록에 자체 호스팅 환경용 상태 필터 추가; 여러 상태를 한 번에 선택할 수 있게 됨
-
[Cloud sessions] 자체 호스팅 러너를 기다리는 모든 클라우드 세션이 동일한 대기열 위치를 표시하던 문제 수정; 이제 각 세션이 자신보다 앞에 있는 세션 수를 보여줍니다
-
[Cloud sessions] Claude가 답변 중인 동안 보낸 메시지가 답변 완료 후 해당 답변 위로 점프하던 문제 수정; 이제 재로드 후에도 그 아래에 유지됩니다
-
[Claude Tag] Slack에서 Claude를 사용할 때, 스레드 내 가장 최신 답변에 대해서만 세션 링크, 모델 및 비용을 포함하는 바닥글(footer)이 표시되도록 변경되었습니다. 이전 답변에서는 이 바닥글이 사라집니다.
-
[Claude Tag] 괄호를 포함하는 URL 링크가 Claude의 Slack 답변과 작업 체크리스트에서 깨지던 문제 수정; 이로 인해 이상한 대괄호 텍스트가 보이거나 잘못된 페이지가 열리던 문제가 해결되었습니다.
-
[Claude Tag] Claude의 Slack 답변이 16진수 색상 코드처럼 보이는 경우(예: 여섯 자리 풀 리퀘스트 번호) 해당 코드 옆에 색상 견본을 그리던 문제 수정
-
[Claude Tag] Activity 페이지의 Memory 탭에서 Claude Tag 관리 권한을 가진 멤버가 작업 공간 및 채널 메모 파일 생성, 편집 및 삭제할 수 있도록 추가
-
[Claude Tag] Slack 채널에서 Claude가 게시하는 플러그인 확인 카드에 플러그인의 이름 대신 ID가 표시되던 문제 수정
-
[Claude Tag] 채널 자체 설정에 포함되지 않은 플러그인을 제거하기 위해 Claude가 Slack에 카드를 게시할 때, 해당 플러그인이 어디서 왔는지 설명하도록 변경되었습니다.
-
[Claude Tag] 자체 호스팅 환경에서 세션이 작업 도중에 새로운 러너(runner)로 이동할 때 Claude가 Slack에서 답장을 잃는 문제 수정
-
[Code Review] 코드 리뷰 검사가 리뷰 완료 후에도 풀 리퀘스트(pull request)에서 가끔
AI 자동 생성 콘텐츠
본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기