> ## 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.

# JetBrains AI 助手

> 通过AI Assistant中的OpenAI兼容提供程序，在IntelliJ IDEA、PyCharm、WebStorm、GoLand及其他JetBrains IDE中使用Hostlinku模型

[JetBrains AI Assistant](https://www.jetbrains.com/help/ai-assistant/) 支持 **第三方 AI 提供商**：您可以使用自己的 API 密钥，将 AI Chat 指向任何 *OpenAI* 兼容的端点。 将 API 密钥填入 Hostlinku 后，IntelliJ IDEA、PyCharm、WebStorm、GoLand、Rider 以及其他 JetBrains IDE 中的聊天功能将使用 Hostlinku 目录中的模型，相关费用将从您的账户余额中扣除。

\*\*前提条件：\*\*已安装并启用 **AI Assistant** 插件，且已获取来自 [控制台](https://console.hostlinku.com) → **API 密钥** 中的 API 密钥 Hostlinku (`sk-…`)。

### 打开模型设置

**设置** (⌘ + , / Ctrl + Alt + S) → **工具** → **AI 助手** → **模型与 API 密钥**。

### 将 Hostlinku 添加为第三方供应商

在**第三方人工智能提供商**部分：

| Field | 值 |
| - | - |
| **提供商** | `OpenAI-compatible` |
| **URL** | `https://api.hostlinku.com/v1` |
| **API密钥** | `sk-…`（API密钥 Hostlinku） |
| **工具调用** | 已勾选 |

![JetBrains 设置 → 工具 → AI 助手 → 模型和 API 密钥：URL 包含 https://api.hostlinku.com/v1](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/jetbrains-ai-settings.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=c236a734ea2f939636f4030a507fc1da)

点击 **测试连接** - IDE 会向网关发送测试请求。如果成功，请点击 **应用**，然后点击 **确定**。

### （可选）设置模型分配

在 **模型分配** 部分，您可以为 **核心功能**（例如 `claude-sonnet-4-6`）和 **即时助手**（例如 `claude-haiku-4-5`）选择 Hostlinku 模型。 请将**Completion model**保留为*Not selected*-内联自动完成功能使用的是未由 Hostlinku 支持的 FIM（参见 [概述](https://docs.hostlinku.com/zh/integrations.md#masalah-umum)）。

### 在AI Chat中选择模型

打开**AI Chat**，确保**Chat**模式已启用，然后从模型下拉菜单中选择模型。该列表取自`GET /v1/models`，因此显示的slug与[目录](https://docs.hostlinku.com/zh/models.md)一致。

![JetBrains AI Chat：下拉菜单显示第三方提供商的列表](https://mintcdn.com/hostlinku/wMpi8klIZneDqj3k/images/integrations/jetbrains-ai-chat.webp?fit=max\&auto=format\&n=wMpi8klIZneDqj3k\&q=85\&s=9132435914901c8447e2f87ac3672b65)

第一个请求将显示在控制台的 → **请求日志** 中。

## 需知事项

仅支持与OpenAI兼容的线路

AI Assistant 目前仅支持 *OpenAI 兼容* 的第三方提供商-尚无 Anthropic 基础 URL 选项。 Claude 模型仍可使用：通过 Chat Completions 调用 slug `claude-sonnet-4-6`，并由网关将其转换为 Anthropic 协议。

* **基础 URL 必须以 `/v1` 结尾。** IDE 会自动添加 `/models` 和 `/chat/completions`；若缺少 `/v1`，*测试连接* 将因 `404` 错误而失败。
* **没有自定义标头。** AI Assistant 仅将 API 密钥作为 `Authorization: Bearer sk-…` 发送-这对 Hostlinku 来说已经足够了。
* \*\*并非所有模型都适用于 Chat。\*\*请选择带有 *工具调用* 功能的模型（在设置中勾选 **工具调用**），以便 IDE 内的工具调用功能能够正常运行。相关建议请参见 [概述](https://docs.hostlinku.com/zh/integrations.md)。
* **JetBrains 中的 Claude Code** 是一个独立的集成（Claude Code 插件使用其命令行界面）。请参阅 [Claude Code](https://docs.hostlinku.com/zh/integrations/claude-code.md)。

## 故障排除

| 症状 | Solusi |
| - | - |
| *连接测试* 失败 `401` | API密钥错误/已被撤销，或者复制时混入了空格。 |
| *连接测试* 失败 `404` | URL 末尾未以 `/v1` 结尾，或者存在诸如 `/chat/completions` 之类的额外路径。 |
| 下拉菜单为空 | 连接尚未*应用*，或者该API密钥无法访问Service Mode中的任何模型。 |
| 与`429`的聊天已结束 | 并行请求过多。请参阅[使用情况与限制](https://docs.hostlinku.com/zh/usage-and-limits.md)。 |


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