TLDR의 최신 릴리스는 --timeout, --exit-0-on-timeout, --exit-2-on-failure 플래그를 통해 Claude Code와의 강력한 통합을 지원합니다. --timeout 0.1은 TLDR이 100밀리초 내에 가능한 많은 테스트를 무작위 순서로 병렬 실행하도록 지시하며, 이는 Claude Code의 after-write 후크에 추가될 때 개발 속도 저해 없이 지속적인 테스트를 보장합니다.
--exit-0-on-timeout 플래그는 100밀리초 내에 모든 테스트가 실행되지 않더라도 TLDR이 정상 종료 코드 0을 반환하게 합니다. 이 설정 덕분에 테스트 실패가 없다면 Claude Code는 원활하게 다음 작업을 진행할 수 있습니다. Claude Code가 파일을 빠르게 수정하는 특성을 고려할 때, 이 후크는 Claude 작업 중 수많은 무작위 테스트 실행을 유발하여 잠재적 버그를 신속히 발견하는 데 기여합니다.
가장 핵심적인 기능은 --exit-2-on-failure 플래그입니다. 이 플래그는 테스트 실패 시 TLDR이 종료 코드 2를 반환하도록 하며, Claude는 이 코드를 감지하면 테스트가 수정될 때까지 추가 진행을 차단합니다. 이는 Claude가 버그가 있는 코드를 계속 생성하는 것을 방지하고, 개발자가 즉시 문제를 해결하도록 유도하는 강력한 메커니즘을 제공합니다.
예시로 제공된 .claude/settings.json 설정은 PostToolUse 후크 내에서 Edit, MultiEdit, Write 동작에 대해 bundle exec tldr --timeout 0.1 --exit-0-on-timeout --exit-2-on-failure 명령을 실행하도록 구성됩니다. 이는 Claude Code가 코드를 수정하거나 작성할 때마다 TLDR이 자동으로 실행되어 코드 안정성을 검증하게 합니다. 이러한 접근 방식은 다른 린터나 테스트 러너 개발자들에게도 타임아웃 및 종료 코드 구성 노출의 중요성을 시사하며, 미래의 후크 인식 CLI 도구의 표준이 될 가능성을 보여줍니다.