Ccg Gateway

다중 에이전트 관리

내장된 10개 이상의 에이전트 템플릿을 제공하며, 사용자 정의 템플릿을 통해 새로운 에이전트를 추가할 수 있습니다. 각 에이전트에 대해 별도의 프로필을 생성하여 서로 다른 서비스 제공업체 구성으로 독립적으로 실행할 수 있습니다.

다중 프로토콜 라우팅 및 변환

Anthropic Messages, OpenAI Chat, OpenAI Responses, Gemini generateContent 네 가지 엔드포인트 유형을 지원합니다. Anthropic, OpenAI Chat, OpenAI Responses 간에는 양방향 프로토콜 변환이 가능하여, 예를 들어 Claude Code가 OpenAI Chat 엔드포인트를 사용하는 서비스 제공업체를 직접 이용할 수 있습니다.

지능형 장애 조치 및 모델 매핑

요청 실패 시 자동 재try, 서비스 제공업체 전환, 서킷 브레이커 메커니즘을 통해 무중단 서비스를 제공합니다. 에이전트와 서비스 제공업체 간 모델 이름이 다를 경우 와일드카드 기반 자동 매핑을 적용하여 수동 구성 파일 수정이 필요하지 않습니다.

가격 및 모델 목록 동기화

공식 모델 가격 정보(장문 컨텍스트 단계별 가격 포함)를 자동으로 동기화하며, 서비스 제공업체당 하나의 배율만 설정하면 됩니다. 또한 서비스 제공업체의 사용 가능한 모델 목록을 실시간으로 가져와 드롭다운에서 직접 선택할 수 있습니다.

포괄적인 로그 및 분석

요청 메타데이터(시간, 에이전트, 서비스 제공업체, 상태, 지연시간, 토큰 상세, 캐시 히트율, 비용 등)와 요청 상세(헤더/본문)를 분리하여 기록합니다. 비용은 토큰 수 × 단가 × 배율로 세부 내역을 보여주며, 오류는 게이트웨이 포착 또는 상류 오류로 분류됩니다. 시스템 로그는 진단 이벤트를 기록하고 중복 제거합니다.

다중 프로필 및 클라우드 동기화

동일한 에이전트에 대해 여러 프로필을 생성하여 독립적인 서비스 제공업체 목록을 유지할 수 있으며, 각 프로필에 해당하는 에이전트 실행 명령을 한 번에 복사할 수 있습니다. 구성은 로컬 파일 내보기/가져오기와 WebDAV를 통한 클라우드 백업을 통해 기기 간에 동기화할 수 있습니다.

MCP, 프롬프트, 스킬 관리

MCP(Model Context Protocol), 프롬프트, 스킬을 한 번 구성하여 여러 에이전트에 적용할 수 있습니다. 스킬은 로컬 디렉터리 또는 원격 Git 저장소에서 설치할 수 있으며, DeepSeek Harness 플러그인은 Git 저장소 URL 입력으로 바로 설치할 수 있습니다.

Windows 사용자를 위한 설치 방법

공식 GitHub 저장소의 Releases 페이지에서 최신 버전의 Windows용 .exe 설치 파일을 다운로드할 수 있습니다. 다운로드 후 파일을 실행하여 설치 마법사를 따릅니다.

또는 Windows 패키지 관리자 Scoop을 통해 다음 명령으로 설치할 수 있습니다:

scoop install extras/ccg-gateway

기본 사용법

설치 후 프로그램을 실행하면 메인 대시보드가 표시되며, 여기서 사용량 통계, 요청 로그, 에이전트 현황 등을 확인할 수 있습니다. 상단 메뉴에서 에이전트 템플릿, 중계 서비스 제공업체, 프로필 관리, 글로벌 설정, 로그 관리 섹션으로 이동하여 구성을 조정할 수 있습니다.

에이전트를 사용하려면 먼저 에이전트 템플릿에서 원하는 에이전트를 선택하거나 새로 만든 후, 중계 서비스 제공업체에서 사용할 서비스 제공업체의 엔드포인트 유형, API 키, 모델 정보를 입력합니다. 서비스 제공업체 목록에서 모델 이름 매핑 규칙을 설정하면, 에이전트가 요청하는 모델 이름을 자동으로 서비스 제공업체의 모델 이름으로 변환합니다.

프로필을 생성하려면 에이전트 템플릿 목록에서 특정 에이전트를 우클릭하거나 프로필 관리 메뉴를 통해 새 프로필을 추가할 수 있으며, 각 프로필은 독립적인 서비스 제공업체 목록을 가집니다. 프로필과 연결된 에이전트 실행 명령은 프로필 목록에서 복사하여 터미널이나 배치 파일에 사용할 수 있습니다.

지원 환경 및 시스템 요구사항

공식 문서에 명시된 바에 따라, 소스 코드로부터 직접 빌드 및 실행하려면 다음 개발 환경이 필요합니다:

• Rust 1.80 이상
• Node.js 18 이상
• pnpm 11 이상

배포된 실행 파일(.exe, .dmg, .AppImage)은 위 개발 도구 없이도 바로 실행할 수 있으며, Windows에서는 64비트 x64 아키텍처를 지원합니다.

최신 버전 및 업데이트

현재 버전은 2.0.7이며, 내부 업데이트 확인 기능을 통해 GitHub Releases에서 최신 버전을 자동으로 확인할 수 있습니다. 설정에서 업데이트 확인 주기를 조정하거나 수동으로 확인할 수 있습니다.

제한 사항 및 확인 사항

에이전트 템플릿을 사용자 정의하여 수정한 경우, 변경 사항이 적용되도록 소프트웨어를 재시작해야 합니다. 사용자 정의 템플릿은 ~/.ccg-gateway/agent-definitions/{id}.json 경로에 저장됩니다.

FAQ

• CCG Gateway는 무료로 사용할 수 있나요?

  네, MIT 라이선스로 배포되는 오픈소스 소프트웨어이므로 무료로 다운로드하고 사용할 수 있습니다.

• Windows 외에 다른 운영체제도 지원하나요?

  네, Windows(.exe), macOS(.dmg, 유니버설), Linux(.AppImage)를 모두 지원하는 크로스플랫폼 애플리케이션입니다.