最后更新

在 Codex 中使用 GitHub Copilot — 通过 Codex Router 接入 Copilot 模型

在 Codex 中使用 GitHub Copilot,指的是把你账户已经可见的 Copilot 模型接入常规 Codex 模型选择器,而无需硬编码模型清单。github-copilot 供应商是纯目录型:它不内置任何模型,而是通过 GitHub 自己的目录,定制你的套餐和组织策略所暴露的模型。

GitHub CopilotGitHub Copilotaccount catalogPAT

哪些 Copilot 模型会被路由

github-copilot 只接受账户可见、且同时满足以下三项要求的模型:

要求为什么重要
Responses APICodex 使用 Responses 协议;其它接口需要不同的适配器
流式转轮在 token 生成时即流式输出
工具调用Codex 的每个转轮都通过工具调用驱动

由于可用性取决于你的套餐和组织策略,仓库不硬编码任何 Copilot 模型 ID。目录就是你定制时 GitHub 为你账户报告的内容。

创建细粒度令牌

不支持经典 ghp_ 令牌。请在 GitHub personal access tokens 创建带 Copilot Requests 权限的细粒度 GitHub PAT。

  1. 打开个人访问令牌创建页面,选择细粒度令牌。
  2. 授予 Copilot Requests 权限。
  3. 复制生成的 github_pat_ 值并妥善保管。

绝不要把令牌粘贴进对话、命令行参数或受版本控制的文件。隐藏提示会把它保存在路由器的受保护状态中。

启用 GitHub Copilot

通过隐藏提示保存令牌,然后定制实时目录:

./bin/model-router codex provider-key github-copilot set
./bin/curate-models github-copilot

Windows 上用 ./model-router.ps1 codex 加相同命令。对于前台进程,路由器还会按以下顺序回退到环境变量:COPILOT_GITHUB_TOKENGH_TOKENGITHUB_TOKEN

然后完全退出 Codex,重新打开,新建任务,并打开模型选择器。

令牌如何被验证

请求时通过 GitHub 的 Copilot 账户端点验证令牌。该端点同时会选择你的推理主机,路由器仅在该主机属于 GitHub 时才接受。路由器不会读取或复制官方 Copilot CLI 的凭据库。

此集成面向 GitHub.com。路由器不配置 GitHub Enterprise Cloud 的数据驻留主机。

额度与配额

请求会消耗用户的 Copilot 额度。当 GitHub 暴露按用户的计量器时,托盘会显示 AI credit 或旧版配额。不暴露按席位配额的 org 管理套餐则退回到路由器观测到的流量。

验证集成

./bin/model-router codex doctor
./bin/model-router codex providers

github-copilot 必须报告 SHOWready。要对单个模型做实时(消耗配额)检查:

./bin/test-model 'github-copilot/MODEL_ID' --live --yes

如果什么都没有出现,见模型缺失

套餐与策略注意事项

Copilot 目录取决于套餐与策略,且 GitHub 的推理接口可能持续演进。请求消耗你自己的 Copilot 额度,请遵守 GitHub Copilot 条款与可接受使用政策。通过第三方路由器路由 Copilot 风险自负;依赖之前请查阅 GitHub 条款。

常见问题

可以在 Codex 中使用 GitHub Copilot 模型吗? 可以。Codex Router 的 github-copilot 供应商会把账户可见的 Copilot 模型接入常规 Codex 选择器,前提是这些模型明确支持 Responses API、流式响应和工具调用。

经典 ghp_ GitHub 令牌能用于 Codex Router 吗? 不能。Copilot 需要带 Copilot Requests 权限的细粒度 github_pat_ 令牌。不支持经典 ghp_ 令牌。

Codex Router 会读取 Copilot CLI 的凭据库吗? 不会。路由器把你输入的 PAT 保存在自己的受保护状态中,并在请求时通过 GitHub 的 Copilot 账户端点验证。它不会读取或复制官方 Copilot CLI 的凭据库。

相关:模型总览自定义模型安装故障排查