Show GN: TokFresh: 내 몰입시간에 맞게 클로드의 5시간 토큰 갱신 관리하기

Context

Claude API는 5시간 단위의 토큰 세션 윈도우를 운영하므로, 첫 호출 시점에 따라 같은 업무시간에도 사용 가능한 토큰 할당량이 달라진다. 토큰 윈도우 갱신을 위해 새벽 6시 등 특정 시각에 의미 없는 메시지를 Claude에 수동으로 전송해야 하는 불편함이 있었다.

Technical Solution

• Claude OAuth 인증과 개인 Cloudflare API Key를 사용해 Cloudflare Workers 템플릿을 개인 계정에 자동 배포
• 스케줄링된 시각에 Cloudflare Workers에서 Claude로 ping 메시지를 자동 전송해 토큰 윈도우 갱신 트리거
• Claude refresh token을 배포 시점에 개인 Cloudflare KV에 저장해 서버 측 credential 보관 로직 제거
• Slack Webhook 또는 Discord Webhook을 통해 갱신 성공/실패 알림 선택적 수신

Key Takeaway

특정 API의 제약사항(5시간 세션 윈도우)을 역으로 활용해 스케줄링 자동화로 리소스 활용을 극대화하는 설계와, 사용자 credential을 serverless 환경의 KV 스토리지에서만 관리해 서버 측 보안 부담을 완전히 제거하는 아키텍처 패턴.