잔량 확인처가 도구마다 분산됨

AI 에이전트를 병용하면 잔량 확인처가 도구마다 분산됩니다. 게다가 리셋 단위는 프로바이더 (Provider)에 따라 다르며, 세션 (Session) 단위인 것도 있고, 주 단위나 모델 (Model) 단위인 것도 있습니다.

이 확인처를 메뉴바의 한 곳으로 집약할 수 있는 것이 바로 지금부터 소개할 CodexBar입니다.

CodexBar란

CodexBar는 AI 코딩 프로바이더 (Coding Provider)의 사용량과 리셋까지 남은 시간을 macOS의 메뉴바에 표시하는 앱입니다. 대응하는 프로바이더는 63개이며, Codex, Claude, Cursor, Gemini, Copilot, OpenRouter, LiteLLM 등이 포함됩니다.

MIT 라이선스의 무료 앱이며, UI는 일본어로 되어 있습니다.

설치

Homebrew를 통해 설치합니다.

brew install --cask steipete/tap/codexbar

GitHub Releases에서 다운로드할 수도 있으며, 이 경우에는 Sparkle을 통한 자동 업데이트를 사용할 수 있습니다. 동작 요건은 macOS 14 이상입니다.

프로바이더 추가

CodexBar는 비밀번호를 저장하지 않고, 이미 로그인된 세션을 읽어옵니다. 따라서 macOS의 권한을 요구합니다.

메뉴바에 표시할 프로바이더 선택

대응하는 63개의 프로바이더가 모두 나열되는 것은 아닙니다. 메뉴바에 표시할 항목은 설정 화면에서 선택합니다.

설정 화면의 프로바이더 목록. 오른쪽 상단의 토글로 메뉴바 표시 여부를 전환

왼쪽 목록에서 프로바이더를 선택하고, 오른쪽 상단의 토글로 온·오프를 전환합니다. 목록의 헤더에는 「6개 켬」과 같이 현재 개수가 표시되며, 검색과 정렬도 가능합니다.

사용하지 않는 프로바이더를 꺼두면, 메뉴바에는 필요한 것만 나열됩니다.

프로바이더 전환

메뉴 상단에 있는 탭으로 프로바이더를 전환합니다. 가장 왼쪽의 「개요」가 전체이며, 그 이후가 개별 프로바이더입니다.

메뉴 상단의 탭. 아이콘 아래의 선이 해당 프로바이더의 잔량

각 아이콘 아래에 그어져 있는 선이 해당 프로바이더의 잔량입니다. 탭을 열지 않아도 어떤 것이 줄어들고 있는지 알 수 있습니다.

표시되는 정보

프로바이더별 패널은 다음과 같이 표시됩니다. 표시되는 틀은 해당 프로바이더가 공개하고 있는 단위를 따릅니다.

Codex (Pro 5x)

Claude (Max 5x)

잔량과 리셋까지 남은 시간

틀마다 「남은 ◯%」와 「◯d ◯h 후에 리셋」이 나란히 표시됩니다. 틀의 종류는 해당 프로바이더가 공개하고 있는 단위를 따릅니다.

표시되는 것은 다음 리셋까지 남은 시간이며, 1시간 미만이 되면 분 단위로 바뀝니다. Claude의 세션 틀은 5시간 주기이므로, 스크린샷의 「18m 후에 리셋」은 5시간 중 4시간 42분이 경과한 상태입니다.

Fable only는 Max 플랜에서 사용할 수 있는 최상위 모델 Fable을 위한 틀입니다. 현재는 Max 플랜 한도의 절반까지라는 형태로 제공되고 있으며, CodexBar는 이를 독립된 틀로 취급합니다. 플랜이나 모델의 제공 형태가 바뀌더라도, 프로바이더 측의 틀이 그대로 항목으로 나열됩니다.

소비 페이스

잔량 아래에는 「◯% 여유」, 「리셋까지 지속 가능」이 표시됩니다. 이는 현재 페이스로 계속 사용했을 때 리셋까지 잔량이 유지될지 여부를 판단하는 것입니다.

잔량이 같더라도 소비 페이스에 따라 판단이 달라집니다. 긴 태스크 (Task)를 던지기 전에, 한도에 도달하기 전에 끝날 수 있을지 가늠할 수 있습니다.

CodexBar로 무엇이 바뀌는가

확인처가 한 곳이 됩니다. 프로바이더별 대시보드 (Dashboard)를 일일이 열어보지 않아도, 메뉴바에 모든 잔량이 나열됩니다.

리셋 시각을 전제로 작업을 짤 수 있습니다. 잔량과 리셋까지 남은 시간이 동시에 나오기 때문에, 지금 다 써버릴지 아니면 리셋을 기다릴지를 결정할 수 있습니다.

잔량이 아니라 페이스(Pace)로 판단할 수 있습니다. 「리셋까지 지속 가능 여부」에 대한 판정이 있기 때문에, 잔량 숫자만 보고 판단할 필요가 없습니다.

요약

• CodexBar는 AI 코딩 프로바이더(AI coding provider)의 사용량을 macOS 메뉴바에 집약하는 무료 앱 (MIT 라이선스, macOS 14 이상)
• brew install --cask steipete/tap/codexbar 명령어로 도입. 비밀번호는 저장하지 않고, 로그인된 세션(Session)을 재사용함 - 메뉴바에 표시할 프로바이더는 설정 화면의 토글(Toggle)로 선택. 사용하는 것만 나열할 수 있음
• 잔량, 리셋까지 남은 시간, 소비 페이스가 하나의 메뉴에 나열됨
• 표시되는 단위는 프로바이더가 공개하고 있는 단위를 따름. Codex는 주간(Weekly), Claude는 세션(Session)·주간·모델별 단위

Discussion