ModelSpan
ModelSpan 可将官方云端 API、中转服务和兼容 API 中的模型接入 VS Code Chat,让你直接在 VS Code 的模型选择器中使用自己的 API 服务。
主要功能
- 支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 和 Gemini GenerateContent。
- 支持官方 API、自建服务、第三方中转和其他兼容 API。
- 支持文本、图片、工具调用和工具结果。
- 自动加载服务提供的模型列表,也支持手动添加模型 ID。
- 可为每个模型设置显示名称、默认思考等级、图片输入、Context Size 和最大输出 Token。
- 支持在 VS Code Chat 会话中切换
Thinking Effort。
- 提供可视化连接编辑器和状态栏管理入口。
- 支持英文和简体中文界面。
- API 密钥安全保存在 VS Code
SecretStorage 中。
快速开始
- 单击 VS Code 状态栏中的 ModelSpan,或在命令面板执行 ModelSpan: 管理连接。
- 选择 添加连接。
- 选择 API 来源,填写 API 根地址和 API 密钥。
- 单击 添加模型,从服务返回的模型列表中选择需要使用的模型。
- 按需调整模型设置,然后单击右上角的 保存。
- 打开 VS Code Chat,在模型选择器中选择已添加的模型。
如果服务不支持自动获取模型列表,可以展开 找不到模型?手动填写模型 ID,直接输入模型 ID。
选择 API 来源
请根据请求实际发送到哪里选择来源,而不是根据模型名称选择:
- OpenAI 官方 API:请求直接发送到
api.openai.com。
- Anthropic 官方 API:请求直接发送到
api.anthropic.com。
- Google Gemini 官方 API:请求直接发送到 Google Gemini API。
- 中转或自定义 API:请求发送到自建服务、第三方中转、聚合平台或其他兼容地址。
例如,通过中转平台使用 GPT 模型时,应选择 中转或自定义 API,并填写中转平台提供的地址和密钥。
中转服务默认使用兼容范围较广的 OpenAI Chat Completions。只有服务文档明确说明时,才需要在高级设置中切换协议:
- 文档使用
/responses:选择 OpenAI Responses。
- 文档使用
/messages:选择 Anthropic Messages。
- 文档使用
generateContent:选择 Gemini GenerateContent。
填写 API 地址
请填写协议的 API 根地址,例如:
https://api.example.com/v1
ModelSpan 会根据所选协议自动追加 /models、/chat/completions 等路径,不要重复填写这些具体接口路径。
测试连接
测试连接用于验证 API 地址、认证信息和模型发现是否正常,并显示发现的模型数量和耗时。
测试过程不会发送模型推理请求,因此不会产生模型生成费用。部分不提供模型发现接口的兼容服务可能无法通过测试,此时仍可手动添加模型 ID 后保存连接。
模型设置
每个已添加模型可以单独配置:
- 显示名称:模型在 VS Code Chat 中显示的名称。
- 默认思考等级:模型默认使用的推理强度。
- 图片输入:是否允许向模型发送图片。
- Context Size:模型输入与输出合计的上下文窗口。
- 最大输出 Token:单次回答允许生成的最大 Token 数。
支持多个思考等级的模型会在 VS Code Chat 会话导航区显示 Thinking Effort 选择器。不同 API 对思考等级的支持可能不同,ModelSpan 会按所选协议转换对应参数。
API 密钥与同步
- API 密钥只保存在当前 VS Code 配置环境的
SecretStorage 中,不会写入设置、日志或 Settings Sync。
- 编辑已有连接时,密钥输入框留空会继续使用已保存的密钥。
- 输入新密钥并保存会替换原密钥。
- 勾选 删除已保存的 API 密钥 后保存,可以清除当前连接的密钥。
- 启用 同步非敏感配置 后,API 地址、模型列表和非敏感自定义请求头等配置可能通过 Settings Sync 同步到其他设备。
隐私说明
- ModelSpan 不收集遥测,也不运行自有代理服务。
- 提示词、图片、工具定义、工具调用和工具结果会直接发送到你配置的 API 地址。
- 第三方服务的数据保留、隐私政策、服务可用性和费用由对应服务商负责;使用付费 API 可能产生费用。
- ModelSpan 与 OpenAI、Anthropic、Google、Microsoft、GitHub 及其他 API 服务不存在隶属或背书关系。
远程工作区
使用 Remote SSH、WSL、Dev Containers 或 Codespaces 时,API 请求通常从运行 VS Code 客户端的本机发出。因此,localhost 和 127.0.0.1 通常指本机,而不是远程工作区。
如果模型服务运行在远程主机,请使用本机能够访问的地址、端口转发或安全隧道。
使用要求
- VS Code 1.125 或更高版本。
- 能够从运行 VS Code 的设备访问所配置的 API 服务。
反馈与支持
ModelSpan 使用 MIT License。