Universal AI Gateway를 제공하는 Copilot API

범용 AI 게이트웨이

하나의 게이트웨이로, 모든 클라이언트와 여러 AI 공급자를 연결합니다.

Chat Completions · OpenAI Responses · Anthropic Messages

English | 简体中文

Copilot API는 로컬 AI 게이트웨이로서 Claude Code, OpenCode, Codex 등 다양한 클라이언트를 GitHub Copilot, 내장된 Codex 및 xAI 공급자, 그리고 서드파티 모델 공급자들을 통합된 API를 통해 연결합니다.

통합 API 게이트웨이: 하나의 로컬 엔드포인트에서 OpenAI와 호환되는 Chat Completions (/v1/chat/completions), OpenAI Responses API (/v1/responses), 그리고 Anthropic과 호환되는 Messages (/v1/messages)를 제공합니다.다중 공급자 지원: 동일한 게이트웨이 뒤에서 GitHub Copilot, 내장된 codex 및 xai 공급자들, 그리고 서드파티 공급자들(Kimi, DeepSeek, DashScope, OpenRouter, OpenCode Go 또는 models.dev의 사용자 지정 공급자)을 라우팅합니다. GitHub Copilot은 선택 사항이며, 활성화된 공급자가 하나라도 있으면 서버는 GitHub 토큰 없이 공급자 전용 모드로 시작됩니다.코딩 에이전트 준비: settings.json 게이트웨이 모델 검색 및 Codex를 위한 통합 모델 카탈로그와 함께 Claude Code, OpenCode, Codex에 대한 최고 수준의 설정(first-class setups)을 제공합니다.스트리밍 및 WebSocket: 세 가지 클라이언트 측 프로토콜 모두에서 SSE 스트리밍을 지원합니다. 상위 Copilot Responses 트래픽은 각 모델이 광고하는 엔드포인트에서 WebSocket 또는 HTTP를 선택하며, 내장된 codex 공급자의 스트리밍 Responses 트래픽은 기본적으로 WebSocket을 사용하고 useResponsesApiWebSocket이 비활성화된 경우 HTTP를 사용합니다.데스크톱 앱: GitHub Copilot 로그인, Codex 및 xAI OAuth, 공급자 구성, 토큰 사용, 로그, 원클릭 시작/중지 기능이 있는 Electron GUI를 제공합니다.

Node.js >= 22.13.0 (npx) 또는 Bun >= 1.2.x가 필요합니다. Copilot 구독은 GitHub Copilot 공급자에만 필요하며, 다른 구성된 공급자들은 독립적으로 실행될 수 있습니다.

npx @jeffreycao/copilot-api@latest start

서버는 기본적으로 http://localhost:4141에서 리스닝합니다. 선택적으로 GitHub Copilot으로 인증하거나 먼저 서드파티 공급자를 구성하십시오:

npx @jeffreycao/copilot-api@latest auth login

게이트웨이가 정상 작동하는지 확인합니다:

curl http://localhost:4141/v1/models

여기서부터는 사용하려는 클라이언트(client) 가이드로 이동하거나, Claude Code, OpenCode, Codex를 사용하거나 Docker로 실행할 수 있습니다.

모든 클라이언트는 동일한 로컬 엔드포인트와 통신합니다. 게이트웨이는 각 요청을 GitHub Copilot, 내장된 codex 또는 xai 공급자, 또는 구성된 타사 공급자로 라우팅하며, 공급자가 다른 프로토콜로 통신할 경우 프로토콜 간 변환(translating)을 수행합니다.

클라이언트 / 프로토콜 매트릭스

공급자 및 프로토콜. 프로토콜 지원은 모델별로 다릅니다. Chat Completions는 네이티브 엔드포인트를 필요로 하는 반면, Responses와 Messages는 지원되는 어댑터(adapter)를 사용할 수 있습니다. 내장된 codex 공급자는 Responses를 네이티브로 사용하며, 타사 공급자들은 모델별 오버라이드를 통해 anthropic, openai-compatible, 또는 openai-responses를 사용할 수 있습니다.

GUI가 선호되나요? desktop/에 있는 Electron 데스크톱 앱은 GitHub Copilot 로그인, OpenAI Codex 및 xAI OAuth, 그리고 Kimi, DeepSeek, DashScope, OpenRouter 또는 models.dev의 사용자 지정 공급자에 대한 API 키 구성을 지원합니다. 이 앱을 사용하면 로컬 서버와 로컬 엔드포인트, 인증 헤더(auth header), 사용 가능한 모델, 사용량, 로그를 하나의 창에서 원클릭으로 시작/중지할 수 있습니다.

Windows x64 (.exe), macOS Apple Silicon (.dmg), 및 Linux x64 (.AppImage) 패키지는 GitHub Releases에 게시됩니다. 전체 설정 및 고급 구성은 Electron Desktop App 문서를 참조하십시오.