Claude Code 2.1.78 업데이트 정리

<클로드 코드 2.1.78 업데이트>

2026년 3월 18일 Claude Code 2.1.78이 배포되었습니다. 이번 버전은 플러그인 전용 영구 저장 경로(${CLAUDE_PLUGIN_DATA})와 API 오류 시 자동 실행되는 StopFailure 훅 이벤트 등 플러그인 개발자를 위한 기능이 중심입니다. 샌드박스가 경고 없이 꺼지거나 보호 디렉터리에 무단으로 쓸 수 있던 보안 문제도 수정되었고 버그 수정 항목이 20개를 넘는 안정성 중심 업데이트입니다.

3줄 요약

• 플러그인 업데이트 후에도 데이터가 살아남는 영구 저장 경로(${CLAUDE_PLUGIN_DATA})가 추가되었습니다. 에이전트 프론트매터에 effort, maxTurns, disallowedTools 설정도 지원됩니다.
• API 오류로 턴이 종료될 때 자동 실행되는 StopFailure 훅 이벤트가 추가되어 오류 알림이나 후속 처리를 자동화할 수 있습니다.
• 샌드박스가 경고 없이 꺼지거나 보호 디렉터리에 무단으로 쓸 수 있던 문제 등 보안 관련 버그가 수정되었습니다.

주요 변경사항

플러그인에 영구 데이터 저장 경로가 추가되었습니다

${CLAUDE_PLUGIN_DATA} 변수가 추가되었습니다. 플러그인이 설정이나 상태 정보를 저장해야 할 때 이 경로를 사용하면 플러그인을 업데이트해도 데이터가 유지됩니다. /plugin uninstall 명령으로 플러그인을 삭제할 때는 이 데이터도 함께 삭제할지 확인하는 안내가 표시됩니다.

API 오류 발생 시 StopFailure 훅 이벤트가 실행됩니다

StopFailure 훅 이벤트가 추가되었습니다. 속도 제한(rate limit)이나 인증 실패 등 API 오류로 턴이 비정상 종료될 때 자동으로 실행되는 스크립트를 등록할 수 있습니다. 오류 발생 시 알림을 보내거나 후속 처리를 자동화하는 데 활용할 수 있습니다.

플러그인 에이전트에 프론트매터 설정이 확장되었습니다

플러그인이 제공하는 에이전트(subagent)의 프론트매터에 effort, maxTurns, disallowedTools 설정을 지정할 수 있게 되었습니다. effort는 에이전트의 사고 깊이를 조절하고 maxTurns는 최대 실행 횟수를 제한합니다. disallowedTools는 특정 도구의 사용을 차단합니다. 플러그인 개발자가 에이전트의 동작 범위를 더 세밀하게 제어할 수 있습니다.

샌드박스 의존성 누락 시 보안 경고가 표시됩니다

샌드박스를 켜두었더라도(sandbox.enabled: true) 실행에 필요한 의존성이 없으면 경고 없이 샌드박스가 꺼지던 문제가 수정되었습니다. 이제 시작할 때 눈에 띄는 경고 메시지가 표시되어 샌드박스 없이 작업하고 있다는 사실을 바로 알 수 있습니다.

부가 변경사항

안정성

• 샌드박스 안에서 git log HEAD 실행 시 Linux에서 "ambiguous argument" 오류가 발생하고 스텁 파일이 작업 디렉터리의 git status를 오염시키던 문제가 수정되었습니다.
• cc log과 --resume이 서브에이전트를 사용한 대규모 세션(5MB 초과)에서 대화 기록을 조용히 잘라내던 문제가 수정되었습니다.
• API 오류가 스톱 훅을 실행시키고 그 훅이 다시 오류를 모델에 전달하면서 무한 루프에 빠지던 문제가 수정되었습니다.
• deny: ["mcp__servername"] 권한 규칙으로 차단한 MCP 서버 도구가 모델에 그대로 전달되어 모델이 차단된 도구를 보고 사용을 시도하던 문제가 수정되었습니다.
• sandbox.filesystem.allowWrite가 절대 경로에서 작동하지 않던 문제가 수정되었습니다. 이전에는 // 접두사가 필요했습니다.
• .git, .claude 등 보호 디렉터리가 bypassPermissions 모드에서 확인 없이 쓰기가 가능하던 문제가 수정되었습니다.
• ANTHROPIC_BETAS 환경 변수가 Haiku 모델 사용 시 조용히 무시되던 문제가 수정되었습니다.
• 대기열에 있는 프롬프트가 줄바꿈 없이 이어붙여지던 문제가 수정되었습니다.

터미널 및 UI

• tmux 환경에서 set -g allow-passthrough on이 설정되어 있으면 터미널 알림(iTerm2/Kitty/Ghostty 팝업, 진행 표시줄)이 외부 터미널까지 전달됩니다.
• 응답 텍스트가 생성되는 대로 줄 단위로 스트리밍됩니다. 이전에는 일정 분량이 모인 후 한 번에 표시되었습니다.
• /sandbox 의존성 탭이 macOS에서 Linux용 사전 요구사항을 표시하던 문제가 수정되었습니다.
• 일반 모드에서 Ctrl+U가 readline의 줄 삭제(kill-line) 대신 스크롤 동작을 하던 문제가 수정되었습니다. Ctrl+U/Ctrl+D 반 페이지 스크롤은 트랜스크립트 모드에서만 동작합니다.
• 음성 모드에서 Ctrl+K 같은 수정자 키 조합의 푸시투톡이 즉시 활성화되지 않고 길게 누르기를 요구하던 문제가 수정되었습니다.
• WSLg가 설치된 WSL2 환경에서 음성 모드가 작동하지 않던 문제가 수정되었습니다. WSL1이나 Windows 10 사용자에게는 명확한 오류 메시지가 표시됩니다.
• VS Code, Cursor, code-server 등 트루컬러를 지원하지 않는 터미널에서 Claude 주황색이 바래 보이던 문제가 수정되었습니다.
• [VS Code] 사이드바를 열 때 이미 로그인된 상태에서도 로그인 화면이 잠깐 깜빡이던 문제가 수정되었습니다.
• [VS Code] 구독 플랜 등급이 확인되지 않는 사용자가 Opus를 선택할 때 "API Error: Rate limit reached" 오류가 발생하던 문제가 수정되었습니다. 모델 드롭다운에서 1M 컨텍스트 옵션이 제외됩니다.

성능

• 대규모 세션을 이어서 열 때 메모리 사용량과 시작 시간이 개선되었습니다.

플러그인 및 기타

• --worktree 플래그가 워크트리 디렉터리에서 스킬과 훅을 로드하지 않던 문제가 수정되었습니다.
• CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 환경 변수와 includeGitInstructions 설정이 시스템 프롬프트의 git 상태 섹션을 숨기지 못하던 문제가 수정되었습니다.
• macOS에서 Dock이나 Spotlight을 통해 VS Code를 실행할 때 Bash 도구가 Homebrew와 PATH에 등록된 바이너리를 찾지 못하던 문제가 수정되었습니다.
• ANTHROPIC_CUSTOM_MODEL_OPTION 환경 변수가 추가되었습니다. /model 선택기에 사용자 지정 모델 항목을 추가할 수 있습니다. 표시 이름과 설명은 _NAME, _DESCRIPTION을 뒤에 붙인 별도 변수로 지정합니다.

결론

Claude Code 2.1.78은 플러그인 개발자를 위한 기능 추가와 보안 수정이 함께 이루어진 업데이트입니다. 새 기능보다는 기존 기능의 안정성을 다지는 데 무게를 둔 버전으로 버그 수정 항목만 20개가 넘습니다.

샌드박스가 경고 없이 꺼지거나 보호 디렉터리에 무단으로 쓸 수 있던 보안 문제가 해결되었으니 샌드박스를 활용하고 있다면 업데이트를 권장합니다. WSL2 음성 모드나 macOS에서 Dock/Spotlight으로 VS Code를 실행할 때 PATH를 못 찾던 문제도 함께 수정되었습니다.