Skip to main content
PromptQuorum
홈/고급 로컬 LLM/AIClient2API 리뷰: 모든 AI 프로토콜을 위한 하나의 로컬 프록시
Overview & Reference

AIClient2API 리뷰: 모든 AI 프로토콜을 위한 하나의 로컬 프록시

·10분 읽기·Hans Kuepper 저 · PromptQuorum 창립자, 멀티 모델 AI 디스패치 도구 · PromptQuorum
언어 선택:
🇺🇸en🇩🇪de🇫🇷fr🇯🇵ja🇨🇳zh🇪🇸es🇧🇷pt🇸🇦ar🇰🇷ko

AIClient2API는 Gemini CLI, Codex, Grok, Kiro, Antigravity의 클라이언트 프로토콜을 하나의 로컬 OpenAI 호환 API로 변환하는 무료 오픈소스 셀프 호스팅 프록시입니다. justlovemaki가 개발했으며 GPL-3.0 라이선스로 배포됩니다. Docker나 Node.js로 실행되며, OpenAI 형식 엔드포인트와 웹 콘솔을 제공하여, OpenAI 호환 클라이언트라면 어떤 것이든 원래는 직접 접근할 수 없었던 제공업체와 통신할 수 있게 해줍니다.

AIClient2API(github.com/justlovemaki/AIClient2API)는 Gemini CLI, Codex, Grok, Kiro, Antigravity의 클라이언트 프로토콜을 하나의 OpenAI 호환 API로 변환해 주는 무료 오픈소스 셀프 호스팅 프록시 서버로, GitHub 스타가 8,700개를 넘습니다. 이 리뷰는 로컬 LLM 소프트웨어 디렉터리에 등록된 AIClient2API 항목의 후속 자료로, 실제로 무엇을 하는지, 어떻게 실행하는지, 어떤 사용자에게 적합한지를 다룹니다.

핵심 요점

  • AIClient2API(github.com/justlovemaki/AIClient2API)는 무료, 오픈소스, 셀프 호스팅 API 프록시입니다 — 호스팅형 서비스가 아닙니다
  • justlovemaki가 개발; 다른 GitHub 계정 아래 거의 동일한 포크가 여러 개 존재하지만, 이 저장소가 스타 수가 가장 많은 원본 버전으로 확인됨
  • 저장소 자체의 라이선스 필드에 따라 GPL-3.0 라이선스 적용
  • Gemini CLI, Codex, Grok, Kiro, Antigravity의 클라이언트 프로토콜을 하나의 OpenAI 호환 API로 변환하며, OpenAI/Claude/Gemini 프로토콜 간 양방향 변환 지원
  • Docker(권장) 또는 Node.js/npm으로 실행; 설정과 상태 모니터링을 위한 웹 콘솔 포함
  • 이 리뷰 작성 시점 기준 GitHub 스타 8,700개 이상, 포크 1,380개 이상이며, 활발히 릴리스 중(v3.5.0은 2026년 9월 출시)

📍 한 문장으로

AIClient2API는 justlovemaki가 개발한 무료 오픈소스(GPL-3.0) 셀프 호스팅 프록시로, GitHub 스타 8,700개 이상을 보유하고 있으며, Gemini CLI, Codex, Grok, Kiro, Antigravity의 클라이언트 프로토콜을 하나의 로컬 OpenAI 호환 API로 변환합니다.

💬 쉽게 말하면

AIClient2API는 자신의 컴퓨터에서 실행하는 작은 서버로, AI 클라이언트 도구와 그 도구들이 통신하는 AI 제공업체 사이에 위치합니다. 다섯 가지 서로 다른 제공업체 프로토콜을 각각 익힐 필요 없이, 모든 요청을 하나의 로컬 주소로 보내면 AIClient2API가 뒤에서 각 제공업체가 실제로 요구하는 형식으로 요청을 변환해 줍니다.

📌참고: 이 리뷰는 해당 프로젝트 자체의 GitHub 저장소, README, 릴리스 히스토리를 바탕으로 작성되었습니다. PromptQuorum이 AIClient2API의 프록시 동작에 대해 직접 부하 테스트나 보안 감사를 수행했다는 의미는 아닙니다.

AIClient2API란 무엇인가?

AIClient2API는 여러 AI 제공업체와 CLI 도구의 클라이언트 프로토콜을 하나의 로컬 OpenAI 호환 API로 통합하는 무료 오픈소스 셀프 호스팅 프록시 서버입니다. GitHub 사용자 justlovemaki가 개발했으며 GPL-3.0 라이선스로 배포됩니다.

  • 제품 유형: 셀프 호스팅 프록시/게이트웨이 서버이며, 채팅 앱, IDE 플러그인, 호스팅형 SaaS 제품이 아님
  • 개발자: justlovemaki(GitHub 계정명); github.com/justlovemaki/AIClient2API 저장소는 다른 계정 아래 존재하는 거의 동일한 여러 포크 중 스타 수가 가장 많은 원본 버전으로 확인됨
  • 라이선스: GPL-3.0, 카피레프트 라이선스 — 수정된 버전을 배포하려면 일반적으로 동일한 라이선스로 소스를 공개해야 함
  • GitHub 메타데이터에 따르면 저장소는 2025년 7월 20일에 생성됨
  • 규모: 이 리뷰 작성 시점 기준 GitHub 스타 8,700개 이상, 포크 1,380개 이상, 미해결 이슈 약 5개 — 포크 수 대비 미해결 이슈가 적어 적극적으로 유지관리되고 있음을 시사함

AIClient2API의 버전 히스토리는 어떻게 되는가?

AIClient2API는 2026년 내내 잦은 점진적 릴리스를 발표했으며, 이 리뷰 시점의 최신 태그 버전인 v3.5.0은 2026년 9월에 공개되었습니다.

  • v3.5.0(2026년 9월): 이 리뷰 시점의 최신 태그 릴리스
  • v3.4.9.1 및 v3.4.8(2026년 9월): v3.5.0 이전 며칠간 나온 점진적 패치 릴리스
  • v3.0.0(2026년 5월): 프로젝트 자체 릴리스 노트에 따르면, 자동화된 스킬 가이드와 원격 API 도움말 엔드포인트를 포함한 더 깊은 AI 지원 통합이 추가됨
  • 2026년 4월: 프로젝트 자체 체인지로그에 따르면, 프로토콜 변환을 포함한 완전한 OpenAI 이미지 생성 및 편집 API 지원이 추가됨
  • 2026년 3월: 프로젝트 자체 체인지로그에 따르면, 멀티모달 입력 및 이미지/동영상 생성을 포함한 Grok 프로토콜 지원이 추가됨

AIClient2API는 실제로 무엇을 하는가?

AIClient2API는 표준 OpenAI 형식 API 요청을 받아, 대상 제공업체가 실제로 필요로 하는 프로토콜로 변환한 뒤 응답을 다시 원래 형식으로 변환해 주는 로컬 서버로 동작합니다.

  • 프로토콜 변환: 프로젝트가 전략(strategy) 및 어댑터 디자인 패턴이라고 설명하는 방식을 사용하여 OpenAI, Claude, Gemini API 형식 간 양방향 변환을 수행
  • 지원 제공업체/프로토콜: 프로젝트 자체 문서에 따르면 Gemini, Claude(Kiro 또는 Antigravity 클라이언트 프로토콜을 통해 접근 가능), Grok(쿠키 또는 CLI OAuth를 통해), Codex, Kimi, MiniMax, OpenAI, 그리고 사용자 지정 OpenAI 호환 엔드포인트
  • 계정 풀 관리: 제공업체별로 여러 계정을 순환 사용하며, 자동 장애 조치와 상태 확인 지원
  • OAuth 통합: Antigravity, Codex, Grok CLI, Kiro를 위한 내장 OAuth 흐름
  • 로드 밸런싱: HTTP 429 속도 제한 오류 발생 시 쿨다운을 두고 제공업체를 선택하며, 제공업체 간 대체(fallback) 체인 지원
  • TLS 사이드카: Go로 작성된 별도의 프록시 컴포넌트로, 프로젝트에 따르면 JA3 TLS 핑거프린트를 시뮬레이션하여 일부 제공업체 엔드포인트의 Cloudflare 또는 403류 차단을 우회하는 용도
  • 웹 콘솔: localhost:3000에서 제공되는 브라우저 기반 UI로 실시간 설정, 상태 모니터링, API 테스트 가능
  • 로깅: 요청/응답을 완전히 기록하며, 프로젝트는 이를 감사나 학습 데이터셋 구축에 유용하다고 설명함

어떻게 설정하고 실행하는가?

AIClient2API는 JSON 설정 파일(또는 웹 콘솔)을 통해 구성되며, 들어오는 요청을 하나 이상의 백엔드 제공업체 계정에 매핑한 뒤 장기 실행되는 로컬 서버 프로세스로 동작합니다.

  • Docker로 시작(권장): 이미지를 받아오고, 로컬 configs 폴더를 마운트한 뒤 프록시의 포트를 노출
  • Node.js로 시작: 저장소를 클론하고, 함께 제공되는 설치 스크립트를 실행한 뒤 npm start 실행
  • 마운트된 configs 디렉터리에서, 또는 http://localhost:3000의 웹 콘솔을 통해 제공업체 자격 증명과 계정 풀 구성
  • 채팅 앱, 코딩 CLI, 사용자 지정 스크립트 등 OpenAI 호환 클라이언트를 제공업체 자체 API 엔드포인트 대신 로컬 프록시 주소로 연결
  • 웹 콘솔을 통해 계정 상태, 속도 제한 쿨다운, 요청 로그를 실시간으로 모니터링
bash
docker run -d -p 3000:3000 -p 8086:8086 -p 1455:1455 -p 56121:56121 \
  -v "your_path/configs:/app/configs" \
  justlikemaki/aiclient-2-api

플랫폼, 가격, 라이선스

플랫폼

AIClient2API의 설명:
Docker 또는 Node.js를 통해 Mac, Windows, Linux 등 여러 플랫폼에서 동작하는 셀프 호스팅 서버 — 클라우드 호스팅 버전은 없음.

비용

AIClient2API의 설명:
무료이며 오픈소스. 연결하는 제공업체 계정이나 API 키에 대해서는 여전히 비용을 지불할 수 있음; 프록시 자체는 무료.

라이선스

AIClient2API의 설명:
저장소의 라이선스 필드에 따라 GPL-3.0.

설치 방법

AIClient2API의 설명:
Docker(권장, 단일 docker run 명령) 또는 함께 제공되는 설치 스크립트와 npm start를 이용한 Node.js.

두 명령 중 하나를 실행하기 전에 github.com/justlovemaki/AIClient2API에서 현재 권장되는 설치 방법과 포트 목록을 확인하십시오.

AIClient2API 비용은 얼마입니까?

AIClient2API 자체는 무료입니다 — 라이선스 비용, 구독료, 사용량 기반 요금이 전혀 없습니다. 실제 비용은 전적으로 어떤 제공업체 계정이나 API 키를 연결하는지에 달려 있습니다.

  • 프록시 소프트웨어: 무료, GPL-3.0 오픈소스, 유료 등급 없음
  • 제공업체 비용: 연결하는 기존 계정이나 API 키가 이미 부과하는 비용(유료 OpenAI/Claude/Gemini API 키, 또는 Codex나 Kiro 같은 CLI 도구에 연결된 구독)
  • 셀프 호스팅 비용: 자신의 컴퓨팅 자원뿐 — 경량 Node.js 프록시이므로 작은 VPS에서도 대개 무시할 수 있는 수준

AIClient2API vs. LiteLLM: 차이점은 무엇인가?

AIClient2API와 LiteLLM은 모두 하나의 API 형식으로 여러 제공업체에 접근할 수 있게 해주지만, 서로 다른 문제를 해결합니다: LiteLLM은 표준 상용 API를 위한 프로덕션급 멀티 프로바이더 라우팅에 초점을 맞추는 반면, AIClient2API는 CLI 구독 및 브라우저 OAuth 기반 AI 도구를 OpenAI 호환 형식으로 연결하는 데 초점을 맞춥니다.

주요 목표

AIClient2API:
CLI/OAuth 기반 AI 도구(Gemini CLI, Codex, Kiro, Antigravity)를 하나의 API로 연결
LiteLLM:
OpenAI 호환 인터페이스 아래 100개 이상의 표준 제공업체 API 통합

라이선스

AIClient2API:
GPL-3.0(카피레프트)
LiteLLM:
MIT(허용적)

주요 사용자

AIClient2API:
표준 API를 통해 CLI 도구 구독을 재활용하려는 개발자
LiteLLM:
여러 벤더에 걸쳐 프로덕션 LLM 트래픽을 표준화하려는 팀

추가 기능

AIClient2API:
TLS 핑거프린트 사이드카, 특정 CLI 도구용 OAuth 흐름
LiteLLM:
예산 관리, 지출 추적, 가상 키, 폭넓은 생태계 통합

이 두 도구는 겹치지만 서로 다른 문제를 해결합니다 — 일부 팀은 표준 제공업체 API에는 LiteLLM을, CLI 구독 기반 제공업체에는 AIClient2API를 사용하는 식으로 둘 다 함께 운용합니다.

누구에게 AIClient2API가 적합한가?

AIClient2API는 이미 여러 클라이언트 도구를 통해 여러 AI 제공업체에 접근하고 있으며, 일관되고 로컬에서 동작하는 OpenAI 호환 엔드포인트 하나를 기반으로 개발하고자 하는 개발자에게 적합합니다.

AIClient2API가 적합하지 않은 경우

완전 관리형 게이트웨이, 엔터프라이즈 지출 통제가 필요하거나 CLI 프로토콜 연동에 따른 이용약관상의 모호함을 피하고 싶다면 AIClient2API는 적합하지 않습니다.

  • 관리형 또는 호스팅 서비스가 아님 — 자신의 인스턴스를 운영, 업데이트, 보안 유지하는 책임은 사용자 본인에게 있음
  • 공식적으로 라이선스가 부여된 표준 제공업체 API를 중심으로 설계되지 않음 — 여러 통합 기능이 서드파티 프록시용으로 설계되지 않은 CLI 도구나 OAuth 프로토콜을 통해 이루어지며, 이는 특정 제공업체의 이용약관과 충돌할 수 있음
  • 전용 LLM 게이트웨이처럼 엔터프라이즈 거버넌스 기능(팀별 예산, 지출 대시보드, SSO)에 초점을 맞추지 않음
  • 이 리뷰에서 확인할 수 있는 범위 내에서는 독립적인 보안 감사를 받지 않았음 — API 자격 증명을 다루는 다른 셀프 호스팅 프록시와 마찬가지로 취급하고, 자신의 컴퓨터 밖으로 노출하기 전에 계정 풀 및 로깅 설정을 검토할 것
  • 이 리뷰가 확인할 수 있는 범위 내에서는 회사나 투자 라운드의 지원을 받지 않음 — 독립적으로 유지관리되는 커뮤니티 기반 프로젝트로 취급할 것

AIClient2API 평가 시 흔한 오해

AIClient2API에 대한 혼란의 대부분은 수많은 포크와 혼동하거나, 표준 멀티 프로바이더 게이트웨이처럼 동작한다고 가정하는 데서 비롯됩니다.

경쟁 제품 및 대안

AIClient2API는 LiteLLM과 가장 직접적으로 비교되며, 프로토콜 연동 프록시가 필요한지 아니면 추론 서버 자체가 필요한지에 따라 vLLM, SGLang, LocalAI 같이 AIClient2API가 앞단에 설 수 있는 OpenAI 호환 서버들과도 비교해 볼 가치가 있습니다.

LiteLLM

주요 특징:
예산 관리와 지출 추적 기능을 갖춘, 100개 이상의 표준 제공업체 API를 통합하는 MIT 라이선스 프록시
링크:
LiteLLM 리뷰

vLLM

주요 특징:
고처리량의 OpenAI 호환 로컬 추론 서버/엔진
링크:
vLLM 설명
vLLM 관련 문서 (10개)

표시되지 않은 81개 더보기

SGLang

주요 특징:
구조화된 생성 최적화를 갖춘 OpenAI 호환 추론 엔진
링크:
SGLang 설명
SGLang 관련 문서 (5개)

기타 언급:

LocalAI

주요 특징:
오픈 웨이트 모델을 위한 셀프 호스팅, OpenAI 호환 로컬 추론 서버
링크:
LocalAI 설명
LocalAI 관련 문서 (8개)

기타 언급:

표시되지 않은 5개 더보기

이 목록은 AIClient2API와 함께 흔히 비교되는 도구들을 반영한 것이며, PromptQuorum의 독자적인 순위가 아닙니다 — 선택하기 전에 각 도구의 현재 기능 구성을 확인하십시오.

자주 묻는 질문

AIClient2API란 무엇입니까?

AIClient2API(github.com/justlovemaki/AIClient2API)는 Gemini CLI, Codex, Grok, Kiro, Antigravity의 클라이언트 프로토콜을 하나의 OpenAI 호환 API로 변환하는 무료 오픈소스(GPL-3.0) 셀프 호스팅 프록시입니다.

AIClient2API는 무료입니까?

예, AIClient2API 자체는 GPL-3.0 라이선스로 무료이며 오픈소스입니다. 다만 연결하는 기존 제공업체 계정이나 API 키에 대해서는 비용이 발생할 수 있습니다.

AIClient2API는 어떻게 설치합니까?

프로젝트 자체 README는 Docker 사용을 권장합니다: docker run -d -p 3000:3000 -p 8086:8086 -p 1455:1455 -p 56121:56121 -v "your_path/configs:/app/configs" justlikemaki/aiclient-2-api를 실행하십시오. Node.js 설치 스크립트도 제공됩니다. 먼저 GitHub 저장소에서 최신 안내를 확인하십시오.

AIClient2API는 어떤 AI 제공업체를 지원합니까?

프로젝트 자체 문서에 따르면 Gemini, Claude(Kiro 또는 Antigravity 경유), Grok, Codex, Kimi, MiniMax, OpenAI, 그리고 사용자 지정 OpenAI 호환 엔드포인트를 지원합니다.

AIClient2API는 누가 만들었습니까?

AIClient2API는 GitHub 사용자 justlovemaki가 개발했습니다. 다른 계정 아래 거의 동일한 포크가 여러 개 존재하지만, 이 저장소가 스타 수가 가장 많은 원본 버전으로 확인됩니다.

AIClient2API는 LiteLLM과 같은 것입니까?

아닙니다. 둘 다 여러 제공업체를 하나의 OpenAI 호환 API 아래 통합하지만, LiteLLM(MIT 라이선스)은 예산 관리 같은 프로덕션 기능을 갖춘 표준 상용 제공업체 API에 초점을 맞추는 반면, AIClient2API(GPL-3.0)는 CLI 도구 및 OAuth 기반 AI 구독을 연결하는 데 초점을 맞춥니다.

AIClient2API는 GPU가 필요합니까?

아니요. AIClient2API는 경량 Node.js 프로토콜 변환 프록시이며 추론 엔진이 아닙니다 — 모델을 직접 실행하지 않으므로 GPU 요구 사항이 없습니다.

AIClient2API의 CLI 프로토콜 통합을 통해 트래픽을 라우팅하는 것이 안전합니까?

여러 통합 기능이 서드파티 프록시용으로 공식 설계되지 않은 CLI 도구나 브라우저 OAuth 프로토콜을 통해 이루어지며, 이는 특정 제공업체의 이용약관과 충돌할 수 있습니다. 프로덕션 트래픽에 사용하기 전에 각 제공업체 자체의 약관을 검토하십시오.

AIClient2API는 제공업체별로 여러 계정을 지원합니까?

예, 프로젝트 문서에 따르면 동일 제공업체의 여러 계정 간 순환 사용, 자동 장애 조치, 상태 확인을 포함한 계정 풀 관리를 지원합니다.

PromptQuorum은 AIClient2API의 주장을 독립적으로 테스트했습니까?

이 리뷰는 해당 프로젝트 자체의 GitHub 저장소, README, 릴리스 히스토리를 바탕으로 작성되었으며, PromptQuorum이 직접 수행한 부하 테스트나 보안 감사에 기반한 것이 아닙니다.

출처

← 고급 로컬 LLM으로 돌아가기