Copilot CLI
GitHub Copilot CLI 是 GitHub 官方的終端 AI 程式設計助手。通過 BYOK(自帶金鑰)模式,可以用環境變數將其指向 WRouter。
- 官方文件:https://docs.github.com/copilot/how-tos/copilot-cli/cli-getting-started
- npm:https://www.npmjs.com/package/@github/copilot
前置要求
| 項 | 要求 |
|---|---|
| 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-6Windows(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-6 | Anthropic 模式日常主力 |
claude-opus-4-8 | 重型推理 |
gemini-2.5-flash | 配合 COPILOT_PROVIDER_TYPE=openai |
已知限制
- Copilot CLI 與 GitHub 平臺(Issue 上下文、倉庫元資訊)的耦合走 GitHub API,不經 WRouter。
- 部分 MCP 整合需額外配置,參考 GitHub 官方文件。