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。
要点
OpenAI-compatible 要填的项
官方设置页:Provider、API Key、URL、Tool calling(仅 OpenAI-compatible 有 Tool calling)。填完点 Test Connection。
文档抓取日
jetbrains.com/help/ai-assistant/use-custom-models.html 与 settings-reference-models.html,本轮 2026-08-30 抓取。设置页标题是 Providers & API keys。
URL 填到哪一层
QCode 填 https://api.qcode.cc/v1。不要把 /chat/completions 贴进 URL。YouTrack LLM-22911 观察:非 /v1 的路径有时会被改写成 /v1。
本页覆盖的功能
第三方模型用于聊天等功能。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,以当前设置页标题为准。
官方列出 OpenAI-compatible endpoints。OpenAI-compatible 要填 URL、API Key,并开关 Tool calling。本地模型默认上下文窗口写的是 64 000 tokens,那是本地模型段,不是本页的远程网关默认值。
@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 仅作观察引用。
相关阅读
Cline 接 OpenAI 兼容 API
VS Code 插件的自定义 base URL。
Zed 接 OpenAI 兼容端点
编辑器里加 openai_compatible Provider。
Warp 自定义推理端点
终端 agent 的公网 /v1。
与 JetBrains 无隶属。功能以 JetBrains 帮助文档为准。本页不是绕过任何厂商订阅鉴权的说明书。