按 JetBrains 官方文档，接第三方提供商不需要 JetBrains AI 订阅。没有订阅时，JetBrains 自家的部分功能可能用不了，但聊天和主要功能会用你接入的模型。
准备工作
1
RuAPI 密钥
在 www.ruapi.ai 注册、充值（充值方法），然后打开控制台 → 令牌管理，点击 添加令牌。密钥以
sk- 开头。2
最新版 IDE
把 JetBrains IDE 和 AI Assistant 插件更新到最新版：接自有密钥的功能是 2025 年 12 月才有的。
设置步骤
1
打开提供商设置
Settings → Tools → AI Assistant → Providers & API keys。
2
把 RuAPI 加为 OpenAI 兼容提供商
在 Third-party AI providers 里填写：
3
测试连接
点 Test Connection，看到连接成功的提示后点 Apply。
4
给各项功能分配模型
在 Models Assignment 里选择模型：
- Core features：主模型，用于默认聊天、编辑器里生成代码、写提交说明。可以选
claude-sonnet-5-5或deepseek-flash。 - Instant helpers：处理小任务的快速模型，用于收集上下文、聊天标题、命名建议。可以选
deepseek-flash或gpt-5.4-mini。 - Context window：默认 64000 token。处理大文件和长对话时可以调大，但不要超过模型支持的上限。
kimi/kimi-k3）。
检查
打开 AI Chat 窗口，在模型列表里选一个 RuAPI 的模型，问一个关于你代码的问题。然后打开 RuAPI 控制台 → 使用日志：会出现带模型和费用的记录。限制
- 代码自动补全（inline completion）要在 AI Completion 里单独设置，而且需要支持 FIM（Fill-in-the-Middle）的专门模型。普通聊天模型不适合，RuAPI 请用来聊天和生成代码。
- Claude 的缓存。 走 OpenAI 兼容提供商时，调 Claude 的请求没有提示缓存。日常聊天影响不大；如果经常处理很长的上下文，主要功能可以选 DeepSeek，它会自动缓存。用 Claude 跑智能体任务，更适合用 Claude Code：它以 Claude 原生格式接 RuAPI，有缓存。
常见问题
Test Connection 不通过
Test Connection 不通过
- 确认 URL 填的是
https://www.ruapi.ai/v1，末尾带/v1。 - 确认粘贴的是完整的 RuAPI 密钥
sk-...，没有多余空格。
找不到模型（404 或 503）
找不到模型（404 或 503）
模型名必须和 RuAPI 上的一字不差，请从价格页复制。
模型不调用工具
模型不调用工具
确认提供商的 Tool calling 已经打开，并且选的是文本模型，而不是生成图片或视频的模型。
找不到 Providers & API keys
找不到 Providers & API keys
把 IDE 和 AI Assistant 插件更新到最新版。如果 IDE 由公司统一管理，管理员可能禁止了第三方密钥。
接下来
- Continue：开源助手，也能在 JetBrains IDE 里用，并支持 Claude 缓存。
- 从 Cursor 迁移：编程智能体对比和迁移步骤。
- 模型与价格：有哪些模型可用。