OpenSource-Hub
C

ccx

SHA-256
2.4k stars·개발 도구·SHA-256 체크섬 확인됨

고성능 AI API 프록시 및 프로토콜 번역 게이트웨이, Claude, OpenAI, Gemini 및 Codex를 지원하며, 내장 웹 관리 패널, 채널 오케스트레이션, 장애 조치 및 다중 키 관리 기능을 갖추고 있습니다.

스마트 다운로드

Download 버전 다운로드

v2.8.14 · 29 MB

여러 AI 서비스를 통합 프록시하여 하나의 인터페이스로 Claude, OpenAI 및 Gemini를 처리합니다.

주요 기능

  • 단일 포트 배포, 자체 웹 관리 인터페이스 및 백엔드 포함
  • Claude Messages, OpenAI 채팅/이미지, Codex Responses 및 Gemini 지원
  • 드래그 앤 드롭 방식의 채널 우선순위 조정, 자동 건강 상태 확인 및 장애 조치
  • 각 채널별 독립적인 API 키 교체, 프록시 설정, 모델 화이트리스트 및 라우팅 접두사
  • 내장된 세션 추적, 다중 턴 대화 워크플로우 지원

할 수 없는 것

  • CCX는 프록시 도구이며, AI 서비스 자체가 아닙니다. 상위 API 키(예: Claude, OpenAI 등)를 직접 획득해야 합니다.
  • 무료 버전은 제한이 없지만, 상위 API의 과금 규칙을 확인해야 합니다. 초과 사용 시 추가 비용이 발생할 수 있습니다.
  • 기본적으로 모든 네트워크 인터페이스를 수신합니다. 프로덕션 환경에서는 방화벽 또는 리버스 프록시를 사용하여 액세스를 제한하는 것을 권장합니다.

사용 사례

  • 팀이 여러 AI 서비스의 API 키를 통합 관리하여 중앙 모니터링 및 속도 제한을 실현합니다.개발자가 로컬 또는 서버에 프록시 게이트웨이를 구축하여 다양한 모델 공급자 간 전환을 용이하게 합니다.

상세 설명

CCX는 고성능 AI API 프록시 및 프로토콜 변환 게이트웨이로, Claude, OpenAI 채팅/이미지, Codex Responses 및 Gemini 등 다양한 업스트림 서비스를 통합 지원합니다. 단일 포트 배포 방식을 채택하고 있으며, 내장된 Web 관리 백엔드와 프론트엔드를 통해 시각화 콘솔에서 채널 관리, 트래픽 모니터링 및 모델 라우팅 구성을 수행할 수 있습니다. one-api 또는 new-api와 같은 유사 도구와 비교하여 CCX는 Claude Messages 및 Codex 엔드포인트를 기본 지원하며, 드래그 앤 드롭 방식의 우선순위 스케줄링, 채널별 API 키 순환, 상태 확인 및 자동 장애 조치, 그리고 서킷 브레이커 복구 메커니즘을 제공합니다. 바이너리, Docker 또는 데스크톱 버전으로 배포할 수 있으며 외부 데이터베이스가 필요하지 않아 개인이나 팀이 가벼운 AI 게이트웨이를 신속하게 구축하기에 적합합니다.

문제 해결 & FAQ (1)

문제 해결
Codex가 긴 대화 후에 'Invalid assistant message: content or tool_calls must be set'를 표시하는 이유는 무엇인가요?

이는 ccx 버전 2.6.77 및 2.6.81에서 긴 대화 후 발생하는 알려진 문제입니다. Workaround: 상태를 재설정하기 위해 새 chat session을 시작하십시오. 아직 영구적인 수정은 없습니다.

원본 Issue #35

태그

AI代理API网关ClaudeOpenAIGemini协议翻译负载均衡多密钥管理

시작하기

1

설치 프로그램 다운로드

위 버튼을 클릭하여 시스템에 맞는 설치 프로그램을 다운로드

2

소프트웨어 설치

다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요

3

최신 바이너리 파일 또는 Docker 이미지 다운로드

4

동일 디렉토리에 .env 파일을 생성하고 PROXY_ACCESS_KEY 및 PORT 등의 환경 변수를 설정합니다

5

바이너리를 실행하거나 컨테이너를 시작한 후 http://localhost:3000을 열면 Web 관리 인터페이스를 사용할 수 있습니다

설치 가이드
  1. 최신 바이너리 파일 또는 Docker 이미지 다운로드
  2. 동일 디렉토리에 .env 파일을 생성하고 PROXY_ACCESS_KEY 및 PORT 등의 환경 변수를 설정합니다
  3. 바이너리를 실행하거나 컨테이너를 시작한 후 http://localhost:3000을 열면 Web 관리 인터페이스를 사용할 수 있습니다
파일 무결성

SHA-256 체크섬 확인됨

GitHub 공식 Release 페이지에서 추출된 체크섬

SHA256 체크섬

37f6b8071174684e7a2dae6f4a30967fd3388797efc7a9a3907a1524418b8ae5

이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.

이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.

오픈소스 투명성

GitHub 소스 보기
환경 가이드

제거 정보

직접 바이너리 파일을 삭제하거나 Docker 컨테이너를 중지 및 삭제하면 CCX를 완전히 제거할 수 있으며, 설정이 남지 않습니다. (설정 파일은 .config 디렉터리에 있으며, 필요에 따라 삭제하세요.)

추가 의존성 없음

다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.

프로젝트 정보
라이선스MIT
마지막 업데이트2026-06-27 09:05:27
GitHub 저장소공식 웹사이트

문제 발생? 아래 FAQ 확인

1 FAQ

유사한 프로젝트