Coxy - GitHub Copilot OpenAI 兼容代理

Coxy 是一个将 GitHub Copilot 转换为 OpenAI 兼容 API 的代理服务，让你可以在任何支持 OpenAI API 的工具中使用 GitHub Copilot。

项目简介

Coxy 由开发者 Hank Chiu 创建，是一个开源的 GitHub Copilot API 代理项目。截至目前，该项目在 GitHub 上已获得 53 stars，主要使用 TypeScript 编写。

核心特性

• OpenAI 兼容接口：支持 /chat/completions 和 /models 端点
• 管理后台 UI：友好的 Web 界面管理 API 令牌
• 多令牌支持：轻松管理多个 GitHub 令牌
• 使用统计：查看聊天消息的使用统计数据
• 内置聊天机器人：简单的聊天界面用于模型评估

技术栈

• 后端: Node.js 22+ / Express / Prisma
• 前端: React / TypeScript
• 数据库: SQLite (通过 Prisma)
• 部署: Docker / Vercel

安装指南

前置要求

• Node.js 22 或更高版本
• GitHub 账号并开通 Copilot 订阅

使用 Docker（推荐）

# 拉取并运行
docker run -p 3000:3000 ghcr.io/coxy-proxy/coxy:latest

# 持久化数据和配置
docker run -p 3000:3000 -v /path/to/coxy.db:/app/coxy.db -v /path/to/.env:/app/.env ghcr.io/coxy-proxy/coxy:latest --provision

使用 pnpm/npx

# 使用 pnpm 运行
pnpx coxy

# 或使用 npx
npx coxy

快速开始

1. 启动服务后访问 http://localhost:3000
2. 登录 GitHub 并生成 API 令牌
3. 设置默认令牌
4. 使用 OpenAI 兼容端点：

curl --request POST \
  --url http://localhost:3000/api/chat/completions \
  --header 'content-type: application/json' \
  --data '{
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "Hi"}]
  }'

使用场景

• 本地 LLM CLI：搭配各种本地大语言模型命令行工具使用
• Open WebUI：通过 OpenAI 兼容接口与 GitHub Copilot 对话
• 超越 VS Code：在更多场景中使用 GitHub Copilot 的算力

环境变量

注意事项

• 确保在 GitHub 账户设置中启用了「OpenAI GPT-5 mini」选项
• 首次运行需要使用 --provision 参数初始化数据库
• 使用 podman 时可能需要使用 127.0.0.1:3000 而非 localhost:3000

项目链接

• GitHub 仓库：coxy-proxy/coxy
• 官方网站：coxy.vercel.app

本文介绍了一个实用的开源工具，帮助开发者更灵活地使用 GitHub Copilot 的免费配额。