Skip to content

Copilot CLI

GitHub Copilot CLI 是 GitHub 官方的終端 AI 程式設計助手。通過 BYOK(自帶金鑰)模式,可以用環境變數將其指向 WRouter。

前置要求

要求
Node.js≥ 22
Copilot CLI最新版本
WRouter一把可用 sk- Token

安裝

bash
npm install -g @github/copilot
copilot --version

配置(BYOK)

Copilot CLI 通過環境變數讀取 Provider 配置。推薦使用 Anthropic 模式 以獲得最佳相容性:

macOS / Linux

bash
export COPILOT_PROVIDER_TYPE=anthropic
export COPILOT_PROVIDER_BASE_URL=https://wrouter.ai/v1
export COPILOT_PROVIDER_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export COPILOT_MODEL=claude-sonnet-4-6

Windows(PowerShell)

powershell
$env:COPILOT_PROVIDER_TYPE="anthropic"
$env:COPILOT_PROVIDER_BASE_URL="https://wrouter.ai/v1"
$env:COPILOT_PROVIDER_API_KEY="sk-xxxx..."
$env:COPILOT_MODEL="claude-sonnet-4-6"

為什麼用 Anthropic 模式

部分推理模型要求 reasoning_content 在下一輪請求中原樣回傳。Copilot CLI 的 OpenAI 整合不支援此機制,可能觸發 400 錯誤。改用 Anthropic Messages 路徑可以規避。

如果你只使用非推理模型(如 gemini-2.5-flash),把 COPILOT_PROVIDER_TYPE 改為 openai 即可。

可選:調整上下文與輸出限制

bash
export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=840000
export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=128000

驗證

bash
copilot

應能用 WRouter 路由的模型正常響應。

推薦模型

模型說明
claude-sonnet-4-6Anthropic 模式日常主力
claude-opus-4-8重型推理
gemini-2.5-flash配合 COPILOT_PROVIDER_TYPE=openai

已知限制

  • Copilot CLI 與 GitHub 平臺(Issue 上下文、倉庫元資訊)的耦合走 GitHub API,不經 WRouter。
  • 部分 MCP 整合需額外配置,參考 GitHub 官方文件。