검색
← 릴리스 노트

안전 모드와 세션·백그라운드 동작 개선

클로드 코드 · 2.1.169 · 기능추가 · 2026.06.08

안전 모드, 세션 이동, 백그라운드 에이전트와 원격 설정 관련 기능이 추가·개선되고 여러 문제를 수정했습니다.

교안에 영향

기존 문서에서 `claude agents --json` 출력 형식과 `--safe-mode`, `/cd`, `disableBundledSkills` 관련 안내는 그대로 맞지 않을 수 있습니다.

요약

- `--safe-mode`와 `CLAUDE_CODE_SAFE_MODE`로 사용자 설정, 플러그인, 스킬, 훅, MCP 서버를 끈 상태로 Claude Code를 시작할 수 있습니다. - `/cd`로 세션을 새 작업 디렉터리로 옮길 수 있고, `/workflows`는 턴 진행 중에도 바로 열립니다. - `disableBundledSkills`와 `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`로 번들 스킬, 워크플로, 기본 슬래시 명령을 모델에서 숨길 수 있습니다. - 백그라운드 세션, `claude agents`, 원격 제어, MCP 정책, Windows·macOS 관련 여러 문제를 수정했습니다. - 응답 스트리밍, 스피너, 색상 대비, 안내 문구, idle timeout, 자동 업데이트 등 사용성도 개선했습니다.

바뀐 것

새 기능 3

  • `--safe-mode` 플래그와 `CLAUDE_CODE_SAFE_MODE` 환경 변수로 모든 사용자 지정 항목을 끈 상태로 Claude Code를 시작할 수 있습니다.
  • `/cd` 명령으로 세션을 새 작업 디렉터리로 옮길 수 있습니다.
  • `disableBundledSkills` 설정과 `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` 환경 변수로 번들 스킬, 워크플로, 내장 슬래시 명령을 숨길 수 있습니다.

개선 2

  • 응답 스트리밍 중과 스피너 애니메이션 동안 CPU 사용량을 줄였습니다.
  • Vertex/Foundry에 기본 5분 idle timeout을 복원해 멈춘 스트림이 무한 대기하지 않도록 했으며, `API_FORCE_IDLE_TIMEOUT=0`으로 해제할 수 있습니다.

수정 20

  • 긴 입력 줄에서 위/아래 화살표가 줄 바꿈된 각 시각적 행을 먼저 따라가도록 고쳤습니다.
  • 기업용 관리 MCP 정책이 재연결, IDE 입력 설정, `--mcp-config`, 초기 설치 후 첫 세션, 원격 설정 로드 전에도 제대로 적용되도록 고쳤습니다.
  • 원격 설정이 없는 조직에서 느린 초기 시작 문제가 개선되었습니다.
  • claude.ai 자격 증명 사용자의 각 턴 시작 시 발생하던 약 30~50ms UI 멈춤을 줄였습니다.
  • Windows에서 `claude -p`가 슬래시 명령·스킬 검사 대기 중 느려지거나 멈춘 것처럼 보이던 문제를 고쳤습니다.
  • 세션 재개 중 OAuth 토큰 갱신이 겹칠 때 Remote Control이 "reconnecting"에서 멈추는 문제를 고쳤습니다.
  • Windows에서 백그라운드 git 명령 실행 시 Git Credential Manager의 "Connect to GitHub" 팝업이 불필요하게 뜨는 문제를 고쳤습니다.
  • 사용자 지정 statusline이 있을 때 푸터 힌트가 보이지 않던 문제를 고쳤습니다.
  • 작업자가 대기 중이던 권한·대화 상자가 죽은 뒤 원격 세션을 다시 연결할 때마다 다시 뜨던 문제를 고쳤습니다.
  • `claude agents --json`에서 차단되었거나 방금 시작한 백그라운드 세션이 빠지던 문제를 고치고, `--all`, `id`, `state`를 추가했습니다.
  • WSL의 Windows Terminal에서 에이전트 화면을 되돌아올 때 남던 깨진 프레임 문제를 고쳤습니다.
  • 백그라운드 에이전트가 미리 준비된 작업자에 배치될 때 프로젝트 수준 `env` 값, 예를 들어 `ANTHROPIC_MODEL`, 을 반영하지 않던 문제를 고쳤습니다.
  • Windows에서 MCPB 플러그인 캐시가 불필요하게 무효화되어 재추출되던 문제를 고쳤습니다.
  • 플러그인 `.in_use` PID 잠금 파일이 무한히 쌓이던 문제를 고치고, 충돌한 세션의 오래된 표식을 하루 한 번 정리하도록 했습니다.
  • 신뢰되지 않은 프로젝트 설정이 신뢰 확인 없이 OTEL 클라이언트 인증서 경로를 지정할 수 있던 문제를 고쳤습니다.
  • `TaskCreate`의 신뢰성을 높여 잘못된 입력은 자동으로 보정하고, 로드되지 않은 도구의 검증 오류에는 스키마를 포함하도록 했습니다.
  • 조직에서 API 키 인증이 비활성화된 경우 표시되는 오류 메시지를 개선해, 활성 API 키의 출처에 따른 안내를 추가했습니다.
  • 잘못된 항목이 있는 원격 관리 설정도 유효한 정책은 적용하고 검증 오류를 표시하도록 바꿨습니다.
  • 백그라운드 세션이 `retire→wake` 사이에 `--ide`, `--chrome`, `--bare`, `--remote-control` 등 플래그를 유지하도록 했고, respawn 상태 검증을 강화했습니다.
  • 백그라운드 세션이 `EnterWorktree` 전에는 shared-checkout 편집이 차단된다는 점을 미리 알리도록 했습니다.