Claude Code Routines 에서 GitHub 에 커밋할 때 발생하는 타임아웃 문제와 해결 방안
요약
Claude Code Routines 환경에서 GitHub MCP를 통해 대용량 파일을 커밋할 때 'Stream idle timeout' 문제가 발생합니다. 이는 파일 크기가 약 11,500 바이트를 초과할 때 두드러지게 나타나며, 현재 샌드박스 보안 설계상 일반적인 `git push` 폴백 방식도 사용할 수 없어 MCP 프레임워크 내부에서 해결책을 찾아야 하는 기술적 난제입니다.
핵심 포인트
- Claude Code Routines는 Research Preview 단계의 기능이므로 사양 변경 가능성을 염두에 두어야 합니다.
- GitHub MCP의 `create_or_update_file` 사용 시, 대용량 파일 커밋 과정에서 'Stream idle timeout' 문제가 발생합니다.
- 문제 해결을 위해 샌드박스 환경 제약(Bash를 통한 git push 불가) 내에서 MCP 프레임워크 레벨의 접근 방식이 필요합니다.
TL;DR Claude Code Routines 에서 GitHub MCP 의 create_or_update_file 을 사용하여 큰 파일을 저장하려고 하면 Stream idle timeout 이 발생합니다 (약 11,500 바이트를 초과할 때 현저하게 발생함). 샌드박스의 보안 설계상 Bash 를 통한 git push 로의 폴백도 사용할 수 없으므로, MCP 프레임워크 내에서 해결해야 합니다.
서론!
본 기사의 내용은 2026 년 4 월時点의 정보입니다. Claude Code Routines 는 리서치 프리뷰 (Research Preview) 단계이므로 향후 업데이트에서 사양이 변경될 가능성이 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기18