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하위 명령도 제공.
일반적인 워크플로우
npx(또는 Docker/Bun)로 설치합니다.- 선택적으로
auth login을 실행하여 GitHub Copilot 계정을 연결합니다. - 서버를 시작합니다 –
localhost:4141에서 수신 대기합니다. - 코딩 어시스턴트 확장(예: Claude Code)을
http://localhost:4141/v1/messages로 지정합니다. - 게이트웨이가 요청을 선택한 공급자로 전달하고 응답을 스트리밍하며 토큰 사용량을 기록합니다.
사용 대상
- 여러 AI 코딩 어시스턴트에 의존하고 단일 로컬 엔드포인트를 원하는 개발자.
- 공급자 간 사용 모니터링 또는 할당량 인식 라우팅을 시행해야 하는 팀.
- 하드코딩된 클라우드 엔드포인트에 대한 자체 호스팅, 구성 가능한 대안을 원하는 모든 사람.
자세한 정보
- 전체 가이드는
docs/guides/en/에 있습니다(시작하기, 공급자별 문서, Docker, 데스크톱 앱, 사용 모니터링 등). - 저장소에는 MIT 라이선스 코드베이스, npm 패키지
@jeffreycao/copilot-api, 사전 빌드된 Electron 바이너리가 포함되어 있습니다.
위 정보는 모두 저장소의 README에서 직접 가져온 것이며 외부 가정은 추가되지 않았습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트