TokFresh 소개: Claude 토큰 리셋 타이밍 자동화하기

아무도 말하지 않는 9-to-6의 문제

Claude Pro나 Max를 실무에 쓰신다면 이미 아실 겁니다. Claude는 세션 첫 메시지로부터 5시간이 지나면 사용량 한도를 리셋합니다. 숫자만 보면 넉넉해 보이지만, 실제 근무일에 대입하면 이야기가 달라집니다.

오전 9시에 자리에 앉았다고 해봅시다. 메일을 확인하고, 티켓을 검토하고, 스탠드업에 참여합니다. Claude에 첫 프롬프트를 입력하는 건 10시쯤이고, 여기서 시계가 돌기 시작해 리셋은 오후 3시에 찾아옵니다.

여기서 점심시간, 길어진 회의, Claude를 켜기도 전에 날린 20분을 빼면, 실제로 쓸 수 있는 시간은 두 시간 남짓입니다. 그마저도 한창 작업하다가, 한창 생각을 이어가다가, 한창 리팩터링하다가 벽에 부딪히기 일쑤입니다.

문제에 깊이 몰입해서 컨텍스트도 다 잡히고 흐름도 붙었는데, 갑자기 막혀버립니다. 다음 창이 열릴 때까지 만들던 걸 멈춰야 하고, 다시 접속 가능해질 때쯤엔 이미 맥락을 다 잃어버린 뒤입니다.

리셋 주기 자체는 문제가 아닙니다. 5시간이면 충분합니다. 문제는 이 창이 언제 시작하느냐입니다. 첫 메시지를 언제 보내느냐에 달려있는데, 대부분에게 이는 적당한 시점보다 한참 늦고, 본인이 전혀 통제할 수 없는 방식으로 정해집니다.

맞서 싸우는 대신 창을 옮기기

TokFresh는 사용량을 늘려주지 않습니다. 대신 시계가 언제 시작하는지를 바꿔줍니다.

Claude가 첫 API 호출로부터 5시간 뒤에 리셋된다면, 그 호출을 더 일찍 발생시키면 리셋도 그만큼 앞당겨집니다. TokFresh는 지정한 시각, 평소 업무를 시작하기 전에 Claude API로 작고 무해한 핑(ping)을 보냅니다. 이 핑이 5시간짜리 타이머를 대신 켭니다.

10시에 보낸 첫 프롬프트가 시계를 돌리는 대신, TokFresh가 아직 자고 있거나 커피를 내리고 있을 오전 6시에 핑을 보냅니다. 5시간짜리 창은 6시부터 11시까지 흘러갑니다. 실제로 9시나 10시에 자리에 앉을 때는 이미 진행 중이던 세션의 중간에 들어와 있는 셈이고, 이 창은 유리한 타이밍에 다시 리셋됩니다.

계산해보면 차이는 확실합니다. 그냥 두면 두 시간이던 실사용 시간이, 창을 실제 업무 시간에 맞추면 세 시간 이상으로 늘어납니다. 구독 플랜이나 사용 습관을 바꾸지 않고, Anthropic 쪽에서 뭔가를 손대지도 않고, 대략 50% 더 많은 실사용 시간을 확보하는 셈입니다. 시계가 앱을 우연히 열었을 때가 아니라 편한 시점에 시작하도록 만드는 것뿐입니다.

실제 설정 과정

TokFresh는 한 번 설정하고 나면 신경 쓸 일이 없도록 만들어졌습니다. 세 단계입니다.

OAuth로 연결하기. Claude 자체 OAuth 플로우로 인증합니다. Claude Code가 쓰는 것과 동일한 방식입니다. API 키를 발급받거나 복사하거나 실수로 설정 파일에 흘릴 일도 없습니다. TokFresh는 비밀번호를 절대 보지도 요구하지도 않습니다.

스케줄 설정하기. 리셋 창이 언제 떨어지길 원하는지 알려주면, TokFresh가 거꾸로 계산해 5시간 간격을 맞춥니다. 오전 9시에 새 창을 열고 오후에 하나 더 원하시나요? 핑을 정확히 언제 쏴야 하는지 TokFresh가 계산해줍니다.

Cloudflare에 배포하기. 클릭 한 번이면 Cloudflare 계정에 Worker가 배포됩니다. 무료 티어로도 이 작업량은 충분히 감당되니, 예상치 못한 청구서를 받을 일은 없습니다.

처음부터 끝까지 3분 정도 걸립니다. 그 뒤로는 Worker가 인프라 위에서 조용히 돌아가며 예정된 핑을 쏘고, 다시는 신경 쓸 필요가 없습니다.

이렇게 만든 이유

완전한 무상태(stateless) 구조. TokFresh 서버는 아무 정보도 저장하지 않습니다. 사용 로그도, 스케줄 정보도, 어딘가 데이터베이스에 잠재적 위험으로 남아 있는 토큰도 없습니다. Worker가 한 번 배포되면, 계정에 한정된 자격 증명으로 Cloudflare 인프라 위에서 독립적으로 돌아갑니다.

비용 제로. 전 과정이 Cloudflare Workers 무료 티어에서 돌아갑니다. 구독료도, 사용량 기반 청구도, 숨어 있는 업셀 제안도 없습니다. 핑 자체가 워낙 가벼워서, 계정을 수십 개는 굴려야 유료 티어에 가까워질 정도입니다.

락인 없음. Worker가 Cloudflare 계정 위에서 돌아가기 때문에, TokFresh 인프라가 계속 살아있어야 할 이유가 없습니다. 코드를 직접 살펴보고, 수정하고, 원하면 언제든 삭제할 수 있습니다. 프로젝트는 github.com/stevejkang/tokfresh에 오픈소스로 공개되어 있습니다.

목표는 애초에 무기한 의존하게 될 서비스를 만드는 게 아니었습니다. 특정한 불편함 하나를 고쳐주고, 돌아가는 인프라의 주도권을 사용자에게 넘긴 다음, 조용히 물러나는 작은 도구를 만드는 것이었습니다.