무엇을 확인할 수 있나요?

RunDog 팝오버에는 Claude의 현재 세션과 주간 사용량, 각 한도의 초기화까지 남은 시간이 표시됩니다. 메뉴 막대를 클릭하지 않을 때는 러너의 움직임이 요약 신호가 됩니다. 여유가 많으면 느긋하게 걷고, 잔량이 줄어들수록 단계적으로 빨라지며, 한도에 닿으면 다음 초기화까지 잠듭니다.

빠른 러너
남은 사용량이 적음
느린 러너
남은 사용량에 여유가 있음
잠든 러너
한도에 닿아 초기화를 기다리는 상태

Claude 계정 연결 순서

  1. Mac App Store에서 RunDog를 설치하고 실행합니다.
  2. 메뉴 막대 러너를 클릭한 뒤 Claude 로그인 버튼을 누릅니다.
  3. 브라우저에서 본인의 Claude 계정으로 로그인하고 연결을 승인합니다.
  4. 표시된 코드를 복사해 RunDog 입력란에 붙여넣고 확인합니다.
  5. 사용량과 초기화 시간이 정상 표시되는지 확인합니다.

RunDog는 별도 계정을 만들지 않습니다. 연결을 끊으면 RunDog가 Mac Keychain에 저장한 Claude 토큰만 삭제하며 Claude Code나 다른 앱의 로그인 상태는 건드리지 않습니다.

자동 갱신과 오류를 읽는 법

연결 후 사용량은 60초마다 자동으로 갱신됩니다. Mac이 잠자기 상태일 때는 폴링을 멈추고, 깨어난 뒤 다시 시작합니다. 인증이 만료되거나 서비스가 재로그인을 요구하면 러너와 팝오버가 로그인 필요 상태를 보여줍니다. 숫자가 오래된 경우에는 마지막 갱신 시각과 오류 메시지를 함께 확인하세요.

개인정보 보호 방식

앱에는 분석·광고·추적 SDK가 없습니다. 로그인 토큰은 macOS Keychain에만 저장되고, 사용량 요청은 Mac에서 Claude로 직접 전송됩니다. RunDog 개발자 서버를 거치지 않습니다. 웹사이트의 쿠키·광고 정책은 개인정보 처리방침에서 별도로 확인할 수 있습니다.

세션 한도와 주간 한도는 다르게 읽습니다

Claude 구독에는 짧은 주기로 초기화되는 현재 세션 한도와, 더 긴 주기로 초기화되는 주간 한도가 함께 적용됩니다. RunDog 팝오버는 두 값을 각각 남은 비율과 초기화 카운트다운으로 나누어 보여줍니다. 세션 잔량이 적어도 초기화가 몇십 분 뒤라면 지금 하던 작업은 마무리할 수 있고, 반대로 세션 잔량이 넉넉해 보여도 주간 잔량이 바닥에 가깝다면 큰 리팩터링을 새로 시작하기에는 위험한 상태입니다. 러너 속도는 이 중 더 빠듯한 쪽을 기준으로 빨라지므로, 러너가 갑자기 속도를 올렸다면 어느 한도가 원인인지 팝오버에서 확인하세요.

세션 한도
현재 세션의 남은 비율과 초기화까지 남은 시간
주간 한도
주간 잔량과 다음 주간 초기화 시각
러너 속도
더 빠듯한 한도를 기준으로 단계적으로 빨라짐

러너 속도 단계를 읽는 법

남은 사용량이 넉넉할 때 러너는 느긋하게 걷습니다. 잔량이 줄어들면 몇 개의 구간을 거치며 단계적으로 빨라지고, 최고 속도에는 상한이 있어 메뉴 막대가 지나치게 산만해지지 않습니다. 한도를 모두 소진하면 러너가 잠들고, 다음 초기화가 지나 사용량이 회복되면 다시 일어나 달립니다. 새 버전이 나오면 러너에 N 표시가 붙고, 잠시 조용히 두고 싶을 때는 설정에서 러너 멈춤을 켤 수 있습니다. 러너는 어디까지나 요약 신호이므로 정확한 수치가 필요할 때는 팝오버의 숫자를 기준으로 판단하세요.

문제가 있을 때 확인할 것

  • 코드를 붙여넣을 입력란이 보이지 않을 때 — 브라우저 승인 뒤 팝오버를 닫았다가 러너를 다시 클릭하면 입력란이 그대로 기다리고 있습니다. 1.0.1 이전 버전에서는 입력란이 사라지는 문제가 있었으므로 최신 버전으로 업데이트하세요.
  • 로그인 필요 상태가 반복될 때 — Claude 쪽 인증이 만료된 경우입니다. 팝오버의 계정 메뉴에서 로그아웃한 뒤 처음부터 다시 연결하면 새 토큰이 Keychain에 저장됩니다.
  • 숫자가 오래되어 보일 때 — 새로고침을 누르면 즉시 다시 읽어옵니다. Mac이 잠자기에서 막 깨어났다면 첫 갱신까지 최대 60초가 걸릴 수 있습니다.
  • 다른 Claude 계정으로 바꾸고 싶을 때 — 계정 메뉴에서 로그아웃한 뒤 다른 계정으로 로그인합니다. 브라우저에 이미 로그인된 계정이 다르면 브라우저에서 먼저 계정을 전환하세요.
  • 러너가 메뉴 막대에 보이지 않을 때 — RunDog 설정 창에서 Claude 러너 표시가 켜져 있는지, 메뉴 막대 공간이 부족해 macOS가 아이콘을 숨기지 않았는지 확인합니다.

Claude Code와 함께 쓸 때

RunDog의 Claude 연결은 Claude Code나 데스크톱 앱의 로그인과 별개입니다. RunDog에서 로그아웃해도 터미널의 Claude Code 세션은 유지되고, 반대로 Claude Code를 재로그인해도 RunDog에는 영향이 없습니다. 같은 구독의 한도를 보는 것이므로 표시되는 남은 비율은 동일한 값을 가리키지만, 갱신 시점이 60초 간격이라 터미널에서 방금 보낸 요청이 반영되기까지 짧은 지연이 있을 수 있습니다.

관련 가이드

Codex 한도와 리셋 확인하기AI 코딩 한도 운영 가이드