CodexBar 🎚️ — 토큰이 고갈되지 않기를.

모든 AI 코딩 한도를 메뉴 바에 담았습니다.

Latest release

AUR

macOS 14+용 작은 메뉴 바 앱으로, AI 코딩 제공업체의 사용량 제한을 표시하고 각 창이 언제 초기화되는지 보여줍니다. 아래 지원되는 제공업체를 확인하세요. 제공업체별로 상태 항목을 표시하거나, 제공업체 전환기(provider switcher)가 있는 Merge Icons 모드를 사용할 수 있습니다. Dock 아이콘은 없으며, 미니멀한 UI와 동적 바 아이콘이 특징입니다.

또한 Linux 데스크톱 앱으로도 이용 가능하며, 사용량 및 지출 창, 별도의 설정, 데스크톱 알림, 선택적 트레이 아이콘 기능을 제공합니다. Omarchy에서는 네이티브 바 위젯이 데스크톱 앱의 데이터를 공유하고 테마를 따릅니다.

왜 필요한가 (Why)

초기화를 고려하세요. 제공업체별 세션, 주간 및 월간 창을 가지며 다음 초기일까지 카운트다운을 표시하여, 긴 작업을 시작할지 말지 추측하는 것을 막아줍니다.
크레딧, 지출, 비용 스캔. 크레딧 잔액, Admin API 사용량 대시보드, 제공업체 청구 요약, 그리고 출처가 충분한 세부 정보를 노출하는 로컬 비용 스캔 기능을 제공합니다.
실시간 상태. 제공업체 상태 폴링(Provider status polling)을 통해 메뉴에 장애 배지(incident badges)를 표시하고 바 아이콘 위에 지표 오버레이(indicator overlay)를 추가합니다.
개인 정보 보호 우선 (Privacy-first). OAuth, 디바이스 플로우(device flow), API 키, 브라우저 쿠키, 로컬 파일 등 기존 제공업체 세션을 재사용하므로 비밀번호가 저장되지 않습니다.

설치 (Install)

macOS 앱

macOS 14 이상(Sonoma)이 필요합니다. GitHub Releases에서 다운로드하거나 Homebrew를 통해 설치할 수 있습니다:

brew install --cask codexbar

Linux 데스크톱 및 Omarchy

Qt 6 데스크톱 앱은 Wayland와 X11을 지원하며, 선택적으로 Omarchy 위젯을 사용할 수 있습니다.
출시된 데스크톱 아카이브는 x86_64 및 ARM64를 대상으로 하며 glibc 2.39+, Qt 6.4+가 필요하고 별도로 설치된 CodexBar CLI가 요구됩니다. Python 3은 사용자별 설치 프로그램(per-user installer)을 실행합니다.

Arch/Omarchy, Fedora, Debian/Ubuntu 런타임 패키지, 검증된 릴리스 다운로드 및 업그레이드에 대해서는 Linux 설치 가이드를 따르십시오. 이 프로그램은 CLI의 리소스 번들을 실행 파일 옆에 보관하고 런처와 선택적 로그인 시작 기능을 설치합니다. 설정(Settings)을 열어 제공업체(providers)를 선택한 다음, 해당 제공업체의 CLI를 통해 인증하거나 API 키를 구성하십시오. GNOME에서는 트레이 확장 기능(tray extension)이 필요할 수 있으며, 앱의 창은 트레이 없이도 작동합니다.

지원되는 기능과 남아 있는 격차에 대해서는 macOS 기능 비교를 참조하십시오.

CLI Tarballs (macOS/Linux)

Homebrew 공식(오늘날 Linux):

brew install steipete/tap/codexbar

Arch Linux AUR 패키지:

yay -S codexbar-cli

또는 GitHub Releases에서 릴리스 tarball을 다운로드하십시오:

macOS: CodexBarCLI-v<tag>-macos-arm64.tar.gz, CodexBarCLI-v<tag>-macos-x86_64.tar.gz
Linux (glibc): CodexBarCLI-v<tag>-linux-aarch64.tar.gz, CodexBarCLI-v<tag>-linux-x86_64.tar.gz
Linux (static musl): CodexBarCLI-v<tag>-linux-musl-aarch64.tar.gz, CodexBarCLI-v<tag>-linux-musl-x86_64.tar.gz

macOS 최초 실행

설정(Settings) → 제공업체(Providers)로 이동하여 사용하는 기능을 활성화합니다.
의존하는 제공업체의 소스(provider sources): CLI, 브라우저 세션, OAuth/장치 흐름(device flow), API 키, 로컬 앱 파일 또는 제공업체 앱에 대해 설치/로그인합니다. (제공업체에 따라 다름)
선택 사항: 설정(Settings) → 제공업체(Providers) → Codex → OpenAI 쿠키(자동 또는 수동)를 추가하여 대시보드 추가 기능을 활성화합니다.

CLI에서 API 키 설정하기

Provider 토글 및 API 키는 해결된 CodexBar 설정 파일에 저장됩니다. 새 설치의 경우 ~/.config/codexbar/config.json을 사용하며, 기존의 ~/.codexbar/config.json 설치본은 레거시 경로에서 여전히 로드됩니다. Settings → Providers에서 사용하는 것과 동일한 provider 목록을 스크립트로 사용할 수 있습니다:

codexbar config providers
codexbar config enable --provider grok
codexbar config disable --provider cursor

API 키를 사용하는 Provider의 경우, Settings를 열지 않고도 키를 저장할 수 있습니다:

printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin

set-api-key는 파이프된 값을 자르고, 제한적인 설정 파일 권한으로 저장하며, 기본적으로 Provider를 활성화합니다. 키만 저장하려면 --no-enable을 사용하거나, 셸 히스토리가 문제가 되지 않는 일회성 로컬 스크립트의 경우 --api-key <키>를 사용하십시오.
전체 흐름은 CLI 설정을 참조하세요.

Provider 목록

Codex — OAuth API 또는 로컬 Codex CLI, 그리고 선택적 OpenAI 웹 대시보드 추가 기능.
OpenAI — 레거시 크레딧 잔액 폴백을 갖춘 관리자 API 키 사용량/비용 그래프.
Azure OpenAI — API 키, 엔드포인트 및 배포 유효성 검사 프로브.
Claude — OAuth API, 브라우저 쿠키 또는 CLI PTY 폴백; 사용 가능한 경우 세션 및 주간 사용량.
ClinePass — 5시간, 주간 및 월별 구독 제한을 위한 API 키.
Cursor — 플랜 + 사용량 + 청구서 초기화를 위한 브라우저 세션 쿠키.
OpenCode — 워크스페이스 구독 사용량을 위한 브라우저 쿠키.
OpenCode Go — 사용량 API, 브라우저 폴백 및 로컬 SQLite 비용 기록.
Alibaba Coding Plan — 코딩 플랜 할당량을 위한 웹 쿠키 또는 API 키.
Alibaba Token Plan — 토큰 플랜 크레딧을 위한 Bailian 브라우저/수동 쿠키.
Qwen Cloud: 브라우저/수동 쿠키를 통한 5시간 및 주간 개별 토큰 플랜 사용.
Gemini: Gemini CLI 자격 증명을 사용하는 OAuth 기반 할당량 API (브라우저 쿠키 없음).
Antigravity: 로컬 언어 서버 프로빙, agy CLI HTTPS 소스 및 Google OAuth 폴백(실험적).
Droid: Factory 사용 + 청구에 대한 브라우저 쿠키 + WorkOS 토큰 플로우.
Copilot: GitHub 장치 흐름 + Copilot 내부 사용 API.
Devin: 일일 및 주간 할당량을 위한 Chrome localStorage 세션 또는 수동 Bearer 토큰.
z.ai: 개인/팀 할당량, MCP, 5시간 및 시간별 사용을 위한 API 토큰.
Manus: 크레딧 잔액, 월간 크레딧 및 일일 새로고침 추적을 위한 브라우저 session_id 인증.
MiniMax: 코딩 플랜 사용을 위한 API 토큰, 쿠키 헤더 또는 브라우저 쿠키.
T3 Chat: Base 및 초과 사용 버킷에 대한 브라우저 쿠키 캡처.
ZoomMate: 크레딧 사용을 위한 Chrome 쿠키 자동 가져오기 또는 수동 cURL 캡처.
Kimi: 주간 할당량 + 5시간 제한 속도에 대한 인증 토큰 (kmi-auth 쿠키의 JWT).
Kilo: Kilo Pass 사용을 위한 CLI 인증 폴백이 있는 API 토큰.
Kiro: CLI 기반 사용; 월간 크레딧 + 보너스 크레딧.
Vertex AI: 로컬 Claude 로그에서 토큰 비용 추적을 하는 Google Cloud gcloud OAuth.
Augment: 크레딧 추적 및 사용 모니터링을 위한 Augment CLI 또는 브라우저 쿠키.
Amp: Amp Free 사용 추적을 위한 브라우저 쿠키 기반 인증.
Ollama: Ollama Cloud 사용 기간에 대한 API 키 액세스 및 브라우저 쿠키.
llmman: 선택적 API 키와 함께 로드된 모델이 사용하는 로컬 데몬 메모리.
Synthetic — 5시간 단위, 주간 토큰 및 검색별 시간 사용량을 위한 API 키 할당량(quota) 엔드포인트.
JetBrains AI — JetBrains IDE 설정에서 가져온 로컬 XML 기반 할당량; 월별 크레딧 추적.
Warp — GraphQL 요청 제한 및 월별 크레딧을 위한 API 토큰.
ElevenLabs — 캐릭터 크레딧 및 음성 슬롯 사용량을 위한 API 키.
OpenRouter — 여러 AI 제공업체에 걸친 크레딧 기반 사용량 추적을 위한 API 토큰.
Windsurf — 플랜 사용을 위한 브라우저 localStorage 세션 가져오기 또는 로컬 SQLite 캐시.
Zed — 플랜, 편집 예측 할당량(edit-prediction quota), 청구 주기 및 연체된 인보이스를 위한 Zed 에디터 Keychain 세션.
Perplexity — Perplexity 사용 데이터에서 가져온 계정 사용 크레딧.
Xiaomi MiMo — 잔액 및 토큰-플랜 사용을 위한 브라우저 쿠키.
Doubao — Volcengine Ark 요청 제한 탐지(probe)를 위한 API 키.
Sakana AI — 5시간 및 주간 할당량 기간을 위한 수동 쿠키 헤더.
Abacus AI — ChatLLM/RouteLLM 컴퓨팅 크레딧 추적을 위한 브라우저 쿠키 인증(auth).
Mistral — API 지출, 크레딧 잔액 및 월별 플랜 사용을 위한 브라우저 쿠키.
DeepSeek — 크레딧 잔액 추적(지불된 금액 대 부여된 금액 상세 내역)을 위한 API 키.
Fireworks — 청구 요약 API를 통한 30일간의 지출을 위한 API 키 + 계정 슬러그.
Charm Hyper — Chrome/수동 세션을 사용하고 API 키 폴백(fallback) 기능을 활용하는 네이티브 Hypercredit 잔액을 위한 통합 플러그인.
DeepInfra — 선불 잔액, 현재 월 지출 및 지출 한도 추적을 위한 API 키.
Moonshot / Kimi API — Moonshot/Kimi API 계정 잔액 추적을 위한 API 키.
Venice — DIEM 또는 USD 잔액 추적을 위한 API 키.
Codebuff — 크레딧 잔액 및 주간 사용량 제한을 위한 API 토큰 (또는 ~/.config/manicode/credentials.json).
Command Code — 월별 USD 크레딧 및 누적 사용량 제한을 위한 API 키 또는 브라우저/수동 쿠키.
Qoder — Qoder 대형 모델(big model) 크레딧 사용을 위한 브라우저 또는 수동 쿠키.
StepFun — Step Plan 사용량 제한 (5시간 + 주간 주기) 및 구독 플랜 이름을 위한 사용자 이름 + 비밀번호 로그인.
AWS Bedrock — Cost Explorer 지출, 월별 예산, 선택적 CloudWatch Claude 활동을 위한 AWS 액세스 키 또는 명명된 AWS 프로필 (AWS CLI를 통한 SSO/assume-role).
Grok — Grok CLI 청구 RPC 및 grok.com 브라우저 세션 대체(fallback).
Groq — 콘솔 지출 및 사용량을 위한 브라우저 세션, 엔터프라이즈 Prometheus API 키 대체(fallback) 포함.
LLM Proxy — 집계 프록시 할당량 통계 및 제공업체별 분류를 위한 API 키 + 기본 URL.
ClawRouter — 월별 예산, 지출, 요청 수, 토큰 수 및 라우팅된 제공업체 사용량을 위한 API 키.
sub2api — 자체 호스팅 게이트웨이 키 할당량, 구독 제한, 지갑 잔액 및 키별 사용량.
Wayfinder — 상태 확인(health), 경로별 분류, 절감액, 결정 지연 시간을 위한 로컬 라우터 게이트웨이 폴링.
LiteLLM — 개인 및 팀 예산/지출 추적을 위한 가상 키 + 프록시 URL.
Bifrost — 예산, 사용량 제한 및 모델 지출을 위한 가상 키 + 자체 호스팅 게이트웨이 URL.
Aixy — 키 범위별 지출, 토큰 및 적용 가능한 개인/공유 예산을 위한 API 키.
Deepgram — 음성(speech), 에이전트(agent), 토큰 및 TTS 측정 항목 전반에 걸친 API 키 사용 요약.
Poe — 현재 포인트 잔액 및 최근 포인트 기록을 위한 API 키.
Chutes — 구독 사용량, 누적 및 월별 할당량 주기, 그리고 종량제(pay-as-you-go) 할당량을 위한 API 키.
Neuralwatt — 구독 kWh 사용량 및 선불 크레딧 잔액을 위한 API 키.
Helmcode — 모델별 할당량 및 클라우드 선불 잔액을 위한 Cloud 및 NaN Builders 대시보드 세션.
ZenMux — 5시간 및 7일 단위의 할당량을 관리하는 API 키.

CodexBar: 메뉴 바에서 모든 AI 코딩 제한을 관리

요약

핵심 포인트