sub2api
SHA-256오픈소스 AI API 중계 게이트웨이로, Claude, OpenAI, Gemini, Grok 등 구독을 표준 API로 통합 변환하며, 카풀 공유를 지원하고 비용을 분담합니다.
여러 AI 구독을 함께 공유하고, 통합하여 API로 변환해 도구에서 사용할 수 있게 하면 비용도 절약되고 번거로움도 줄어듭니다.
주요 기능
- 다중 구독 통합 연결: Claude / OpenAI / Gemini / Grok 구독 원클릭 연결, OpenAI 호환 API로 통합 출력
- 카풀 공유 메커니즘: 여러 사용자가 하나의 구독을 공유하고, 할당량에 따라 비용을 분담하여 1인당 비용을 대폭 절감
- 네이티브 도구 호환: Claude Code, Codex, Gemini CLI 등 주요 AI 프로그래밍 도구를 즉시 사용 가능
- 자체 호스팅 배포: Docker 기반 원클릭 배포, 데이터 자율 통제, PostgreSQL + Redis 프로덕션급 아키텍처 지원
- Web 관리 패널: Vue 3 기반 시각화 패널, 구성원 관리, 할당량 배분, 사용량 통계를 한눈에 확인
할 수 없는 것
- •이 프로젝트를 사용하면 Anthropic 등 상위 서비스 제공업체의 서비스 약관을 위반할 수 있으며 계정 차단 위험이 있고, 그로 인한 결과는 사용자가 스스로 감수해야 합니다.
- •기술 학습 및 연구 목적으로만 사용할 수 있으며, 현지 법률 및 규정을 준수해야 하고, 어떠한 형태의 상업적 운영도 금지됩니다.
- •프로젝트 개발자는 어떤 개인이나 단체에 상업적 운영을 허가한 적이 없으며, sub2api 명목의 유료 서비스에 주의하시기 바랍니다.
- •배포 시 반드시 README의 면책 조항을 먼저 자세히 읽고 이해한 후 사용하시기 바랍니다.
사용 사례
- 팀 협업: 팀 내 여러 명이 하나의 Claude 구독을 공유하고, 내부 API 게이트웨이를 통해 통합 사용하며, 비용이 투명하게 사용량별로 배분됩니다
- 개인 개발자: 여러 플랫폼 구독을 하나의 API Key로 통합하고, 다양한 AI 프로그래밍 도구 간에 원활하게 전환할 수 있습니다
상세 설명
Sub2API는 오픈소스 AI API 게이트웨이 플랫폼으로, Claude, OpenAI, Gemini, Grok 등 주요 AI 구독을 하나의 API 엔트리로 통합합니다. 핵심 혁신은 구독 할당량 배분과 카풀 공유 메커니즘으로, 여러 사용자가 하나의 공식 구독을 공유하여 1인당 사용 비용을 대폭 절감합니다. Token 과금과 키 관리에 중점을 둔 One API 등의 전통적인 중계 프로젝트와 달리, Sub2API는 OAuth 구독 연결을 기본 지원하여 팀이 공식 구독을 카풀로 공유하기에 특히 적합합니다. Claude Code, Codex, Gemini CLI 등 주요 코딩 도구와 완벽하게 호환되며, 호스팅 사이트와 Docker 자체 호스팅 두 가지 배포 방식을 제공합니다. 기술 스택은 Go 1.26, Vue 3, PostgreSQL 15+, Redis 7+ 기반으로 바로 사용할 수 있습니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
Docker Compose로 배포: docker-compose.yml을 생성하고 PostgreSQL 및 Redis 연결 정보를 구성합니다.
공식 구독의 OAuth Token 받기: Claude / OpenAI / Gemini 공식 플랫폼에서 로그인 및 인증합니다.
관리 패널에서 구독을 추가하고 공유 할당량을 설정한 후, 자신의 API Key를 생성합니다.
- Docker Compose로 배포: docker-compose.yml을 생성하고 PostgreSQL 및 Redis 연결 정보를 구성합니다.
- 공식 구독의 OAuth Token 받기: Claude / OpenAI / Gemini 공식 플랫폼에서 로그인 및 인증합니다.
- 관리 패널에서 구독을 추가하고 공유 할당량을 설정한 후, 자신의 API Key를 생성합니다.
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
ae6b2e7ae30d784e7d7cbda119bcbc0b70f8e9334570f958bb255dad453adc17이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
Docker 환경에서 docker compose down을 실행하여 컨테이너를 중지하고 제거합니다. 데이터를 완전히 정리해야 하는 경우 docker volume rm을 사용하여 관련 데이터 볼륨을 삭제합니다. 소스 코드 배포의 경우 소스 코드 디렉터리와 해당 PostgreSQL 데이터베이스 및 Redis 데이터를 직접 삭제하면 됩니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.