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。COPILOT_PROVIDER_MODEL_ID="gpt-6.1-sol" 和 COPILOT_PROVIDER_WIRE_MODEL="openai/gpt-6.2-sol"。
Claude 模型
Claude 模型使用 Anthropic Messages。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 模型。

