GitHub Copilot 兼容 API 方案:copilot-api 使用指南
GitHub Copilot 原生仅支持 VS Code、JetBrains 等少数 IDE,且无公开的标准 API 接口。开源项目 copilot-api 通过反向工程实现 GitHub Copilot API 代理,将其封装为兼容 OpenAI 和 Anthropic 规范的 API 服务,允许在任意支持该规范的工具中调用 Copilot 能力。
核心价值
- 复用订阅:拥有 Copilot 订阅的开发者可在 Raycast、Claude Code 等工具中复用 Copilot 能力,无需额外购买其他 AI 服务。
- 降低门槛:学生群体可通过 GitHub 学生包免费获取的 Copilot,借助该代理实现多场景使用。
- 生态融合:弥补 Copilot 原生无标准 API 的短板,让 Copilot 融入现有 AI 工具链。
注意:该项目为非官方代理,使用时需遵守 GitHub 的可接受使用政策,避免过度自动化请求触发风控。
核心特性
1. 双生态兼容
完美实现 OpenAI 兼容接口(/v1/chat/completions 等)和 Anthropic 兼容接口(/v1/messages 等),只要工具支持这两大主流 API 规范即可接入。
2. 深度集成 Claude Code
通过 --claude-code 命令行标识,可一键生成 Claude Code 的配置命令,快速将 Copilot 设为后端服务。
3. 精细化流量控制
提供多重防护机制规避速率限制:
--rate-limit:设置请求间隔(秒)。--wait:触发速率限制时自动等待冷却。--manual:手动审批每一个 API 请求。
4. 可视化监控
内置 Web 版使用仪表盘,可查看 Copilot 的使用配额、请求统计、令牌状态等核心信息。
5. 灵活的认证与部署
- 认证方式:支持交互式认证或通过
auth子命令生成令牌,配合--github-token实现无交互认证。 - 部署方式:支持本地直接运行、Docker 容器部署、npx 一键启动。
- 账户支持:兼容个人、商业、企业三种 GitHub Copilot 账户类型。
6. 调试友好
提供 --show-token 标识显示令牌,配合 --verbose 日志标识查看详细运行日志。
快速上手
前置条件:Bun(≥1.2.x) 运行环境、拥有 Copilot 订阅的 GitHub 账户。
方式 1:npx 一键启动
# 基础启动,默认端口 4141
npx copilot-api@latest start
# 自定义端口 + 详细日志
npx copilot-api@latest start --port 8080 --verbose
# 企业版账户 +30 秒请求间隔 + 自动等待
npx copilot-api@latest start --account-type enterprise --rate-limit 30 --wait

