원문 보기
GitHub - router-for-me/CLIProxyAPI: Wrap Gemini CLI, Antigravity, ChatGPT Codex, Claude Code, Qwen Code, iFlow as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini 2.5 Pro, GPT 5, Claude, Qwen model through API
Service

GitHub - router-for-me/CLIProxyAPI: Wrap Gemini CLI, Antigravity, ChatGPT Codex, Claude Code, Qwen Code, iFlow as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini 2.5 Pro, GPT 5, Claude, Qwen model through API

router-for-me
2026.01.28
·GitHub·by 성산/부산/잡부
#API#Proxy#LLM#Gemini#OpenAI

핵심 포인트

  • 1CLIProxyAPI는 OpenAI/Gemini/Claude/Codex 호환 API 인터페이스를 제공하는 프록시 서버로, Gemini, OpenAI Codex, Claude Code, Qwen Code, iFlow와 같은 다양한 CLI 모델을 API 키 없이 OAuth 방식으로 사용할 수 있게 합니다.
  • 2이 프로젝트는 다중 계정 로드 밸런싱, 스트리밍, 함수 호출, 멀티모달 입력 등을 지원하며, Amp CLI 및 다양한 IDE 확장 프로그램과 연동하여 AI 코딩 도구 사용을 용이하게 합니다.
  • 3CLIProxyAPI를 기반으로 vibeproxy, ProxyPal, CodMate 등 다수의 파생 프로젝트들이 개발되어, 사용자들이 API 키 없이 AI 모델에 접근하고 관리하는 데 기여하는 생태계를 형성하고 있습니다.

CLIProxyAPI는 CLI 도구를 위한 OpenAI, Gemini, Claude, Codex 호환 API 인터페이스를 제공하는 프록시 서버입니다. 이 프로젝트의 핵심 목표는 사용자가 개인적인 OAuth 구독을 활용하여 다양한 대규모 언어 모델(LLM)에 접근할 수 있도록 하며, 전통적인 API 키 관리의 필요성을 줄이는 것입니다. 특히, OpenAI Codex (GPT 모델), Claude Code, Qwen Code, iFlow 와 같은 특정 모델에 대한 OAuth 로그인 지원을 강조합니다.

핵심 방법론 및 기술적 세부사항:

  1. API 호환성 및 프록싱 (API Compatibility & Proxying):
CLIProxyAPI는 미들웨어(middleware) 역할을 수행하여, 들어오는 요청을 OpenAI 또는 Gemini와 같은 표준화된 API 포맷으로 변환하고 실제 LLM 제공자에게 전달합니다. 이를 통해 기존의 OpenAI 호환 클라이언트나 SDK가 별도의 수정 없이 다양한 LLM에 접근할 수 있습니다. 즉, __INLINE_FORMULA_0__ 의 흐름을 가집니다.

  1. OAuth 기반 인증 (OAuth-based Authentication):
프로젝트의 가장 중요한 특징 중 하나는 OAuth를 통한 인증 지원입니다. 사용자는 OpenAI, Gemini, Claude, Qwen, iFlow와 같은 서비스에 대해 직접적인 API 키를 입력하는 대신, 표준 OAuth 인증 흐름을 통해 로그인할 수 있습니다. CLIProxyAPI는 내부적으로 OAuth 토큰을 관리하며, 이를 통해 여러 계정의 사용이 용이해지고 보안 위험을 줄입니다. 이 방식은 특히 API 사용량을 개별 계정의 구독 한도 내에서 관리하고자 할 때 유용합니다.

  1. 다중 계정 및 로드 밸런싱 (Multi-account & Load Balancing):
동일한 LLM 제공자(예: Gemini)에 대해 여러 계정을 설정할 수 있으며, CLIProxyAPI는 이러한 계정들 간에 요청을 Round-robin 방식으로 로드 밸런싱하여 분산 처리합니다. 이는 단일 계정의 한도 초과를 방지하고, 서비스 가용성을 높이며, 대규모 트래픽을 처리하는 데 기여합니다.

  1. 모델 라우팅 및 폴백 (Model Routing & Fallback):
CLIProxyAPI는 지능적인 모델 라우팅 기능을 제공합니다. 특정 모델이 사용 불가능하거나 최적의 선택이 아닐 경우, claude-opus-4.5를 claude-sonnet-4로 자동 전환하는 것과 같이 미리 정의된 대체 모델로 요청을 라우팅할 수 있습니다. 이는 사용자의 경험을 원활하게 유지하고 서비스 중단을 최소화하는 데 도움이 됩니다.

  1. 기능 호출 및 멀티모달 입력 지원 (Function Calling & Multimodal Input Support):
최신 LLM의 주요 기능인 함수 호출(Function Calling) 및 텍스트와 이미지 등 멀티모달(multimodal) 입력에 대한 지원을 포함하여, 복잡한 AI 작업을 처리할 수 있는 유연성을 제공합니다.

  1. 보안 및 관리 (Security & Management):
관리 엔드포인트는 localhost로만 제한되어 외부 접근을 차단함으로써 보안을 강화합니다. 또한, MANAGEMENT_API.md 문서를 통해 API를 통한 구성 및 관리가 가능함을 명시하고 있습니다.

  1. SDK 및 확장성 (SDK & Extensibility):
Go 언어로 작성된 재사용 가능한 SDK를 제공하여 개발자가 CLIProxyAPI의 기능을 자신의 애플리케이션에 쉽게 임베드할 수 있도록 합니다. 이는 사용자 정의 제공자(Custom Provider)를 추가하는 등의 고급 확장을 가능하게 합니다.

응용 분야:

  • Amp CLI 및 IDE 확장 통합: Amp CLI 및 Amp IDE 확장과 긴밀하게 통합되어, 사용자가 Google/ChatGPT/Claude OAuth 구독을 Amp의 코딩 도구와 함께 사용할 수 있도록 합니다.
  • 다양한 프로젝트 기반 활용: vibeproxy, Subtitle Translator, CCS (Claude Code Switch), ProxyPal, Quotio, CodMate, ProxyPilot, Claude Proxy VSCode, ZeroLimit, CPA-XXX Panel 등 다양한 macOS, Windows 기반 데스크톱 애플리케이션 및 CLI 래퍼에서 CLIProxyAPI를 백엔드로 활용하여 "API 키 불필요(no API keys needed)" 원칙을 구현합니다.
  • CLIProxyAPI 기반/영감 프로젝트: 9Router와 같이 CLIProxyAPI에서 영감을 받아 Next.js로 구현된 프로젝트들은 OpenAI, Claude, Gemini, Ollama 간의 포맷 변환, 콤보 시스템, 다중 계정 관리 등의 기능을 제공하며 생태계를 확장하고 있습니다.