通过 JetBrains AI Assistant 的 BYOK（自带密钥）功能，将 IntelliJ 系列 IDE 对接到 AutoRouter

IntelliJ IDE

IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains 系列 IDE 内置 AI Assistant 插件，支持 BYOK（Bring Your Own Key，自带密钥） 模式。通过 OpenAI-compatible（OpenAI 兼容） 提供商，可将 IDE 对接到 AutoRouter，使用 AutoRouter 网关分发的各类模型，无需 JetBrains AI 订阅。

官网：https://www.jetbrains.com/idea
官方文档：JetBrains AI Assistant BYOK

本文适用于 IntelliJ IDEA、PyCharm、WebStorm、GoLand、Rider 等所有支持 AI Assistant 的 JetBrains IDE。自定义端点目前仅支持 OpenAI 兼容 协议，Anthropic 原生提供商暂不支持自定义 Base URL。

📦 接入前准备

准备信息

已安装 JetBrains IDE（2026.1 或更高版本推荐）
已安装并启用 AI Assistant 插件
一个可用的 AutoRouter 地址（必须以 /v1 结尾）
一个可用的 AutoRouter API Key（在控制台生成）
想使用的模型名称（如 claude-sonnet-4-6、gpt-5.4、deepseek-v4-pro 等，需与 AutoRouter 控制台中的模型 ID 完全一致）

🚀 第一步：配置 OpenAI 兼容提供商

方式 A：通过 AI Chat 快速配置（推荐新手）

打开 IDE 左侧的 AI Chat 工具窗口。
点击 Bring your own API key（自带 API 密钥）。
在 Provider 中选择 OpenAI-compatible。
填写配置：
- URL：https://autorouter.top/v1
- API Key：在 AutoRouter 控制台生成的 API Key
点击 Continue 完成配置。

方式 B：通过设置页面配置（推荐长期使用）

打开 Settings / Preferences（Cmd+, / Ctrl+Alt+S）。
导航至 Tools → AI Assistant → Providers & API keys。
在 Third-party AI providers 区域：
- Provider：选择 OpenAI-compatible
- URL：https://autorouter.top/v1
- API Key：输入 AutoRouter API Key
- Tool calling：若模型支持 Tool Calling，建议开启（用于 MCP 与 Agent 功能）
点击 Test Connection 验证连接是否成功。
点击 Apply 保存。

若之前已配置过 JetBrains AI 或其他提供商，需先在同一页面退出 JetBrains AI 登录，或将 Provider 设为 None，再配置 BYOK。

🔧 第二步：分配模型

OpenAI 兼容端点接入的模型需手动分配到 AI Assistant 功能。在同一设置页面的 Model Assignment 区域填写：

配置项	说明	示例
Core features	聊天默认模型、代码生成、提交信息等核心功能	`claude-sonnet-4-6`
Instant helpers	聊天标题生成、上下文收集等轻量功能	`gpt-5.4` 或与 Core 相同
Completion model	行内代码补全（需 FIM 模型支持，可选）	留空或填写支持补全的模型
Context window	模型上下文窗口大小（tokens）	按模型能力设置，如 `128000`

字段要点

模型 ID 必须与 AutoRouter 控制台中暴露的名称 完全一致。
Base URL 必须以 /v1 结尾，例如 https://autorouter.top/v1。
若模型支持工具调用，请确保 Tool calling 已开启，否则 Agent / MCP 功能可能不可用。

✅ 第三步：验证接入

打开 AI Chat 工具窗口，切换到 Chat 模式。
在模型下拉列表中选择已分配的 AutoRouter 模型。
发送一条测试消息，例如：

帮我写一个读取 JSON 文件的 Kotlin 函数

若模型正常响应，说明接入成功。也可点击窗口工具栏中的 JetBrains AI 组件，确认当前激活的提供商为 OpenAI-compatible。

🔄 切换模型

聊天中切换：在 AI Chat 面板的模型下拉列表中直接选择其他模型。
修改默认模型：在 Settings → Tools → AI Assistant → Providers & API keys → Model Assignment 中更新 Core features 等配置项。

❓ 常见问题

找不到 AI Assistant 或 BYOK 选项

确认 IDE 版本为 2024.1 或更高，并在 Settings → Plugins 中启用 AI Assistant 插件。
若已登录 JetBrains AI，需先退出登录后再配置 BYOK。

Test Connection 失败或报 401 Unauthorized

检查 API Key 是否正确，可在 AutoRouter 控制台重新生成。
确认 URL 以 /v1 结尾，格式为 https://autorouter.top/v1。

模型列表为空或聊天报错

确认 Model Assignment 中填写的模型 ID 与 AutoRouter 控制台一致。
部分 Claude 模型在 OpenAI 兼容协议下可能表现不如 Messages API；若遇 400 错误，可尝试换用 GPT 或 DeepSeek 等 OpenAI 兼容模型。

部分 AI Assistant 功能不可用

纯 BYOK 模式下，依赖 JetBrains 专有模型的功能（如部分智能重构）可能不可用。如需完整功能，可同时激活 JetBrains AI 订阅，与自定义模型并存使用。

Agent / MCP 无法调用工具

确认 Tool calling 已开启，且所选模型在 AutoRouter 中支持 Tool Calling。

企业网络 / VPN 环境连接失败

在 Settings → Appearance & Behavior → System Settings → HTTP Proxy 中配置代理，并在 Tools → Server Certificates 中添加企业根证书（如适用）。

IntelliJ IDE

目录