JetBrains IDEs

JetBrains IDE 通过 Agent Client Protocol (ACP) 为 AI 编程助手提供原生支持。该集成允许你在 JetBrains IDE 中直接使用 Qwen Code，并获取实时代码建议。

功能特性

• 原生 Agent 体验：在 JetBrains IDE 中集成 AI 助手面板
• Agent Client Protocol：完整支持 ACP，实现高级 IDE 交互
• 符号管理：使用 # 提及文件，将其添加到对话上下文中
• 对话历史：在 IDE 内访问历史对话记录

环境要求

• 支持 ACP 的 JetBrains IDE（如 IntelliJ IDEA、WebStorm、PyCharm 等）
• 已安装 Qwen Code CLI

安装

从 ACP Registry 安装（推荐）

1. 安装 Qwen Code CLI：

   npm install -g @qwen-code/qwen-code

2. 打开 JetBrains IDE，导航至 AI Chat 工具窗口。

3. 点击 Add ACP Agent，然后点击 Install。

   

   对于使用 JetBrains AI Assistant 和/或其他 ACP Agent 的用户，请在 Agents List 中点击 Install From ACP Registry，然后安装 Qwen Code ACP。

   

4. 此时，Qwen Code Agent 应已出现在 AI Assistant 面板中。

   

手动安装（适用于旧版 JetBrains IDE）

1. 安装 Qwen Code CLI：

   npm install -g @qwen-code/qwen-code

2. 打开 JetBrains IDE，导航至 AI Chat 工具窗口。

3. 点击右上角的三点菜单，选择 Configure ACP Agent，并使用以下设置配置 Qwen Code：

{
  "agent_servers": {
    "qwen": {
      "command": "/path/to/qwen",
      "args": ["--acp"],
      "env": {}
    }
  }
}

4. 此时，Qwen Code Agent 应已出现在 AI Assistant 面板中。

故障排查

Agent 未显示

• 在终端中运行 qwen --version 验证安装是否成功
• 确保你的 JetBrains IDE 版本支持 ACP
• 重启 JetBrains IDE

Qwen Code 无响应

• 检查网络连接
• 在终端中运行 qwen 验证 CLI 是否正常工作
• 如果问题仍然存在，请 在 GitHub 上提交 Issue