引言

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

前置条件：

• PyCharm 2026.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），执行：

curl https://cursor.com/install -fsS | bash

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

• macOS / Linux (zsh)：

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

• Linux (bash)：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.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 命令添加到环境变量中。

2.在 PyCharm 中配置 Cursor ACP 代理

2.1 确认 PyCharm 版本

打开 PyCharm，进入 PyCharm → About（macOS）或 Help → About（Windows/Linux），确保版本号 ≥ 2026.1。如果低于此版本，请先升级。

2.2 安装 AI Assistant 插件（如果尚未安装）

1. 打开 Settings → Plugins。
2. 搜索 AI Assistant，点击安装。
3. 重启 PyCharm。

2.3 添加 Cursor 代理

1. 【AI聊天】>【…】>【设置】 2. 【设置】>【工具】>【AI Assistant】>【代理】-选择安装智能体

---

三、PyCharm中安装其他AI插件（扩展）

（一）通义灵码

1. PyCharm插件市场搜索 Tongyi Lingma安装
2. 根据提示登录阿里云账号
   
   

参考资料

• https://www.jetbrains.com.cn/acp/
• https://agentclientprotocol.com/get-started/introduction