编码工具
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_TYPE | openai |
COPILOT_PROVIDER_BASE_URL | https://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 都应立即轮换。