Skip to content
| Marketplace
Sign in
Visual Studio Code>AI>ModelSpanNew to Visual Studio Code? Get it now.
ModelSpan

ModelSpan

wenwj

|
1 install
| (0) | Free
Connect official and relay API models to VS Code Chat.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

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 中。

快速开始

  1. 单击 VS Code 状态栏中的 ModelSpan,或在命令面板执行 ModelSpan: 管理连接。
  2. 选择 添加连接。
  3. 选择 API 来源,填写 API 根地址和 API 密钥。
  4. 单击 添加模型,从服务返回的模型列表中选择需要使用的模型。
  5. 按需调整模型设置,然后单击右上角的 保存。
  6. 打开 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 服务。

反馈与支持

  • 项目主页
  • 问题反馈
  • 安全问题请参阅 SECURITY.md,不要在公开 Issue 中提交 API 密钥、提示词或请求正文。

ModelSpan 使用 MIT License。

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
© 2026 Microsoft