接入软件
JetBrains AI Assistant
在 IntelliJ / PyCharm 等 JetBrains IDE 的 AI Assistant 里添加 OpenAI-compatible 提供方。
约 6 分钟适合:用 JetBrains IDE 的开发者
开始之前
- JetBrains IDE 已安装 AI Assistant 插件(2026 版)
- 一把 Key,以及从模型广场复制的模型名
步骤 1 · STEP 0x01
添加 OpenAI-compatible 提供方
Settings | Tools | AI Assistant | Providers & API keys
1
Provider
OpenAI-compatible
2
URL
https://api.suanlimao.shop/v1
3
API Key
<你的 Key>
4
Tool calling
开(模型支持时)
5
Test Connection
打开 Settings | Tools | AI Assistant | Providers & API keys,在第三方提供方里 Provider 选 OpenAI-compatible,填地址和 Key,点 Test Connection。
官方页面没有写 URL 要不要带 /v1(示例只给了本机地址)。先填
https://api.suanlimao.shop/v1;Test Connection 报 404 再换成 https://api.suanlimao.shop。步骤 2 · STEP 0x02
把功能指到这个模型
AI Assistant → Model Assignment
1
Core features
<模型名>(你的提供方)
2
Instant helpers
<模型名> 或更便宜的模型
- 连接成功后,在 Model Assignment 里把 Core features(聊天、生成等)和 Instant helpers(小提示类功能)分别指到你的模型;两处可以选不同模型,Instant helpers 用便宜模型更省。
- 模型名官方没写是自动拉取还是手填;界面要你输入时,填从模型广场复制的名字。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
步骤 3 · STEP 0x03
代码补全另外设置(可选)
AI Assistant → AI Completion
1
Provider
OpenAI Compatible
2
Base URL
https://api.suanlimao.shop/v1
3
API key
<你的 Key>
4
Model
<模型名>
5
Model context / Max output tokens
按模型参数
- 行内代码补全不走 Model Assignment,要在 AI Completion 一节里单独选 OpenAI Compatible 并填地址、Key、模型。
- 官方提示:这一节的 Test Connection 不会验证补全模型。
官方说明:用第三方模型时「部分功能可能不可用」;无 JetBrains AI 订阅也可以用自带模型,但要让全部功能可用仍需订阅。
✓ 怎么确认成功了
- AI Assistant 的聊天能用你的模型回答。
- 控制台「用量」页出现这次请求。
常见问题
Test Connection 失败?
先确认 Key 完整;再在 URL 里试带 / 不带 /v1 两种写法;还是不行就看「连不上怎么办」。
聊天能用,但某些功能报错或变灰?
这是官方提到的「部分功能不可用」。可以试试把 Tool calling 打开(需要模型支持工具调用),或者给那些功能换一个模型。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。