GitHubCopilot

适用场景:

可以通过 VS Code Custom Endpoint、Copilot CLI 或 GitHub Copilot App 使用 MaiToken。初次配置的用户建议优先选择 VS Code。

1. VS Code:推荐方式

  1. 升级 VS Code: 将 VS Code 更新到包含 Language Models 管理功能的稳定版本。

  2. 打开模型管理: 按下 Cmd/Ctrl + Shift + P 打开命令面板,运行 Chat: Manage Language Models。也可以单击 Chat 模型选择器中的齿轮图标。

  3. 添加自定义端点: 单击 Add Models → Custom Endpoint。

  4. 填写基础信息: 组名填写 MaiToken,显示名称填写 MaiToken - 模型ID,API Key 填写您自己的 MaiToken Key。

  5. 选择 API 类型: 选择 Chat Completions。

  6. 编辑配置文件: VS Code 将打开 chatLanguageModels.json。将下面示例中的 <你的 MaiToken Key> 和 <模型ID> 替换为实际内容,然后保存文件。

  7. 选择模型: 回到 Chat,从模型选择器中选择 MaiToken 模型。如果模型没有立即出现,请重启 VS Code。

{  "name": "MaiToken",  "vendor": "customendpoint",  "apiKey": "<你的 MaiToken Key>",  "apiType": "chat-completions",  "models": [    {      "id": "<模型ID>",      "name": "MaiToken - <模型ID>",      "url": "https://api.maitoken.com/v1/chat/completions",      "toolCalling": true,      "streaming": true,      "maxInputTokens": 128000,      "maxOutputTokens": 8192    }  ]}
128000 和 8192 仅为示例,请根据实际模型的上下文长度和最大输出限制进行调整。如果模型不支持工具调用,请将 toolCalling 设置为 false,但该模型将无法用于 Agent。
配置完成后这样测试
  1. 测试普通对话: 在聊天框中输入“只回复 OK”。如果收到正常回复,说明 API Key、API 地址和模型 ID 基本正确。

  2. 测试项目读取: 打开一个测试项目,输入“请读取当前项目目录,只列出一级文件名,不要修改任何文件。”

  3. 测试 Agent: 让 Agent 新建一个名为 test-maitoken.txt 的文件并写入 hello,然后确认文件已经生成。请勿使用真实生产项目进行测试。

2. Copilot CLI:适合终端用户

每次启动 Copilot CLI 前,请先在当前终端中设置以下环境变量。

macOS / Linux
export COPILOT_PROVIDER_BASE_URL="https://api.maitoken.com/v1"export COPILOT_PROVIDER_TYPE="openai"export COPILOT_PROVIDER_API_KEY="<你的 MaiToken Key>"export COPILOT_MODEL="<模型ID>" copilot
Windows PowerShell
$env:COPILOT_PROVIDER_BASE_URL="https://api.maitoken.com/v1"$env:COPILOT_PROVIDER_TYPE="openai"$env:COPILOT_PROVIDER_API_KEY="<你的 MaiToken Key>"$env:COPILOT_MODEL="<模型ID>" copilot
环境变量 填写内容
COPILOT_PROVIDER_BASE_URL https://api.maitoken.com/v1
COPILOT_PROVIDER_TYPE openai
COPILOT_PROVIDER_API_KEY <你的 MaiToken Key>
COPILOT_MODEL <模型ID>
Copilot CLI 的 Agent 需要模型支持流式输出和工具调用。如果普通聊天成功但 Agent 报错,请优先换用支持 tool_calls、streaming 且上下文长度较大的模型。

3. GitHub Copilot App

  1. 打开设置: 启动 GitHub Copilot App,然后打开 Settings → Model providers。

  2. 添加服务商: 单击 Add provider,选择 OpenAI-compatible HTTP endpoint。

  3. 填写参数: 显示名称填写 MaiToken;Base URL 填写 https://api.maitoken.com/v1 ;API Key 填写您自己的 MaiToken Key;模型填写 <模型ID>。

  4. 保存并选择: 保存配置后,从模型选择器中选择该模型,然后启动一个 Agent 会话。

GitHub Copilot App 的自定义服务商功能可能仍处于预览阶段,相关入口名称可能随版本更新而变化。

常见问题

问题 处理建议
VS Code 中不显示模型 保存 chatLanguageModels.json 后重启 VS Code,并确认当前工作区已经设为可信。
Agent 中无法选择模型 模型必须启用 toolCalling,并且接口必须能够返回 OpenAI 兼容的工具调用数据。
企业账号没有 BYOK 组织管理员可能关闭了 BYOK 策略,请联系组织管理员开启。