> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# JetBrains AI Assistant 用自己的密钥：通过 RuAPI 接 Claude、DeepSeek、GPT

> 把 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE 里的 AI Assistant 作为 OpenAI 兼容提供商接到 RuAPI：用自己的密钥，不需要 JetBrains AI 订阅。不用 VPN，用 USDT 付款。

**AI Assistant** 是 JetBrains IDE（IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm、Rider 等）里自带的 AI 助手。从 2025 年 12 月起，它可以接第三方提供商的自有密钥（BYOK），包括 RuAPI 这样的 OpenAI 兼容提供商。接好后，聊天和 AI Assistant 的各项功能就用 Claude、GPT、Gemini、DeepSeek 等模型，只按用掉的 token 付费。RuAPI 在俄罗斯不用 VPN 也能用，余额用 USDT 充值，不需要境外银行发行的卡。

<Note>
  按 JetBrains 官方文档，接第三方提供商不需要 JetBrains AI 订阅。没有订阅时，JetBrains 自家的部分功能可能用不了，但聊天和主要功能会用你接入的模型。
</Note>

## 准备工作

<Steps>
  <Step title="RuAPI 密钥">
    在 [www.ruapi.ai](https://www.ruapi.ai/?utm_source=docs\&utm_campaign=zh-jetbrains-ai-assistant) 注册、充值（[充值方法](/zh/topup)），然后打开控制台 → **令牌管理**，点击 **添加令牌**。密钥以 `sk-` 开头。
  </Step>

  <Step title="最新版 IDE">
    把 JetBrains IDE 和 AI Assistant 插件更新到最新版：接自有密钥的功能是 2025 年 12 月才有的。
  </Step>
</Steps>

<Tip>
  不需要银行卡：余额可以用 USDT 充值。还没有 USDT 的话，可以按[这篇教程](/zh/buy-usdt)用卢布购买。也支持境外银行发行的卡。
</Tip>

## 设置步骤

<Steps>
  <Step title="打开提供商设置">
    **Settings** → **Tools** → **AI Assistant** → **Providers & API keys**。
  </Step>

  <Step title="把 RuAPI 加为 OpenAI 兼容提供商">
    在 **Third-party AI providers** 里填写：

    | 字段 | 填什么 |
    | - | - |
    | **Provider** | `OpenAI-compatible` |
    | **URL** | `https://www.ruapi.ai/v1`——末尾**带** `/v1` |
    | **API Key** | 你的 RuAPI 密钥 `sk-...` |
    | **Tool calling** | 打开——RuAPI 的文本和代码模型都支持工具调用 |
  </Step>

  <Step title="测试连接">
    点 **Test Connection**，看到连接成功的提示后点 **Apply**。
  </Step>

  <Step title="给各项功能分配模型">
    在 **Models Assignment** 里选择模型：

    * **Core features**：主模型，用于默认聊天、编辑器里生成代码、写提交说明。可以选 `claude-sonnet-5-5` 或 `deepseek-flash`。
    * **Instant helpers**：处理小任务的快速模型，用于收集上下文、聊天标题、命名建议。可以选 `deepseek-flash` 或 `gpt-5.4-mini`。
    * **Context window**：默认 64000 token。处理大文件和长对话时可以调大，但不要超过模型支持的上限。

    点 **Apply**。
  </Step>
</Steps>

准确的模型名见[价格页](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=zh-jetbrains-ai-assistant)。名称要一字不差，连同前缀和大小写（例如 `kimi/kimi-k3`）。

## 检查

打开 **AI Chat** 窗口，在模型列表里选一个 RuAPI 的模型，问一个关于你代码的问题。然后打开 RuAPI 控制台 → **使用日志**：会出现带模型和费用的记录。

## 限制

* **代码自动补全**（inline completion）要在 **AI Completion** 里单独设置，而且需要支持 FIM（Fill-in-the-Middle）的专门模型。普通聊天模型不适合，RuAPI 请用来聊天和生成代码。
* **Claude 的缓存。** 走 OpenAI 兼容提供商时，调 Claude 的请求没有提示缓存。日常聊天影响不大；如果经常处理很长的上下文，主要功能可以选 DeepSeek，它会自动缓存。用 Claude 跑智能体任务，更适合用 [Claude Code](/zh/integrations/claude-code)：它以 Claude 原生格式接 RuAPI，有缓存。

## 常见问题

<AccordionGroup>
  <Accordion title="Test Connection 不通过">
    * 确认 **URL** 填的是 `https://www.ruapi.ai/v1`，末尾带 `/v1`。
    * 确认粘贴的是完整的 RuAPI 密钥 `sk-...`，没有多余空格。
  </Accordion>

  <Accordion title="找不到模型（404 或 503）">
    模型名必须和 RuAPI 上的一字不差，请从[价格页](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=zh-jetbrains-ai-assistant)复制。
  </Accordion>

  <Accordion title="模型不调用工具">
    确认提供商的 **Tool calling** 已经打开，并且选的是文本模型，而不是生成图片或视频的模型。
  </Accordion>

  <Accordion title="找不到 Providers & API keys">
    把 IDE 和 AI Assistant 插件更新到最新版。如果 IDE 由公司统一管理，管理员可能禁止了第三方密钥。
  </Accordion>
</AccordionGroup>

## 接下来

* [Continue](/zh/integrations/continue)：开源助手，也能在 JetBrains IDE 里用，并支持 Claude 缓存。
* [从 Cursor 迁移](/zh/integrations/cursor-alternatives)：编程智能体对比和迁移步骤。
* [模型与价格](/zh/models)：有哪些模型可用。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.