Turn GitHub Copilot, OpenCode Zen, or Google Antigravity into OpenAI/Anthropic API compatible server. Fork with bug fixes: auto re-auth, logout support, Zen mode, Antigravity mode, and more.
npm install copilot-api-plus> Fork of ericc-ch/copilot-api with bug fixes and improvements.
将 GitHub Copilot、OpenCode Zen、Google Antigravity 等 AI 服务转换为 OpenAI 和 Anthropic 兼容 API，支持与 Claude Code、opencode 等工具无缝集成。
---
- 功能特点
- 快速开始
- 详细使用指南
- GitHub Copilot 模式
- OpenCode Zen 模式
- Google Antigravity 模式
- 代理配置
- Claude Code 集成
- opencode 集成
- API 端点
- 命令行参考
- Docker 部署
- 常见问题
---
| 功能 | 说明 |
|------|------|
| 🔌 多后端支持 | GitHub Copilot、OpenCode Zen、Google Antigravity 三种后端可选 |
| 🤖 双协议兼容 | 同时支持 OpenAI Chat Completions API 和 Anthropic Messages API |
| 💻 Claude Code 集成 | 一键生成 Claude Code 启动命令 (--claude-code) |
| 📊 使用量监控 | Web 仪表盘实时查看 API 使用情况 |
| 🔄 自动认证 | Token 过期自动刷新，无需手动干预 |
| ⚡ 速率限制 | 内置请求频率控制，避免触发限制 |
| 🌐 代理支持 | 支持 HTTP/HTTPS 代理，配置持久化 |
| 🐳 Docker 支持 | 提供完整的 Docker 部署方案 |
---
``bash全局安装
npm install -g copilot-api-plus
$3
bash
启动服务器（默认使用 GitHub Copilot）
npx copilot-api-plus@latest start使用 OpenCode Zen
npx copilot-api-plus@latest start --zen使用 Google Antigravity
npx copilot-api-plus@latest start --antigravity与 Claude Code 配合
npx copilot-api-plus@latest start --claude-code
`服务器启动后，默认监听
。---
📖 详细使用指南
$3
使用你的 GitHub Copilot 订阅访问 AI 模型。
#### 前置要求
- GitHub 账户
- 有效的 Copilot 订阅（Individual / Business / Enterprise）
#### 启动步骤
`bash
npx copilot-api-plus@latest start
`首次运行会引导你完成 GitHub OAuth 认证：
1. 终端显示设备码，例如：
2. 打开浏览器访问：https://github.com/login/device
3. 输入设备码，点击授权
4. 返回终端，等待认证完成认证成功后，Token 会保存到本地，下次启动无需重新认证。
#### 企业/商业账户
bash
Business 计划
npx copilot-api-plus@latest start --account-type businessEnterprise 计划
npx copilot-api-plus@latest start --account-type enterprise
`#### 可用模型
| 模型 | ID | 上下文长度 |
|------|-----|-----------|
| Claude Sonnet 4 |
| 200K |
| Claude Sonnet 4.5 | claude-sonnet-4.5 | 200K |
| GPT-4.1 | gpt-4.1 | 1M |
| o4-mini | o4-mini | 200K |
| Gemini 2.5 Pro | gemini-2.5-pro | 1M |---
$3
使用 OpenCode Zen 的多模型 API 服务，支持 GPT-5、Claude、Gemini 等顶级编程模型。
#### 前置要求
1. 访问 https://opencode.ai/zen
2. 注册账号并创建 API Key
#### 启动步骤
方式一：交互式设置
`bash
npx copilot-api-plus@latest start --zen
`
首次运行会提示输入 API Key，保存后下次自动使用。方式二：直接指定 API Key
bash
npx copilot-api-plus@latest start --zen --zen-api-key YOUR_API_KEY
`#### 可用模型
| 模型 | ID | 说明 |
|------|-----|------|
| GPT-5.2 |
| OpenAI 最新模型 |
| GPT-5.1 Codex Max | gpt-5.1-codex-max | 代码优化版 |
| GPT-5.1 Codex | gpt-5.1-codex | 代码专用 |
| GPT-5 Codex | gpt-5-codex | OpenAI Responses API |
| Claude Opus 4.5 | claude-opus-4-5 | Anthropic Claude (200K) |
| Claude Sonnet 4.5 | claude-sonnet-4-5 | Anthropic Claude (200K) |
| Claude Sonnet 4 | claude-sonnet-4 | Anthropic Claude |
| Gemini 3 Pro | gemini-3-pro | Google Gemini |
| Qwen3 Coder | qwen3-coder | Alibaba Qwen |
| Kimi K2 | kimi-k2 | Moonshot |
| Grok Code Fast 1 | grok-code-fast-1 | xAI |更多模型请访问 opencode.ai/zen
#### API 端点
Zen 模式支持以下 API 端点：
| 端点 | 说明 |
|------|------|
|
/v1/chat/completions | OpenAI 兼容 Chat API |
| /v1/messages | Anthropic 兼容 Messages API |
| /v1/responses | OpenAI Responses API (GPT-5 系列) |
| /v1/models | 获取可用模型列表 |专用端点（无需
--zen 标志也可访问）：
- /zen/v1/chat/completions
-
-
- #### 管理 API Key
bash
查看/更换 API Key（清除后重新启动会提示输入）
npx copilot-api-plus@latest logout --zen
`---
$3
使用 Google Antigravity API 服务，支持 Gemini 和 Claude 模型。
#### 前置要求
- Google 账户
#### 认证方式
方式一：API Key（推荐 - 最简单）
1. 访问 https://aistudio.google.com/apikey 获取 API Key
2. 使用环境变量启动：
bash
Linux/macOS
GEMINI_API_KEY=your_api_key npx copilot-api-plus@latest start --antigravityWindows PowerShell
$env:GEMINI_API_KEY = "your_api_key"
npx copilot-api-plus@latest start --antigravityWindows CMD
set GEMINI_API_KEY=your_api_key
npx copilot-api-plus@latest start --antigravity
`方式二：OAuth 网页登录（推荐）
bash
npx copilot-api-plus@latest start --antigravity
`首次运行会提示选择登录方式：
- Web（推荐）：自动打开浏览器完成 Google 登录，授权后自动捕获回调
- Manual：手动复制回调 URL 到终端
方式三：自定义 OAuth 凭证
如果遇到
错误，可以创建自己的 OAuth 应用：1. 访问 https://console.cloud.google.com/apis/credentials
2. 创建 OAuth 2.0 客户端 ID（选择"桌面应用"类型）
3. 添加重定向 URI：
http://localhost:8046/callback
4. 使用环境变量或命令行参数：bash
环境变量方式
ANTIGRAVITY_CLIENT_ID=your_client_id ANTIGRAVITY_CLIENT_SECRET=your_secret \
npx copilot-api-plus@latest start --antigravity命令行参数方式
npx copilot-api-plus@latest start --antigravity \
--antigravity-client-id your_client_id \
--antigravity-client-secret your_secret
`#### 可用模型
| 模型 | ID | 说明 |
|------|-----|------|
| Gemini 2.5 Pro |
| Google Gemini |
| Gemini 2.5 Pro Preview | gemini-2.5-pro-preview-05-06 | Google Gemini |
| Gemini 2.0 Flash | gemini-2.0-flash-exp | 快速响应 |
| Gemini 2.0 Flash Thinking | gemini-2.0-flash-thinking-exp | 支持思考链 |
| Claude Opus 4.5 | claude-opus-4-5 | Anthropic Claude |
| Claude Sonnet 4.5 | claude-sonnet-4-5 | Anthropic Claude |#### 特性
- ✅ 自动 Token 刷新
- ✅ 多账户支持，自动轮换
- ✅ 配额用尽自动切换账户
- ✅ 支持 Thinking 模型（思考链输出）
#### 多账户管理
可以添加多个 Google 账户，系统会在配额用尽时自动切换：
`bash
添加新账户
npx copilot-api-plus@latest antigravity add列出所有账户
npx copilot-api-plus@latest antigravity list按索引删除账户
npx copilot-api-plus@latest antigravity remove 0清除所有账户
npx copilot-api-plus@latest antigravity clear
或使用 logout 命令
npx copilot-api-plus@latest logout --antigravity
`---
🌐 代理配置
如果你需要通过代理访问网络，有两种配置方式：
$3
配置一次，永久生效，下次启动自动使用。
bash
交互式配置
npx copilot-api-plus@latest proxy --set或直接设置
npx copilot-api-plus@latest proxy --http-proxy http://127.0.0.1:7890同时设置 HTTP 和 HTTPS 代理
npx copilot-api-plus@latest proxy --http-proxy http://127.0.0.1:7890 --https-proxy http://127.0.0.1:7890
`#### 代理管理命令
bash
查看当前代理配置
npx copilot-api-plus@latest proxy启用代理
npx copilot-api-plus@latest proxy --enable禁用代理（保留设置）
npx copilot-api-plus@latest proxy --disable清除代理配置
npx copilot-api-plus@latest proxy --clear
`#### 示例：配置 Clash 代理
bash
Clash 默认端口 7890
npx copilot-api-plus@latest proxy --http-proxy http://127.0.0.1:7890验证配置
npx copilot-api-plus@latest proxy
输出：
Current proxy configuration:
Status: ✅ Enabled
HTTP_PROXY: http://127.0.0.1:7890
HTTPS_PROXY: http://127.0.0.1:7890
`$3
仅当次启动生效：
bash
Linux/macOS
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
npx copilot-api-plus@latest start --proxy-envWindows PowerShell
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
npx copilot-api-plus@latest start --proxy-envWindows CMD
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890
npx copilot-api-plus@latest start --proxy-env
`$3
1.
参数（从环境变量读取）
2. 持久化配置（proxy --set 设置的）
3. 无代理---
💻 Claude Code 集成
Claude Code 是 Anthropic 的 AI 编程助手。
$3
`bash
使用 GitHub Copilot 作为后端
npx copilot-api-plus@latest start --claude-code使用 OpenCode Zen 作为后端
npx copilot-api-plus@latest start --zen --claude-code使用 Google Antigravity 作为后端
npx copilot-api-plus@latest start --antigravity --claude-code
`运行后：
1. 选择主模型（用于代码生成）
2. 选择快速模型（用于后台任务）
3. 启动命令会自动复制到剪贴板
4. 打开新终端，粘贴并运行命令启动 Claude Code
$3
在项目根目录创建
：`json
{
"env": {
"ANTHROPIC_BASE_URL": "http://localhost:4141",
"ANTHROPIC_AUTH_TOKEN": "dummy",
"ANTHROPIC_MODEL": "claude-sonnet-4",
"ANTHROPIC_SMALL_FAST_MODEL": "gpt-4.1",
"DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1"
}
}
`然后启动 copilot-api-plus 服务器后，在该项目目录运行
命令。---
🔧 opencode 集成
opencode 是一个现代 AI 编程助手。
$3
1. 在项目根目录创建
opencode.json：`json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"copilot-api-plus": {
"api": "openai-compatible",
"name": "Copilot API Plus",
"options": {
"baseURL": "http://127.0.0.1:4141/v1"
},
"models": {
"claude-sonnet-4": {
"name": "Claude Sonnet 4",
"id": "claude-sonnet-4",
"max_tokens": 64000,
"profile": "coder",
"limit": { "context": 200000 }
},
"gpt-4.1": {
"name": "GPT-4.1",
"id": "gpt-4.1",
"max_tokens": 32768,
"profile": "coder",
"limit": { "context": 1047576 }
}
}
}
}
}
`2. 启动 copilot-api-plus：
bash
npx copilot-api-plus@latest start
`3. 在同一目录运行 opencode：
bash
npx opencode@latest
`4. 选择
作为 provider$3
`bash
设置环境变量
export OPENAI_BASE_URL=http://127.0.0.1:4141/v1
export OPENAI_API_KEY=dummy运行 opencode
npx opencode@latest
`---
📡 API 端点
服务器启动后，默认监听
。$3
| 端点 | 方法 | 说明 |
|------|------|------|
|
/v1/chat/completions | POST | 聊天补全（支持流式） |
| /v1/models | GET | 模型列表 |
| /v1/embeddings | POST | 文本嵌入（仅 Copilot） |$3
| 端点 | 方法 | 说明 |
|------|------|------|
|
/v1/messages | POST | 消息 API（支持流式） |
| /v1/messages/count_tokens | POST | Token 计数 |$3
各后端都有独立的专用路由，即使切换默认后端也能访问：
| 路由前缀 | 说明 |
|----------|------|
|
/copilot/v1/* | GitHub Copilot 专用 |
| /zen/v1/* | OpenCode Zen 专用 |
| /antigravity/v1/* | Google Antigravity 专用 |$3
| 端点 | 方法 | 说明 |
|------|------|------|
|
/usage | GET | 使用量统计（仅 Copilot） |
| /token | GET | 当前 Token 信息 |$3
`bash
OpenAI 格式
curl http://localhost:4141/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4",
"messages": [{"role": "user", "content": "Hello!"}]
}'Anthropic 格式
curl http://localhost:4141/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: dummy" \
-d '{
"model": "claude-sonnet-4",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
`---
⚙️ 命令行参考
$3
| 命令 | 说明 |
|------|------|
|
| 启动 API 服务器 |
| auth | 仅执行 GitHub 认证流程 |
| logout | 清除已保存的凭证 |
| proxy | 配置代理设置 |
| antigravity | 管理 Google Antigravity 账户 |
| check-usage | 查看 Copilot 使用量 |
| debug | 显示调试信息 |$3
| 参数 | 别名 | 默认值 | 说明 |
|------|------|--------|------|
|
--port | -p | 4141 | 监听端口 |
| --verbose | -v | false | 详细日志 |
| --account-type | -a | individual | 账户类型 (individual/business/enterprise) |
| --claude-code | -c | false | 生成 Claude Code 启动命令 |
| --zen | -z | false | 启用 OpenCode Zen 模式 |
| --zen-api-key | - | - | Zen API Key |
| --antigravity | - | false | 启用 Google Antigravity 模式 |
| --antigravity-client-id | - | - | Antigravity OAuth Client ID |
| --antigravity-client-secret | - | - | Antigravity OAuth Client Secret |
| --rate-limit | -r | - | 请求间隔（秒） |
| --wait | -w | false | 达到限制时等待而非报错 |
| --manual | - | false | 手动审批每个请求 |
| --github-token | -g | - | 直接提供 GitHub Token |
| --show-token | - | false | 显示 Token 信息 |
| --proxy-env | - | false | 从环境变量读取代理 |$3
| 参数 | 说明 |
|------|------|
|
--set | 交互式配置代理 |
| --enable | 启用已保存的代理 |
| --disable | 禁用代理（保留设置） |
| --clear | 清除代理配置 |
| --show | 显示当前配置 |
| --http-proxy | HTTP 代理 URL |
| --https-proxy | HTTPS 代理 URL |
| --no-proxy | 不走代理的主机列表 |$3
| 参数 | 别名 | 说明 |
|------|------|------|
|
--github | -g | 仅清除 GitHub Copilot 凭证 |
| --zen | -z | 仅清除 Zen 凭证 |
| --antigravity | - | 仅清除 Antigravity 凭证 |
| --all | -a | 清除所有凭证 |> 提示：不带参数运行
logout 会显示交互式菜单供选择。$3
管理 Google Antigravity 账户的子命令：
| 子命令 | 说明 |
|--------|------|
|
add | 添加新的 Antigravity 账户（OAuth 登录） |
| list | 列出所有已配置的账户及其状态 |
| remove | 按索引删除指定账户 |
| clear | 清除所有 Antigravity 账户（需确认） |`bash
示例
npx copilot-api-plus@latest antigravity add # 添加账户
npx copilot-api-plus@latest antigravity list # 列出账户
npx copilot-api-plus@latest antigravity remove 0 # 删除索引为 0 的账户
npx copilot-api-plus@latest antigravity clear # 清除所有账户
`---
🐳 Docker 部署
$3
bash
使用预构建镜像
docker run -p 4141:4141 \
-v ./copilot-data:/root/.local/share/copilot-api-plus \
ghcr.io/imbuxiangnan-cyber/copilot-api-plus
`$3
bash
构建镜像
docker build -t copilot-api-plus .运行容器
docker run -p 4141:4141 \
-v ./copilot-data:/root/.local/share/copilot-api-plus \
copilot-api-plus
`$3
yaml
version: "3.8"
services:
copilot-api-plus:
build: .
ports:
- "4141:4141"
volumes:
- ./copilot-data:/root/.local/share/copilot-api-plus
environment:
- GH_TOKEN=your_github_token # 可选
restart: unless-stopped
`$3
bash
docker run -p 4141:4141 \
-e HTTP_PROXY=http://host.docker.internal:7890 \
-e HTTPS_PROXY=http://host.docker.internal:7890 \
-v ./copilot-data:/root/.local/share/copilot-api-plus \
copilot-api-plus start --proxy-env
`---
❓ 常见问题
$3
所有数据存储在
目录下：| 文件 | 说明 |
|------|------|
|
github_token | GitHub Token |
| zen-auth.json | Zen API Key |
| antigravity-accounts.json | Antigravity 账户 |
| config.json | 代理等配置 |$3
`bash
交互式选择要清除的凭证
npx copilot-api-plus@latest logout仅清除 GitHub Copilot 凭证
npx copilot-api-plus@latest logout --github
或简写
npx copilot-api-plus@latest logout -g清除 Zen 凭证
npx copilot-api-plus@latest logout --zen清除 Antigravity 凭证
npx copilot-api-plus@latest logout --antigravity清除所有凭证
npx copilot-api-plus@latest logout --all
`$3
bash
命令行查看（仅 Copilot）
npx copilot-api-plus@latest check-usage
`启动服务器后，也可以访问 Web 仪表盘：
https://imbuxiangnan-cyber.github.io/copilot-api-plus?endpoint=http://localhost:4141/usage
$3
bash
显示调试信息
npx copilot-api-plus@latest debugJSON 格式输出
npx copilot-api-plus@latest debug --json启用详细日志
npx copilot-api-plus@latest start --verbose
`$3
避免触发 GitHub 的滥用检测：
bash
设置请求间隔 30 秒
npx copilot-api-plus@latest start --rate-limit 30达到限制时等待而非报错
npx copilot-api-plus@latest start --rate-limit 30 --wait手动审批每个请求
npx copilot-api-plus@latest start --manual
``---
> [!WARNING]
> 这是 GitHub Copilot API 的逆向工程代理。不受 GitHub 官方支持，可能随时失效。使用风险自负。
> [!WARNING]
> GitHub 安全提示：过度的自动化或脚本化使用 Copilot 可能触发 GitHub 的滥用检测系统，导致 Copilot 访问被暂停。请负责任地使用。
>
> 相关政策：
> - GitHub 可接受使用政策
> - GitHub Copilot 条款
---
MIT License