配置中心/接入其他 Agent 工具/Copilot CLI

Copilot CLI

最后更新 2026-09-21·约 11 分钟读完

🔥 加入飞创 AI 交流群

微信扫码进群
微信扫码进群
💬

飞创 Token 交流群 · 扫码或进入官网加入

✍️

GitHub Copilot CLI 教程 — 通过 BYOK 模式将 GitHub 官方终端 AI 编程助手接入飞创 AI 中转站,支持 Agent 模式、工具调用与 MCP。

关于Copilot CLI

GitHub Copilot CLI是GitHub官方推出的终端AI编程助手,支持BYOK(自带叉子)模式接入接口模型端点,可通过环境变量直接对接飞创 AI 中转站。支持代理模式、工具调用和MCP。

本教程介绍如何将Copilot CLI通过BYOK模式指向飞创 AI 中转站,使用飞创 AI 中转站 网关分发的模型完成日常编码任务。

📦 接入前准备

  • Node.js 22 或更高版本
  • 一个可用的 飞创 AI 中转站的 API 密钥(在控制台生成)

🚀 第一步:安装 Copilot CLI

Plain Text复制
npm install -g @github/copilot

安装完成后,验证版本:

Plain Text复制
copilot --version

详细安装说明请参考官方入门指南。

🔧第二步:配置飞创 AI 中转站(核心步骤)

Copilot CLI 通过环境变量读取自定义 Provider 配置,推荐使用anthropic类型以获得最佳兼容性。

Linux / macOS

Plain Text复制
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-6

Windows(PowerShell)

Plain Text复制
$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。

任选:调整上下文与输出限制

Plain Text复制
export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=840000export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=128000

✅ 第三步:启动并验证

Plain Text复制
copilot

输入任意编程问题(例如“帮我写一个读取JSON文件的Python函数”),模型正常响应即配置成功。

Plain Text复制
copilot help providers

可上市全部与提供商相关的环境指标说明。

🔄 切换模型

修改COPILOT_MODEL环境变量并重新启动copilot:

Plain Text复制
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的值