GitHub Copilot CLI ↗ 支持通过环境变量配置的 bring-your-own-key（BYOK）模型提供商。通过 AI Gateway 的 REST API 路由 — 这是一个与 OpenAI 兼容的 /chat/completions 端点，使用 Cloudflare API 令牌进行身份验证。第三方模型通过 Unified Billing 计费，因此环境中无需提供商 API 密钥。或者，你也可以使用 BYOK (Store Keys) 将自己的提供商 API 密钥存储在 AI Gateway 中，并使用同一 Cloudflare API 令牌进行身份验证 — AI Gateway 会在每次请求时解析已存储的密钥。
与 Claude Code 不同，GitHub Copilot CLI 使用单个 Authorization 标头对模型提供商进行身份验证，且无法发送自定义请求标头。这就是配置使用 REST API 的原因 — 它在标准 Authorization 标头中接受 Cloudflare API 令牌 — 而不是 Claude Code 所用的 gateway 令牌和 cf-aig-authorization 标头流程。由于 Copilot CLI 也无法设置 cf-aig-gateway-id 标头，请求会通过账户的默认 gateway 路由。
开始之前，你需要：
- 已安装 GitHub Copilot CLI。安装方法请参阅 Installing GitHub Copilot CLI ↗。
- 具有
AI Gateway权限的 Cloudflare API 令牌。 - 账户上已为第三方模型加载积分。
- 支持工具调用（tool calling）和流式传输的模型。为获得最佳效果，请使用上下文窗口至少为 128k token 的模型。
-
设置提供商环境变量。GitHub Copilot CLI 在启动时读取这些变量，并将
/chat/completions追加到 base URL。这些命令为当前会话设置变量。若要持久化，请将其添加到 shell 配置文件（例如~/.zshrc或~/.bashrc）。将
<ACCOUNT_ID>替换为你的 Cloudflare 账户 ID，将<CF_API_TOKEN>替换为你的 Cloudflare API 令牌。将COPILOT_MODEL设为provider/model格式的任意受支持模型。export COPILOT_PROVIDER_TYPE="openai" export COPILOT_PROVIDER_BASE_URL="https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai/v1" export COPILOT_PROVIDER_API_KEY="<CF_API_TOKEN>" export COPILOT_MODEL="openai/gpt-4.1"$env:COPILOT_PROVIDER_TYPE = "openai" $env:COPILOT_PROVIDER_BASE_URL = "https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai/v1" $env:COPILOT_PROVIDER_API_KEY = "<CF_API_TOKEN>" $env:COPILOT_MODEL = "openai/gpt-4.1" -
启动 GitHub Copilot CLI 并发送提示。请求现在会通过 AI Gateway 路由。
copilot
要确认流量已到达 AI Gateway，请参阅验证是否生效。