dwgx/WindsurfAPI

Turn Windsurf / Devin Desktop's 100+ AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, Anthropic- & Gemini-compatible APIs. Zero-dependency self-hosted reverse proxy for Claude Code, Cline & Cursor. 把 Windsurf/Devin 云端 100+ 模型变成三套兼容 API。

해결하는 문제

WindsurfAPI는 Windsurf(구 Codeium/Devin Desktop) 플랫폼의 내부 프로토콜을 표준 호환 API로 변환하여 100개 이상의 AI 모델(Claude, GPT, Gemini, Grok 및 다양한 오픈 소스 모델 포함)에 액세스할 수 있는 방법을 제공합니다. 이를 통해 사용자는 각 개별 제공업체에 대한 직접적인 구독 없이도 OpenAI, Anthropic 또는 Gemini API 형식을 사용하는 기존 AI 도구 및 SDK에 이러한 모델을 통합할 수 있습니다.

작동 방식

이 프로젝트는 들어오는 표준 API 요청(OpenAI, Anthropic, Gemini)을 Windsurf의 내부 gRPC 프로토콜로 변환하는 HTTP 프록시 서버 역할을 합니다. 로컬 Windsurf Language Server (LS) 바이너리와 통신하며, 해당 바이너리는 요청을 Windsurf 클라우드 서버로 전달합니다. 안정성 및 액세스 관리를 위해 자동 로테이션, 속도 제한 격리 및 장애 조치 메커니즘을 갖춘 계정 풀을 유지합니다. 또한 깨끗한 API 경험을 보장하기 위해 응답에서 제공업체별 ID 마커를 제거합니다.

대상 사용자

개발자: 자신의 애플리케이션이나 스크립트에서 하이엔드 모델(Claude 3.5/4.5 또는 GPT-5 변형 등)을 사용하고자 하는 개발자.
AI 에이전트 사용자: Claude Code, Cline, Cursor 또는 Aider와 같은 도구를 사용하며 Windsurf의 모델 카탈로그를 백엔드로 사용하고자 하는 사용자.
셀프 호스터: 여러 LLM을 위한 통합 API 게이트웨이를 찾는 사용자.

주요 특징

멀티 API 호환성: OpenAI (/v1/chat/completions), Anthropic (/v1/messages) 및 Gemini (/v1beta/models/*) 표준을 동시에 지원합니다.
광범위한 모델 지원: Anthropic, OpenAI, Google 및 다양한 중국 LLM을 포함한 주요 제공업체의 100개 이상의 모델에 액세스할 수 있습니다.
제로 종속성: 순수 Node.js로 구축되었으며 npm 런타임 종속성이 없습니다. 커스텀 protobuf 구현 및 이미지 디코딩을 활용합니다.
계정 관리: OAuth 로그인(Google/GitHub), 계정 풀 모니터링 및 프록시 구성을 위한 웹 대시보드가 포함되어 있습니다.
에이전트 준비 완료: tool_use 및 tool_result 신호를 전달하도록 특별히 설계되어 Claude Code와 같은 에이전트형 CLI 도구와 함께 작동할 수 있습니다.
리소스 효율성: 저사양 VPS에서 OOM (Out of Memory) 오류를 방지하기 위해 메모리 가드 및 유휴 TTL이 있는 LS 인스턴스 풀을 구현합니다.