caozhiyuan/copilot-api

GitHub Copilot, OpenAI Codex, OpenCode Go, and third-party AI provider gateway with OpenAI and Anthropic API compatibility.

Copilot API – 여러 코딩 AI 공급자를 위한 로컬 게이트웨이

개요

  • 사용자 머신에서 실행되는 오픈소스 Node.js/Bun 서버(기본값: http://localhost:4141).
  • 클라이언트 도구(Claude Code, OpenCode, Codex, 일반적인 OpenAI 또는 Anthropic SDK)가 통신할 수 있는 단일 OpenAI 호환 HTTP API를 제공합니다.
  • 백그라운드에서 게이트웨이는 각 요청을 적절한 백엔드로 전달합니다: GitHub Copilot, 내장 codex/xai 서비스, 또는 Kimi, DeepSeek, DashScope, OpenRouter, OpenCode Go, models.dev에 등록된 사용자 지정 공급자와 같은 타사 모델 공급자.

중요성

  • AI 기반 코딩 어시스턴트를 사용하는 개발자는 서로 다른 클라이언트 측 확장 기능을 처리해야 하며 각각 다른 엔드포인트(Chat Completions, Responses, Anthropic Messages)를 기대합니다. Copilot API는 이를 하나의 로컬 엔드포인트로 표준화하여 구성 마찰을 제거합니다.
  • 또한 공급자를 혼합하고 매칭할 수 있습니다. 예를 들어 Copilot 할당량이 소진되면 오픈소스 모델로 폴백하거나 편집기 설정을 변경하지 않고 공급자 간 비용을 비교할 수 있습니다.

주요 기능(README에 설명된 대로)

  • 통합 API: /v1/chat/completions(OpenAI 스타일), /v1/responses(GitHub Copilot 스타일), /v1/messages(Anthropic 스타일)의 세 가지 공개 라우트를 지원합니다. 모든 라우트는 Server-Sent Events를 통해 결과를 스트리밍합니다.
  • 다중 공급자 라우팅: Copilot, codex, xai 및 다양한 외부 서비스용 어댑터를 기본 지원합니다. 공급자는 간단한 config.json 파일을 통해 활성화할 수 있습니다. Copilot 토큰이 제공되지 않으면 서버는 "공급자 전용" 모드로 계속 작동합니다.
  • 코딩 에이전트 준비: Claude Code, OpenCode, Codex용 사전 구성 설정. 자동 모델 검색 및 Codex용 병합된 모델 카탈로그 포함.
  • 스트리밍 및 WebSocket: 클라이언트 측 스트리밍에 SSE 사용. 업스트림 트래픽은 공급자의 기능에 따라 WebSocket 또는 HTTP를 사용할 수 있습니다.
  • 데스크톱 GUI: OAuth 로그인, API 키 입력, 원클릭 시작/중지, 토큰 사용량, 로그, 사용 가능한 모델 표시를 처리하는 Electron 앱(Windows, macOS, Linux).
  • Docker 지원: 컨테이너화된 배포를 위한 공식 Docker Compose 레시피. 구성 및 사용 로그를 위한 영구 /data 볼륨 포함.
  • CLI: npx @jeffreycao/copilot-api@latest start로 시작, auth login으로 Copilot 자격 증명 설정, debug 하위 명령도 제공.

일반적인 워크플로우

  1. npx(또는 Docker/Bun)로 설치합니다.
  2. 선택적으로 auth login을 실행하여 GitHub Copilot 계정을 연결합니다.
  3. 서버를 시작합니다 – localhost:4141에서 수신 대기합니다.
  4. 코딩 어시스턴트 확장(예: Claude Code)을 http://localhost:4141/v1/messages로 지정합니다.
  5. 게이트웨이가 요청을 선택한 공급자로 전달하고 응답을 스트리밍하며 토큰 사용량을 기록합니다.

사용 대상

  • 여러 AI 코딩 어시스턴트에 의존하고 단일 로컬 엔드포인트를 원하는 개발자.
  • 공급자 간 사용 모니터링 또는 할당량 인식 라우팅을 시행해야 하는 팀.
  • 하드코딩된 클라우드 엔드포인트에 대한 자체 호스팅, 구성 가능한 대안을 원하는 모든 사람.

자세한 정보

  • 전체 가이드는 docs/guides/en/에 있습니다(시작하기, 공급자별 문서, Docker, 데스크톱 앱, 사용 모니터링 등).
  • 저장소에는 MIT 라이선스 코드베이스, npm 패키지 @jeffreycao/copilot-api, 사전 빌드된 Electron 바이너리가 포함되어 있습니다.

위 정보는 모두 저장소의 README에서 직접 가져온 것이며 외부 가정은 추가되지 않았습니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트