프로젝트 소개

claude-desktop-gateway는 Claude Desktop이 OpenAI, Gemini, DeepSeek 등 Anthropic 이외의 제공업체 AI 모델에 액세스할 수 있도록 하는 경량 프록시 프로그램입니다. 이 프로그램은 Anthropic API 요청을 OpenAI 호환 형식으로, 그리고 그 반대로 변환하여 Claude Desktop의 핵심 동작을 수정하지 않고도 원활한 통합을 가능하게 합니다. 게이트웨이는 단일 YAML 파일(models.yaml)을 통해 완전히 구성되며, 사용자는 여기서 제공업체와 관련 모델을 정의합니다. 각 제공업체는 활성화 또는 비활성화할 수 있으며, API 키는 환경 변수, auth.json 파일 또는 설정 파일에 직접 포함(보안 경고 있음)하여 로드할 수 있습니다. 모델은 공식 Anthropic 모델과의 충돌을 피하기 위해 'claude-'로 시작하는 별칭으로 매핑됩니다. 텍스트, 이미지 입력, 도구 호출(tool calls), 추론 모드 및 스트리밍 응답을 지원합니다. 게이트웨이는 Linux/WSL에서 헤드리스 서비스로 또는 Windows에서 시스템 트레이 애플리케이션으로 실행되며, 기본적으로 3458 포트에서 대기합니다. 사용자는 Claude Desktop에서 개발자 모드(Developer Mode)를 활성화하고 로컬 게이트웨이 URL을 가리키도록 설정해야 합니다. 빌드를 위한 Go 외에 필요한 런타임 종속성은 없습니다. GATEWAY_LOG가 설정된 경우 프로그램이 요청을 기록하여 문제 해결을 돕습니다. 모델 목록을 갱신하려면 설정 변경 후 게이트웨이와 Claude Desktop을 재시작해야 합니다. 게이트웨이는 Gateway API 키를 검증하지 않으므로, Claude Desktop 내의 인증을 위해 어떤 값(예: 'x')이라도 입력하면 충분합니다.