当前位置：首页 > news >正文

PyCharm 中接入 Cursor AI：通过 ACP 实现无缝协作

news 2026/5/15 18:52:48

引言

Cursor 以其出色的 AI 代码补全和对话能力，成为很多开发者的新宠。但如果你习惯了 PyCharm 强大的 Python 开发体验，又不想失去 Cursor 的 AI 辅助，该怎么办？

好消息是：从 PyCharm 2026.1 开始，JetBrains 引入了 ACP（Agent Client Protocol，智能体客户端协议）开放标准，允许你在 PyCharm 内部直接接入各种 AI 智能体——包括 Cursor、Claude Agent、Junie 等。也就是说，你可以在 PyCharm 里使用 Cursor 的 AI 能力，无需来回切换编辑器。

本文会详细介绍 ACP 是什么、如何在 PyCharm 中配置 Cursor ACP 代理，以及常见问题的解决办法。

一、什么是 ACP？

ACP（Agent Client Protocol）是 JetBrains 在 2026.1 版本中推出的一种开放协议，用于在 IDE（如 PyCharm）和各种 AI 智能体（Agent）之间建立标准化的通信。

简单理解：

传统上，每个 AI 插件（如 GitHub Copilot、Codeium）都需要为自己的 IDE 单独开发插件。
ACP 出现后，任何一个实现了 ACP 协议的 AI 智能体，都可以被 PyCharm 直接识别和调用，不需要为 PyCharm 单独写插件。

因此，Cursor 团队如果提供了符合 ACP 标准的代理程序，你就能在 PyCharm 中像使用本地 AI 一样使用 Cursor 的能力。

二、如何在 PyCharm 中接入 Cursor AI

前置条件：
PyCharm2026.1 或更高版本（Pro / 免费版均可，但需要安装 AI Assistant 插件）
Cursor 编辑器（或至少 Cursor 的 ACP 代理程序 cursor-agent）
一个有效的 Cursor付费账号（ACP 方式需要付费订阅）

1. 准备工作：安装 Cursor CLI 工具

为了让 PyCharm 能找到并启动 Cursor 的 ACP 智能体，你需要在系统里安装cursor-agent命令行工具。

1）安装 cursor-agent
打开终端（macOS/Linux）或命令提示符（Windows），执行：

curlhttps://cursor.com/install-fsS|bash

安装完成后，将 ~/.local/bin 添加到 PATH 中（如果安装脚本没有自动完成的话）：

macOS / Linux (zsh)：

echo'export PATH="$HOME/.local/bin:$PATH"'>>~/.zshrcsource~/.zshrc

Linux (bash)：

echo'export PATH="$HOME/.local/bin:$PATH"'>>~/.bashrcsource~/.bashrc

验证是否安装成功：

cursor-agent--version# 或者agent--version

如果看到版本号，说明安装成功。

2）可选：通过 Cursor 编辑器安装 Shell 命令
如果你已经安装了 Cursor 桌面版，也可以直接在 Cursor 中按Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Shell Command，选择Shell Command: Install 'cursor' command in PATH。这会自动将 cursor 和 cursor-agent 命令添加到环境变量中。