GitHub Copilot CLI

四个环境变量 — COPILOT_PROVIDER_BASE_URL、COPILOT_PROVIDER_TYPE、COPILOT_PROVIDER_API_KEY 和 COPILOT_MODEL — 将 Copilot CLI 切换到你自己的端点；GitHub 说明 BYOK 无需 GitHub 登录。

# Set before you start Copilot CLI. Variable names and order are GitHub's;
# COPILOT_PROVIDER_BASE_URL and COPILOT_MODEL are the two marked Required.
export COPILOT_PROVIDER_BASE_URL=https://api.kunavo.com/v1   # see the note below
export COPILOT_PROVIDER_TYPE=openai                          # the default, shown for clarity
export COPILOT_PROVIDER_API_KEY=sk-kn-...
export COPILOT_MODEL=claude-sonnet-5

copilot

分步操作

1. 在 /app/keys 创建密钥并复制——它只会显示一次。
2. 检查是否存在过时的 ~/.copilot/providers.json（或其 COPILOT_PROVIDERS_CONFIG 指向的文件）。如果其中声明了 provider 或 model，其优先级就高于第 3 步中的所有设置。
3. 按上述方式导出 COPILOT_PROVIDER_BASE_URL、COPILOT_PROVIDER_API_KEY 和 COPILOT_MODEL。COPILOT_PROVIDER_TYPE 默认为 openai；GitHub 将其描述为适用于“任何其他兼容 OpenAI Chat Completions API 的端点”。
4. 从同一个 shell 启动 copilot——这些变量会在启动时读取，因此较早打开的终端仍会使用旧值。
5. 给它一个读取并编辑文件的任务。Copilot CLI 要求模型支持工具调用和流式传输，首次运行时同时验证这两项，比发送问候语更有参考价值。若要比较两个 id，可使用 --model 在单次运行中覆盖 COPILOT_MODEL。

已于 2026年9月21日 对照 GitHub 的《在 GitHub Copilot CLI 中使用自己的 LLM 模型》 检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 GitHub Copilot CLI 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models，包含价格的目录见模型页面。费率单位为每 1M token 的美元，格式为输入 / 输出。

另一种方式：COPILOT_PROVIDER_TYPE=anthropic

GitHub 记录了三种提供商类型，Kunavo 支持其中两种线格式：/v1/chat/completions 对应 openai，/v1/messages 对应 anthropic。GitHub 页面上的 Anthropic 示例包含四条导出命令，其基础 URL 是不带路径的源站地址 https://api.anthropic.com：

1. COPILOT_PROVIDER_TYPE=anthropic
2. COPILOT_PROVIDER_BASE_URL——根据 GitHub 示例的形式，应使用不带后缀的 https://api.kunavo.com，因为 Anthropic 自身的路由位于该源站地址下的 /v1/messages，Kunavo 也与之保持一致。这里同样适用上文的说明：GitHub 展示的是示例，而非规则。
3. COPILOT_PROVIDER_API_KEY——你的 sk-kn- 密钥。Kunavo 的 Messages 接口 接受 x-api-key 或 Authorization: Bearer 格式，因此 CLI 在此选择哪种请求头都可以读取。
4. COPILOT_MODEL——提供商期望的 id。GitHub 示例使用了带连字符的 Anthropic 风格拼写，而其受支持模型列表则用点号书写相同系列；在 BYOK 模式下，id 会传递到你的端点，因此请使用上表中的拼写。

本页为何仍优先介绍 openai 类型：GitHub 文档没有说明 Anthropic BYOK 路径会转发 cache_control、anthropic-beta 还是特定的 anthropic-version。对于重复上下文而言，这会影响账单——参见提示缓存——本页不打算对文档未说明的答案作出假设。openai 类型没有这类未解之处，因此本页为其提供了完整的配置块。