在 Codex 中使用 GitHub Copilot — 通过 Codex Router 接入 Copilot 模型
在 Codex 中使用 GitHub Copilot,指的是把你账户已经可见的 Copilot 模型接入常规 Codex 模型选择器,而无需硬编码模型清单。github-copilot 供应商是纯目录型:它不内置任何模型,而是通过 GitHub 自己的目录,定制你的套餐和组织策略所暴露的模型。
哪些 Copilot 模型会被路由
github-copilot 只接受账户可见、且同时满足以下三项要求的模型:
| 要求 | 为什么重要 |
|---|---|
| Responses API | Codex 使用 Responses 协议;其它接口需要不同的适配器 |
| 流式 | 转轮在 token 生成时即流式输出 |
| 工具调用 | Codex 的每个转轮都通过工具调用驱动 |
由于可用性取决于你的套餐和组织策略,仓库不硬编码任何 Copilot 模型 ID。目录就是你定制时 GitHub 为你账户报告的内容。
创建细粒度令牌
不支持经典 ghp_ 令牌。请在 GitHub personal access tokens 创建带 Copilot Requests 权限的细粒度 GitHub PAT。
- 打开个人访问令牌创建页面,选择细粒度令牌。
- 授予 Copilot Requests 权限。
- 复制生成的
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_TOKEN、GH_TOKEN、GITHUB_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 必须报告 SHOW 与 ready。要对单个模型做实时(消耗配额)检查:
./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 的凭据库。