AI Limits

실시간 사용량 모니터링

데스크톱 위젯이나 작업 표시줄(Taskbar) 패널을 통해 Claude, Codex, Copilot, Antigravity의 현재 사용량 비율을 실시간으로 확인할 수 있습니다. 세션별 한도와 주간 한도를 표시하며, 만료 시각 카운트다운 기능도 제공합니다.

유연한 위젯 커스터마이징

오른쪽 메뉴를 통해 Compact, Medium, Expanded 세 가지 디테일 레벨과 수평/수직 프로그레스 바 레이아웃을 선택할 수 있습니다. 모노크롬 포함 총 9가지 팔레트와 배경 불투명도, 밝기, 채도 조절 기능으로 데스크톱 환경에 맞춰 위젯의 생김새를 자유롭게 변경할 수 있습니다.

작업 표시줄 표시(Indicator)

전체 화면 앱을 사용할 때 위젯이 가려지는 경우를 대비해 작업 표시줄에 사용량을 표시하는 인디케이터 기능이 있습니다. 트레이 아이콘의 링 차트를 통해 가장 많이 사용하는 두 개의 프로바이더 상태를 파악하거나, 시계 옆 투명 패널로 상세 수치를 확인할 수 있습니다.

설정 및 진단

설정 파일은 %APPDATA%AiLimitsconfig.toml에 자동으로 생성되며, 모든 메뉴 변경 사항이 이 파일에 저장됩니다. 오류 진단을 위해 ailimits=debug 환경 변수를 설정하면 %APPDATA%AiLimitsailimits.log 파일에 디버그 로그가 기록됩니다.

다운로드 및 설치 방법

AI Limits는 Windows 패키지 관리자를 통해 간편하게 설치할 수 있습니다. 터미널에서 아래 명령어 중 하나를 사용하세요.

• WinGet: winget install napxlexn.AILimits
• Scoop: scoop bucket add ailimits https://github.com/napxlexn/scoop-ailimits 및 scoop install ailimits
• Chocolatey: choco install ailimits

또는 GitHub Releases 페이지에서 AiLimits-Setup-EXE 파일을 직접 다운로드하여 실행할 수도 있습니다. 설치 시 관리자 권한이 필요하지 않으며(%LOCALAPPDATA%AiLimits 경로에 설치), Windows 시작 시 자동 실행 및 바탕화면 바로가기 생성 옵션을 선택할 수 있습니다. 각 릴리스에는 설치 프로그램 없이 사용할 수 있는 포터블 zip 파일도 함께 제공됩니다.

기본 사용법 및 인증

이 프로그램은 별도의 로그인 과정을 거치지 않습니다. Claude Code, Codex CLI, GitHub CLI(github.com/copilot), Antigravity CLI를 한 번이라도 실행한 적이 있다면, 해당 도구가 남긴 인증 토큰을 자동으로 감지하여 사용량을 표시하기 시작합니다. 위젯은 토큰을 읽기만 할 뿐 갱신하지 않으므로, 기존 CLI의 로그인 상태를 유지하는 데 영향을 주지 않습니다.

CLI를 사용하지 않거나 별도의 인증 키를 지정하고 싶은 경우, 위젯을 마우스 오른쪽 버튼으로 클릭한 후 ‘Providers’ 메뉴에서 클립보드에서 붙여넣기(Paste from clipboard) 기능을 사용하여 키를 저장할 수 있습니다. 터미널에서는 ailimits-auth.exe를 통해 설정을 관리할 수 있습니다.

이런 경우에 유용합니다

Claude Code, GitHub Copilot, OpenAI Codex 등 AI 개발 도구를 활용하여 프로젝트를 진행하는 Windows 11 사용자에게 유용합니다. 남은 사용량과 리셋까지 남은 시간을 실시간으로 모니터링하여 업무 중 갑작스러운 한도 초과로 인한 작업 중단을 미리 방지하고 워크플로우를 효율적으로 관리할 수 있습니다.

지원 환경·시스템 요구사항

공식적으로 Windows 11 환경에서 네이티브로 동작하도록 설계되었습니다. Rust로 빌드되어 정적 링크 방식을 사용하므로 Visual C++ Redistributable이나 번들 DLL이 필요하지 않으며, 설치 시 관리자 권한이 요구되지 않습니다.

최신 버전·업데이트

제공된 증거 기준 최신 버전은 0.6.2입니다. 위젯 내 메뉴에서 ‘Automatic updates’ 옵션을 활성화하면 자동으로 백그라운드 업데이트가 진행됩니다.

제한 사항·확인 사항

설치 프로그램이 코드 서인(Code Signing)되지 않았으므로, Windows SmartScreen이 ‘Windows가 PC를 보호하고 있습니다’ 경고를 표시할 수 있습니다. 이 경우 ‘자세한 정보’를 클릭한 후 ‘어쨌든 실행’을 선택하면 됩니다. 각 프로바이더별 실시간 데이터의 유효 기간은 CLI의 토큰 수명에 따라 다릅니다. 예를 들어 Claude는 마지막 세션 이후 약 8시간, Codex는 CLI 사용 중에만 유효하며, 토큰이 만료되면 마지막으로 기록된 값이 회색으로 표시됩니다. Anthropic 서버 측에서는 Claude의 사용량 엔드포인트에 읽기 속도 제한(Rate-limit)이 걸려 있어 갱신이 지연될 수 있습니다.