跳转到主要内容
只需一个 Capriole AI API Key,就能在 GitHub Copilot CLI 中使用 GPT-6.2 Astra、Claude Fable 5.1、Opus 5.5 和 Gemini 4 Carbon,价格比官方 API 最多低 92%。

GitHub Copilot CLI 是什么

GitHub Copilot CLI 是 GitHub 面向终端的编程智能体。它的自带密钥(BYOK)模式会把模型请求发送到你通过环境变量设置的提供商。这套配置让它使用 Capriole AI。

前置条件

开始前请确保你已经拥有以下内容。
  • Capriole AI 账户,可在此处注册
  • Premium 方案(每月 USD 9,还包含无限网页聊天)或 Team 方案,获取 API Key 需要其中之一,可在此处订阅
  • Capriole AI API Key,可在此处获取

安装

使用 npm 安装 GitHub Copilot CLI。
验证安装。
设置 COPILOT_PROVIDER_BASE_URL 后,无需登录 GitHub。

配置

模型验证

使用下方各配置方案,GitHub Copilot CLI 1.0.100 经 Capriole AI 调用“支持的模型”一节中的每个模型,都通过了文件读取、文件写入和最终答案检查。 Copilot CLI 一次只使用一个提供商,因此请选择所需模型系列对应的配置方案。每个配置方案都会设置两个模型值。
  • COPILOT_PROVIDER_WIRE_MODEL 是 Copilot 发送的 Capriole AI 模型 ID。
  • COPILOT_PROVIDER_MODEL_ID 是 Copilot 认识的模型。Copilot 根据它选择工具、提示词和 Token 上限。

GPT 模型

GPT 模型使用 Responses API。
如需使用 GPT-6.2 Sol,请设置 COPILOT_PROVIDER_MODEL_ID="gpt-6.1-sol" 和 COPILOT_PROVIDER_WIRE_MODEL="openai/gpt-6.2-sol"。

Claude 模型

Claude 模型使用 Anthropic Messages。
如需使用 Opus 5.5,请设置 COPILOT_PROVIDER_WIRE_MODEL="claude-opus-5-5"。
  • COPILOT_PROVIDER_BEARER_TOKEN 以 Bearer Token 形式发送 Key。
  • Base URL 不含 /v1,因为 Copilot 会自行添加 /v1/messages。
  • 保持 COPILOT_PROVIDER_MODEL_ID="claude-opus-4.6"。如果使用 claude-sonnet-4 等较旧的模型配置,Copilot 会发送思考预算,Opus 5.5 会以 requires adaptive thinking 拒绝请求。

Gemini、Grok、GLM 和 Kimi 模型

这些模型使用 Chat Completions。
如需使用其他模型,请把 COPILOT_PROVIDER_WIRE_MODEL 改为 google-latest、google/gemini-4-carbon、google/gemini-4-argon、google/gemini-3.8-flash、xai/grok-4.7 或 zai/glm-5.3-flash。 保持 COPILOT_PROVIDER_MODEL_ID="claude-sonnet-4"。如果使用 gpt-5.4 等 GPT 模型配置,Copilot 会发送这些模型不接受的工具类型。 使用 Kimi K3.1 Pro 时,请设置 COPILOT_PROVIDER_MODEL_ID="claude-opus-4.6" 和 COPILOT_PROVIDER_WIRE_MODEL="moonshot/kimi-k3.1-pro"。claude-sonnet-4 模型配置会发送 temperature: 0,而 Kimi K3.1 Pro 不接受这个值。 如需长期保留某个配置方案,请把它的各行添加到 ~/.zshrc 或 ~/.bashrc,然后打开新的终端。

运行 GitHub Copilot CLI

在项目目录中启动 Copilot CLI。
如需非交互式运行,请通过 -p 传入提示词。

支持的模型

openai-latest、claude-latest 和 google-latest 始终指向各自系列中我们最新的旗舰模型,目前分别是 GPT-6.2 Astra、Claude Fable 5.1 和 Gemini 4 Carbon。

故障排除

为什么 Copilot CLI 返回身份验证错误

确认已在同一个 Shell 中导出 CAPRIOLE_AI_API_KEY。对于 Claude 模型,请使用 COPILOT_PROVIDER_BEARER_TOKEN,不要使用 COPILOT_PROVIDER_API_KEY。

为什么请求出现端点错误

对于 GPT、Gemini、Grok、GLM 和 Kimi 模型,COPILOT_PROVIDER_BASE_URL 是 https://api.caprioletech.com/v1。对于 Claude 模型,它是不含 /v1 的 https://api.caprioletech.com。

为什么 Opus 5.5 因 requires adaptive thinking 失败

设置 COPILOT_PROVIDER_MODEL_ID="claude-opus-4.6"。

为什么 Gemini、Grok、GLM 或 Kimi 请求出现工具错误

设置 COPILOT_PROVIDER_MODEL_ID="claude-sonnet-4"(Kimi K3.1 Pro 设为 "claude-opus-4.6")。GPT 模型配置会发送只有 OpenAI 模型才接受的工具类型。

说明

  • Copilot CLI在你的电脑上运行编程工具,Capriole AI 负责处理模型请求。
  • 运行 copilot help providers 可以查看所有 BYOK 环境变量。
  • Gemini 4 Carbon 的思考时间比 Gemini 4 Argon 长,每一轮可能更慢、用的 token 更多。想要更快的回应,请使用 google/gemini-4-argon。
  • 想在其他编程智能体中使用同一个 API Key,请参阅使用一个 API Key 配置编程智能体。
  • 官方参考资料包括安装 GitHub Copilot CLI和在 Copilot CLI 中使用 BYOK 模型。
最后修改于 2026年11月18日