계정을 연결하세요.
조회값의 의미를 알아보세요.

요구 사항 및 출시 정보

AIUsageWatch는 다음 환경용 무료 네이티브 메뉴 막대 앱입니다: macOS 14 이상. 공개 출시를 준비 중입니다. 다운로드가 가능해지면 이 웹사이트에 검증된 링크를 추가할 예정입니다. 제공업체 계정과 해당 요금제의 요금은 별도입니다.

출시된 앱을 Applications 폴더로 옮긴 후 다음 옵션을 활성화하세요: 로그인 시 열기. 앱은 메뉴 막대에 표시되며 Dock 아이콘이 필요하지 않습니다. 실행 중인 앱을 Finder에서 열면 환경설정이 앞으로 표시됩니다.

제공업체 연결

1. Codex: Codex CLI를 설치하고 로그인하세요. 계정에서 해당 설정 디렉터리를 지정하세요. 일반적인 경로는 ~/.codex입니다. 앱은 로컬 CLI app-server를 통해 해당 디렉터리에 저장된 로그인을 사용합니다.
2. Claude: 기본 ~/.claude 계정은 Safari의 claude.ai 세션을 사용합니다. 환경설정에서 Safari의 Cookies.binarycookies 파일에 대한 접근을 허용하세요. 별도의 Claude 설정 디렉터리에는 다음 설정으로 Claude Code에 로그인하세요: CLAUDE_CONFIG_DIR. 앱은 해당 디렉터리에서 다음 파일을 읽습니다: .credentials.json.
3. Cursor: Safari에서 cursor.com에 로그인하고 환경설정에서 Safari 쿠키 파일에 대한 접근을 허용하세요. Cursor는 사용량 조회에 계정 디렉터리를 사용하지 않습니다.
4. Grok: 다음 파일이 있는 Grok 디렉터리를 선택하세요: logs/unified.jsonl. 해당 로그의 청구 조회값을 갱신하려면 Grok를 실행하세요.

앱은 각 출처에서 확인 가능한 할당량 정보를 읽습니다. Claude 및 Codex CLI 출처에는 해당 계정의 저장된 로그인이 필요합니다. 웹사이트 미리보기는 계정에 접근하지 않습니다.

개인용·업무용 계정을 함께

메뉴에서 환경설정… 항목을 선택하거나 ⌘,를 누르세요. 각 계정에는 라벨, 제공업체, 디렉터리, 색상, 문자가 있습니다. 디렉터리를 추가하려면 + 버튼을 사용하세요. 앱은 디렉터리 내용으로 제공업체를 추정합니다. 새 계정을 사용하기 전에 제공업체를 확인하세요.

다른 Codex 로그인에는 별도의 CODEX_HOME 디렉터리를 선택하세요. 다른 Claude 로그인에는 별도의 CLAUDE_CONFIG_DIR 디렉터리를 사용하고 해당 디렉터리에 자체 인증 정보를 저장하세요. 기본 Claude Safari 세션에 여러 조직이 포함되면 어느 계정인지 명확하지 않을 수 있습니다. 이 경우 별도의 설정 디렉터리를 사용하세요. Cursor 조회 기능은 사용 가능한 Safari 세션을 사용하므로 Cursor 행을 중복 추가해도 독립적인 로그인이 만들어지지 않습니다.

계정이 늘어나면 열이 추가되며 각 열에는 최대 세 행이 표시됩니다. 지정한 문자와 색상은 계정을 구분하는 데 도움이 됩니다. 일반 설정에는 새로 고침 시점, 백분율 표시, 문자, 지원되는 Codex 적립된 초기화권 만료 정보에 대한 경고가 있습니다.

막대의 의미 이해하기

채워진 부분은 남은 할당량을 의미합니다. 잔여량이 0%이면 채워진 막대가 없습니다. 색상은 계정을 구분합니다. 메뉴에는 백분율, 확인 가능한 초기화 시각, 관련 사용 기간의 상세 정보, 조회 상태가 표시됩니다.

Claude는 주간 정보와 확인 가능한 5시간 상세 정보를 제공하고, Codex는 기본 주간 한도를 선택합니다. Cursor는 사용 기간을 명시하지 않는 응답 데이터의 자체 포함 사용량 수치를 사용합니다. Grok는 CLI 로그의 주간 크레딧 수치를 사용합니다. 서로 다른 제공업체의 백분율은 같은 수의 토큰, 프롬프트, 달러 금액을 의미하지 않습니다.

Codex의 적립된 초기화권을 만료 전에 확인하세요

Codex가 사용 가능한 적립된 초기화권과 만료일을 보고하면 AIUsageWatch는 다음 초기화권이 만료되기 전에 계정 옆에 경고 표시점을 보여줄 수 있습니다. 메뉴에서 사용 가능한 개수와 만료 정보를 확인하세요. 사용하지 않은 적립된 초기화권은 만료 시 소멸할 수 있습니다. 이는 주간 할당량이 정기적으로 초기화되는 시각과는 별개입니다.

환경설정에서 초기화권 만료 전 경고 옵션을 켜고 경고 시점을 1–14일 전으로 설정하세요. 기본값은 2일 전이며 빨간 경고 표시점으로 표시됩니다. 색상은 변경할 수 있습니다. 계정 문자를 끈 상태에서도 표시점은 계속 보입니다. 경고는 앱이 실행 중이고, 경고가 활성화되어 있으며, 최신 만료 데이터를 확인할 수 있어야 표시됩니다. 적립된 초기화권을 자동으로 사용하거나 시스템 알림을 보내지는 않습니다.

Codex의 자동 시작 요청

실시간 조회에서 Codex의 주간 잔여량이 100%로 나타나면, AIUsageWatch는 해당 디렉터리에 저장된 CLI 로그인을 사용해 소규모 codex exec 요청 하나를 보냅니다. 이 요청은 시작 전 상태로 남아 있을 수 있는 주간 사용 기간을 시작하기 위한 것입니다. Codex에서 사용 가능한 기본 모델을 사용하고 해당 계정의 할당량을 소량 사용합니다.

요청이 실행 중이거나 실패하면 해당 계정에 빨간 표시점이 나타납니다. 메뉴는 상태를 설명하고 수동 재시도를 제공합니다. 앱은 해당 주간 사용 기간의 시도 여부를 메모리에 저장합니다. 기억된 시도에 대해서는 반복 조회해도 추가 요청을 보내지 않습니다. 앱을 다시 실행하면 메모리에서 이 정보가 지워지므로 실시간 잔여량이 여전히 100%이면 또 다른 요청이 발생할 수 있습니다.

과거 세션 기록을 대체 데이터로 사용할 때는 시작 요청을 보내지 않습니다. 현재 빌드에서는 Claude의 자동 시작 요청이 활성화되어 있지 않습니다. 이는 사용량 조회와 별개의 동작이며, 현재 환경설정에는 Codex 시작 요청을 켜고 끄는 옵션이 없습니다.

수치가 오래되었거나, 없거나, 예상과 다를 때

• 저장된 조회값: 마지막 정상 조회값은 Mac에 캐시되어 앱 실행 시 복원됩니다. 새로 고침에 실패하면 메뉴에서 경과 시간을 안내합니다.
• 요청 제한 또는 연결 실패: 요청 제한 후에는 15분, 다른 오류 후에는 2분 동안 재시도를 기다립니다. 지금 새로 고침 기능은 이 대기 시간을 건너뜁니다.
• Safari 연결: 올바른 제공업체에 로그인되어 있는지 확인하고 쿠키 파일 접근 권한을 검토하며, 세션에서 어느 계정인지 명확한지 확인하세요.
• Grok: CLI를 실행해 새 사용량 조회값을 기록하세요. 만료된 사용 기간이나 오래된 로그는 실시간 잔여량 대신 과거 데이터로 표시됩니다.
• Codex: CLI를 사용할 수 있고 설정한 디렉터리에 원하는 로그인이 저장되어 있는지 확인하세요. app-server를 사용할 수 없으면 대체 데이터인 세션 기록에 오래된 정보가 표시될 수 있습니다.

제공업체의 엔드포인트와 응답 데이터는 바뀔 수 있습니다. 조회값은 제공업체가 다음 요청을 수락한다고 보장하지 않습니다. 잔여량이나 초기화 정보가 잘못된 것 같다면 제공업체 자체 계정 페이지를 확인하세요.

로컬 설정 및 제공업체 연결

환경설정과 캐시된 조회값은 다음 위치에 저장됩니다: ~/Library/Application Support/AiUsageWatch/. 앱은 키체인을 직접 읽지 않습니다. 제공업체 CLI는 자체 로그인 동작을 관리합니다. 실시간 조회 기능은 기존 세션이나 인증 정보를 사용해 해당 제공업체에 연결합니다. 자세한 내용은 개인정보 처리방침 문서에서 로컬 앱 저장, 제공업체 연결, 지원 메시지가 어떻게 구분되는지 확인하세요.

문제 신고

AIUsageWatch 지원팀 문의 시 앱 버전, macOS 버전, 제공업체, 조회 상태, 문제를 재현하는 절차를 알려주세요. 진단용 --dump 모드를 사용한다면 출력 내용을 보내기 전에 검토하세요. 토큰, 쿠키 값, 비공개 계정 경로, 기타 민감한 정보를 제거하세요. 인증 정보 파일은 업로드하지 마세요.