## 변경 사항 - 문제 해결을 위해 모든 커스텀 설정(CLAUDE.md, 플러그인(plugins), 스킬(skills), 훅(hooks), M
요약
Claude Code의 안정성과 사용자 경험을 개선하기 위한 업데이트 사항을 다룹니다. 새로운 `--safe-mode` 플래그 도입, `/cd` 명령어 추가, MCP 정책 적용 오류 수정 및 다양한 플랫폼에서의 성능 최적화가 포함되었습니다.
핵심 포인트
- 문제 해결을 위한 `--safe-mode` 플래그 및 환경 변수 추가
- 프롬프트 캐시를 유지하며 디렉토리를 이동하는 `/cd` 명령어 도입
- MCP 서버 정책 적용 오류 및 Windows/macOS 환경의 성능 이슈 수정
- 에이전트 세션 관리 및 명령 기록 탐색 기능 개선
변경 사항
-
문제 해결을 위해 모든 커스텀 설정(CLAUDE.md, 플러그인(plugins), 스킬(skills), 훅(hooks), MCP 서버)을 비활성화한 상태로 Claude Code를 시작할 수 있는
--safe-mode플래그(및CLAUDE_CODE_SAFE_MODE환경 변수)를 추가했습니다. -
세션 중간에 프롬프트 캐시(prompt cache)를 깨뜨리지 않고 세션을 새로운 작업 디렉토리로 이동할 수 있는
/cd명령어를 추가했습니다. -
모델로부터 번들된 스킬(bundled skills), 워크플로우(workflows), 내장 슬래시 명령어(built-in slash commands)를 숨길 수 있는
disableBundledSkills설정 및CLAUDE_CODE_DISABLE_BUNDLED_SKILLS환경 변수를 추가했습니다. -
긴 입력 줄의 줄 바꿈(wrapped rows)을 넘어 명령 기록(command history)으로 점프하던 상/하 화살표 문제를 수정했습니다. 이제 화살표는 각 시각적 줄을 먼저 이동하며, 기록 호출 시 근접한 가장자리에서 시작됩니다.
-
기업 관리형 MCP 정책(
allowedMcpServers/deniedMcpServers)이 재연결 시, IDE 유형 설정 시, 설치 후 첫 세션 중--mcp-config서버 사용 시, 또는 원격 설정이 로드되기 전에 적용되지 않던 문제를 수정했습니다. 또한 원격 설정이 없는 조직(orgs)에서 콜드 스타트(cold starts)가 느려지던 문제도 수정했습니다. -
claude.ai 자격 증명으로 로그인한 macOS 사용자의 경우, 매 턴 시작 시 약 30-50ms의 UI 스톨(UI stall)이 발생하던 문제를 수정했습니다.
-
Windows에서 슬래시 명령어/스킬 스캔을 기다리는 동안
claude -p가 느려지거나 멈춘 것처럼 보이던 문제(2.1.161 버전에서의 회귀 현상)를 수정했습니다. -
OAuth 토큰 갱신이 동시에 발생했을 때, 세션을 재개한 후 원격 제어(Remote Control)가
-
커스텀 상태 표시줄(statusline)을 사용하는 사용자에게 "esc to interrupt"가 표시되지 않던 문제 수정
-
워커(worker)가 대기 중 종료된 원격 세션에 재연결할 때, 오래된 권한 및 대화창 프롬프트가 매번 다시 나타나던 문제 수정
-
claude agents --json실행 시 차단되었거나 방금 실행된 백그라운드 세션이 누락되던 문제 수정; 완료된 세션을 포함하는--all옵션을 추가하고, 새로운id및state필드 추가 -
Windows Terminal에서 WSL을 통해 에이전트(agent)를 사용하다가 다시 돌아올 때, 에이전트 뷰에서 오래되거나 깨진 프레임이 남던 문제 수정
-
백그라운드 에이전트가 미리 가동된 워커(pre-warmed worker)로 할당될 때 프로젝트 수준의 설정
env값(예:ANTHROPIC_MODEL)을 무시하던 문제 수정 -
Windows에서 MCPB 플러그인 캐시가 비정상적으로 무효화되어 불필요한 재추출이 발생하던 문제 수정
-
플러그인의
.in_usePID 잠금(lock) 파일이 무제한으로 쌓이던 문제 수정; 충돌한 세션에서 발생한 오래된 마커는 이제 하루에 한 번씩 정리됩니다 -
신뢰할 수 없는 프로젝트 설정이 신뢰 확인 없이 OTEL 클라이언트 인증서 경로를 설정할 수 있던 문제 수정
-
이제 턴(turn)이 진행 중인 동안에도
/workflows가 즉시 열립니다 -
TaskCreate신뢰성 개선: 잘못된 입력은 자동으로 복구되며, 로드되지 않은 도구(tool)에 대한 유효성 검사 오류 시 스키마(schema)를 포함합니다 -
조직에서 API 키 인증을 비활성화한 경우 표시되는 오류 메시지 개선; 활성 API 키의 출처에 기반한 안내를 제공합니다
-
응답 스트리밍(streaming) 및 스피너(spinner) 애니메이션 중 CPU 사용량 감소
-
Vertex/Foundry에서 기본 5분 유휴 시간 제한(idle timeout)을 복구하여, 중단된 스트림이 무한히 대기하는 대신 중단되도록 수정; 제외하려면
API_FORCE_IDLE_TIMEOUT=0으로 설정하세요 -
잘못된 항목이 포함된 원격 관리 설정의 경우, 전체 페이로드를 조용히 삭제하는 대신 나머지 유효한 정책을 적용하고 유효성 검사 오류를 표시합니다
-
백그라운드 세션이 retire→wake 과정 전반에 걸쳐
--ide,--chrome,--bare,--remote-control및 기타 플래그를 보존하며, 재시작(respawn) 상태 검증이 강화되었습니다 -
백그라운드 세션(Background sessions)은 이제 워크트리(worktree)에 진입하기 전까지 shared-checkout 편집이 차단됨을 안내받으며, 이를 통해
EnterWorktree호출 전 편집이 거부되어 낭비되는 상황을 방지합니다. -
"CLAUDE.md 파일이 너무 깁니다" 경고 임계값이 이제 모델의 컨텍스트 윈도우(context window) 크기에 따라 조절됩니다.
-
Windows의 자동 업데이트(Auto-updater) 기능은
claude.exe가 다른 프로세스에 의해 점유된 경우, 해당 세션 내에서 재시도하는 것을 중단합니다. -
슬래시 명령(slash-command) 메뉴 내 스킬 태그(skill tags)의 색상 대비가 개선되었습니다.
-
여러 개의 동시 세션을 실행할 때
claude agents사용을 제안하는 팁을 추가했습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기