@jer-y/copilot-proxy
v0.11.0
Published
Turn GitHub Copilot into an OpenAI/Anthropic-compatible server with Claude Code and Codex support.
Maintainers
Readme
English | 简体中文
Copilot API Proxy
面向单一可信操作者的本地适配器,将一个或多个由所有者配置的 GitHub Copilot 身份接入兼容 OpenAI 和 Anthropic 的 API。
[!WARNING] 本项目通过逆向工程实现,非官方支持;Copilot 变化可能导致失效,过度自动化可能触发滥用控制。请阅读 GitHub 可接受使用政策和 Copilot 条款。
默认仅供可信用户通过回环地址使用,不提供下游用户认证;远程访问须经过认证私有网关。
快速开始
需要 Copilot 订阅及 Node.js >= 22.19.0。使用 setup codex 时,PATH 中还须安装 Codex >= 0.134.0。
npm install --global @jer-y/copilot-proxy@latest
copilot-proxy setup claude按需把 claude 换为 codex 或 openai-sdk。setup 可能更新 copilot-proxy 自身的认证数据,但只打印配置,不写入客户端配置文件,也不启动客户端。
- 在另一个终端执行 setup 输出的完整代理启动命令。
- 自行应用输出的客户端配置,再运行客户端。
- 使用
copilot-proxy doctor检查运行中的服务。
本文对应所在修订版;发布包请使用随包文档,各 CLI 命令保持同一版本。npx、源码安装及故障排查见入门指南;已有安装请先查看升级清单。
能力
- OpenAI 兼容的 Chat Completions、HTTP/SSE Responses、Models 和 Embeddings。
- Anthropic 兼容的 Messages 和 token counting。
- 所选模型明确声明支持时可用的原生 Responses WebSocket。
- 确定性多账号路由、客户端设置、诊断和原生服务管理。
只支持原生协议,不做跨协议翻译、账号负载均衡或自动故障转移。可用性取决于账号、模型、端点和传输,详见协议兼容性。
文档
通过任务索引查找账号、部署、升级、API 和 Dashboard 文档。受支持的拓扑见产品支持;暴露监听器或分享诊断前,请阅读安全策略。
开发
源码开发需要 Git 与 Bun >= 1.3.6。按源码安装准备环境后运行 bun run dev。构建与测试命令集中维护在本地验证。
致谢
最初基于 ericc-ch/copilot-api,此后代码库已进行全面重构。
