编码工具

GitHub Copilot CLI

通过 BYOK 将 GitHub Copilot CLI 连接到 TokenLab

概述

GitHub Copilot CLI 可以连接任意 OpenAI Chat Completions 兼容端点。TokenLab 使用 Copilot CLI 官方环境变量完成配置。

安装

使用 Node.js 22 或更高版本时,通过 npm 安装:

npm install -g @github/copilot@1.0.85

在 macOS 或 Linux 上,也可以使用 Homebrew:

brew install --cask copilot-cli

验证安装:

copilot --version

配置 TokenLab

启动 Copilot CLI 前设置提供商变量:

按快速开始中 macOS、Linux、WSL 或 Windows PowerShell 的终端步骤设置 TOKENLAB_API_KEY,避免把密钥写进命令历史,然后从同一终端启动 Copilot CLI。长期使用请通过本地密钥管理器提供密钥,不要把明文密钥追加到 shell 配置文件。

这些变量仅用于本次启动,保留已保存的账户、默认模型与权限。正常启动时不附加这些变量,即可继续使用原设置;不要将它们写入 shell 配置文件。

COPILOT_PROVIDER_TYPE=openai COPILOT_PROVIDER_BASE_URL=https://api.tokenlab.sh/v1 COPILOT_PROVIDER_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" copilot --model claude-sonnet-5-5
变量TokenLab 值
COPILOT_PROVIDER_TYPEopenai
COPILOT_PROVIDER_BASE_URLhttps://api.tokenlab.sh/v1
COPILOT_PROVIDER_API_KEY你的 TokenLab API 密钥
COPILOT_MODEL实时模型 ID,例如 claude-sonnet-5-5

GitHub 要求所选模型同时支持流式输出和工具调用。claude-sonnet-5-5 支持工具调用,且上下文窗口大于 GitHub 建议的 128K 下限。

验证

在 Copilot CLI 中,先发送只读任务,例如:

检查此仓库并总结顶层目录结构,不要修改文件。

保存设置或列出模型不能证明密钥有效或请求完成。发送提示词会使用 TokenLab 余额;先核对回复及对应请求记录,再尝试工具,辅助请求也可能计费。

查看 Copilot CLI 文档中的提供商设置:

copilot help providers

在同一个 Agent 里出图、做视频

Copilot CLI 还可以通过 TokenLab MCP 服务器生成图片和短视频。每次生成从同一个 TokenLab 余额扣费。把下面的条目合并进 ~/.copilot/mcp-config.json。Copilot CLI 只把 PATH 传给服务器,所以两个变量都要写在 env 里:

{
  "mcpServers": {
    "tokenlab": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
      },
      "tools": ["*"]
    }
  }
}

只在这个本地文件里把 <TOKENLAB_API_KEY> 换成你的密钥。启动 Copilot CLI,运行 /mcp show tokenlab 检查连接。然后试试:

先用 get_model_pricing 查询 nano-banana-2 的价格,再用 create_image 以 nano-banana-2、1k 分辨率生成一张照片:白色桌面上的一只哑光黑色咖啡杯。

create_video 返回任务 ID,Agent 会调用 get_task_status,直到视频生成完成。其他设置见 Copilot CLI 添加 MCP 服务器。

故障排查

不要把 API 密钥提交到 Git 跟踪的脚本或配置文件。任何出现在终端历史、截图或日志中的 Key 都应立即轮换。

本页内容