简介
copilot-api 是由 ericc-ch 开发的 GitHub Copilot API 代理项目,通过反向工程实现,将 Copilot 封装为兼容 OpenAI 和 Anthropic 规范的 API 服务。这使得用户可以在任意支持该规范的工具中调用 Copilot 能力。
核心功能
GitHub Copilot 原生仅支持 VS Code、JetBrains 等少数 IDE,且无公开的标准 API 接口。copilot-api 的核心作用是架起 Copilot 与 OpenAI/Anthropic 生态的桥梁:
- 对于拥有 Copilot 订阅(个人/企业/商业版)的开发者,无需额外购买其他 AI 服务,就能在 Raycast、Claude Code 等工具中复用 Copilot 能力;
- 弥补了 Copilot 原生无标准 API 的短板,让 Copilot 融入现有 AI 工具链,提升开发流程的连贯性。
需要注意的是,该项目是反向工程实现的非官方代理,并非 GitHub 官方支持,使用时需遵守 GitHub 的可接受使用政策,避免过度自动化请求触发风控。
主要特性
copilot-api 围绕开发者实际使用需求做了全方位优化,核心特性覆盖兼容性、可控性、可观测性等多个维度:
1. 双生态兼容,无缝对接海量工具
完美实现 OpenAI 兼容接口(/v1/chat/completions、/v1/models、/v1/embeddings)和 Anthropic 兼容接口(/v1/messages、/v1/messages/count_tokens),只要工具支持这两大主流 API 规范,就能直接接入 Copilot,无需修改任何代码。
2. 深度集成 Claude Code,赋能开发者助手
通过 --claude-code 命令行标识,可一键生成 Claude Code 的配置命令,快速将 Copilot 设为 Claude Code 的后端服务;也可通过配置 .claude/settings.json 文件实现永久生效。
3. 精细化流量控制,规避风控限制
针对 GitHub Copilot 的速率限制,提供多重防护机制,避免因请求过于频繁导致账户被限制:
--rate-limit:设置请求间隔(秒),强制控制请求频率;--wait:触发速率限制时自动等待冷却,而非直接报错;--manual:手动审批每一个 API 请求,实现精细化流量管控。
4. 可视化监控,实时掌握使用状态
内置 Web 版使用仪表盘,启动服务后可通过控制台输出的 URL 直接访问,支持查看 Copilot 的使用配额、请求统计、令牌状态等核心信息。
5. 灵活的认证与部署,适配多环境
- 认证方式:支持交互式认证,也可通过
auth子命令生成令牌,配合--github-token实现无交互认证,适配 CI/CD 等自动化环境; - 部署方式:支持本地直接运行、Docker 容器部署、npx 一键启动,无需复杂的环境配置;
- 账户支持:兼容个人、商业、企业三种 GitHub Copilot 账户类型,通过
--account-type即可快速切换。
6. 调试友好,提升问题排查效率
提供 --show-token 标识,可在认证和令牌刷新时显示 GitHub 和 Copilot 令牌,方便开发者排查认证相关问题;配合 --verbose 日志标识,能查看详细的请求和服务运行日志。
部署指南
copilot-api 的使用门槛极低,仅需满足两个前置条件:Bun(≥1.2.x) 运行环境、拥有 Copilot 订阅的 GitHub 账户。
方式 1:npx 一键启动(推荐,无需安装)
# 基础启动,默认端口 4141
npx copilot-api@latest start
# 自定义端口 + 详细日志
npx copilot-api@latest start --port 8080 --verbose
npx copilot-api@latest start --account-type enterprise --rate-limit 30 --

