According to JetBrains’ documentation, connecting a third-party provider doesn’t require a JetBrains AI subscription. Without one, some JetBrains-specific features may be unavailable, but chat and the core features run on the models you connect.
Before you start
1
RuAPI API key
Sign up at www.ruapi.ai and top up your balance (how to top up). Then go to Console → API Keys and click Create API key. Keys start with
sk-.2
Latest version of your IDE
Update your JetBrains IDE and the AI Assistant plugin to the latest version: support for your own keys arrived in December 2025.
Setup
1
Open the provider settings
Settings → Tools → AI Assistant → Providers & API keys.
2
Add RuAPI as an OpenAI-compatible provider
Under Third-party AI providers, fill in the fields:
3
Test the connection
Click Test Connection, wait for the success message, then click Apply.
4
Assign models to features
Under Models Assignment, choose the models:
- Core features — the main model: default chat, in-editor code generation, commit messages.
claude-sonnet-5-5ordeepseek-flashwork well. - Instant helpers — a fast model for small tasks: collecting context, chat titles, name suggestions.
deepseek-flashorgpt-5.4-miniwork well. - Context window — 64,000 tokens by default. You can raise it for large files and long conversations, but not beyond what the model supports.
kimi/kimi-k3).
Verify the setup
Open the AI Chat window, pick one of the RuAPI models from the model list and ask a question about your code. Then open the RuAPI Console → Usage Logs: you’ll see an entry with the model and the cost of the request.Limitations
- Code completion (inline completion) is configured separately, under AI Completion, and requires dedicated models with FIM (Fill-in-the-Middle) support. Regular chat models aren’t suitable — use RuAPI for chat and code generation.
- Caching for Claude. Through an OpenAI-compatible provider, requests to Claude go without prompt caching. That’s fine for regular chat; if you work with long context a lot, pick DeepSeek for core features — it caches automatically. For agentic work with Claude, Claude Code is a better fit: it connects to RuAPI in Claude’s native format, with caching.
Troubleshooting
Test Connection fails
Test Connection fails
- Make sure the URL field is
https://www.ruapi.ai/v1, including the trailing/v1. - Make sure you pasted the full RuAPI key (
sk-...) with no extra spaces.
Model not found (404 or 503)
Model not found (404 or 503)
The model name must match the one on RuAPI exactly — copy it from the pricing page.
The model doesn't call tools
The model doesn't call tools
Make sure Tool calling is enabled for the provider and that you’ve selected a text model, not an image or video generation model.
There's no Providers & API keys section
There's no Providers & API keys section
Update your IDE and the AI Assistant plugin to the latest version. If your IDE is managed by your organization, an administrator may have disabled third-party keys.
What’s next
- Continue — an open-source assistant that also runs in JetBrains IDEs and supports caching for Claude.
- Switching from Cursor — a comparison of coding agents and step-by-step migration.
- Models and prices — the full list of available models.