caozhiyuan/copilot-api

Copilot API – 多编码 AI 提供商的本地网关

它是什么

• 一个在您的机器上运行的开源 Node.js/Bun 服务器（默认地址 http://localhost:4141）。
• 它提供一个单一的、兼容 OpenAI 的 HTTP API，客户端工具（Claude Code、OpenCode、Codex、通用的 OpenAI 或 Anthropic SDK）可以与之通信。
• 在幕后，网关将每个请求转发到相应的后端：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：Electron 应用（Windows、macOS、Linux），处理 OAuth 登录、API 密钥输入、一键启停，并显示令牌使用量、日志和可用模型。
• 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；未添加任何外部假设。