Skip to main content
JetBrains AI Assistant 内置了用于自定义提供商的 兼容 OpenAI 协议的端点 字段。Tokios 会提供一个稳定且经过身份验证的 URL，您只需将该 URL 填入该字段即可；同时还需设置与模型对应的连接器、注册部署名称，并附上 sk-tok-… 类型的 API 密钥。整个过程无需维护任何隧道，您的机器上也不会出现未受保护的开放端口。 此配置方式适用于所有搭载了 AI Assistant 插件的 JetBrains 集成开发环境，包括 IntelliJ IDEA、PyCharm、GoLand、WebStorm、Rider 等。

​
前置条件

  • 已成功配置好与本地模型相连的 Tokios 连接器——详情参见 连接器安装
  • 已注册的模型部署名称——详情参见 模型注册
  • 有效的 Tokios API 密钥（sk-tok-…）——详情参见 API 密钥管理
  • 已安装 AI Assistant 插件的 JetBrains 集成开发环境

​
将 AI Assistant 的提供商地址设为 Tokios

1

打开 AI Assistant 的提供商设置页面

打开 设置 | 工具 | AI 助手 | 提供商与 API 密钥。由于 JetBrains 在不同版本中调整了该设置的位置，请确认您当前安装的 AI 助手版本所对应的具体菜单路径与标签名称。
2

找到与 OpenAI 兼容的端点区域

寻找 与 OpenAI 兼容的端点 区域，该区域用于配置第三方 OpenAI 兼容服务器；此处显示的字段标签可能因版本而异，请核对您所使用的版本。
3

输入 Tokios 的 URL 地址

将端点 URL 设置为：
4

粘贴您的 Tokios API 令牌

将您的 sk-tok-… 令牌粘贴至该端点的 API 密钥字段中。AI 助手会在每次请求时将其作为 Bearer 令牌发送。
5

添加对应的部署项作为模型

Enter the public deployment name you registered in the Models tab — for example, gemma-tunnel — as the model for this endpoint. This is the value AI Assistant sends in the model field; it is not Ollama’s, llama.cpp’s, vLLM’s, or LM Studio’s local model id.
6

按需启用工具调用功能

若 AI 助手为此端点提供了工具/函数调用开关，请将其开启。模型是否真正响应工具调用则取决于模型本身的能力。
请将 gemma-tunnel 替换为您注册的部署名称，将 sk-tok-YOUR_KEY 替换为您自己的令牌。切勿将二者写入任何共享配置文件中。
JetBrains IDE 中对 AI 助手自定义提供商的支持被描述为兼容 OpenAI 的接口。目前尚无确认的兼容 Anthropic 的自定义基础 URL 字段，因此请通过上述兼容 OpenAI 的端点进行连接，而不要使用 Tokios 提供的类 Anthropic 端点。
自定义端点无法支持 AI 助手的全部功能。截至 2026.1 版本，JetBrains 仅说明第三方模型与本地模型可在 AI Chat 模块中使用，而 Junie 及后续编辑建议功能仍需依赖 JetBrains 的云端模型。预计聊天功能会逐步转向使用自定义端点，但内联建议功能仍将沿用内置提供商。
在将模型分配给各项功能前，请利用提供商设置中的 Test Connection 功能验证端点是否可正常响应。

​
为何这种方式优于单纯使用隧道

若无额外配置，本地模型服务器仅会在 localhost 端口或局域网内监听，此时 JetBrains 云端 AI 助手后端无法访问该服务。虽然普通隧道（如 ngrok）能开放端口，但往往会导致模型在未经身份验证的状态下对外提供服务，且每次重启后访问地址都会发生变化。 Tokios 连接器仅支持出站连接，因此本地模型不会开启任何入站端口，所有发送至模型的请求均携带限定范围的 sk-tok-… 令牌。
  • 杜绝未授权访问 — 连接器仅向 Tokios 发起连接请求，不会开放任何监听端口，且所有请求均需携带有效令牌方可通过验证。
  • 固定访问地址 — https://api.tokios.com/v1 地址在多次重启后仍保持不变，只需在 AI 助手设置中配置一次即可。
  • 令牌权限可控 — 可针对特定部署场景设定令牌权限，一旦发现令牌泄露也能立即予以撤销，且无需改动本地模型或连接器配置。

​
故障排查

AI 助手发送的 API 密钥缺失、格式有误或已被撤销。请确认所粘贴的 sk-tok-… 密钥内容完整且不含多余空白字符，同时前往 Keys 页面检查该密钥的当前状态。
AI 助手返回的 model 数值与已注册的部署项不匹配。请确认您在 AI 助手内输入的模型名称与 Models 页面上显示的公开名称完全一致，而非您在 Ollama、llama.cpp、vLLM 或 LM Studio 中使用的本地模型 ID。
对应部署项所使用的连接器处于离线状态或已达到并发上限。请查看 Connectors 页面：该连接器状态应显示为 Online，且运行该连接器的机器必须处于正常开机且可连通状态。

​
后续操作指引

快速入门

请依次完成连接器设置、模型注册以及全新 API 密钥的生成。

兼容客户端列表

此处列出了其他兼容 OpenAI 及 Anthropic 协议的客户端所需的基础 URL 与令牌配置方法。