跳转到主要内容
GitHub Copilot CLI 是 GitHub 的终端编码助手。它支持 BYOK(自带密钥), 让你可以把它指向 OrcaRouter。
协议:Anthropic(通过 COPILOT_PROVIDER_TYPE=anthropic
  • Base URL: https://api.orcarouter.ai——不带 /v1
  • /v1 时请求路径会变成 /v1/v1/messages 并以 404 失败

安装

npm install -g @github/copilot
copilot --version
需要 Node.js 22+。

配置

设置以下环境变量:
export COPILOT_PROVIDER_TYPE=anthropic
export COPILOT_PROVIDER_BASE_URL="https://api.orcarouter.ai"   # NOTE: no /v1
export COPILOT_PROVIDER_API_KEY="sk-orca-..."
export COPILOT_MODEL="orcarouter/auto"                         # or e.g. anthropic/claude-opus-4.8

运行

copilot -p "Reply with exactly: OK" --allow-all
你应该会看到 OK。去掉 -p 即可进入交互式会话。

注意事项

  • base URL 不得包含 /v1——带 /v1 时请求路径会变成 /v1/v1/messages 并以 404 失败。
  • 非交互模式需要 --allow-all(或设置 COPILOT_ALLOW_ALL)。
  • 模型名称使用 vendor/model 格式;orcarouter/auto 是最简单的选择。
请使用 CLI,而不是 VS Code 扩展。 GitHub Copilot 的 VS Code 扩展 目前不提供自定义的 OpenAI 兼容端点——它的 Add Models 选择器(Anthropic / OpenAI / Google / OpenRouter / Ollama / Azure)只 允许你输入 API 密钥,没有 base URL 字段,因此无法将其指向 OrcaRouter。请改用 Copilot CLI,并配合上面的环境变量。

启用思考 / 推理

--effort 标志在 BYOK 自定义模型上无效。 Copilot CLI 会拿模型名称去对照内置的支持推理模型白名单;自定义的 vendor/model 名称不在其中,因此 --effort high 会被拒绝并报:
Error: Model "anthropic/claude-sonnet-4.6" does not support reasoning effort configuration (requested: "high").
当指向 OrcaRouter 时,请不带 --effort 运行——此时思考 由模型 / 上游的默认行为决定。(已验证。)