IDEA教程 进入控制台
JetBrains AI Assistant

在 IDEA 中接入ModNex API

使用 JetBrains 官方 AI Assistant 的 OpenAI-compatible 配置，将 AI Chat 连接到 ModNex API。本页只保留可由 JetBrains 官方文档和实际接口验证的步骤。

开始配置 JetBrains 官方文档

Before you start

准备工作

本教程针对支持“Providers & API keys”的新版 JetBrains AI Assistant。

IntelliJ IDEA

安装可使用新版 AI Assistant 的 JetBrains IDE。菜单名称会随 IDE 语言显示为中文或英文。

AI Assistant 插件

在 IDEA 的 Plugins / 插件市场中安装 JetBrains 官方发布的 AI Assistant。

ModNex API Key

在 ModNex API 控制台创建密钥，并确保所属分组拥有目标模型权限和可用余额。

!
版本判断：如果设置中找不到 AI Assistant → Providers & API keys，说明当前 IDE 或插件版本没有该配置入口。请先更新 IDEA 与 AI Assistant，不要套用第三方插件的菜单路径。

Configuration

按官方界面完成配置

以下字段名称来自 JetBrains AI Assistant 2026.2 官方文档。

01

创建 ModNex API Key

登录 https://modnex.cc/keys，创建一个单独用于 IDEA 的密钥，例如命名为 idea-ai-assistant。

02

打开提供商设置

进入 Settings → Tools → AI Assistant → Providers & API keys。中文界面通常对应“设置 → 工具 → AI Assistant → 提供商和 API 密钥”。

03

选择 OpenAI-compatible

在 Third-party AI providers 区域，将 Provider 选择为 OpenAI-compatible。不要选择 OpenAI 官方提供商，因为 ModNex API 使用的是兼容端点。

04

填写 URL 与 API Key

URL 填写 https://modnex.cc/v1；API Key 填写第一步在 ModNex 控制台创建的密钥。

Tool calling 用于声明模型是否支持工具调用。首次只验证普通对话时可先关闭；需要 AI Assistant 调用工具并确认模型支持后再开启。

05

测试并保存

点击 Test Connection。连接成功后点击 Apply 保存；随后打开 AI Chat，在模型选择器中选择该提供商返回的可用模型。

Parameters

配置参数核对

接口名称和模型列表以 ModNex 控制台当前实际配置为准。

Provider
OpenAI-compatible
URL
https://modnex.cc/v1
API Key
ModNex API 控制台创建的密钥，不使用 OpenAI 官方平台密钥。
Tool calling
仅在所选模型支持工具调用且确有需要时开启。
保存方式
先点击 Test Connection，成功后点击 Apply。
i
URL 只填写到 /v1。不要手动追加 /chat/completions 或 /responses，具体请求路径由 AI Assistant 生成。

Verified example

真实测试案例

用固定、可核对的 Java 示例判断连接、上下文读取和输出是否正常。

测试代码

在 IDEA 新建一个 Java 文件并粘贴：

public static int divide(int total, int count) {
    return total / count;
}

测试提问

选中这段方法，在 AI Chat 中发送：

请指出这段 Java 代码的边界问题，
给出最小修改方案，并补一个 JUnit 5 测试。
  1. 回答应识别 count == 0 会触发 ArithmeticException。
  2. 回答应给出明确的参数校验或业务处理方案。
  3. ModNex 控制台的“用量日志”应出现对应调用记录。
!
不要用“随便问一句”作为完整验收。固定代码案例能验证插件是否真正读取了选中上下文，而不只是完成普通聊天。

Troubleshooting

常见问题

先保留错误文字、发生时间和 Request ID，再到 ModNex 控制台查询日志。

找不到 Providers & API keys

先确认安装的是 JetBrains 官方 AI Assistant，并更新 IDEA 与插件。该入口属于较新的 AI Assistant；旧版或第三方插件的设置位置不同，不能直接套用本教程。

Test Connection 返回 401 或 403
  • 401：重新复制有效的 ModNex API Key，检查首尾空格和密钥状态。
  • 403：检查密钥所属分组是否拥有所选平台和模型权限。
Test Connection 成功，但模型不可用

连接测试只说明端点和认证基本可用。请继续检查模型名称、Key 所属分组权限、账户余额，并在 ModNex 控制台用量日志中查看实际请求的错误信息。

AI Chat 可用，但代码补全没有变化

这是可能的正常现象。JetBrains 官方说明：通用聊天模型不一定支持 FIM 或 edit prediction，AI Chat 可用不等于行内代码补全和 Next Edit Suggestions 一定可用。不要把两类功能混为同一个测试。

出现 429、503 或超时
  • 429：检查余额、调用频率、用户并发和模型额度。
  • 503：可能是当前模型没有可用上游账号或上游繁忙。
  • 超时：缩短上下文后重试，并根据时间或 Request ID 查询 ModNex 控制台用量日志。