copilot-api-plus

v1.0.23

Published

a day ago

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.

0High
0Medium
0Low

akb447

proxy github-copilot openai-compatible anthropic-compatible opencode-zen google-antigravity claude-code

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 三种后端可选 | | 🤖 双协议兼容 | 同时支持 OpenAI Chat Completions API 和 Anthropic Messages API | | 💻 Claude Code 集成 | 一键生成 Claude Code 启动命令 (--claude-code) | | 📊 使用量监控 | Web 仪表盘实时查看 API 使用情况 | | 🔄 自动认证 | Token 过期自动刷新，无需手动干预 | | ⚡ 速率限制 | 内置请求频率控制，避免触发限制 | | 🌐 代理支持 | 支持 HTTP/HTTPS 代理，配置持久化 | | 🐳 Docker 支持 | 提供完整的 Docker 部署方案 |

🚀 快速开始

安装

# 全局安装
npm install -g copilot-api-plus

# 或使用 npx 直接运行（推荐）
npx copilot-api-plus@latest start

基本用法

# 启动服务器（默认使用 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

服务器启动后，默认监听 http://localhost:4141。

📖 详细使用指南

1. GitHub Copilot 模式（默认）

使用你的 GitHub Copilot 订阅访问 AI 模型。

前置要求

GitHub 账户
有效的 Copilot 订阅（Individual / Business / Enterprise）

启动步骤

npx copilot-api-plus@latest start

首次运行会引导你完成 GitHub OAuth 认证：

终端显示设备码，例如：XXXX-XXXX
打开浏览器访问：https://github.com/login/device
输入设备码，点击授权
返回终端，等待认证完成

认证成功后，Token 会保存到本地，下次启动无需重新认证。

企业/商业账户

# Business 计划
npx copilot-api-plus@latest start --account-type business

# Enterprise 计划  
npx copilot-api-plus@latest start --account-type enterprise

可用模型

| 模型 | ID | 上下文长度 | |------|-----|-----------| | Claude Sonnet 4 | 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 |

2. OpenCode Zen 模式

使用 OpenCode Zen 的多模型 API 服务。

前置要求

访问 https://opencode.ai/zen
注册账号并创建 API Key

启动步骤

方式一：交互式设置

npx copilot-api-plus@latest start --zen

首次运行会提示输入 API Key，保存后下次自动使用。

方式二：直接指定 API Key

npx copilot-api-plus@latest start --zen --zen-api-key YOUR_API_KEY

可用模型

| 模型 | ID | 说明 | |------|-----|------| | Claude Sonnet 4.5 | claude-sonnet-4-5 | Anthropic Claude (200K) | | Claude Opus 4.5 | claude-opus-4-5 | Anthropic Claude (200K) | | GPT-5 Codex | gpt-5-codex | OpenAI Responses API | | Gemini 3 Pro | gemini-3-pro | Google Gemini | | Qwen3 Coder 480B | qwen3-coder | Alibaba Qwen | | Kimi K2 | kimi-k2 | Moonshot | | Grok Code Fast 1 | grok-code | xAI |

更多模型请访问 opencode.ai/zen

管理 API Key

# 查看/更换 API Key（清除后重新启动会提示输入）
npx copilot-api-plus@latest logout --zen

3. Google Antigravity 模式

使用 Google Antigravity API 服务，支持 Gemini 和 Claude 模型。

前置要求

Google 账户

认证方式

方式一：API Key（推荐 - 最简单）

访问 https://aistudio.google.com/apikey 获取 API Key
使用环境变量启动：

# Linux/macOS
GEMINI_API_KEY=your_api_key npx copilot-api-plus@latest start --antigravity

# Windows PowerShell
$env:GEMINI_API_KEY = "your_api_key"
npx copilot-api-plus@latest start --antigravity

# Windows CMD
set GEMINI_API_KEY=your_api_key
npx copilot-api-plus@latest start --antigravity

方式二：OAuth 网页登录（推荐）

npx copilot-api-plus@latest start --antigravity

首次运行会提示选择登录方式：

Web（推荐）：自动打开浏览器完成 Google 登录，授权后自动捕获回调
Manual：手动复制回调 URL 到终端

方式三：自定义 OAuth 凭证

如果遇到 invalid_client 错误，可以创建自己的 OAuth 应用：

访问 https://console.cloud.google.com/apis/credentials
创建 OAuth 2.0 客户端 ID（选择"桌面应用"类型）
添加重定向 URI：http://localhost:8046/callback
使用环境变量或命令行参数：

# 环境变量方式
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 | gemini-2.5-pro-exp-03-25 | 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 账户，系统会在配额用尽时自动切换：

# 添加新账户：重新运行启动命令，选择添加账户
npx copilot-api-plus@latest start --antigravity

# 清除所有账户
npx copilot-api-plus@latest logout --antigravity

🌐 代理配置

如果你需要通过代理访问网络，有两种配置方式：

方式一：持久化配置（推荐）

配置一次，永久生效，下次启动自动使用。

# 交互式配置
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

代理管理命令

# 查看当前代理配置
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 代理

# 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

方式二：环境变量（临时）

仅当次启动生效：

# 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-env

# Windows 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-env

# Windows 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

代理配置优先级

--proxy-env 参数（从环境变量读取）
持久化配置（proxy --set 设置的）
无代理

💻 Claude Code 集成

Claude Code 是 Anthropic 的 AI 编程助手。

自动配置（推荐）

# 使用 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

运行后：

选择主模型（用于代码生成）
选择快速模型（用于后台任务）
启动命令会自动复制到剪贴板
打开新终端，粘贴并运行命令启动 Claude Code

手动配置

在项目根目录创建 .claude/settings.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 服务器后，在该项目目录运行 claude 命令。

🔧 opencode 集成

opencode 是一个现代 AI 编程助手。

配置步骤

在项目根目录创建 opencode.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 }
        }
      }
    }
  }
}

启动 copilot-api-plus：

npx copilot-api-plus@latest start

npx opencode@latest

选择 copilot-api-plus 作为 provider

快捷方式：使用环境变量

# 设置环境变量
export OPENAI_BASE_URL=http://127.0.0.1:4141/v1
export OPENAI_API_KEY=dummy

# 运行 opencode
npx opencode@latest

📡 API 端点

服务器启动后，默认监听 http://localhost:4141。

OpenAI 兼容端点

| 端点 | 方法 | 说明 | |------|------|------| | /v1/chat/completions | POST | 聊天补全（支持流式） | | /v1/models | GET | 模型列表 | | /v1/embeddings | POST | 文本嵌入（仅 Copilot） |

Anthropic 兼容端点

| 端点 | 方法 | 说明 | |------|------|------| | /v1/messages | POST | 消息 API（支持流式） | | /v1/messages/count_tokens | POST | Token 计数 |

专用端点

各后端都有独立的专用路由，即使切换默认后端也能访问：

| 路由前缀 | 说明 | |----------|------| | /copilot/v1/* | GitHub Copilot 专用 | | /zen/v1/* | OpenCode Zen 专用 | | /antigravity/v1/* | Google Antigravity 专用 |

监控端点

| 端点 | 方法 | 说明 | |------|------|------| | /usage | GET | 使用量统计（仅 Copilot） | | /token | GET | 当前 Token 信息 |

调用示例

# 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!"}]
  }'

⚙️ 命令行参考

命令列表

| 命令 | 说明 | |------|------| | start | 启动 API 服务器 | | auth | 仅执行 GitHub 认证流程 | | logout | 清除已保存的凭证 | | proxy | 配置代理设置 | | check-usage | 查看 Copilot 使用量 | | debug | 显示调试信息 |

start 命令参数

| 参数 | 别名 | 默认值 | 说明 | |------|------|--------|------| | --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 | 从环境变量读取代理 |

proxy 命令参数

| 参数 | 说明 | |------|------| | --set | 交互式配置代理 | | --enable | 启用已保存的代理 | | --disable | 禁用代理（保留设置） | | --clear | 清除代理配置 | | --show | 显示当前配置 | | --http-proxy | HTTP 代理 URL | | --https-proxy | HTTPS 代理 URL | | --no-proxy | 不走代理的主机列表 |

logout 命令参数

| 参数 | 别名 | 说明 | |------|------|------| | --github | -g | 仅清除 GitHub Copilot 凭证 | | --zen | -z | 仅清除 Zen 凭证 | | --antigravity | - | 仅清除 Antigravity 凭证 | | --all | -a | 清除所有凭证 |

提示：不带参数运行 logout 会显示交互式菜单供选择。

🐳 Docker 部署

快速启动

# 使用预构建镜像
docker run -p 4141:4141 \
  -v ./copilot-data:/root/.local/share/copilot-api-plus \
  ghcr.io/imbuxiangnan-cyber/copilot-api-plus

自行构建

# 构建镜像
docker build -t copilot-api-plus .

# 运行容器
docker run -p 4141:4141 \
  -v ./copilot-data:/root/.local/share/copilot-api-plus \
  copilot-api-plus

Docker Compose

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

使用代理

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

❓ 常见问题

数据存储位置

所有数据存储在 ~/.local/share/copilot-api-plus/ 目录下：

| 文件 | 说明 | |------|------| | github_token | GitHub Token | | zen-auth.json | Zen API Key | | antigravity-accounts.json | Antigravity 账户 | | config.json | 代理等配置 |

切换账户

# 交互式选择要清除的凭证
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

查看使用量

# 命令行查看（仅 Copilot）
npx copilot-api-plus@latest check-usage

启动服务器后，也可以访问 Web 仪表盘：

https://imbuxiangnan-cyber.github.io/copilot-api-plus?endpoint=http://localhost:4141/usage

调试问题

# 显示调试信息
npx copilot-api-plus@latest debug

# JSON 格式输出
npx copilot-api-plus@latest debug --json

# 启用详细日志
npx copilot-api-plus@latest start --verbose

速率限制

避免触发 GitHub 的滥用检测：

# 设置请求间隔 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

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

Copilot API Plus

📋 目录

✨ 功能特点

🚀 快速开始

安装

基本用法

📖 详细使用指南

1. GitHub Copilot 模式（默认）

前置要求

启动步骤

企业/商业账户

可用模型

2. OpenCode Zen 模式

前置要求

启动步骤

可用模型

管理 API Key

3. Google Antigravity 模式

前置要求

认证方式

可用模型

特性

多账户管理

🌐 代理配置

方式一：持久化配置（推荐）

代理管理命令

示例：配置 Clash 代理

方式二：环境变量（临时）

代理配置优先级

💻 Claude Code 集成

自动配置（推荐）

手动配置

🔧 opencode 集成

配置步骤

快捷方式：使用环境变量

📡 API 端点

OpenAI 兼容端点

Anthropic 兼容端点

专用端点

监控端点

调用示例

⚙️ 命令行参考

命令列表

start 命令参数

proxy 命令参数

logout 命令参数

🐳 Docker 部署

快速启动

自行构建

Docker Compose

使用代理

❓ 常见问题

数据存储位置

切换账户

查看使用量

调试问题

速率限制

⚠️ 免责声明

📄 许可证