Claude Code v2.1.204 — 헤드리스 세션에서 훅이 끊기던 버그 수정
AI

Claude Code v2.1.204 — 헤드리스 세션에서 훅이 끊기던 버그 수정

zaq · · 2 min read

원격 환경에서 Claude Code를 돌릴 때 세션이 멋대로 종료되는 골치 아픈 버그가 드디어 잡혔습니다.

한마디로 요약

SessionStart 훅이 실행되는 동안 헤드리스 세션에서 이벤트 스트리밍이 멈추는 문제가 수정되었습니다. 이 때문에 원격 워커가 훅 도중에 "idle" 상태로 판단돼 강제 종료되는 현상이 발생했었습니다.

무슨 문제였나?

Claude Code는 CI/CD 파이프라인이나 서버 환경에서 헤드리스 모드로 자주 돌아갑니다. 이때 세션 시작 시점에 실행되는 SessionStart 훅이 있는데, 이 훅이 돌아가는 동안 스트리밍 이벤트가 제대로 전달되지 않는 버그가 있었습니다.

결과적으로 시스템이 "아, 아무 것도 안 하네?"라고 착각해서 워커를 idle 상태로 간주하고 중간에 세션을 날려버리는 거죠. 훅이 아직 실행 중인데도 말이죠.

어떤 상황에서 체감되나?

  • GitHub Actions 등 CI 환경에서 Claude Code를 돌릴 때 세션이 갑자기 끊기던 분들
  • 원격 서버에서 백그라운드 작업 중 훅 실행 직후 프로세스가 사라지던 현상
  • 자동화 스크립트에서 "왜 중간에 멈추지?" 하고 의문이었던 부분

이 패치로 훅 실행 중에도 이벤트가 정상적으로 스트리밍되어, 워커가 더 이상 중간에 잘리지 않습니다.

마무리

작아 보이는 픽스지만, CI/CD 자동화에 의존하는 팀에게는 꽤 치명적인 버그였습니다. 이제 원격 환경에서도 안심하고 SessionStart 훅을 쓸 수 있겠네요.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.204