Copilot CLI

官方主页：github.com/features/copilot/cli
安装文档：docs.github.com - Install Copilot CLI
网关配置：Using your own LLM models
协议类型：OpenAI 兼容（BYOK，自带模型提供商）

安装

GitHub Copilot CLI 支持 macOS、Linux 与 Windows。其余写法以官方安装文档为准。

npm 安装（全平台）（需 Node.js 22+）

npm install -g @github/copilot

Homebrew（macOS / Linux）

brew install copilot-cli

WinGet（Windows）

winget install GitHub.Copilot

安装脚本（macOS / Linux）

curl -fsSL https://gh.io/copilot-install | bash

安装完成后用 copilot --version 确认。

对接 TokenBay

对接机制

Copilot CLI 默认使用 GitHub 托管的模型。官方提供 BYOK（Bring Your Own Key） 能力，可改用自带的模型提供商——通过启动前设置一组 COPILOT_PROVIDER_* 环境变量来切换。TokenBay 走其中的 OpenAI 兼容类型（COPILOT_PROVIDER_TYPE 的默认值即 openai）。

接入要点：

COPILOT_PROVIDER_BASE_URL 填 TokenBay 的 OpenAI 兼容端点根 https://api.tokenbay.com/v1；
COPILOT_PROVIDER_API_KEY 填 TokenBay API Key；
COPILOT_MODEL 指定要使用的模型 ID（也可用 --model 命令行参数）。

模型能力要求：所选模型必须同时支持工具调用（function calling）与流式输出（streaming），否则 Copilot CLI 会报错。官方建议使用上下文窗口不低于 128k 的模型。

1. 获取 API Key

控制台创建 API Key

2. 配置环境变量

Copilot CLI 在启动前读取下列环境变量：

变量	必填	值
`COPILOT_PROVIDER_BASE_URL`	是	`https://api.tokenbay.com/v1`
`COPILOT_PROVIDER_API_KEY`	是	你的 TokenBay API Key（`sk-...`）
`COPILOT_MODEL`	是	要使用的模型 ID（如 `gpt-5.3-codex`）
`COPILOT_PROVIDER_TYPE`	否	提供商类型，默认 `openai`，接 TokenBay 保持默认即可

macOS / Linux（zsh 或 bash）

把下面几行追加到 ~/.zshrc 或 ~/.bashrc，然后执行 source ~/.zshrc 让其生效：

export COPILOT_PROVIDER_BASE_URL="https://api.tokenbay.com/v1"
export COPILOT_PROVIDER_API_KEY="sk-XXXXXXX"
export COPILOT_MODEL="gpt-5.3-codex"

Windows（PowerShell，写入用户级环境）

[Environment]::SetEnvironmentVariable('COPILOT_PROVIDER_BASE_URL','https://api.tokenbay.com/v1','User')
[Environment]::SetEnvironmentVariable('COPILOT_PROVIDER_API_KEY','sk-XXXXXXX','User')
[Environment]::SetEnvironmentVariable('COPILOT_MODEL','gpt-5.3-codex','User')

Windows（CMD）

setx COPILOT_PROVIDER_BASE_URL "https://api.tokenbay.com/v1"
setx COPILOT_PROVIDER_API_KEY "sk-XXXXXXX"
setx COPILOT_MODEL "gpt-5.3-codex"

PowerShell 与 CMD 的写法都是永久化用户环境变量，需要新开一个终端窗口才会读到。设置完成后启动 copilot 即生效。

3. 推荐模型

用途	模型 ID
主力编码	`gpt-5.3-codex`
通用旗舰 / 复杂推理	`gpt-5.5`
高性价比	`gpt-5.4-mini`

模型名格式：模型名称中版本号仅接受小数点形式（如 gpt-5.4），不要写成连字符形式（gpt-5-4）。

所选模型须支持工具调用与流式输出。上表为示例，准确的 Model ID 与端点以模型清单为准；接入前请核对并确认所属分组已授权该模型。

4. 验证接入

设置好环境变量后启动 Copilot CLI：

copilot

发送一条消息确认能正常返回；也可用 --model 在启动时临时指定模型：

copilot --model gpt-5.5

若鉴权失败或报模型不可用，先检查：

COPILOT_PROVIDER_BASE_URL 是否带 /v1；
环境变量是否已设置并新开终端；
所选模型是否支持工具调用与流式输出，且 Model ID 与 TokenBay 上游一致。