Claude Code 세션을 캘린더에 등록했더니 5시간 제한 초기화 시간을 정확히 알게 되어 밤새는 일을 멈췄습니다
I put my Claude Code sessions on a calendar and now I can see exactly when my 5h windows reset so I stopped staying up for them
핵심 요약
Claude Code 사용량 제한에 맞춰 밤을 새우는 문제를 해결하기 위해 세션 시간을 시각화하고 관리하는 'AgentCal'을 개발했습니다.
- 사용량 시각화 — 주간 뷰를 통해 Claude Code 세션과 5시간 제한 윈도우를 한눈에 확인 가능함
- 제한 관리 — API 응답에 숨겨진 주간 모델별 사용량 한도를 추적하여 효율적인 작업 배분 지원함
- 자동화 기능 — 제한 초기화 시점에 맞춰 작업을 예약하여 수면 중에도 업무 처리가 가능하도록 설계됨
- 개발자 도구 — 로컬 API를 통해 세션 상태를 추적하고 Slack 알림이나 자동 스크립트를 자유롭게 구성 가능함
사용량 제한에 맞춰 하루 일정을 짜는 것에 지쳤습니다. /usage를 확인하고, 주간 한도를 계산하고, 윈도우가 새벽 2시에 초기화되는데 그걸 놓치고 싶지 않아서 밤을 새우곤 했죠.
이번 주에 이 문제 때문에 병원에 입원까지 했다는 사람의 글을 봤습니다.
그래서 AgentCal을 만들었습니다. 코딩 에이전트를 위한 로컬 캘린더입니다.
제공하는 기능:
- 주간 뷰에서 모든 Claude Code 세션을 블록으로 표시합니다. 병렬 세션은 겹친 회의처럼 나란히 표시됩니다.
- 현재 5시간 윈도우를 음영 처리된 밴드로 보여주며, 정확한 초기화 시간에 점선과 헤더에 카운트다운을 표시합니다.
- 주간 한도와 모델별 주간 제한을 보여줍니다. 첫날 이걸 보고 깜짝 놀랐습니다. Fable 5 주간 한도의 79%를 쓰고 있었는데 전혀 몰랐거든요. 그 제한은 API 응답에는 있지만 어디에도 표시되지 않으니까요.
다음으로 작업 중인 기능:
초기화 시점에 프롬프트나 명령어를 예약할 수 있게 될 겁니다. 윈도우가 오전 6시 40분에 열리면 작업이 바로 시작되니, 당신은 자고 일어나서 작업이 완료된 결과물을 확인하면 됩니다. 윈도우를 낭비할 필요가 없죠.
해커들을 위한 정보:
모든 것이 로컬 API의 이벤트로 처리됩니다. 세션 시작, 세션 유휴 상태, 초기화 임박, 초기화 완료 등 모든 상태가 REST, SSE, 웹훅으로 제공됩니다. 원하는 로직을 마음껏 구축하세요. 제한에 도달하면 Slack 알림을 보내거나, 자정 이후에는 세션 시작을 거부하거나, 초기화되자마자 프롬프트를 실행하는 스크립트 등 무엇이든 가능합니다.
Claude Code 핸들로부터 업데이트를 받을 수 있게 트위터 워처도 추가할까 생각 중입니다.
피드백 환영합니다. 다중 계정 설정도 지원하지만 테스트가 거의 안 된 상태라, 여러 Claude 계정을 사용 중이시라면 특히 의견을 듣고 싶습니다.
업데이트 소식은 X에서 팔로우해주세요! https://x.com/milindlabs
어떻게 생각하시나요? 피드백과 어떤 기능이 도움이 될지 의견 부탁드립니다.
