copilot-api

把 Copilot 订阅变成 OpenAI 兼容 API，一行代码接入现有应用

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署基础设施 🍴 复刻 251 👀 关注 4

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1116

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，需自行部署。

项目预览

copilot-api 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类基础设施

开发团队caozhiyuan

官网地址https://caozhiyuan.github.io/copilot-api

GitHubhttps://github.com/caozhiyuan/copilot-api

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，需自行部署。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型anthropic-compatible,github-copilot,openai-responses

GitHub 星标★ 1116

上线时间2025-08-20 00:00:00

代码更新2026-11-08

仓库体积8.1 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数9

项目介绍

copilot-api 是一个统一 AI 网关，将 GitHub Copilot、OpenAI Codex、OpenCode Go 等订阅制 AI 服务转换为 OpenAI 和 Anthropic 兼容的 API。它解决了开发者无法直接使用 Copilot 等服务的 API 问题，通过一个轻量级网关，让现有基于 OpenAI SDK 的应用无缝接入这些订阅服务，同时支持第三方 AI 提供商。核心能力包括多服务适配、协议转换、请求路由和密钥管理，并提供与 OpenAI/Anthropic 一致的接口，降低迁移成本。项目基于 TypeScript 开发，适合个人开发者和小团队快速集成多种 AI 能力，但当前处于早期阶段，生态和文档尚待完善。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1116

技术标签

github-copilot

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node.js >= 22.13.0 或 Bun >= 1.2.x
需要能使用 npx（随 Node.js/npm 提供）
Token 用量统计功能需要 Node.js >= 22.13.0 或 Bun
可选：一个 GitHub Copilot 订阅账号用于登录认证

安装与启动步骤

1确认运行环境

确认本机已安装 Node.js >= 22.13.0 或 Bun >= 1.2.x；若只需网关本身，低版本也能跑，但 token 用量统计不可用。
```
node -v
```
2登录 GitHub Copilot

可选步骤。若要用 Copilot 订阅额度，先执行登录，按提示在浏览器完成授权；也可改用第三方提供商。
```
npx @jeffreycao/copilot-api@latest auth login
```
3启动网关服务

启动后服务默认监听 http://localhost:4141，保持该终端窗口不要关闭。
```
npx @jeffreycao/copilot-api@latest start
```
4验证网关是否可用

新开一个终端窗口执行，返回模型列表即表示网关已正常启动。
```
curl http://localhost:4141/v1/models
```
5配置 Claude Code（交互式）

带 --claude-code 启动会自动匹配各档位最新模型，生成设置环境变量的命令并复制到剪贴板，粘贴到新终端运行即可。
```
npx @jeffreycao/copilot-api@latest start --claude-code
```
6配置 Claude Code（手动）

在项目根目录创建 .claude/settings.json，按示例填写 env 中的 ANTHROPIC_BASE_URL 等变量，避免每次重新交互配置。
7配置 OpenCode

用 OpenCode OAuth 应用完成认证后再启动网关，然后在 opencode.json 中把 baseURL 指向网关。
```
npx @jeffreycao/copilot-api@latest auth --oauth-app=opencode
npx @jeffreycao/copilot-api@latest start
```

关键配置

配置项	必填	说明	示例
`ANTHROPIC_BASE_URL`	是	Claude Code 请求的网关地址	`http://localhost:4141`
`ANTHROPIC_AUTH_TOKEN`	否	Claude Code 调用网关时的鉴权令牌	`dummy`
`ANTHROPIC_MODEL`	否	Claude Code 默认使用的模型名	`gpt-5.6-sol[1m]`
`modelMappings`	否	把纯模型名映射回 codex 等提供商路由	`{"gpt-5.6-sol":"codex/gpt-5.6-sol"}`
`provider.local.options.baseURL`	否	OpenCode 中指向网关的接口地址	`http://localhost:4141/v1`
`provider.local.options.apiKey`	否	OpenCode 调用网关时的鉴权密钥	`dummy`

如何确认成功

执行 curl http://localhost:4141/v1/models，能返回模型列表就说明网关已在 4141 端口正常启动。

常见问题

Q：Claude Code 里模型名写成 codex/xxx 会怎样？

A：Claude Code 会把 codex/ 前缀当特殊模式并降级处理，例如每次请求都丢弃之前的思考块。建议用纯模型名，并在 config.json 的 modelMappings 中映射回 codex 路由。

Q：为什么要关掉 CLAUDE_CODE_TOTAL_TOKENS_REMINDER？

A：它会把 <total_tokens> 提示块注入对话，而默认预算 15,000,000 token 意义不大，README 建议设为 off 关闭。

Q：OpenCode 为什么必须用 @ai-sdk/anthropic？

A：这样 OpenCode 会用 Anthropic Messages 语义与网关通信，而不是把所有请求压平成 OpenAI Chat Completions。

Q：使用非 Claude 模型时有什么要注意的？

A：不要开启 ENABLE_TOOL_SEARCH；只有使用 Claude 模型时才可开启。

Q：Token 用量统计为什么不可用？

A：该功能需要 Node.js >= 22.13.0 或 Bun 运行环境，版本过低时无法记录用量。

注意事项

网关默认监听 http://localhost:4141，Claude Code 的 ANTHROPIC_BASE_URL 不要带 /v1 后缀，OpenCode 的 baseURL 才需要带 /v1。
全程通过 npx 运行，无需全局安装，第一次执行会自动下载 npm 包。
使用 Codex 提供商时不要用 codex/xxx 格式配置模型名，改用纯模型名加 modelMappings。
设置 CLAUDE_CODE_ATTRIBUTION_HEADER 为 0 可避免系统提示中写入计费与版本信息导致提示缓存失效。