工具教程 · 2026-08-30

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

截至 2026-10-07,AI Assistant 的 OpenAI-compatible 提供方在 QCode 上只配 GPT 与国产模型:在 Settings | Tools | AI Assistant | Providers & API keys 里 URL 填 https://api.qcode.cc/openai/v1,贴 QCode key,点 Test Connection。AI Assistant 的 Anthropic 提供方没有 URL 栏,接不了 QCode;要用 Claude 请装 Claude Code [Beta] 插件,ANTHROPIC_BASE_URL 设为 https://api.qcode.cc/api。

更新于 2026-10-07

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#jetbrains#OpenAI-compatible#BYOK#AI Assistant

要点

4

OpenAI-compatible 要填的项

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

2026-10-07

文档抓取日

jetbrains.com/help/ai-assistant/use-custom-models.html 与 settings-reference-providers-and-api-keys.html(旧地址 settings-reference-models.html 已跳转到这里),2026-10-07 复核。设置页标题仍是 Providers & API keys。

/openai/v1

URL 填到哪一层

QCode 填 https://api.qcode.cc/openai/v1,只配 GPT 与国产模型。不要把 /chat/completions 贴进 URL。

Chat

本页覆盖的功能

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

AI Assistant 的第三方模型是什么

JetBrains AI Assistant 默认走 JetBrains AI 服务上的云模型。官方另开一条:用你自己的 API key 接 Anthropic、Google、OpenAI,或 OpenAI-compatible 端点(文档举例 llama.cpp、LiteLLM)。QCode 的 OpenAI 兼容端点走最后这一条,只能配 GPT 与国产模型;Claude 在 JetBrains 里要走 Claude Code 插件。这不是改客户端标识。

现在还在被搜什么

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-10-07 复核。

注意

不是所有 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/openai/v1,配 GPT 与国产模型。在 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/openai/v1,贴 QCode API key,按需要打开 Tool calling,点 Test Connection,Apply。③ 打开 AI Chat 的模型选择器,在对应分区里选 GPT 或国产模型(可用 id 见 /models,如 gpt-6-sol、glm-5.3);claude-* 在这个端点上不可用。需要补全时另看 AI Completion 段,不要假设聊天模型能做 FIM。

在 QCode 上

QCode 的 OpenAI 兼容端点是 https://api.qcode.cc/openai/v1,只服务 GPT 与国产模型,填 claude-* 会报 model_not_available_on_endpoint。要在 JetBrains 里用 Claude,先装 Claude Code CLI,再装 Claude Code [Beta] 插件(插件复用 CLI 的配置),把 ANTHROPIC_BASE_URL 设为 https://api.qcode.cc/api,ANTHROPIC_AUTH_TOKEN 用同一把 key。可调哪些模型以 /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 填到哪一层?

填到 /openai/v1,即 https://api.qcode.cc/openai/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-providers-and-api-keys.html,15 July 2026),2026-08-30 抓取、2026-10-07 复核。@JetBrainsHelp 2026-08-21 关于 ChatGPT 订阅。YouTrack LLM-22660 仅作观察引用。QCode 端点写法依据 docs.qcode.cc 的 JetBrains IDE 集成页与接入点与 API 格式页(2026-10-07 抓取)。

在 AI Assistant 里加 OpenAI-compatible

官方 URL 栏 + QCode 的 /openai/v1,配 GPT 与国产模型;Claude 走 Claude Code 插件。

先体验,再决定

不确定选哪档?先买体验版(¥60/月),满意再升级,旧套餐剩余价值按比例退回余额。