Kelvinthedude/ccNexus

ccNexus은(는) 무엇을 하나요?

🔄 Claude Code용 API 엔드포인트 로테이션을 자동화하여 다중 제공자 지원, 스마트 재시도, 실시간 통계를 통해 안정성과 성능을 향상시킵니다.

개요

ccNexus는 Claude Code 환경에서 API 호출의 신뢰성을 높이기 위해 설계된 도구입니다. 다중 API 제공자를 지원하며, 엔드포인트 장애 시 자동으로 대체 엔드포인트로 전환하고 지능적인 재시도 전략을 적용합니다.

주요 기능

• 다중 제공자 지원: OpenAI, Anthropic 및 OpenAI 호환 API 제공자를 지원합니다.
• 자동 엔드포인트 로테이션: 장애 발생 시 자동으로 다음 엔드포인트로 전환합니다.
• 스마트 재시도: 네트워크 오류, 속도 제한, 서버 오류 등 다양한 오류 유형에 맞는 재시도 전략을 제공합니다.
• 실시간 통계: API 호출 성공률, 지연 시간, 사용량 패턴을 모니터링할 수 있는 대시보드를 제공합니다.
• 구성 가능: 환경 변수 또는 구성 파일을 통해 간편하게 설정할 수 있습니다.

설치

npm install -g ccnexus
# 또는
npx ccnexus init

사용 방법

1. 구성 파일 생성

프로젝트 루트에 ccnexus.config.json 파일을 생성합니다:

{
  "providers": [
    {
      "name": "openai",
      "apiKey": "sk-your-openai-api-key",
      "endpoint": "https://api.openai.com/v1"
    },
    {
      "name": "anthropic",
      "apiKey": "sk-ant-your-anthropic-api-key",
      "endpoint": "https://api.anthropic.com/v1"
    }
  ],
  "retry": {
    "maxRetries": 3,
    "baseDelay": 1000,
    "maxDelay": 30000
  },
  "monitoring": {
    "enableStats": true,
    "logLevel": "info"
  }
}

2. 환경 변수 설정

export CCNEXUS_CONFIG_PATH="./ccnexus.config.json"
export CCNEXUS_DEFAULT_PROVIDER="openai"

3. Claude Code와 통합

Claude Code 프롬프트에서 다음 명령어를 사용하여 통합합니다:

/ccnexus start

4. 명령어 목록

• ccnexus start: 엔드포인트 로테이션 서비스 시작
• ccnexus status: 현재 연결 상태 및 통계 확인
• ccnexus switch <provider>: 특정 제공자로 수동 전환
• ccnexus stats: 실시간 통계 대시보드 표시
• ccnexus stop: 서비스 중지

실시간 통계 예시

📊 ccNexus 통계 대시보드
─────────────────────────────
총 요청: 1,234
성공: 1,210 (98.1%)
실패: 24 (1.9%)
평균 지연 시간: 342ms
활성 제공자: openai
대체 제공자: anthropic (준비)
─────────────────────────────

문제 해결

로그 확인

ccnexus logs --level debug

구성 검증

ccnexus validate

라이선스

MIT License

기여

버그 리포트, 기능 제안, 풀 리퀘스트를 환영합니다. GitHub 저장소를 방문해주세요.