구독형 AI 서비스의 쿼터를 여러 사람이 나눠 쓰게 하는 관문
Claude, OpenAI, Gemini, Grok 같은 구독형 AI 서비스를 개별 계정으로만 쓰던 방식을 바꿔, 여러 사용자가 하나의 계정으로 접속해 비용을 분담하게 만듭니다. 이 플랫폼은 각 사용자에게 전용 API 키를 발급하고, 요청을 적절한 계정으로 전달하며, 사용량을 토큰 단위로 정산합니다. 결과적으로 고가의 구독료를 혼자 부담하지 않고, 팀이나 공동체 안에서 효율적으로 AI 코딩 도구를 활용할 수 있는 구조가 만들어집니다.
구독 쿼터의 분배와 정산
이 시스템의 핵심은 여러 개의 상류 AI 계정을 하나의 관문 뒤에서 관리하는 것입니다. 사용자는 플랫폼이 생성한 API 키를 사용해 Claude Code나 Codex 같은 도구에 접속합니다. 플랫폼은 어떤 계정으로 요청을 보낼지 지능적으로 선택하고, 세션이 유지되도록 관리합니다. 동시에 각 사용자의 토큰 사용량을 정확히 추적해 비용을 계산합니다. 이를 통해 계정 하나당 여러 사용자가 접속해도 혼란 없이 요청이 처리되고, 누가 얼마나 썼는지 명확히 알 수 있습니다.
운영을 위한 관리 도구
웹 기반 관리 대시보드를 통해 계정을 추가하거나 삭제하고, 사용자의 접근 권한을 설정할 수 있습니다. 사용자별 동시 접속 수와 요청 속도 제한을 조정해 특정 사용자가 전체 자원을 독점하지 않도록 막습니다. 내장된 결제 시스템을 통해 EasyPay, Alipay, WeChat Pay, Stripe를 연동해 사용자가 스스로 충전할 수 있게 합니다. 외부 티켓팅 시스템 등을 iframe으로 임베드해 관리 화면을 확장하는 것도 지원합니다.
배포 환경과 요구 사항
서버에 설치하려면 Linux 환경에서 PostgreSQL 15 이상과 Redis 7 이상이 실행 중이어야 합니다. Docker Compose를 사용하면 데이터베이스와 캐시 서버까지 함께 배포할 수 있어 설정이 간편해집니다. macOS의 Apple Silicon 칩을 사용하는 경우 Apple container를 통해 로컬에서 전체 스택을 실행할 수도 있습니다. Nginx를 리버스 프록시로 사용할 때는 헤더에 밑줄이 포함된 값이 삭제되지 않도록 underscores_in_headers on; 설정을 추가해야 세션 유지 기능이 정상 작동합니다.
사용 전 반드시 확인할 리스크
이 프로젝트를 사용하면 Anthropic 등 상류 제공사의 서비스 약관을 위반할 수 있습니다. 계정 정지, 서비스 중단, 데이터 손실 등 발생하는 모든 위험은 사용자가 전적으로 부담해야 합니다. 개발진은 상업적 이용을 승인한 적이 없으며, 기술 학습과 연구 목적으로만 제공된다고 명시합니다. 따라서 이 도구를 도입하기 전에 해당 국가의 법률과 각 AI 서비스의 이용약관을 꼼꼼히 검토해야 합니다. 특히 상업적 목적으로 사용할 경우 법적 분쟁과 손실의 책임은 사용자 본인에게 있습니다.
