nguyenphutrong/quotio

Quotio – macOS용 AI 코드 어시스턴트의 커맨드 센터

무엇인가요 – Swift로 작성된 네이티브 macOS 앱으로, CLIProxyAPI라는 로컬 프록시 서버를 실행하고 제어할 수 있습니다. 이 프록시는 명령줄 AI 코드 도구(Claude Code, Codex CLI, OpenCode 등)에서 오는 요청을 단일 지점으로 라우팅하여 여러 AI 제공자 계정을 관리하고, 토큰 사용량을 모니터링하며, 제공자를 자동으로 전환할 수 있습니다.

왜 중요한가요 – OpenAI Codex, Anthropic Claude 등 여러 AI 기반 코드 생성기를 사용할 때마다 별도의 API 키를 관리하고, 사용 제한을 모니터링하며, 각 CLI 도구를 수동으로 설정해야 합니다. Quotio는 이를 모두 통합합니다:

• 여러 제공자용 OAuth 또는 API 키 자격 증명을 한 곳에서 추가할 수 있습니다.
• 트래픽, 토큰 소비량, 성공률의 실시간 대시보드.
• 제공자의 할당량이 낮아지면 자동 장애 전환(Round-Robin 또는 Fill-First).
• 메뉴바 상태, 알림, Sparkle 기반 자동 업데이트.

주요 기능

• 다중 제공자 지원 – Claude, OpenAI Codex, Qwen, Vertex AI, iFlow, Antigravity, Kiro, GitHub Copilot.
• 독립형 할당량 보기 – 프록시를 시작하지 않고도 사용량을 확인할 수 있습니다.
• 한 번의 클릭으로 에이전트 설정 – 설치된 CLI 에이전트를 감지하고 프록시 설정을 자동으로 작성합니다.
• 실시간 대시보드 – 트래픽, 토큰 사용량, 성공률 그래프.
• 스마트 할당량 관리 – 계정별 시각적 추적, 자동 라우팅 전략.
• API 키 관리자 – 로컬 프록시용 키를 생성하고 저장합니다.
• 메뉴바 통합 및 알림 – 서버 상태와 할당량 부족 알림을 빠르게 확인할 수 있습니다.
• 자동 업데이트 – 내장된 Sparkle 업데이트 기능.
• 다국어 UI – 영어, 베트남어, 간체중국어.

지원되는 생태계

• 제공자 – 위에 나열된 OAuth 또는 서비스 계정 JSON 인증.
• IDE 할당량 모니터링 – Cursor, Trae(읽기 전용 모니터링).
• CLI 에이전트 – Claude Code, Codex CLI, Amp CLI, OpenCode, Factory Droid(프록시 사용하도록 자동 설정).

설치

1. Homebrew(권장)

   brew tap nguyenphutrong/tap
   brew install --cask quotio
   

2. 직접 다운로드 – GitHub Releases 페이지에서 최신 .dmg 파일을 다운로드합니다.
3. 소스에서 빌드 – 리포지토리를 클론하고 Xcode에서 Quotio.xcodeproj를 열어 Quotio 스키마를 실행합니다.
   • 앱은 처음 실행 시 CLIProxyAPI 바이너리를 다운로드합니다.
   • macOS가 서명되지 않은 앱을 차단할 수 있으므로, xattr -cr /Applications/Quotio.app를 실행하여 허용합니다.

기본 워크플로우

1. 서버 시작 – 대시보드에서 Start를 클릭합니다.
2. 계정 추가 – Providers 탭에서 OAuth로 인증하거나 API 키를 붙여넣습니다.
3. 에이전트 구성 – Agents 탭에서 설치된 CLI 도구를 선택하고 Configure를 누릅니다(자동 또는 수동 모드).
4. 모니터링 – Dashboard, Quota, Logs 패널을 사용하여 트래픽, 토큰 사용량, 요청 디버깅을 확인합니다.
5. 설정 조정 – Settings에서 리스닝 포트, 라우팅 전략, 자동 시작 동작, 알림 설정을 변경합니다.

커뮤니티 및 기여

• 도움이나 피드백을 원하시면 README에 있는 링크를 통해 디스코드 서버에 참여하세요.
• 포크하여 기능 브랜치를 만들고, 커밋, 푸시, PR을 열어 기여하세요.

라이선스 – MIT (see LICENSE).

---

Quotio는 여러 AI 코드 생성 서비스에 의존하는 개발자들이 macOS에서 자격 증명, 할당량, 프록시 라우팅을 단일 시각적 인터페이스로 관리할 수 있도록 도와주는 실용적인 도구입니다.