## 변경 사항 - 모드(mod)의 프롬프트 데코레이션에 `virtualText`를 추가했습니다: 드래프트나 제출된 프롬프트에는 절대 나타나
요약
이번 업데이트는 Claude의 모드(mod) 기능과 에이전트 워크플로우를 대폭 개선했습니다. `virtualText` 추가, OpenTelemetry 캐시 분리 등 개발자 경험을 향상시키는 기술적 변경 사항들이 포함되었습니다. 또한, 다양한 버그 수정 및 UI/UX 개선으로 안정성과 사용성을 높였습니다.
핵심 포인트
- 모드(mod)에 virtualText를 추가하여 프롬프트 상자에 시각적 텍스트 표시 기능 구현
- OpenTelemetry 이벤트에 캐시 쓰기 수명별 속성 분리 및 GenAI 컨벤션 적용
- 워크플로우 에이전트의 prompt와 model을 재작성할 수 있는 기능 추가로 유연성 확보
- 다양한 세션/에이전트 관련 버그 수정으로 안정적인 대화 흐름 보장
변경 사항
- 모드(mod)의 프롬프트 데코레이션에
virtualText를 추가했습니다: 드래프트나 제출된 프롬프트에는 절대 나타나지 않는, 프롬프트 상자에 그려지는 텍스트입니다. - OpenTelemetry의
api_request이벤트에cache_creation_5m_tokens와cache_creation_1h_tokens를 추가하여 캐시 쓰기를 수명(lifetime)별로 분리했습니다. - 모드에
$.ui.view({ agentId })를 추가했습니다: 질문할 때 에이전트의 대화 기록을 메인 뷰에서 보여주며,$.ui.view({})는 이전 화면으로 돌아갑니다. - 모드의
Text에 오른쪽에서 왼쪽(right-to-left) 텍스트를 위한dir속성을 추가했습니다: Windows와 VS Code의 터미널에서는 해당 방향으로 줄이 읽히고 오른쪽 정렬됩니다. - AWS의 Claude Platform에
/advisor를 추가했습니다:/advisor로 선택하거나,advisorModel또는--advisor를 사용해야 어드바이저가 실행되며,CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1을 설정하면 비활성화됩니다. - 트레이스 스팬(trace spans)에
gen_ai.provider.name,gen_ai.conversation.id,gen_ai.tool.name,error.type등 OpenTelemetry GenAI 시맨틱 컨벤션 속성을 추가했습니다. - 워크플로우 에이전트의
prompt와model을agent.spawn모드 훅(mod hook)에서 재작성할 수 있는 기능을 추가했습니다: 이전에는 워크플로우 에이전트를 거부할 수만 있었습니다. - 프롬프트 상자의 텍스트가 타이핑 편집 없이 변경될 때 발생하는
prompt.change모드 훅을 추가했습니다: 이는 불러온 기록 항목, 지우기(clear), 실행 취소(undo), 또는 플러그인의 채우기(fill) 등의 경우입니다. - 세션 자체의 네트워크 설정이 조직 정책에 의해 호스트가 차단되었다고 Claude에게 알리던 클라우드 세션 관련 오류를 수정했습니다.
- 작은 자동 압축 창을 선택할 때 토큰 사용량이 높다는
/autocompact경고를 수정했습니다. - 백그라운드 명령이 아직 실행 중일 때 종료하는 경우
SessionEnd훅이 작동하지 않던 문제를 수정했습니다. claude --help가--restricted설명에서 제거된 도구를 명시하던 오류를 수정했습니다.- 데이터 중 하나가 불완전하게 반환될 때,
claude agents가 어떤 풀 리퀘스트의 상태도 새로 고치지 않던 문제를 수정했습니다. - 클라우드 세션의 컨테이너가 교체된 후, 에이전트가 이미 한 번 재개되었음에도 불구하고 배경 에이전트가 손실되고 재개할 수 없다고 Claude에게 알리던 오류를 수정했습니다.
- 메시지를 입력했던 서브 에이전트가 작업 완료 직후
/tasks에서 사라져 대화로 돌아갈 방법이 없던 문제를 수정했습니다. - 자식 에이전트를 보고 있는 동안 완료된 부모 에이전트가 브레드크럼(breadcrumb)에서 사라지던 문제를 수정했습니다 (자식이 최상위 레벨에 다시 루트화되어 표시됨).
- 입력이 갑작스럽게 들어올 때 에이전트 뷰가 "up", "down" 또는 "escape"와 같은 타이핑된 단어를 해당 키로 인식하여, 답변 도중 'peek' 위치를 이동시키거나 초안을 지울 수 있던 문제를 수정했습니다.
- 예를 들어 재개 후 MCP 서버가 재연결되는 동안 대화 도중에 자동 도구 검색(
ENABLE_TOOL_SEARCH=auto)이 꺼지던 문제를 수정했습니다. forceLoginOrgUUID에 의해 로그인 거부 시, 거부된 조직의 토큰이 저장되거나/login이후에도 유효하게 남아있던 문제를 수정했습니다.reftable저장소에서 충돌하는 체리픽(cherry-pick) 또는 리버트(revert)를 클로드 데스크톱 및 원격 제어 세션의 diff 뷰가 감지하지 못하던 문제를 수정했습니다.- 호출 입력이 도착할 때 Artifact 도구의 상세한(
verbose) 출력이ctrl+o라인에서Artifact("(unprintable path)")를 읽던 문제를 수정했습니다. 이제 해당 행은 Bash처럼 "Waiting…" 및 "Running…"을 표시합니다. - 세션을 재개한 후 작성된 첫 번째 기록(transcript entry)이 충돌로 인해 기록의 마지막 줄이 잘렸을 때 손실되던 문제를 수정했습니다.
- 유니코드 줄 또는 단락 구분자(Unicode line or paragraph separator)인 (U+2028, U+2029)를 포함하는 경우
/branch가 메시지를 누락시키고claude purge가 하위 폴더 프로젝트를 건너뛰던 문제를 수정했습니다. - 플러그인
WorktreeCreate및WorktreeRemove훅이 Claude Code가--worktree로 시작할 때 (아직--tmux와는 다름) 실행되지 않던 문제를 수정했습니다. reftable참조 저장소를 사용하는 저장소에서git commit -q실행 후 OpenTelemetry의tool_result이벤트가git_commit_id를 누락시키던 문제를 수정했습니다.- 모드의
prompt.submit훅이 재작성하거나 삭제한 프롬프트가 여전히 OpenTelemetry의user_prompt이벤트 및 상호 작용 스팬(interaction span)에 타이핑된 것으로 기록되고, 세션 제목 요청에도 영향을 주던 문제를 수정했습니다. - 모드 핫 리로딩에 관한 클로드에게 전달하려던 메모가 마치 사용자가 타이핑한 것처럼 기록(transcript)에 나타나던 문제를 수정했습니다.
model을 무시하는 agent hook 수정:haiku와 같은 별칭이 이제 올바르게 해석되고, 서브 에이전트의 모델이 이를 덮어쓰지 않으며, 사용 불가능한 모델은 액션을 허용하기보다 호출자의 모델로 폴백(fallback)합니다.- 태그나 브랜치가 커밋 ID처럼 이름 지어졌을 때
--worktree세션이 가끔 잘못된 커밋에서 시작되는 문제 수정, 그리고 시작 시 git 상태가 새 worktree의 브랜치명이 아닌 다른 것을 명명하는 문제 수정 - git의 reftable ref 저장소를 사용하는 리포지토리에서 브랜치가 ".invalid"로 표시되고
--worktree가 worktree를 다시 여는 데 실패하던 문제 수정 - Claude가 세션 스크래치패드에 파일을 전체 경로 대신 단순 파일명이나 상대 경로로 명명하는 문제 수정
claude remote-control서버가 잠긴 키체인과 같은 짧은 로그인 오류 후 연결 갱신을 포기하던 문제 수정; 이제 재시도하며,claude /login을 실행해야 할 때 경고합니다.- origin의 기본 브랜치를 가져올 수 없을 때 bare 리포지토리의 worktree에서
--worktree가 실패하던 문제 수정; 이제 폴백 베이스는 메인 리포지토리가 아닌 현재 체크아웃의 HEAD입니다. - VS Code, Cursor 또는 Devin Desktop 통합 터미널에서 Claude Code를 시작할 때 확장 프로그램 확인을 위해 에디터의 명령줄 도구를 두 번 실행하던 문제 수정; 이제 한 번만 실행합니다.
- 모드의
prompt.edithook이chat:newline키바인딩(Ctrl+J 또는 재지정된 Enter)으로 입력된 줄 바꿈에 대해 호출되지 않던 문제 수정 - API가 MCP 도구의 입력 스키마를 거부할 때 대화가 매 턴마다 400 오류로 실패하던 문제 수정; Claude Code는 이제 나머지 대화 동안 해당 도구를 파라미터 없이 전송합니다.
- 컴팩션(compaction)이 출력 토큰 제한으로 인해 응답을 잘랐을 때, 헤드리스 또는 Agent SDK 세션을 재개하는 과정에서 최근 메시지를 잃어버리던 문제 수정 (본 버전부터의 컴팩션에 해당)
- 컴팩션 후 MCP 서버가 연결을 마친 시점에 Claude에게 해당 서버의 도구와 지침이 알려지지 않던 문제 수정
- 여러 세션을 동시에 제공하는 컴퓨터에서 여전히 실행 중임에도 불구하고 원격 제어(Remote Control) 세션이 중지된 것으로 표시되는 문제 수정
- 같은 턴(turn)에서 재시도되거나 미완료된 응답에 이어 압축(compaction)이 발생했을 때, 헤드리스(headless) 또는 Agent SDK 세션을 다시 시작하면 압축 요약 정보가 손실되거나 사전 압축 기록을 불러오는 문제 수정
- Claude가 백그라운드 명령(background command)의 출력 파일을 폴링(polling)하거나 해당 명령이 실행되는 동안 대기(sleeping)하는 문제 수정
- 인증서가 운영체제(OS) 인증서 저장소를 통해서만 신뢰되는 TLS 검사 프록시(TLS-inspecting proxy) 뒤에서 기능 플래그(feature flags) 및 단계적 출시(staged rollouts) 정보가 오래된 상태로 유지되던 문제 수정
claude daemon stop --any명령 실행 시, 걸린(stuck) 백그라운드 서비스가 계속 실행되는 상태에서도 "stopped"를 출력하던 문제 수정: 이제는 대기하고, 서비스를 강제 종료하며, 여전히 남아있을 경우 exit 1과 함께 이를 알림- 원격 측정(telemetry) 기능이 비활성화된 경우,
claude daemon stop명령이 아무 출력 없이 종료되고 세션들이 실행 중인 것으로 남아있던 문제 수정 - Cowork 클라우드 세션에서 파일이 실제로 도착하지 않았음에도 불구하고 사용자의 로컬 컴퓨터 경로에 대해 쓰기(Write), 편집(Edit), 노트북 편집(NotebookEdit) 작업이 성공했다고 보고되던 문제 수정
- 세션이 이전에 해당 도구들을 명시하지 않은 기록을 재개할 때, Claude가 지연된(deferred) 도구를 검색하던 문제 수정
- 다크 ANSI 테마 및 16색 터미널에서 보조(희미한/dim) 텍스트가 일반 텍스트와 동일하게 보이는 문제 수정
- 조직의 정책을 읽을 수 없을 때 클라우드 세션이 턴(turn)당 5분간 멈추던 문제 수정; 이제는 즉시 종료되고 그 이유를 알려줍니다
- 긴 답변 도중 세션이 재시작될 때 클라우드 세션이 이미 답변된 메시지를 두 번째로 실행하던 문제 수정
- 자체 호스팅 러너(Self-hosted runner): 아무도 출력을 읽지 않을 때 러너와 오케스트레이터가 멈추는 현상(폴링 없음,
/healthz또는SIGTERM종료) 수정; 로그는 최신 256 KiB를 유지하고 카운트 감소를 표시합니다 (Windows 제외) - Cowork 클라우드 세션에서 WebFetch 기능을 개선하여, 페이지를 다시 가져오는 대신 방금 실패했음을 Claude에게 알려주도록 수정
-
내장된
plugin-authoring스킬에서 모드 공유 기능 개선: Claude가 파일을 열기 전에 키를 스캔하고, 프로젝트 외부 폴더를 스캔하기 전에는 사용자에게 질문합니다. -
@로 언급된 PDF에 대해 Claude 3 모델이 받는 메모리(note)가 개선되어, 내용을 읽지 않고 답변하는 경우가 줄었습니다.
-
아티팩트 업데이트 기능 개선: 이제 Claude는 작은 변경 사항을 적용하고 아티팩트를 한 번의 호출로 재출판하며, 더 큰 편집은 단일 응답 내에서 수행하고 재출판합니다.
-
설정에서
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST세션이 CA-bundle, tool-proxy, git TLS 및SSL_CERT_FILE과 같은 git config 변수를 무시하도록 변경되었습니다. 이는 Claude Desktop의 프로젝트 설정에만 적용됩니다. -
종료 시 멈추라는 요청 후에도 여전히 실행 중인 백그라운드 명령을 강제 종료(force-kill)하도록 변경되었습니다. 이전에는 전체 화면 모드에서 해당 명령들이 계속 실행될 수 있었습니다.
-
Claude Desktop의 Code 탭이
forceLoginGatewayUrl이 세션 호스트 이름을 제공하는 Anthropic 운영 게이트웨이를 지정할 때 관리 설정(managed settings)을 적용하도록 변경되었습니다. 이 게이트웨이는 시작 시 도달 가능해야 합니다. -
claude gateway가 이제 데스크톱에서 사용할 수 없는desktop:정책 키에 대해, 이전에는 경고와 함께 시작하던 것과 달리 시작 시 중지되도록 변경되었습니다. -
api.anthropic.com으로의 대용량 요청이 텔레메트리가 비활성화된 경우에도 gzip 압축을 사용하도록 변경되었습니다. 이를 비활성화하려면
CLAUDE_CODE_GZIP_REQUEST_BODIES=0을 설정하십시오. -
claude-api스킬이 아카이브하거나 삭제하라고 요청하지 않는 한 관리 에이전트(Managed Agents) 세션을 유지하도록 변경되었습니다. -
백그라운드 세션이 핸드오프 파일에서 실행되는 대신, 워크플로우 도구(Workflow tool)의 승인을 통해 진행 중인 워크플로우를 재개하도록 변경되었습니다.
-
로컬 세션 기록(transcripts)에 각 API 요청의 시스템 프롬프트, 도구 및 매개변수가 함께 기록되도록 변경되어, 공유하려는 기록은 요청을 정확하게 재현할 수 있습니다.
-
/sandbox모드 옵션이 -
Cowork 클라우드 세션의
PermissionRequest훅 변경: 훅 허용(allow) 내에서setMode업데이트는 무시되지만, 나머지 승인 절차는 여전히 적용됩니다. -
훅 변경: PreToolUse 및 PermissionRequest 훅의
updatedInput은 이제 Claude 자체 입력과 유사하게 검증됩니다. 알 수 없는 키는 삭제되며, 도구 입력이 호출을 거부하면(reject) 해당 호출이 거부됩니다. -
효과가 없던
claude remote-control에서--sandbox및--no-sandbox플래그를 제거했습니다. 이제 이 중 어느 것을 전달해도 오류와 함께 종료됩니다. 세션의 샌드박싱을 설정하려면 설정에서sandbox.enabled를 지정하세요. -
[VSCode] 에디터에서 선택한 텍스트가 메시지에 추가되는 것을 막기 위해
claudeCode.attachSelection설정을 추가했습니다. -
[VSCode] 사용 크레딧이 소진된 후에도 '빠른 모드(fast mode)'가 켜져 있는 문제를 수정했습니다. 이로 인해 모든 요청이 거부되고 재전송되었는데, 이제는 다시 켤 때까지 꺼지며 오류 알림을 표시합니다.
-
[VSCode] 항상 사고하는(always think) 모델에서 'Thinking' 토글이 Off로 전환되는 문제를 수정했습니다. 해당 모델에 대해서는 더 이상 이 토글이 표시되지 않습니다.
-
[VSCode] 플래그가 지정된 메시지에서
-
[VSCode] Windows 및 Linux에서 Ctrl+Alt+F가 탐색기(Explorer), 다른 트리 뷰 또는 디버그 콘솔을 여는 대신 포커스 뷰를 토글하도록 수정
-
[VSCode] macOS에서 다른 창이나 터미널에 열린 세션을 확인하는 과정에서 추가 프로세스가 생성되던 문제 수정: 이제 매번
ps를 찾기 위해 PATH를 검색하는 대신/bin/ps를 직접 시작함 -
[VSCode] Windows: 충돌 또는 전원 손실 후, Windows가 재시작되어 오래된 프로세스 ID를 다른 프로그램에 할당했을 때
AI 자동 생성 콘텐츠
본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기