leookun/cursor-byok

해결하는 문제

Cursor의 기본 제공 모델 옵션은 고정된 공급자 및 결제 플랜에 묶여 있어 선택의 여지가 거의 없습니다. cursor-byok는 자체 API 키, 엔드포인트 및 모델 ID를 가져올 수 있게 하여 그 제한을 제거합니다. 사용할 모델에 대한 제어권을 다시 제공하여 Cursor의 기본 채널 대신 이미 보유한 크레딧과 공급자를 활용할 수 있습니다.

작동 방식

cursor-byok는 사용자 머신에서 로컬 서비스로 실행됩니다. Cursor는 에이전트 요청과 도구 결과를 이 서비스로 보내고, 서비스는 프로토콜을 변환하여 구성된 모델 API로 전달합니다. 프로토콜 변환(OpenAI 및 Anthropic 호환), 요청 전달, 도구 호출 조정, 대화 상태를 모두 사용자 컴퓨터에서 처리합니다. API 키와 설정은 로컬에 저장되고, 실제 모델 요청은 선택한 공급자로 나갑니다.

대상 사용자

이 프로젝트는 Cursor를 사용하면서 자체 모델 구독, 크레딧 또는 자체 호스팅 서비스를 사용하려는 개발자를 위해 만들어졌습니다. Cursor가 제공하는 모델에 제한되는 것에 지쳤고 호환 가능한 API를 자유롭게 연결하고 싶다면 이 프로젝트가 적합합니다.

주요 기능

• 자체 모델 채널 가져오기: 자체 엔드포인트, 자격 증명 및 모델 ID를 구성합니다.
• OpenAI 및 Anthropic 호환 API 또는 사용자 지정 엔드포인트 지원.
• 모델 관리: 여러 구성을 추가, 복제, 편집, 재정렬 및 일괄 테스트.
• 연결 벤치마크: 첫 토큰까지의 시간, 생성 속도를 측정하고 원시 공급자 응답을 검사합니다.
• 에이전트 워크플로 유지: 도구 호출, 스킬, MCP 및 다중 턴 대화가 모두 계속 작동합니다.
• 세션 메트릭: 토큰 사용량, 캐시 적중률, 대화 턴 수 및 예상 가치를 추적합니다.
• 크로스 플랫폼: macOS, Windows 및 Linux에서 실행됩니다.