AI 구독 계정을 표준 형식의 API로 제공하는 프록시이다

별도의 API 키를 발급받지 않고도 기존 OAuth 구독 계정만으로 표준 API 호출을 수행한다. 이는 API 키 관리와 추가 과금 체계를 부담스러워하는 개발자가 기존 SDK나 코딩 에이전트에서 구독 모델을 즉시 활용하도록 선택지를 넓힌다.

CLIProxyAPI(구독 계정을 API로 변환하는 프록시 도구)는 ChatGPT Codex, Claude Code, Gemini, Grok Build, Antigravity 등의 OAuth 계정을 로컬 프록시에 연결해 표준 형식의 API로 제공한다. 사용자는 별도의 API 키 발급 절차를 건너뛰고 기존 API 클라이언트 환경에서 구독 중인 모델을 그대로 호출한다. 로컬 프록시가 구독 계정의 권한을 API 표준 규격으로 중계하는 구조다.

v6.10.0 버전부터는 본체 내부에 포함됐던 사용량 통계 기능이 제거됐다. 사용량 확인이 필요한 사용자는 SQLite 기반의 CPA Usage Keeper나 CPA-Manager-Plus를 별도로 연결해 통계 기능을 구현한다. 기능 분리를 통해 본체는 프록시 역할에 집중하고 데이터 관리는 외부 모듈이 담당하게 했다.

요청과 응답 형식을 변환하며 다양한 입력 방식과 통신

스트리밍과 일반 응답, WebSocket 처리뿐만 아니라 도구 호출과 텍스트, 이미지 입력까지 지원 범위에 포함한다. OpenAI Responses, Gemini Interactions, Claude Messages 형식으로 들어온 요청을 실제 모델 제공자가 요구하는 규격으로 변환해 전달하고, 응답 역시 클라이언트에 맞게 반환한다. 요청과 응답의 형식을 양방향으로 변환하는 프록시 구조를 통해 서로 다른 모델 제공자의 통신 프로토콜을 하나로 통합한다. 입력 방식과 통신 규격의 차이를 중간 계층에서 해결해 모델 간 전환 비용을 낮춘다.

Gemini, OpenAI, Claude, Grok 계정을 여러 개 등록해 라운드 로빈(요청을 순차적으로 배분하는 방식) 방식으로 요청을 분산한다. 각 제공자가 제공하는 CLI(명령줄 인터페이스) 로그인 과정을 통해 개별 계정을 등록하고 인증을 수행한다. 설정 파일을 활용해 OpenRouter와 같은 OpenAI 호환 외부 API를 추가로 연결하는 구성도 지원한다. 다중 계정 운용과 외부 API 연동으로 단일 계정의 요청 제한을 분산하고 전체적인 처리 용량을 확장한다. 이를 통해 대규모 요청 상황에서도 서비스 중단 없는 통신 경로를 확보한다.

개발자용 SDK 및 관리 API와 일반 사용자용 데스크톱

애플리케이션 내부에 프록시 기능을 직접 통합하려면 Go SDK(Go 언어용 소프트웨어 개발 키트)를 활용한다. 계정과 설정을 제어하는 관리 API를 통해 시스템 운영 권한을 관리한다. 이를 통해 별도의 API 크레딧 구매 없이 기존 구독 계정을 코딩 에이전트나 자체 SDK에 통합하는 경로를 확보한다.

일반 사용자는 EasyCLIProxyAPI(그래픽 기반 프록시 설정 도구)를 통해 환경을 구축한다. 그래픽 설정과 트레이 제어, 원클릭 실행 기능을 제공해 명령어 입력 과정을 생략한다. 자동 업데이트 기능을 통해 최신 상태를 유지한다.

소프트웨어 배포는 MIT 라이선스(수정 및 배포가 자유로운 오픈소스 라이선스)를 따른다. 다만 구독 및 OAuth 계정을 API 형태로 사용하는 것이 각 제공자의 이용 약관과 허용 범위에 부합하는지는 사용자가 직접 확인한다. 도구는 약관 준수 여부를 보장하지 않는다.

MIT 라이선스 기반의 CLIProxyAPI를 도입하되, v6.10.0 이후 통계 기능이 분리되었으므로 CPA Usage Keeper 또는 CPA-Manager-Plus를 별도로 연결한다.