plugin.json에 engines["claude-code"]를 추가했습니다. 명시된 Claude Code 버전 범위를 벗어난 플러그인은 설치, 업데이트, 로드되지 않으며, 설치와 업데이트는 범위에 맞는 최신 버전을 선택합니다claude plugin validate에 플러그인의 TypeScript 훅 모듈에 대한 타입 검사를 추가했습니다. 각 검사 결과는 경고이며, --strict를 사용하면 이 경고에서 실패합니다claude plugin validate에서 mod의 engine.create 훅이 추가, 보류 또는 대체하는 $ 명사를 검사하도록 추가했습니다CLAUDE_CODE_AUTO_MODE_MODEL을 지원하도록 추가했습니다(Claude Desktop이 이 버전을 포함하면 적용됩니다)claude -p 및 SDK 세션에서 훅이 오래 실행되는 동안 30초마다 진행 상태 신호(heartbeat)를 보내도록 추가했습니다. 이로써 Claude Desktop 같은 호스트가 턴을 멈춘 것으로 판단해 종료하지 않습니다(호스트가 이 버전을 포함하면 적용됩니다).docx 지원을 추가했습니다/diff to close 힌트를 추가했고, 패널 포커스와 닫기 키를 ? 단축키 가이드에 추가했습니다Bash(PORT=* npm run dev)처럼 변수 값에 *가 포함된 Bash 허용 규칙에 대해 시작 시 경고를 추가했습니다CLAUDE_CODE_PERFORCE_MODE를 언급하는 일회성 시작 알림을 추가했습니다CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES를 추가했습니다(2.1.318부터 사용 가능). 1로 설정하면 서브에이전트 진행 요약과 이를 작성하는 요청을 끕니다(#86879)CLAUDE_CODE_RESUME_HINT_COMMAND를 추가했습니다. Claude Code를 시작하는 프로그램이 이 값을 설정하면 종료 힌트에 해당 프로그램의 재개 명령이 표시됩니다claude plugin install --json 결과에 unsetOptionCount를 추가했습니다. 아직 설정되지 않은 userConfig 옵션의 개수를 나타냅니다isPromptCovered를 추가했습니다. 프롬프트 위의 대화상자나 입력 필드가 프롬프트를 가리는지 알려줍니다/compact를 다시 실행하거나 /context 같은 명령 뒤에 실행할 때, Claude가 아직 답하지 않은 메시지가 요약되어 사라지던 문제를 수정했습니다settings.json을 직접 수정한 내용을 되돌리던 문제를 수정했습니다. 세션 중에 삭제한 설정 파일은 이제 삭제된 상태로 유지됩니다claude plugin 명령과 claude mcp list 문제를 수정했습니다/proc 파일에서 Edit과 Bash가 메모리 부족으로 실패하던 문제, 그리고 장치 및 명명된 파이프에서 Edit이 멈추거나 메모리 부족이 발생하던 문제를 수정했습니다ExitWorktree, 워크트리 종료 대화상자, /resume이 세션을 잘못된 폴더에 남겨두던 문제를 수정했습니다ctrl+x enter처럼 키 조합의 마지막 키(Enter)가, 해당 조합의 동작을 그 자리에서 사용할 수 없을 때 대화상자의 텍스트 필드에 작용하던 문제를 수정했습니다ps 프로세스가 쌓이던 문제를 수정했습니다WorktreeCreate 훅으로 만들었거나 중첩된 저장소에 속한 워크트리에 들어간 뒤, 서브에이전트 기록과 큰 도구 결과가 세션 기록과 별도로 저장되던 문제를 수정했습니다/fork, 왼쪽 화살표, --bg로 이어간 명명된 Anthropic 프로필 세션이 다른 로그인으로 넘어가던 문제를 수정했습니다. 업데이트 중 열려 있던 세션은 다시 열어 주세요TOKEN_EXPIRED 같은 로그인 서버의 오류로 끝나고 다시 로그인하라는 안내가 나오지 않던 문제를 수정했습니다ant auth login 프로필이 대신 사용되면서 "Credit balance too low"가 표시되던 문제를 수정했습니다/login으로 다시 로그인하면 다음 메시지부터 정상적으로 진행됩니다X-Api-Key 헤더가 설정되어 있을 때, 청구 안내에 ant auth login 조직 이름이 표시되던 문제를 수정했습니다/login이나 토큰 갱신이 성공한 직후 "Not logged in · Please run /login"이 다시 표시되던 문제를 수정했습니다awsAuthRefresh 또는 gcpAuthRefresh 명령이 한 요청에 대해 두 번 실행되던 문제를 수정했습니다claude -p 경고에서, claude auth logout이 저장된 MCP 서버 로그인과 플러그인 시크릿도 함께 삭제한다고 안내하도록 수정했습니다.git이나 .claude 같은 민감한 경로에 쓰는 명령에 대해, 저장된 규칙이 다음 프롬프트를 막지 못하는데도 Bash 권한 프롬프트가 "다시 묻지 않음"을 제안하던 문제를 수정했습니다lsof 명령이 권한 프롬프트 없이 실행되던 문제를 수정했습니다cat > file <<EOF처럼 파일을 쓰는 Bash 명령이 "Read 1 file"로 표시되던 문제를 수정했습니다rm을 판단해, 우회 권한 모드나 Bash 허용 규칙에서 위험한 삭제 프롬프트를 건너뛰던 문제를 수정했습니다--permission-mode auto 또는 설정의 defaultMode: auto가, auto 모드를 사용할 수 없을 때 더 많은 것을 허용할 수 있는 모드로 시작하던 문제를 수정했습니다. 이제 먼저 묻는 Manual 모드로 시작합니다plansDirectory가 설정된 경우 계획 파일이 프로젝트 밖에 작성되던 문제를 수정했습니다. 프로젝트 내부에 머물러 있음을 확인할 수 없는 쓰기는 이제 거부됩니다Bash(ls*)처럼 와일드카드가 붙은 Bash 허용 규칙이 일부 경우 권한 프롬프트를 건너뛰던 문제를 수정했습니다. Bash(NODE_ENV*)처럼 변수 이름을 지정하는 규칙은 이제 묻습니다ANTHROPIC_BASE_URL의 게이트웨이에서, 게이트웨이 모델 이름에 "haiku"가 포함된 모델에 대해 auto 모드가 실행되던 문제를 수정했습니다. claude-haiku-5-5를 제외한 해당 모델은 이제 거부됩니다. Haiku 4.5가 거부되는 것과 같습니다sudo, env 등의 래퍼를 통해 실행되는 일부 명령을 Bash 거부 및 확인 규칙이 놓치던 문제를 수정했습니다sudo 옵션을 사용한 Bash 허용 규칙이 일부 경우 권한 프롬프트를 건너뛰던 문제를 수정했습니다sandbox.excludedCommands가 자신이 지정하지 않은 명령을 일부 경우 샌드박스 밖에서 실행하던 문제를 수정했습니다Read 거부 규칙이 적용된 경로에 쓸 수 있던 문제를 수정했습니다tool.check 훅에서 나온 권한 프롬프트가, 질문한 플러그인 대신 해당 도구에 훅을 건 모든 플러그인의 이름을 표시하던 문제를 수정했습니다CLAUDE_CODE_SUBPROCESS_ENV_SCRUB가 설정되고 sandbox.enabled가 꺼진 Linux에서 HTTP 훅이 HTTP 500으로 실패하던 문제를 수정했습니다--settings 또는 샌드박스를 켜는 SDK 설정의 검증이 실패했을 때, claude -p와 Agent SDK가 Bash를 샌드박스 없이 실행하던 문제를 수정했습니다. 이제 Claude Code는 시작 시 중단하고 잘못된 설정을 알려줍니다/export가 조용히 일찍 멈추던 문제를 수정했습니다claude mcp add --help가 긴 예시 명령을 여러 줄로 나누어, 복사한 예시가 헤더 없이 실행되던 문제를 수정했습니다defaultEnabled: false 플러그인이 꺼진 상태로 남던 문제를 수정했습니다/fast on과 /fast off가 /fast 메뉴와 달리 플러그인의 config.set 훅을 호출하지 않던 문제를 수정했습니다-p 실행 결과를 보여줍니다npm, pip, uv, cargo, github, gh라는 이름의 마켓플레이스가 예약된 이름이라는 이유로 거부되던 문제를 수정했습니다init.plugin_errors에 표시됩니다renames 맵에서 잘못된 항목 하나 때문에 다른 이름 변경까지 무시되던 문제를 수정했습니다claude --bg --safe-mode 세션이, 안전 모드에서 시작하지 않을 프로젝트 MCP 서버에 대해 시작 시 멈추고 묻던 문제를 수정했습니다/mcp와 /plugins로 MCP 서버 페이지를 열면 커서가 "Disable"에 놓이던 문제를 수정했습니다. 이제 페이지에 "Reconnect"가 표시되며 그 항목에 커서가 놓입니다enabledPlugins에 버전 목록이 있는 플러그인이 메시지 없이 꺼진 상태로 남던 문제를 수정했습니다. /plugin과 claude plugin list가 그 이유를 표시합니다UserPromptSubmit 또는 플러그인 프롬프트 훅이 아직 실행 중인 원격 및 SDK 세션에서 오류로 표시되던 문제를 수정했습니다claude -p 호출자가 MCP 서버를 제거했다가 다시 추가한 뒤, 그 사이 도구 호출이 시도되면 서버가 도구 없이 연결 해제 상태로 남던 문제를 수정했습니다--plugin-dir mod의 훅이 멈추거나 훅 워커가 충돌할 때, 텍스트 출력 claude -p 실행이 stderr에 아무것도 출력하지 않던 문제를 수정했습니다CLAUDE_CODE_MCP_STARTUP_WAIT_MS를 낮추면, --allowedTools 또는 mcp_tool 훅에 지정된 MCP 서버가 첫 턴 전 2초 미만만 대기받던 SDK 세션 문제를 수정했습니다cleanupPeriodDays에 따라 세션이 만료될 때 남던 문제를 수정했습니다managed-settings.json(managed-settings.d 포함)을 다시 쓰는 동안 시작하면 관리형 설정을 놓치던 문제를 수정했습니다. 이제 시작 시 이 파일을 한 번 더 읽습니다.claude/settings.local.json이 전역적으로 무시되지 않던 문제를 수정했습니다/diff가 diff 패널을 닫기 전에 Claude의 작업이 끝나기를 기다리던 문제를 수정했습니다/memory가 잘못되거나 돌아가는 경로를 표시하고, Windows에서 파일 경로의 슬래시가 빠지던 문제를 수정했습니다CLAUDE_CODE_DISABLE_WEB_FETCH를 다시 확인하지 않던 문제를 수정했습니다https://로 접속할 때도 계속 남아 있던 문제를 수정했습니다claude --teleport가 빈 세션을 열고, 재개가 실패하면 claude -p --teleport가 오류 없이 종료되던 문제를 수정했습니다ctl+k처럼 잘못 입력된 키 조합 수정자가 수정자 없는 키에 바인딩되던 문제를 수정했습니다. 이제 해당 바인딩은 무시됩니다/btw 답변과 요약에 대화의 이전 응답이 포함되던 경우가 있던 문제를 수정했습니다CLAUDE_CODE_RESUME_INTERRUPTED_TURN이 훅의 continue: false로 중단된 턴을 다시 실행하던 문제를 수정했습니다git add -N으로 추가한 파일을 누락하던 문제를 수정했습니다browser_batch 같은 일부 Claude in Chrome 도구 호출이 전체 화면 기록(ctrl+o)이나 서브에이전트 진행 상황에 도구 이름을 표시하지 않던 문제를 수정했습니다claude doctor와 /status가 여전히 읽고 있다고 표시하던 문제를 수정했습니다--chrome 세션이 Claude in Chrome 없이 시작하는 이유를 알려주지 않던 문제를 수정했습니다. 이제 이유를 알려주는 줄이 표시됩니다/rewind 목록이 추적 중인 모든 파일을 변경된 것으로 표시하고, 라벨 표시가 느리며, 파일 읽기가 응답하지 않으면 아무것도 표시하지 않던 문제를 수정했습니다--debug 및 --debug-file이 디버그 로그 폴더의 latest 파일을 덮어쓰던 문제를 수정했습니다claude update가 끝나는 순간 Ctrl+C를 누르면 claude 명령이 삭제되던 경우를 수정했습니다CLAUDE_CODE_EFFORT_LEVEL이 재정의하는 노력 수준을 모델 선택기와 /model이 선택된 값으로 표시하던 문제를 수정했습니다.claude 없이 sparsePaths 목록을 제안하여, 워크트리에 프로젝트 설정과 규칙이 빠지던 문제를 수정했습니다/model 선택기에서 최신 모델의 강조 표시가 누락되던 문제를 수정했습니다/upgrade와 전체 화면에서 Ctrl+클릭한 링크가 조용히 실패하던 문제를 수정했습니다. 이제 주소를 표시합니다/chrome으로 연결이 완료된다고 안내하던 문제를 수정했습니다. 이제 claude --chrome으로 재시작하라고 안내합니다--no-session-persistence로 실행한 세션 뒤에도 긴 도구 결과가 디스크에 남아 있던 문제를 수정했습니다. 이제 정상 종료, Ctrl+C, SIGTERM 시 삭제됩니다PreCompact, PostCompact, 컴팩션 후 SessionStart 훅이 agent_id와 agent_type을 받지 못하던 문제를 수정했습니다CLAUDE_CODE_TRANSCRIPT_LOCAL_GC가 저장된 기록에서 메시지를 누락하던 문제를 수정했습니다/usage가 설정 토큰과 CLAUDE_CODE_OAUTH_TOKEN의 한도 막대를 숨기던 문제를 수정했습니다. 세션 및 주간 막대는 유지하고 나머지가 없는 이유를 표시합니다/usage가 서브에이전트 유형 이름 옆에 세션 전체 비율을 표시하고, 요청이 있었던 시간만 계산해야 하는데 세션이 8시간 실행되었다고 표시하던 문제를 수정했습니다claude remote-control이 새 컴퓨터로 다시 연결되던 문제를 수정했습니다. 이제 최대 30일 동안 식별 정보를 유지합니다DISABLE_TELEMETRY 또는 DO_NOT_TRACK이 설정되어 있을 때 다른 기기와 휴대폰 알림에 Claude가 권한을 요청하는 내용이 표시되지 않던 문제를 수정했습니다command가 숫자, 불리언, 객체일 때 호스트가 종료되거나 세션 출력 읽기를 멈추던 문제를 수정했습니다managedSettings가 Remote Control, agent view, Workflows, Artifact 끄기 스위치를 무시하던 문제를 수정했습니다otlp 익스포터에 엔드포인트는 있지만 OTEL_EXPORTER_OTLP_PROTOCOL이 없을 때 OpenTelemetry 내보내기가 조용히 실패하던 문제를 수정했습니다. 이제 기본값은 http/protobuf입니다localhost:4318 엔드포인트로의 OpenTelemetry 내보내기가 설정된 프록시를 거치던 문제를 수정했습니다OTEL_RESOURCE_ATTRIBUTES의 잘못된 항목 하나 때문에 해당 변수의 모든 속성이 OpenTelemetry 리소스에서 빠지던 문제를 수정했습니다. 나머지 속성은 유지되며, /status가 빠진 항목을 알려줍니다OTEL_LOG_ASSISTANT_RESPONSES=0일 때 OpenTelemetry user_prompt 이벤트와 interaction 스팬이 백그라운드 에이전트의 응답을 기록하던 문제를 수정했습니다OTEL_EXPORTER_OTLP_TIMEOUT이 허용할 수 있는 최댓값이기도 합니다(이전에는 30초).agent.name이 custom 대신 사용자 정의 서브에이전트의 이름을 표시하던 문제를 수정했습니다claude agents가 이전 턴의 상태를 표시하던 문제를 수정했습니다CLAUDE_CODE_SUBPROCESS_ENV_SCRUB가 설정된 경우, 읽기 전용 git 명령이 승인을 요구하거나 claude -p에서 거부되던 문제를 수정했습니다claude agents에서 입력 중인 프롬프트가 사라지던 문제를 수정했습니다. 이제 Esc를 두 번 눌러야 지워지며, ctrl+y로 복원할 수 있습니다claude attach 및 claude agents 세션에서 백그라운드 전환 키가 동작하지 않던 문제를 수정했습니다. Ctrl+B 후 800ms 이내에 d를 누르면 분리됩니다DISABLE_ERROR_REPORTING 없이 시작된 경우, 셸에만 설정된 DISABLE_ERROR_REPORTING을 백그라운드 세션이 무시하던 문제를 수정했습니다claude agents에서 잘못된 "needs input" 알림이 표시되던 문제, 그리고 텍스트 없이 Bash나 Read 같은 기본 도구만 사용한 백그라운드 턴이 끝난 뒤 알림이 반복되던 문제를 수정했습니다claude -p가 다른 모델을 조용히 사용하던 문제를 수정했습니다. 이제 stderr에 경고를 출력합니다claude -p가 실행할 때마다 deniedModels 및 availableModels 항목에 대한 안내를 출력하던 문제를 수정했습니다. /status와 claude doctor에서는 여전히 목록을 볼 수 있습니다.exe 옆에 있는 .cmd 또는 .bat 래퍼(예: git.exe 옆의 git.cmd)를 같은 PATH 폴더에서 찾았을 때 실행하던 문제를 수정했습니다. 이제 cmd.exe와 같이 .exe를 실행합니다/clear, /resume, /branch를 사용한 후, 종료된 세션의 예약된 작업이 실행되지 않던 문제를 수정했습니다/login과 claude setup-token에서 요청이 거부되거나, 연결할 수 없거나, 시간 초과되었을 때의 로그인 오류 메시지를 개선했습니다. 무슨 일이 일어났는지와 무엇을 확인해야 하는지 알려줍니다/mcp에서 API가 입력 스키마를 거부하여 제외된 서버 도구의 개수와 그 이유를 표시하도록 개선했습니다cleanupPeriodDays 정리 시 읽을 수 없는 폴더를 오류로 계산하도록 개선했습니다/v1/models가 max_input_tokens를 명시하도록 개선했습니다ToolSearch가 일치하는 항목이 없다고만 보고하지 않고 그 사실을 알려주도록 개선했습니다/home이 autofs 맵인 Linux에서 시작 속도를 개선했습니다. Claude Code는 더 이상 /home 자체에서 파일을 찾지 않습니다. /에서 한 폴더보다 깊은 맵 루트에는 CLAUDE_CODE_AUTOMOUNT_ROOTS를 설정하세요-p, SDK, IDE, 클라우드 세션의 Fable 한도 메시지를 개선했습니다. 한도가 언제 초기화되는지, 그리고 계속 진행하는 방법을 알려줍니다/security-review는 Claude가 실행하기 전에 묻도록 변경했습니다. 스킬의 인라인 git 명령은 베어 저장소 워크트리와 유사한 폴더에서, 허용하기 전까지 멈추도록 변경했습니다(auto 모드와 우회 모드는 제외)ALL_PROXY로만 설정된 프록시를 사용하지 않도록 변경했습니다. 네트워크에 프록시가 필요하다면 HTTPS_PROXY를 설정하세요/autocompact를, 200K를 유지하려면 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 사용하세요/clear를 하기 전까지 모든 턴이 실패할 수 있으므로, 채워지기 전에 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정하세요MCP_SDK_GENERATION=v1이 v2 MCP 클라이언트를 호환 모드(이전 핸드셰이크, 완화된 OAuth 로그인 검사)로 실행하도록 변경했습니다. v1 MCP 클라이언트가 제거되기 때문입니다dontAsk 모드처럼 물어볼 사람이 없는 경우에는 /mcp를 사용하세요--global 또는 --host 없이 실행하는 glab config set과 glab config edit --local은 Bash 샌드박스 안에서 읽기 전용으로 실패하도록 변경했습니다. 샌드박스 밖에서 실행하세요settings.local.json에 저장될 허용 규칙은 세션 동안만 유지되며 저장되지 않습니다분량 관계로 이후 내용은 번역에서 제외했습니다. 전체 내용은 위 원문 링크에서 확인하세요.