---
title: "JetBrains 集成"
description: "基于 Cursor 官方 JetBrains integration 文档解释 ACP、AI Assistant、安装、认证、能力、定价和迁移边界。"
verifiedAt: "2026-05-09"
---

JetBrains 集成让你不用离开 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE，就能通过 ACP 使用 Cursor agent。

> [!NOTE]
> **阅读目标**：读完本章，你应该能判断是迁移到 Cursor，还是保留 JetBrains 并通过 Agent Client Protocol 接入 Cursor agent。

## 1. 先判断

JetBrains 集成不是把 Cursor UI 嵌进 JetBrains，而是通过 Agent Client Protocol 让 JetBrains IDE 作为 client，Cursor agent 作为 server。

| 需求 | 推荐 |
| --- | --- |
| 团队强依赖 IntelliJ / PyCharm / WebStorm 工程模型 | 用 JetBrains ACP |
| 想完整使用 Cursor 编辑器体验 | 迁移到 Cursor |
| 只想保留 JetBrains 快捷键 | 在 Cursor 装 JetBrains keymap extension |
| 需要 IDE 内文件编辑和终端命令 | JetBrains ACP 可覆盖核心 agent 能力 |

官方帮助页也确认：可以不切换编辑器，通过 ACP 在 JetBrains 中连接 Cursor agent。

## 2. 前置条件

| 条件 | 要求 |
| --- | --- |
| Cursor plan | 需要 paid Cursor plan |
| JetBrains IDE | IntelliJ IDEA、PyCharm、WebStorm 或其他 JetBrains IDE |
| Plugin | AI Assistant plugin enabled |
| Version | 官方说明为 JetBrains 2025.1+ |

如果团队卡在旧版 JetBrains 或禁用了 AI Assistant plugin，就先不要把 ACP 写成可用路径。

## 3. 安装流程

1. 打开 JetBrains IDE 的 AI Chat panel。位置通常在右侧 sidebar，或 View -> Tool Windows -> AI Chat。
2. 在 AI Chat panel 打开 agent provider list。
3. 选择 Add Agent from Registry。
4. 搜索 Cursor 并安装。
5. 选择 Cursor 作为 agent provider。
6. 完成认证。
7. 在 AI Chat panel 中发送 prompt 开始使用。

初次验证建议用小任务，例如“解释当前文件的测试入口”或“在当前项目里找登录逻辑”，不要直接让 agent 批量改代码。

## 4. 能力边界

Cursor ACP 在 JetBrains 中提供的能力包括：

| 能力 | 说明 |
| --- | --- |
| Model selection | 可选择适合任务的 frontier models |
| Codebase understanding | Cursor indexing 和 semantic search 用于大项目检索 |
| File editing | agent 读写项目文件，结果反映在 JetBrains editor |
| Terminal commands | agent 在 IDE integrated terminal 中运行 shell commands |

这覆盖了 agent-driven development 的核心，但具体体验仍由 JetBrains AI Chat 和 ACP client 决定。遇到 UI、快捷键、工程结构问题，要先区分是 JetBrains、AI Assistant、ACP 还是 Cursor agent 层。

## 5. 工作方式

ACP 是连接 AI agents 和 IDEs 的开放标准。

```mermaid
flowchart LR
  User["Prompt in JetBrains AI Chat"] --> Client["JetBrains ACP client"]
  Client --> Server["Cursor agent server"]
  Server --> Index["Cursor indexing / semantic search"]
  Server --> Edits["File edits"]
  Server --> Terminal["Terminal commands"]
  Edits --> IDE["JetBrains editor"]
  Terminal --> IDE
```

当你发送 prompt，AI Chat plugin 会通过 ACP 转发给 Cursor agent。agent 读取项目文件，处理请求，并把 edits 和 terminal commands streaming 回 JetBrains IDE。

## 6. 迁移和并行使用

从 JetBrains 迁到 Cursor 时：

- 可安装 IntelliJ IDEA Keybindings extension 保留快捷键肌肉记忆。
- Cursor 使用 folder-based project model，不是 JetBrains project system。
- 语言支持更多依赖 extensions，而不是 JetBrains 内置插件。

如果团队暂时不能迁移，可以先用 JetBrains ACP 做过渡：保留 JetBrains 工程和插件生态，同时接入 Cursor agent。

## 7. 定价和治理

Cursor ACP 使用 Cursor subscription 的 usage-based pricing。上线前要确认：

- 参与试用的成员是否有 paid plan。
- 模型选择是否符合团队成本策略。
- JetBrains 中 agent terminal command 的权限边界。
- 项目代码 indexing 是否符合团队隐私策略。
- 是否需要给团队写统一的 JetBrains ACP 使用 SOP。

## 商业级验收

上线前至少完成：

- 在目标 JetBrains IDE + 2025.1+ 环境中安装 AI Assistant。
- 从 ACP registry 安装 Cursor。
- 完成认证并能发起一次只读 agent 任务。
- 验证文件编辑能落回 JetBrains editor。
- 验证 terminal command 可运行且日志可审查。
- 明确哪些任务用 JetBrains ACP，哪些任务转到 Cursor editor 或 Cloud Agent。

## 官方来源

- [Cursor JetBrains Integration](https://cursor.com/docs/integrations/jetbrains.md) —— 官方 ACP、前置条件、安装、能力、工作方式和 pricing。
- [Cursor Help: Migrate from JetBrains](https://cursor.com/help/getting-started/migrate-jetbrains.md) —— 官方迁移和 ACP 说明。
- [Cursor ACP Mode](https://cursor.com/docs/cli/acp.md) —— ACP 背景。
- [Cursor Models and Pricing](https://cursor.com/docs/models-and-pricing.md) —— 官方定价入口。

## 接下来去哪

<Cards>
  <Card title="Xcode 集成" description="继续学习 Xcode 26.3+ 内置 MCP server 和 xcrun mcpbridge。" href="/docs/cursor/official/05-integrations-sdk/75-xcode" />
  <Card title="Cursor CLI ACP" description="回看 ACP 在 CLI 自动化中的用法。" href="/docs/cursor/official/03-cli-automation/34-acp" />
</Cards>
