---
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="/zh-Hant/docs/cursor/official/05-integrations-sdk/75-xcode" />
  <Card title="Cursor CLI ACP" description="回看 ACP 在 CLI 自動化中的用法。" href="/zh-Hant/docs/cursor/official/03-cli-automation/34-acp" />
</Cards>
