UniRoute
使用指南

JetBrains AI Assistant 接入指南

在 JetBrains AI Assistant 中配置 OpenAI 兼容供应商、UniRoute API Key 和模型分配。

JetBrains AI Assistant 接入 · 按量 API

将 JetBrains IDE 中的 AI Assistant 接入 UniRoute。添加 OpenAI 兼容供应商，再为聊天和编辑器操作选择模型。

适合：使用 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE 的开发者。

开始配置获取 API Key

快速配置

登录后可一键创建 Key 并自动填入 登录

按字段复制并粘贴到客户端设置中。

Provider

text
OpenAI-compatible

URL

text
https://api.uniroute.app/v1

API Key

text
YOUR_UNIROUTE_API_KEY

Core features

text
deepseek-v4-flash

Instant helpers

text
deepseek-v4-flash

配置步骤

1. 打开 AI Assistant 供应商设置

打开 Settings → Tools → AI Assistant → Providers & API keys，在 Third-party AI providers 区域将 Provider 设为 OpenAI-compatible。

UniRoute 使用 AI Assistant 的兼容供应商；Junie 原生 BYOK 栏只接受 OpenAI 或 Anthropic 直接签发的 Key。

2. 填写地址与密钥

粘贴快速配置中的 URL 和 API Key。使用 MCP 工具时启用 Tool calling，再点击 Test Connection 和 Apply。

3. 选择聊天模型

打开 AI Chat 的模型选择器，在 UniRoute 供应商区域选中 deepseek-v4-flash，新建聊天。

4. 分配编辑器功能

返回 Providers & API keys → Models Assignment，将 Core features 和 Instant helpers 设为 deepseek-v4-flash，点击 Apply。

行内补全和下一次编辑建议使用独立的 AI Completion 供应商设置，需要支持 FIM 的模型。

这几个变量分别做什么

字段用途
Provider选择 OpenAI-compatible，连接自定义 Chat Completions 接口。
URL以 /v1 结尾的 API 基础地址，请求使用 /chat/completions。
API Key用于 UniRoute 请求认证。
Tool calling允许所选模型调用已配置的 MCP 工具。
Core features / Instant helpers手动分配编辑器生成与轻量助手任务使用的模型。

选择模型

DeepSeek V4

deepseek-v4-flash

文字对话、代码问答与轻量编辑器辅助。

Claude Sonnet 5.5

claude-sonnet-5-5

代码解释、审查和较长的实现讨论。

替代方案：Claude Code 插件

从 JetBrains Marketplace 安装 Claude Code 插件，并按 Claude Code 接入指南 完成 CLI 配置。将以下内容合并到 Claude 用户设置中，保留其他字段：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.uniroute.app",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_UNIROUTE_API_KEY"
  },
  "model": "claude-sonnet-5-5"
}

从这些设置中移除旧的 ANTHROPIC_API_KEY。在 IDE 终端运行 claude；外部 Claude Code 终端可用 /ide 连接 IDE。

怎么确认已经切过来了

发送一句测试：请只回复：你好

打开 用量日志，查看模型、请求状态与扣费。测试会产生实际 API 费用。

确认 AI Chat 中已选中 UniRoute 供应商，查看流式回复，再到用量日志核对模型。

切回原配置 / 恢复备份

在 Providers & API keys 中恢复原供应商和模型分配，点击 Apply，再到 AI Chat 选择原模型。

还没安装？

安装当前 IDE 构建对应的 AI Assistant 插件，再打开 AI Chat 工具窗口。

常见问题

需要 JetBrains AI 订阅吗？

这套供应商配置使用 UniRoute API Key。JetBrains AI 订阅提供的托管功能单独使用。

为什么还要分配功能模型？

兼容模型连接成功后会显示在 AI Chat 中；编辑器操作需要手动选择 Core features 和 Instant helpers。

组织管理的 IDE 中找不到供应商选项怎么办？

组织通过 JetBrains 管理设置控制第三方供应商访问，请联系管理员启用兼容供应商。

常见错误

聊天正常，编辑器操作不可用

兼容模型尚未分配给功能。

在 Models Assignment 中选择 Core features 和 Instant helpers，点击 Apply。

401 / 认证失败

Key 不完整、已撤销或缺少权限。

替换为完整有效的 UniRoute API Key，再次测试连接。

404 / 接口错误

URL 中重复添加了版本或完整聊天路径。

将 URL 设为 https://api.uniroute.app/v1。

行内补全仍使用其他模型

AI Completion 使用独立供应商设置。

为该工作流单独配置支持 FIM 的 AI Completion 模型。

参考资料

JetBrains 自定义模型设置 · 智能体激活方式 · Claude Code JetBrains 插件

相关链接

全部集成 · 管理 API Key · 协议与地址 · 模型价格 · 用量记录