Claude Code Window Keeper
2026.08 ~ 진행 중 · 개인 개발 · 1명
| Provider | 3종 |
| Operation | 24/7 |
Claude Code, Codex, Spark의 5시간 rate-limit window를 자동으로 감시하고, window가 리셋되는 시점에 공식 CLI를 통해 최소 요청을 전송해 다음 window를 즉시 시작하는 개인용 Go 데몬입니다. Synology NAS의 Docker 환경에서 24시간 무인 운영되며, 인증 갱신·사용량 임계치 제어·Discord 알림·GitHub Actions 기반 CI/CD까지 자동화했습니다.
- Claude Code·Codex·Spark의 5시간 rate-limit window reset 시점을 감지해 다음 window를 자동 시작
- Provider별 독립 goroutine 기반 scheduler를 구성해 각 서비스의 usage와 trigger를 개별 관리
- 공식 Claude·Codex CLI를 PTY로 자동 실행하고, trigger 이후 usage를 재조회해 실제 window 활성화 여부 검증
- 기존 CLI OAuth credential을 재사용하고 access token 만료 시 refresh 및 credential 파일 자동 갱신
- Weekly usage가 설정한 임계치를 초과하면 다음 weekly reset까지 자동 trigger 중단
- 인증이 완전히 만료된 경우에만 Discord Webhook으로 알림을 전송하도록 장애 알림 최소화
- GitHub Actions에서 테스트·lint·버전 관리·Release·Docker 이미지 빌드·NAS 배포까지 CI/CD 자동화
- wavever/CCLimitPing을 기반으로 개인 Synology NAS의 24/7 단일 컨테이너 운영 환경에 맞게 구조와 기능을 재설계