引言
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 命令添加到环境变量中。
2.在 PyCharm 中配置 Cursor ACP 代理
2.1 确认 PyCharm 版本
打开 PyCharm，进入PyCharm→About（macOS）或 Help → About（Windows/Linux），确保版本号 ≥ 2026.1。如果低于此版本，请先升级。
2.2 安装 AI Assistant 插件（如果尚未安装）
- 打开
Settings→Plugins。 - 搜索
AI Assistant，点击安装。 - 重启 PyCharm。
2.3 添加 Cursor 代理
- 【AI聊天】>【…】>【设置】
2. 【设置】>【工具】>【AI Assistant】>【代理】-选择安装智能体
三、PyCharm中安装其他AI插件（扩展）
（一）通义灵码
- PyCharm插件市场搜索
Tongyi Lingma安装 - 根据提示登录阿里云账号
参考资料
- https://www.jetbrains.com.cn/acp/
- https://agentclientprotocol.com/get-started/introduction
