[TIL-260717] readTimeout 하나 고치려다 ClaudeClient를 다시 설계하게 된 이야기
·
Backend/Architecture & Design
기능 개발을 마치면 우리 팀은 PR을 올리고 꼼꼼하게 코드 리뷰를 주고받는다.리뷰는 단순히 버그를 찾는 수준을 넘어, 더 좋은 구조와 유지보수하기 쉬운 설계 방향까지 함께 고민해 주는 문화가 자리 잡혀 있다. 잘한 부분은 왜 좋았는지 이야기해 주고, 개선할 부분은 어떤 점을 보완하면 더 좋은 구조가 될지 이유와 함께 제안해 준다.이번 글도 그런 리뷰를 통해 배우고 개선한 내용을 정리한 기록이다.처음에는 Claude API의 readTimeout 설정 하나만 수정하면 끝날 일이라고 생각했다.하지만 리뷰를 따라 코드를 하나씩 살펴보면서,HTTP 타임아웃과 애플리케이션 타임아웃이 서로 어떤 영향을 주는지 이해하게 되었고,재시도가 여러 계층에서 중복되고 있다는 구조적인 문제를 발견했으며,결국 ClaudeClie..