# GitHub Copilot CLI

CLI · OpenAI 兼容接口 BYOK

## 设置 Provider 环境变量

按官方说明安装 GitHub Copilot CLI。选择支持 Chat Completions、流式响应和工具调用的模型；GitHub 建议至少 128k 上下文以获得更好的效果。

启动前设置环境变量。将 `<YOUR_FOXMU_API_KEY>` 和 `<MODEL_ID>` 替换为完整密钥与准确模型 ID。`COPILOT_PROVIDER_TYPE=openai` 选择 OpenAI 兼容 Provider，Base URL 带 `/v1`。

```bash
export FOXMU_API_KEY='<YOUR_FOXMU_API_KEY>'
export COPILOT_PROVIDER_BASE_URL='https://foxmu.ai/v1'
export COPILOT_PROVIDER_TYPE='openai'
export COPILOT_PROVIDER_API_KEY="$FOXMU_API_KEY"
export COPILOT_MODEL='<MODEL_ID>'
```

## 启动 Copilot CLI

从该终端启动 `copilot`。发送不含敏感内容的简短问题，在[使用记录](/usage-logs)中对照模型和时间。保留 CLI 原有的工具审批控制。

这些变量配置 GitHub Copilot CLI 的 BYOK，不覆盖 IDE 行内补全或全部 Copilot 功能。切换 Provider 会改变模型请求的目标地址，确保端点属于你准备使用的环境。

```bash
copilot
```

## 排查 Copilot CLI 模型错误

| 现象 | 检查项 |
| --- | --- |
| 模型缺失或不符合预期 | `COPILOT_MODEL` 与启动时的 `--model` 覆盖 |
| 401 | `COPILOT_PROVIDER_API_KEY`、完整密钥与密钥状态 |
| 404 | Base URL、重复 `/v1` 和 Chat Completions 支持 |
| 工具或流式错误 | Copilot CLI 必须同时支持这两种能力 |
| 响应慢或不完整 | 上下文、输出预算和[超时排查](/docs/errors-504) |

普通文本 cURL 成功不足以判定模型兼容。请使用你有权发送的内容验证编程流程。

## 下一步

- [创建 API 密钥](https://foxmu.ai/keys)
- [打开在线调试](https://foxmu.ai/playground)
- [查看使用记录](https://foxmu.ai/usage-logs)
- [浏览文档目录](https://foxmu.ai/docs)

## 官方参考

- [GitHub Copilot CLI BYOK](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models)