简介
copilot-api 是一个反向工程实现的 GitHub Copilot API 代理,能将 Copilot 封装为兼容 OpenAI 和 Anthropic 规范的 API 服务。用户可在任意支持该规范的工具中调用 Copilot 能力,打破原生 IDE 限制。
核心价值
- 复用 Copilot 订阅:无需额外购买其他 AI 服务,在 Raycast、Claude Code 等工具中复用 Copilot 能力。
- 降低使用成本:适合拥有 GitHub 学生包免费 Copilot 的用户,实现多场景使用。
- 融入工具链:弥补 Copilot 原生无标准 API 的短板,提升开发流程连贯性。
注意:该项目为非官方代理,并非 GitHub 官方支持,使用时需遵守 GitHub 的可接受使用政策,避免过度自动化请求触发风控。
核心特性
1. 双生态兼容
完美实现 OpenAI 兼容接口(/v1/chat/completions 等)和 Anthropic 兼容接口(/v1/messages 等)。只要工具支持这两大主流 API 规范,就能直接接入 Copilot。
2. 深度集成 Claude Code
通过 --claude-code 命令行标识,可一键生成 Claude Code 的配置命令,快速将 Copilot 设为后端服务;也可通过配置 .claude/settings.json 文件实现永久生效。
3. 精细化流量控制
针对 GitHub Copilot 的速率限制,提供多重防护机制:
--rate-limit:设置请求间隔(秒),强制控制请求频率。--wait:触发速率限制时自动等待冷却。--manual:手动审批每一个 API 请求。
4. 可视化监控
内置 Web 版使用仪表盘,启动服务后可通过控制台输出的 URL 直接访问,支持查看配额、请求统计、令牌状态等。
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
方式 2:Docker 容器部署
使用源码中的 Dockerfile:
# 构建镜像
docker build -t copilot-api .
# 启动容器,映射 4141 端口
docker run -p 4141:4141 copilot-api

