오픈소스 프로젝트(73): Sub2API - 클로드·OpenAI·Gemini 구독을 API로 변환하는 올인원 릴레이

발행: 2주 전 (2026년 5월 23일 AM 09:37 GMT+9)

8 분 소요

Source: Dev.to

소개

“AI 구독 할당량을 유동적으로 관리하고, 한 푼도 낭비하지 않게 하세요.”
이 글은 “하루에 하나씩 오픈소스 프로젝트” 시리즈의 73번째 글입니다. 오늘은 Sub2API(또는 CRS2)를 살펴봅니다.

Claude Code, GitHub Copilot 같은 네이티브 AI 파워툴이 등장하면서, 많은 개발자들이 Claude Pro, OpenAI Plus 등 여러 AI 구독을 동시에 보유하게 되었습니다. 하지만 이러한 구독은 사용량 제한이나 유휴 할당량이 존재합니다. 흩어져 있는 구독 자원을 어떻게 하나로 모아 비용을 효율적으로 분배할 수 있을까요? Sub2API가 바로 그 해답을 제시합니다.

Sub2API는 단순 포워더가 아니라, 계정 관리, 할당량 분배, 자동 청구, 내장 결제까지 전 과정을 처리하는 풀-스택 API 프록시 플랫폼입니다. 팀 공유, “카풀”(비용 공유) 혹은 개인 멀티 계정 통합에 최적화되어 있습니다.

Sub2API의 핵심 포지셔닝과 해결하는 문제점
지원되는 주요 모델 및 구독 타입
핵심 기능: 멀티 계정 관리, 지능형 스케줄링, 토큰 단위 청구
빠른 배포 방법: 스크립트 설치와 Docker Compose
Sub2API로 나만의 AI API 릴레이 서비스 구축하기

사전 요구 사항

AI 모델 API(OpenAI, Claude, Gemini 등)에 대한 기본 이해
기본적인 Linux 명령줄 사용 경험
Docker 혹은 컨테이너 기반 배포 개념에 대한 친숙함

Sub2API 개요

Sub2API는 Go 언어로 개발된 AI API 게이트웨이 플랫폼으로, 다양한 채널(OAuth 인증 계정, Session Key, 일반 API Key 등)에서 AI 구독을 **“풀링”**하는 것이 핵심 로직입니다.

Sub2API를 사용하면 다음을 할 수 있습니다.

리소스 집계: 여러 Claude Pro 혹은 OpenAI 계정을 연결해 하나의 통합 표준 API로 출력
비용 공유: 사용량 기반 청구가 가능한 “카풀” 메커니즘 제공
무리 없는 통합: 생성된 API가 Claude Code, OpenClaw 등 네이티브 툴과 별도 클라이언트 설정 없이 바로 동작

Maintained by: Wei‑Shaw

생태계

프로젝트는 활발한 커뮤니티 지원을 받고 있으며, 모바일 관리 콘솔(sub2api‑mobile) 등 주변 도구도 제공됩니다.

📄 핵심 레포지토리: Wei-Shaw/sub2api

🛠️ 기술 스택: Go (Gin, Ent), Vue 3, PostgreSQL, Redis

📄 라이선스: LGPL‑3.0

📈 통계: GitHub ★22k+ (역사적 데이터 포함)

Sub2API가 해결하는 “리소스 섬” 문제

Upstream Account Pool (Claude, OpenAI, Gemini)
      ↓ Integration
Sub2API Platform Layer (Auth, Billing, Load Balancing, Session Persistence)
      ↓ Unified Distribution
Downstream Applications (IDE, Chat clients, Scripts)

멀티 계정 관리: 다양한 업스트림 계정 타입 지원 및 세션 지속성 자동 처리
정밀 청구: 토큰 단위 사용량 추적·비용 계산, 사용자 정의 요금 적용 가능
스마트 스케줄링: Sticky Sessions 및 로드밸런싱 지원으로 장기 대화 연속성 보장
내장 결제 시스템: Alipay, WeChat Pay, Stripe 등 네이티브 결제 지원, 사용자가 직접 충전 가능
동시성·속도 제한: 사용자·계정 별 제한 설정으로 리소스 보호
관리 대시보드: 실시간 모니터링·관리용 직관적인 웹 UI 제공

설치 방법

방법 1: 원클릭 스크립트 설치 (권장)

깨끗한 Ubuntu/Debian 환경에 적합합니다.

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

주의 사항

PostgreSQL 15+와 Redis 7+가 사전에 설치돼 있어야 합니다.
스크립트는 바이너리를 /opt/sub2api에 배치하고 systemd 서비스 파일을 생성합니다.

방법 2: Docker Compose 배포

# 배포 디렉터리 생성
mkdir -p sub2api-deploy && cd sub2api-deploy

# 배포 준비 스크립트 다운로드 및 실행
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash

# 서비스 실행
docker compose up -d

설치가 완료되면 http://YOUR_SERVER_IP:8080 에서 관리 대시보드에 접속합니다.

설계 우선순위: “계정 상태 관리”

전통적인 리버스 프록시(Nginx 등)는 애플리케이션 레이어 세션을 이해하지 못합니다. Sub2API는 Sticky Sessions 를 통해 session_id 헤더를 사용해 특정 업스트림 계정에 요청을 고정시켜, 대화가 중간에 끊기지 않도록 합니다.

Note: Nginx를 리버스 프록시로 사용할 경우 underscores_in_headers on; 설정을 활성화해 헤더의 언더스코어를 허용해야 합니다.

풀링 로직

(여기에 다이어그램이나 상세 로직 설명이 들어갑니다.)

통합 생태계

(이미지 혹은 추가 도구 리스트)

기술 스택

Backend: Go – 높은 동시성 처리와 배포 용이성 제공
Database: PostgreSQL – 복잡한 관계와 청구 기록 관리
Cache: Redis – 속도 제한 및 실시간 상태 동기화

🌟 GitHub: Wei-Shaw/sub2api

📖 문서: 레포지토리 내에 배포, 결제 설정, API 사용법에 대한 상세 가이드 제공

🖥️ 데모: httpshttps://demo.sub2api.org/

대상 독자

카풀 리더: Claude/OpenAI Plus 비용을 나누고 싶은 조직자
개발자·파워 유저: 네이티브 CLI 툴을 위해 여러 계정 할당량을 통합하고 싶은 개인
기업 내부 팀: 사내 AI 리소스 사용을 배분·감사해야 하는 팀

핵심 포인트

구독 기반 할당량을 표준 API 서비스로 변환하는 데 특화
관리·스케줄링·청구·결제를 한 번에 처리하는 올인원 솔루션
스크립트·Docker 등 다양한 배포 옵션 제공
Go/PostgreSQL/Redis 기반으로 중대형 배포에 안정적인 성능 보장

Sub2API는 현재 “리소스 집계”와 “상업 모델”을 가장 긴밀히 결합한 오픈소스 솔루션으로, 구독 자유를 실현하는 강력한 도구입니다.

더 유용한 인사이트와 흥미로운 제품은 제 홈페이지에서 확인해 주세요.