OpenRouter for Copilot Chat
在 GitHub Copilot Chat 的模型选择器中直接使用任意 OpenRouter 模型——主模型和视觉模型都可以自由选择,自带 API Key(BYOK)。
不替换 Copilot,而是增强它:Agent 模式、工具调用、Instructions、MCP、Skills 全部保留,底层跑在 OpenRouter 上。
默认模型
| 用途 |
默认模型 |
说明 |
| 主模型 |
deepseek/deepseek-v4-flash |
DeepSeek V4 Flash,1M 上下文,性价比高 |
| 视觉模型 |
z-ai/glm-5v-turbo |
Z.ai GLM-5V-Turbo,原生多模态(支持图片输入) |
注意:OpenRouter 上 GLM V5 有两个 ID——z-ai/glm-5-turbo(纯文本)和 z-ai/glm-5v-turbo(视觉版,V = Vision)。视觉代理必须用带 v 的这个。
特性
- 模型选择器中直接出现 OpenRouter 模型,与 GPT、Claude 并列,对话中可随时切换。
- 主模型任意选择:
OpenRouter: Select Main Model 从 OpenRouter 实时模型目录里挑,或直接在设置里填任意模型 ID。
- 视觉模型任意选择:
OpenRouter: Select Vision Model 只列出支持图片输入的模型。
- 透明视觉代理:主模型是纯文本模型时,拖入的图片会自动交给视觉模型描述,再把描述文本喂给主模型——全程无感。
- 思考模式:支持 DeepSeek 等模型的
reasoning_content(尽力而为地渲染思考内容)。
- 工具调用:完整支持 Copilot Agent 模式的工具调用(文件编辑、终端、搜索、Git、测试、MCP、Skills)。
- API Key 安全存储:存放在 VS Code SecretStorage(系统钥匙串),绝不写入 settings.json。
- 零运行时依赖:纯 VS Code API + Node.js 内置(
fetch),无需本地代理服务。
快速开始
- 命令面板(
Ctrl+Shift+P)→ OpenRouter: Set API Key,粘贴你的 OpenRouter API Key(在 https://openrouter.ai/keys 创建)。
- 打开 Copilot Chat,点击模型选择器,选择 OpenRouter for Copilot Chat 开头的模型。
- 开始聊天。想换模型就运行 OpenRouter: Select Main Model / Select Vision Model。
设置项
| 设置 |
默认值 |
说明 |
openrouter-copilot.baseUrl |
https://openrouter.ai/api/v1 |
API 端点(自建/代理时修改) |
openrouter-copilot.mainModel |
deepseek/deepseek-v4-flash |
主模型 ID,任意 OpenRouter 模型 |
openrouter-copilot.visionModel |
z-ai/glm-5v-turbo |
视觉代理模型 ID,需支持图片输入 |
openrouter-copilot.displayName |
OpenRouter for Copilot Chat |
模型选择器中显示的名字 |
openrouter-copilot.enableVisionProxy |
true |
主模型纯文本时,用视觉模型描述图片 |
openrouter-copilot.mainModelImageInput |
false |
主模型原生支持图片时设为 true,图片直通、跳过视觉代理 |
openrouter-copilot.maxTokens |
0 |
最大输出 token(0 = 不限) |
openrouter-copilot.httpReferer |
"" |
可选 HTTP-Referer 头,用于 OpenRouter 应用署名 |
openrouter-copilot.appTitle |
OpenRouter for Copilot Chat |
可选 X-OpenRouter-Title 头,用于 OpenRouter 应用署名 |
命令
- OpenRouter: Set API Key / Clear API Key / Get API Key
- OpenRouter: Select Main Model / Select Vision Model(实时拉取 OpenRouter 模型目录)
- OpenRouter: Open Settings / Show Logs
手动安装
cd openrouter-for-copilot-chat
npm install
npm run compile # 编译到 out/
npx @vscode/vsce package # 打包 .vsix
然后 VS Code → 扩展面板 → ... → 从 VSIX 安装。
环境要求
- VS Code 1.116+
- GitHub Copilot Chat(Free / Pro 均可)
- OpenRouter API Key
工作原理
扩展通过 VS Code 的 vscode.lm.registerLanguageModelChatProvider('openrouter-copilot', provider) 注册语言模型提供商,实现 LanguageModelChatProvider 接口:
provideLanguageModelChatInformation:返回主模型(配置的 mainModel)到模型选择器。
provideLanguageModelChatResponse:把 Copilot 消息转成 OpenAI/OpenRouter 格式 → 若含图片且主模型纯文本,先让 visionModel 描述 → 调用 OpenRouter /chat/completions(SSE 流式)→ 把 delta 转成 LanguageModelTextPart / LanguageModelToolCallPart 回传给 Copilot。
provideTokenCount:估算 token 数。
License
MIT
| |