> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hostlinku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# VS Code（聊天）

> 在 VS Code 的内置聊天和客服功能中，通过“自定义端点”提供商使用 Hostlinku 模型-无需登录 GitHub，仅需 API 密钥 Hostlinku

[VS Code](https://code.visualstudio.com/docs/agent-customization/language-models) 的内置聊天功能（聊天面板、代理模式和内联聊天）可通过 **自定义端点** 提供商使用外部模型。 该提供程序支持三种 API 格式-Chat Completions、Responses、Anthropic 和 Messages-这四种格式均由 Hostlinku 提供支持。 此类 BYOK 模型**无需登录 GitHub 或安装 Copilot 插件**。

**先决条件：** 最新版本的 VS Code（自定义端点已取代已弃用的 *OpenAI Compatible* 提供程序）以及 [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) 扩展。

### 添加自定义端点提供商

打开命令面板（⌘/Ctrl + Shift + P）→ **聊天：管理语言模型** → **添加模型** → **自定义端点**。然后填写：

| 提示 | 值 |
| - | - |
| **组名** | `Hostlinku` |
| **显示名称** | `Hostlinku` |
| **API密钥** | `sk-…`（API密钥 Hostlinku） |
| **API 类型** | **Chat Completions** |

VS Code 将 API 密钥存储在密钥存储中，并将该密钥的引用 (`${input:chat.lm.secret.…}`) 写入 `chatLanguageModels.json`。**请勿**将原始密钥粘贴到 JSON 文件中。

### 注册模型 Hostlinku

VS Code 打开了 `chatLanguageModels.json`。将 [目录](https://docs.hostlinku.com/zh/models.md) 中的 slug 填入 `models` 数组中-保持 VS Code 已生成的 `apiKey` 值不变：

```json theme={null}
[
  {
    "name": "Hostlinku",
    "vendor": "customendpoint",
    "apiKey": "${input:chat.lm.secret.XXXXX}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "claude-sonnet-4-6",
        "name": "Claude Sonnet 4.6",
        "url": "https://api.hostlinku.com/v1/chat/completions",
        "toolCalling": true,
        "vision": true,
        "contextWindow": 1000000,
        "maxOutputTokens": 64000
      },
      {
        "id": "gpt-5-5",
        "name": "GPT-5.5",
        "url": "https://api.hostlinku.com/v1/chat/completions",
        "toolCalling": true,
        "vision": true,
        "contextWindow": 1000000,
        "maxOutputTokens": 64000
      },
      {
        "id": "claude-haiku-4-5",
        "name": "Claude Haiku 4.5",
        "url": "https://api.hostlinku.com/v1/chat/completions",
        "toolCalling": true,
        "vision": false,
        "contextWindow": 200000,
        "maxOutputTokens": 16000
      }
    ]
  }
]
```

![VS Code 中的 chatLanguageModels.json 文件包含提供商 Hostlinku，其网址为 https://api.hostlinku.com/v1/chat/completions](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/vscode-chatlanguagemodels.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=0dc1a32e0ece7d9acda151012babb8b0)

请输入 `url` **并附上端点路径**（`/v1/chat/completions`），以免 VS Code 需要猜测。`toolCalling: true` 是必需的，以便模型在 **Agent** 模式下显示。

### 在聊天中选择模型

保存文件。Hostlinku模型出现在**Chat: Manage Language Models**中，并附有其上下文大小和功能信息：

![VS Code 的“对话语言模型”包含组 Hostlinku：Claude Haiku 4.5、Claude Sonnet 4.6、GPT-5.5](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/vscode-language-models.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=3980871a3e1292ab4d9677616c867fc6)

然后从“聊天”面板中的模型选择器中选择一个模型（如果尚未显示，请重启 VS Code）。第一个请求将显示在控制台中 → **请求日志**。

![VS Code 聊天面板中的模型选择器显示了 Hostlinku 中的 Claude Sonnet 4.6、Claude Haiku 4.5 和 GPT-5.5](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/vscode-chat-model-picker.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=5da7221d3f6a824ea0b095c9b5150a8b)

## 其他 API 格式

每个模型均可通过`apiType`采用不同的格式：

| `apiType` | `url` | 注释 |
| - | - | - |
| `chat-completions` | `https://api.hostlinku.com/v1/chat/completions` | 建议的默认设置-所有目录中的模型。 |
| `messages` | `https://api.hostlinku.com/v1/messages` | 格式为 Anthropic；VS Code 将密钥作为 `x-api-key` 发送（网关已接收）。 |
| `responses` | `https://api.hostlinku.com/v1/responses` | **必须**添加 `"statefulResponses": false` - 详见下文。 |

Responses API Hostlinku 属于无状态型

默认情况下，VS Code 会为 `apiType: "responses"` 模型发送 `previous_response_id`，而 Hostlinku 不会保存响应，因此此类请求会被 `400` 拒绝。 若要使用 Responses API，请在该模型中添加 `"statefulResponses": false`，以便 VS Code 发送完整的对话记录。请参阅 [Responses API](https://docs.hostlinku.com/zh/responses.md)。

```json theme={null}
{
  "id": "gpt-5-5",
  "name": "GPT-5.5 (Responses)",
  "url": "https://api.hostlinku.com/v1/responses",
  "apiType": "responses",
  "statefulResponses": false,
  "toolCalling": true,
  "vision": true,
  "contextWindow": 1000000,
  "maxOutputTokens": 64000
}
```

## 需知事项

* **内联建议（自动补全）仍使用 Copilot。** BYOK 仅适用于聊天和实用任务；语义搜索、嵌入和代码补全需要 GitHub 账户。
* **无需登录 GitHub**，VS Code 会提示你选择 *实用模型*（会话标题、提交信息等）。 请将 `chat.utilityModel` 和 `chat.utilitySmallModel` 的设置填入 Hostlinku 模型-`claude-haiku-4-5` 适用于 *small* 类型。
* **Copilot Business/Enterprise：** 组织管理员需在 Copilot GitHub 设置中启用 *在 VS Code 中使用自带语言模型密钥* 策略。
* **不受信任的工作区**（受限模式）仅显示 **Auto** 模型；请信任该工作区，以便显示 Hostlinku 模型。

## 故障排除

| 症状 | Solusi |
| - | - |
| 模型在Agent模式下未显示 | 选择套件`"toolCalling": true`，并使用目录中带有*tool calling*功能的模型。 |
| `401` | API密钥错误/已被撤销 - 请通过“语言模型”编辑器中的服务提供商齿轮图标进行更新。 |
| `404 model_not_found` | `id` 的 slug 必须与 `GET /v1/models` 完全一致。 |
| `400` 引用了 `previous_response_id` | 模型为`apiType: "responses"`，不含`"statefulResponses": false`。 |
| 新模型未亮相 | 保存 `chatLanguageModels.json` 后，请重新启动 VS Code。 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.