工具教程 · 2026-08-30

JetBrains AI Assistant 接 OpenAI 兼容端点
Providers & API keys 里加

截至 2026-08-30,官方文档把 OpenAI-compatible 列为第三方提供方。下一步:Settings | Tools | AI Assistant | Providers & API keys,填 https://api.qcode.cc/v1 和 QCode key,点 Test Connection。

#jetbrains#OpenAI-compatible#BYOK#AI Assistant

要点

4

OpenAI-compatible 要填的项

官方设置页:Provider、API Key、URL、Tool calling(仅 OpenAI-compatible 有 Tool calling)。填完点 Test Connection。

2026-08-30

文档抓取日

jetbrains.com/help/ai-assistant/use-custom-models.html 与 settings-reference-models.html,本轮 2026-08-30 抓取。设置页标题是 Providers & API keys。

/v1

URL 填到哪一层

QCode 填 https://api.qcode.cc/v1。不要把 /chat/completions 贴进 URL。YouTrack LLM-22911 观察:非 /v1 的路径有时会被改写成 /v1。

Chat

本页覆盖的功能

第三方模型用于聊天等功能。AI Completion(行内补全)是另一段设置,官方要求 FIM,一般聊天模型不够。

AI Assistant 的第三方模型是什么

JetBrains AI Assistant 默认走 JetBrains AI 服务上的云模型。官方另开一条:用你自己的 API key 接 Anthropic、Google、OpenAI,或 OpenAI-compatible 端点(文档举例 llama.cpp、LiteLLM)。QCode 是 OpenAI 兼容网关,走最后这一条。这不是改客户端标识。

现在还在被搜什么

2026-08 检索里,人仍在问 JetBrains 怎么 BYOK。@JetBrainsHelp 在 2026-08-21 写:个人 ChatGPT 订阅不能直接接到 AI Assistant Chat,要用 OpenAI API key 走 BYOK。本页只回答:官方 OpenAI-compatible 怎么填,以及填 QCode 之后下一步。

时间线

文档现状

Use third-party and local models(2026-07-28)与 Providers & API keys 设置页(2026-07-15):路径 Settings | Tools | AI Assistant | Providers & API keys。旧文案可能仍写 Models & API keys,以当前设置页标题为准。

2026-07-28

官方列出 OpenAI-compatible endpoints。OpenAI-compatible 要填 URL、API Key,并开关 Tool calling。本地模型默认上下文窗口写的是 64 000 tokens,那是本地模型段,不是本页的远程网关默认值。

2026-08-21

@JetBrainsHelp:个人 ChatGPT 订阅不能直连 AI Assistant Chat;用 API key 走 BYOK。文档另写:组织若用 IDE Services / JetBrains Central,管理员可能关掉第三方。

已确认 vs 注意

已确认

AI Assistant 官方支持 OpenAI-compatible:URL + API Key + Test Connection。模型出现在聊天的模型选择器对应分区。文档抓取 2026-08-30。

注意

不是所有 AI Assistant 功能都能用第三方模型;官方建议可同时 Activate JetBrains AI。AI Completion 与聊天提供方独立,要 FIM。IDE 里的 Junie Agent 在 YouTrack LLM-22660(2026-01)当时要求 Anthropic 或 OpenAI 官方提供方——本页不把 Junie 写成同一条接入。不写改 header / 中间人代理配方。

用哪条通道

AI Assistant · OpenAI-compatible(本页)

有自定义 base URL 时走这条。QCode 填 https://api.qcode.cc/v1。在 Model Assignment 里把远程模型派给 Core features / Instant helpers。

厂商官方提供方 / Junie

Anthropic、Google、OpenAI 官方 key 走各自 Provider。Junie 是另一条产品线,不要把本页步骤复制进 Junie。ChatGPT 个人订阅不是 API key。

下一步怎么做

打开 Settings | Tools | AI Assistant | Providers & API keys。Third-party AI providers 选 OpenAI-compatible。URL 填 https://api.qcode.cc/v1,贴 QCode API key,按需要打开 Tool calling,点 Test Connection,Apply。打开 AI Chat 的模型选择器,在对应分区里选模型。模型 id 从 /models 复制。换模型只改 id。需要补全时另看 AI Completion 段,不要假设聊天模型能做 FIM。

在 QCode 上

QCode 提供 OpenAI 兼容端点 https://api.qcode.cc/v1。AI Assistant 按官方 OpenAI-compatible 接上即可。可调哪些模型以 /models 实时列表为准,本页不把目录快照写成永久在售。

常见问题

AI Assistant 能接自定义 OpenAI 兼容网关吗?

能。官方 Use third-party and local models 把 OpenAI-compatible endpoints 列为支持项,设置页有 URL 和 Test Connection。

设置页现在叫什么?

2026-08-30 抓到的标题是 Providers & API keys,路径 Settings | Tools | AI Assistant | Providers & API keys。旧帮助页可能写 Models & API keys,以 IDE 里当前页名为准。

URL 填到哪一层?

填到 /v1,例如 https://api.qcode.cc/v1。不要把 /chat/completions 贴进 URL。

ChatGPT Plus 能当 API key 用吗?

@JetBrainsHelp 2026-08-21:个人 ChatGPT 订阅不能直接接到 AI Assistant Chat。要用 OpenAI API key 走 BYOK。QCode key 属于 API key 这条路径。

Junie 也能填这个 URL 吗?

本页只讲 AI Assistant。YouTrack LLM-22660(2026-01)当时写 Junie Agent 需要 Anthropic 或 OpenAI 官方提供方。Junie CLI 另有自定义模型 JSON,是另一条产品线。不要把本页步骤当成 Junie 配方。

接上以后行内补全能用吗?

不一定。官方把 AI Completion 做成独立段,行内补全要 FIM。一般聊天模型通常没有这项能力。第三方模型也可能让部分功能不可用。

信息来源

JetBrains 官方 Use third-party and local models(jetbrains.com/help/ai-assistant/use-custom-models.html,页脚 28 July 2026)与 Providers & API keys(settings-reference-models.html,15 July 2026),本轮 2026-08-30 抓取。@JetBrainsHelp 2026-08-21 关于 ChatGPT 订阅。YouTrack LLM-22660、LLM-22911 仅作观察引用。

在 AI Assistant 里加 OpenAI-compatible

官方 URL + QCode 的 /v1。模型 id 以 /models 为准。

相关阅读

与 JetBrains 无隶属。功能以 JetBrains 帮助文档为准。本页不是绕过任何厂商订阅鉴权的说明书。