🔥 加入飞创 AI 交流群

💬
飞创 Token 交流群 · 扫码或进入官网加入
✍️
GitHub Copilot CLI 教程 — 通过 BYOK 模式将 GitHub 官方终端 AI 编程助手接入飞创 AI 中转站,支持 Agent 模式、工具调用与 MCP。
关于Copilot CLI
GitHub Copilot CLI是GitHub官方推出的终端AI编程助手,支持BYOK(自带叉子)模式接入接口模型端点,可通过环境变量直接对接飞创 AI 中转站。支持代理模式、工具调用和MCP。
- 官方文档:https://docs.github.com/copilot/how-tos/copilot-cli/cli-getting-started
- 包地址:https://www.npmjs.com/package/@github/copilot
本教程介绍如何将Copilot CLI通过BYOK模式指向飞创 AI 中转站,使用飞创 AI 中转站 网关分发的模型完成日常编码任务。
📦 接入前准备
- Node.js 22 或更高版本
- 一个可用的 飞创 AI 中转站的 API 密钥(在控制台生成)
🚀 第一步:安装 Copilot CLI
npm install -g @github/copilot安装完成后,验证版本:
copilot --version详细安装说明请参考官方入门指南。
🔧第二步:配置飞创 AI 中转站(核心步骤)
Copilot CLI 通过环境变量读取自定义 Provider 配置,推荐使用anthropic类型以获得最佳兼容性。
Linux / macOS
export COPILOT_PROVIDER_TYPE=anthropicexport COPILOT_PROVIDER_BASE_URL=https://feichuang.cn/v1export COPILOT_PROVIDER_API_KEY=your-feichuang-api-keyexport COPILOT_MODEL=claude-sonnet-4-6Windows(PowerShell)
$env:COPILOT_PROVIDER_TYPE="anthropic"$env:COPILOT_PROVIDER_BASE_URL="https://feichuang.cn/v1"$env:COPILOT_PROVIDER_API_KEY="your-feichuang-api-key"$env:COPILOT_MODEL="claude-sonnet-4-6"为什么推荐人择类型
部分模型(特别是思考带链的推理模型)要求将reasoning_content在下一轮请求中原样回传。Copilot CLI 的 OpenAI 集成不支持此机制,可能触发400错误。改用Anthropic Messages API兼容端点可以规避此问题。
如果你只使用非推理模型(如gemini-2.5-flash),也可以COPILOT_PROVIDER_TYPE改为openai。
任选:调整上下文与输出限制
export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=840000export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=128000✅ 第三步:启动并验证
copilot输入任意编程问题(例如“帮我写一个读取JSON文件的Python函数”),模型正常响应即配置成功。
copilot help providers可上市全部与提供商相关的环境指标说明。
🔄 切换模型
修改COPILOT_MODEL环境变量并重新启动copilot:
export COPILOT_MODEL=gemini-2.5-flashcopilot模型名称必须与 飞创 AI 中转站 控制台中公开的模型 ID完全一致。
❓ 常见问题
| 问题 | 解决方案 |
|---|---|
| 提示400 Bad Request | 将COPILOT_PROVIDER_TYPE切换为anthropic |
| 提示模型不存在 | 确认COPILOT_MODEL与 飞创 AI 中转站 控制台的模型 ID 一致 |
| API Key 无效 | 在 飞创 AI 中转站 控制台重新生成密钥并更新环境变量 |
| 环境指标不生效 | 检查是否有新打开的 shell,或将信号写入~/.bashrc/ ~/.zshrc/ PowerShell Profile |
| 输出被截断 | 增加COPILOT_PROVIDER_MAX_OUTPUT_TOKENS的值 |