KKUREI DASHBOARD곁에 두는 사용량 계기판

남은 한도는,
고양이 밑에서.

Codex·Claude Code 남은 사용량을 한눈에.
바탕화면 고양이 그레이가 밑에서 알려 줘요.

작업하다 한도가 얼마나 남았는지 궁금할 때, 창을 오가지 않아도 돼요. 대시보드로 사용량을 보고, 무료 바탕화면 고양이 Kkurei Free의 밑 게이지로 곁에 두세요.

무료 · 회원가입 없음 · Mac(Apple Silicon·Intel)과 Windows 10·11을 지원해요.

01 / DOWNLOAD내 컴퓨터에 맞는 파일을 받으세요

대시보드와 고양이는 함께 쓰는 두 개의 프로그램이에요. 같은 폴더에 두면 대시보드에서 고양이를 켜고 끌 수 있어요. 꾸레이는 무료이며, Codex·Claude Code를 쓰기 위한 계정과 구독 조건은 각 서비스의 기준을 따라요.

01 / MAC

Mac용

파일Kkurei-AI-Dashboard-mac-v0.2.2.zip
크기7.9MB
필요한 것macOS 14 이상
종류Apple Silicon · Intel

Mac 다운로드

02 / WINDOWS

Windows용

파일Kkurei-AI-Dashboard-win-v0.2.2.zip
크기3.4MB
필요한 것Windows 10·11 64비트 · Python 3.10 이상(Tcl/Tk 포함)
종류미리보기 · 코드 서명 없음

Windows 다운로드

두 ZIP 모두 Apple·Microsoft의 서명 심사를 받지 않았어요. 열 때 경고가 뜨면 아래 설치 안내대로 확인해 주세요. 받은 파일이 맞는지는 아래 SHA256 값으로 비교할 수 있어요.

02 / INSTALL다운로드부터 그레이를 만날 때까지

Mac

ZIP 파일을 풀어요
받은 ZIP을 더블클릭하세요. 압축을 푼 폴더 안에 AI Usage Dashboard.app과 Kkurei Free.app이 있는지 확인해 주세요.
폴더째 응용 프로그램으로 옮겨요
Finder에서 폴더 그대로 응용 프로그램(Applications)에 옮겨 주세요. 두 앱은 같은 폴더에 둬야 해요. 하나만 꺼내 옮기거나 압축 파일 안에서 바로 실행하면 고양이를 찾지 못할 수 있어요.
대시보드를 우클릭 → 열기
AI Usage Dashboard.app을 우클릭하고 열기를 선택하세요. 임시 서명이고 Apple 공증을 받지 않아 개발자 확인 경고가 뜰 수 있어요.
캐릭터 켜기를 눌러요
대시보드가 열리면 캐릭터 켜기를 누르세요. Kkurei Free를 처음 열 때도 경고가 뜨면 같은 방법으로 확인하세요. 계정을 연결해 사용량이 조회되면 그레이 밑에 게이지를 표시할 수 있어요.

‘열기’로도 막힌다면
앱을 한 번 실행한 뒤 시스템 설정 → 개인정보 보호 및 보안에서 해당 앱의 그래도 열기를 확인하세요. macOS 버전에 따라 우클릭만으로는 열리지 않을 수 있어요. 출처와 파일을 확인한 뒤 해당 앱에만 허용해 주세요.

받은 파일이 같은지 확인하기 · Mac

터미널(응용 프로그램 → 유틸리티)에서 아래 명령을 실행하고, 나온 64자리 값이 아래 값과 정확히 같은지 비교하세요. 저장한 위치나 이름이 다르면 경로를 바꿔 주세요.

shasum -a 256 ~/Downloads/"Kkurei-AI-Dashboard-mac-v0.2.2.zip"

공식 Mac ZIP SHA256: 11433c0e2b949a9e331093905565717d52b79a911bb1c0bbd52fde2d76bfcb91

Windows

Python을 먼저 설치해요
대시보드는 Python 3.10 이상이 필요해요. python.org에서 받아 설치하고, 설치 화면의 선택 기능에서 tcl/tk and IDLE을 켜 주세요. 이미 있다면 건너뛰어도 돼요.
ZIP을 풀고 폴더를 옮겨요
ZIP 전체를 풀어 문서 같은 계속 쓸 곳에 두세요. 폴더 안에 Kkurei Free.exe와 Start Dashboard.cmd가 함께 있어야 해요. 하나만 꺼내 옮기지 마세요.
Start Dashboard.cmd를 실행해요
더블클릭하면 대시보드가 열려요. 처음에는 계정 연결 안내를 따라 Codex·Claude Code에 로그인하세요.
Kkurei Free.exe를 열어요
‘PC 보호’ 경고가 뜨면 추가 정보 → 실행을 누르세요. 코드 서명을 받지 않은 프로그램이라 나오는 경고예요. 대시보드의 꾸레이 버튼에서 고양이를 켜고 끌 수도 있어요.

Windows판은 미리보기예요
계정을 여러 개 더하는 기능은 Mac판에만 있어요. Claude Code 사용량은 Claude Code를 쓰는 동안 갱신돼요. 고양이 화면이 안 뜨면 Microsoft Edge WebView2가 설치돼 있는지 확인해 주세요.

받은 파일이 같은지 확인하기 · Windows

PowerShell에서 아래 명령을 실행하고, 나온 Hash 값이 아래 값과 정확히 같은지 비교하세요.

Get-FileHash "$HOME\Downloads\Kkurei-AI-Dashboard-win-v0.2.2.zip" -Algorithm SHA256

공식 Windows ZIP SHA256: c9946212af36d80e8d1feda68d60b26c667581440aefba2f568c74ff9e270848

SHA256은 파일 내용을 숫자와 영문자로 나타낸 확인값이에요. 값이 다르면 열지 말고 이 페이지에서 다시 받아 주세요. 값이 같다는 것은 공개한 파일과 같다는 뜻이며, 운영체제의 보안 심사나 공증을 대신하지는 않아요. ‘컴퓨터를 손상시킵니다’ 같은 경고가 뜨면 실행을 멈추고 문의해 주세요.

03 / CONNECT설치 → 터미널 로그인 → 사용량 조회

대시보드의 ‘필요한 것’ 안내도 이 순서로 따라가세요. 쓸 서비스부터 연결하면 돼요. 이미 설치하고 로그인했다면 상태를 확인한 뒤 대시보드에서 새로고침해 보세요.

Codex 연결하기

먼저 Codex CLI 공식 설치 안내에 따라 설치하세요. CLI는 터미널에서 쓰는 Codex예요. 설치 후 터미널에서 아래 명령을 차례로 실행하세요.

codex login
codex login status

브라우저에서 사용할 ChatGPT 계정으로 로그인하고, 두 번째 명령에서 로그인 상태를 확인하세요. 명령을 찾지 못하면 설치를 마친 뒤 터미널을 새로 열어 보세요.

대시보드는 Codex CLI의 기존 ChatGPT 로그인을 사용해요. 일반 ChatGPT 웹의 모든 모델 한도를 보여 주는 것은 아니에요. 로그인 명령 안내

Claude Code 연결하기

Claude Code 공식 설치 안내에 따라 터미널용 Claude Code를 설치하세요. 그다음 Claude 구독 계정으로 로그인하세요.

claude auth login --claudeai

브라우저 인증을 끝낸 뒤 대시보드의 Claude 연결 안내를 따라 사용량을 조회하세요. 작업 폴더 신뢰 여부를 묻는다면 직접 확인하고 승인해 주세요.

Claude 데스크톱 앱 로그인과 터미널 로그인은 별개일 수 있어요. 데스크톱 앱이 열려 있어도 Claude Code에서 다시 로그인해야 할 수 있어요.

명령이 지원되지 않으면 공식 안내에 따라 Claude Code를 업데이트한 뒤 다시 시도하세요.

사용량을 확인하려고 모델에 질문을 보내지 않아요.
Claude Code의 사용량 안내를 조회하며, 사용량 확인을 위한 대화 요청을 만들지 않아요. 다만 로그인 확인과 사용량 조회에는 각 서비스에 연결할 인터넷이 필요해요. 서버 응답이나 계정 상태에 따라 조회가 늦어질 수 있어요.

04 / FEATURES필요한 숫자만, 고양이 밑에

큰 대시보드로 한도를 살펴보고, 작업 중에는 그레이 밑의 작은 게이지로 확인하세요. 도해의 숫자는 설명용 예시이고 실제 표시 항목은 계정과 서비스가 제공하는 정보에 따라 달라져요.

대시보드 보기

Codex·Claude Code의 남은 사용량과 리셋까지의 시간을 확인해요. 제공되는 5시간·주간 한도를 함께 살펴보세요. 작은 바 모드에서는 바를 더블클릭해 전체 대시보드로 돌아갈 수 있어요.

‘꾸레이 밑에 표시’ 고르기

대시보드 설정의 꾸레이 밑에 표시에서 보고 싶은 항목을 체크하세요. 선택한 항목이 그레이 밑에 나타나요. 여러 한도가 있다면 지금 작업에 필요한 줄만 골라 두면 편해요.

남은 양이 적어지면 말풍선

남은 사용량이 20·15·10·5% 경계에 이르면 말풍선으로 알려 줘요. 그레이의 크기를 바꾸면 밑의 게이지도 함께 커져 읽기 편해져요. 값이 갱신되는 시점에 따라 표시가 늦을 수 있어요.

계정이 여러 개라면 (Mac)

대시보드 설정의 추가 계정에서 GPT·Claude 계정을 이름과 함께 더하세요. 계정마다 따로 로그인하고, 보고 싶은 한도만 체크해 그레이 밑에 “Claude 회사 5시간”처럼 이름을 붙여 띄울 수 있어요.

그레이 메뉴

그레이를 더블클릭해 메뉴를 열어 보세요. 크기·음량 조절, 대시보드 열기, 도구, 놀이, 그리기, 자동 시작을 찾을 수 있어요. 놀이는 kkurei.com 웹게임으로 이어지고, 무료판의 그리기는 무료로 쓸 수 있어요.

사용량은 서비스에서 마지막으로 받아 온 값이에요. 수신 대기·갱신 대기·오류가 보일 때는 최신 사용량으로 단정하지 말고 연결 상태와 마지막 조회를 확인하세요. 이 앱은 OpenAI 또는 Anthropic의 공식 앱이 아닌 별도 제작 앱이에요.

05 / HELP자주 묻는 질문

‘Claude Code 로그인이 필요합니다’가 계속 떠요.

터미널에서 claude auth login --claudeai로 다시 로그인하세요. Claude 데스크톱 앱에 로그인한 것만으로는 터미널 인증이 완료되지 않을 수 있어요. 브라우저에서 계정을 확인한 뒤 대시보드로 돌아와 새로고침하세요. 계속되면 Claude Code를 업데이트하고, 대시보드의 Claude 연결 안내와 작업 폴더 신뢰 여부를 확인해 주세요. 계정에서 사용량 정보를 제공하지 않거나 서비스 오류가 있으면 로그인 후에도 조회되지 않을 수 있어요.

python3가 없다고 나와요.

조회에 Python 3이 필요해요. 터미널에서 python3 --version으로 확인하세요. 없다면 아래 명령으로 Apple의 Xcode 명령줄 도구 설치 창을 열고 설치를 마쳐 주세요. 전체 Xcode 앱을 설치할 필요는 없어요.

xcode-select --install

설치 후 python3 --version을 다시 확인하고 대시보드를 재실행하세요. Apple 명령줄 도구 안내

그레이는 보이는데 게이지가 안 떠요.

대시보드가 켜져 있는지, Codex 또는 Claude Code의 사용량이 한 번 이상 정상 조회됐는지 확인하세요. 그다음 설정의 ‘꾸레이 밑에 표시’에 체크된 항목이 있는지 보세요. 캐릭터만 켜서는 새 사용량을 받아 오지 못해요. 두 앱이 같은 폴더에 있는지도 확인해 주세요.

앱이 열리지 않거나 고양이를 찾지 못해요.

ZIP을 완전히 풀고 두 앱이 든 폴더를 응용 프로그램으로 옮겼는지 확인하세요. 위의 SHA256 비교 후 우클릭 → 열기를 시도하고, 필요하면 시스템 설정 → 개인정보 보호 및 보안에서 해당 앱의 ‘그래도 열기’를 확인하세요. macOS 14 이상이 필요해요. 손상 경고가 반복되거나 확인값이 다르면 실행을 멈추고 문의해 주세요.

Mac을 켤 때 자동으로 시작하지 않게 하고 싶어요.

그레이 메뉴에서 자동 시작을 끄고, 대시보드 설정의 ‘Mac 로그인 시 자동 시작’도 꺼 주세요. 계속 실행된다면 시스템 설정 → 일반 → 로그인 항목(및 확장 프로그램)에서 관련 앱이 남아 있는지 확인하세요.

삭제하려면 어떻게 하나요?

먼저 두 앱의 자동 시작을 끄고 대시보드와 Kkurei Free를 모두 종료하세요. 그다음 응용 프로그램에 옮겨 둔 배포 폴더를 휴지통으로 옮기면 돼요. 사용량 기록까지 지우려면 Finder → 이동 → 폴더로 이동에서 ~/Library/Application Support/UsageFloat를 확인하세요. 이 폴더는 다른 UsageFloat 판과 공유할 수 있으니, 다른 판을 쓰지 않고 기록이 필요 없을 때만 삭제하세요. Codex·Claude Code 자체의 로그인은 앱 삭제와 별개로 유지돼요.

숫자가 다른 화면과 다르거나 늦게 바뀌어요.

한도의 종류(5시간·주간 등)와 남은 양인지 사용한 양인지 먼저 비교해 주세요. 대시보드는 마지막 조회값을 표시하므로 실시간으로 계속 일치하지는 않을 수 있어요. 인터넷 연결을 확인하고 새로고침한 뒤, 갱신 대기나 오류 표시가 남는지 살펴보세요.

Windows에서도 쓸 수 있나요?

네, 위의 Windows ZIP을 받아 쓸 수 있어요. 대시보드는 Python 3.10 이상이 필요하고, 아직 미리보기라서 계정 여러 개 추가는 Mac판에만 있어요. 설치 방법은 위 설치 안내의 Windows 항목을 보세요.

06 / PRIVACY사용량 값은 이 컴퓨터 안에서

사용량 값은 이 컴퓨터의 대시보드와 게이지에만 쓰며 꾸레이 서버로 보내지 않아요. 앱 자체의 방문 통계도 없어요. 각 AI 서비스의 로그인과 사용량을 확인하는 통신은 해당 서비스와 이루어져요.

사용량과 게이지 선택 정보는 Mac은 ~/Library/Application Support/UsageFloat, Windows는 %LOCALAPPDATA%\UsageFloat에 저장돼요. codex.json, claude.json, gauge-select.json, dashboard-path.txt 등이 여기에 있어요. 문의할 때는 비밀번호·인증 토큰·로그인 파일을 보내지 말고, 오류 문구와 macOS 버전만 먼저 알려 주세요.

앱에서 웹게임·도구·동선을 열면 각 웹사이트의 개인정보 처리 기준이 적용돼요. 이 안내 웹페이지의 운영 기준은 사이트 개인정보 처리방침에서 확인할 수 있어요. 도움이 필요하면 문의하기로 알려 주세요.

MORE / KKUREI함께 써 보세요

작업 사이 짧은 휴식이나 다음 외출을 준비할 때도 꾸레이와 함께해 보세요.

남은 한도는,고양이 밑에서.