适用场景:
| 可以通过 VS Code Custom Endpoint、Copilot CLI 或 GitHub Copilot App 使用 MaiToken。初次配置的用户建议优先选择 VS Code。 |
|---|
1. VS Code:推荐方式
升级 VS Code: 将 VS Code 更新到包含 Language Models 管理功能的稳定版本。
打开模型管理: 按下
Cmd/Ctrl + Shift + P打开命令面板,运行Chat: Manage Language Models。也可以单击 Chat 模型选择器中的齿轮图标。添加自定义端点: 单击 Add Models → Custom Endpoint。
填写基础信息: 组名填写
MaiToken,显示名称填写MaiToken - 模型ID,API Key 填写您自己的 MaiToken Key。选择 API 类型: 选择 Chat Completions。
编辑配置文件: VS Code 将打开
chatLanguageModels.json。将下面示例中的<你的 MaiToken Key>和<模型ID>替换为实际内容,然后保存文件。选择模型: 回到 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。 |
|---|
配置完成后这样测试
测试普通对话: 在聊天框中输入“只回复 OK”。如果收到正常回复,说明 API Key、API 地址和模型 ID 基本正确。
测试项目读取: 打开一个测试项目,输入“请读取当前项目目录,只列出一级文件名,不要修改任何文件。”
测试 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>" copilotWindows 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
打开设置: 启动 GitHub Copilot App,然后打开 Settings → Model providers。
添加服务商: 单击 Add provider,选择 OpenAI-compatible HTTP endpoint。
填写参数: 显示名称填写
MaiToken;Base URL 填写 https://api.maitoken.com/v1 ;API Key 填写您自己的 MaiToken Key;模型填写<模型ID>。保存并选择: 保存配置后,从模型选择器中选择该模型,然后启动一个 Agent 会话。
| GitHub Copilot App 的自定义服务商功能可能仍处于预览阶段,相关入口名称可能随版本更新而变化。 |
|---|
常见问题
| 问题 | 处理建议 |
|---|---|
| VS Code 中不显示模型 | 保存 chatLanguageModels.json 后重启 VS Code,并确认当前工作区已经设为可信。 |
| Agent 中无法选择模型 | 模型必须启用 toolCalling,并且接口必须能够返回 OpenAI 兼容的工具调用数据。 |
| 企业账号没有 BYOK | 组织管理员可能关闭了 BYOK 策略,请联系组织管理员开启。 |
