lich0821/ccNexus

해결하는 문제

ccNexus는 여러 AI API 엔드포인트를 관리하고 전환하기 위한 프록시 에이전트입니다. API의 불안정성과 인증의 복잡성을 해결하기 위해 자동 장애 대체, 다양한 AI 제공업체 간의 포맷 변환, 대규모 인증 토큰 풀을 중앙에서 관리하는 시스템을 제공합니다.

작동 방식

이 도구는 AI 클라이언트(Claude Code 또는 Codex CLI 등)와 다양한 AI 백엔드 사이의 중개자 역할을 합니다. 다음과 같은 핵심 기능을 제공합니다:

• 엔드포인트 전환: 현재 엔드포인트가 실패하면 자동으로 건강한 엔드포인트로 전환합니다.
• API 포맷 변환: Claude, OpenAI, Gemini 포맷 간에 요청과 응답을 변환하여 다양한 제공업체 간의 호환성을 보장합니다.
• Codex 토큰 풀: 접근 토큰과 갱신 토큰의 배치를 관리하며, 자동 전환, 만료된 토큰 갱신, 무효 자격 증명의 격리 기능을 수행합니다.
• 구성 관리: Wails를 통해 크로스플랫폼 GUI 또는 Docker를 통해 헤드리스 서버 모드로 엔드포인트를 구성하고 WebDAV를 통해 데이터를 동기화할 수 있습니다.

대상 사용자

특히 Claude Code와 Codex CLI를 사용하며, 여러 API 키나 제공업체를 통합하여 AI 서비스의 고가용성을 확보하고자 하는 개발자 및 고급 사용자입니다.

주요 기능

• 자동 장애 대체: 서비스 중단을 방지하기 위해 시ーム리스하게 엔드포인트를 전환합니다.
• 다중 제공업체 지원: Claude, OpenAI, Gemini 포맷 변환을 지원합니다.
• 토큰 풀 관리: Codex 토큰의 자동 전환 및 갱신을 처리합니다.
• 상세한 통계: 각 자격 증명별로 실시간으로 이벤트 기반으로 요청, 오류, 토큰 사용량을 추적합니다.
• 크로스플랫폼 배포: Windows, macOS, Linux용 데스크톱 애플리케이션 또는 서버용 Docker 컨테이너로 제공됩니다.