copilot-api

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

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

开源 free 基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1047

维护状态活跃

是否开源是

定价模式 free

项目数据

分类基础设施

开发团队caozhiyuan

所属国家

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

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

定价模式free

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

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-gateway,anthropic-compatible,codex,github-copilot,openai-responses,opencode

GitHub 星标★ 1047

30天Star增速

HF 下载量

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

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数8

使用教程

难度：入门约 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：它会把提示块注入对话，而默认预算 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 可避免系统提示中写入计费与版本信息导致提示缓存失效。

核心亮点

支持 GitHub Copilot、OpenAI Codex 等多种订阅服务，统一转换为标准 API
兼容 OpenAI 和 Anthropic 协议，可直接替换现有 SDK 的 base_url
轻量级 TypeScript 实现，部署简单，适合个人和中小团队快速上手

不足之处

早期项目，文档和社区支持尚不完善
依赖第三方订阅服务的稳定性，存在被官方封禁的风险

适用场景

将 Copilot 订阅能力暴露给内部工具或自动化脚本
在现有 OpenAI 应用中低成本切换多种 AI 后端
统一管理多个 AI 提供商的密钥和请求路由

替代项目

one-api、new-api、LiteLLM

项目介绍

copilot-api 是基础设施领域的开源项目，由 caozhiyuan 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,047）位列前 30%，在基础设施分类中处于中上游。

近 42 天，它的 GitHub 星标从 963 增加到 1,047，净增 84。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，需自行部署。

它主要面向的使用场景是：将Copilot订阅能力暴露给内部工具或自动化脚本。同类可对比的替代方案包括 one-api、new-api、LiteLLM。

上一篇：GoModel

下一篇：router