IntelliJ IDEA AI Assistant 携带OpenCode保姆级安装教程来了

01 引言

AI Assistant 是 JetBrains 官方推出的 AI 驱动插件，专为软件开发设计。但是之前由于需要订阅才能使用，安装了之后又卸载了。

上一节简单介绍了一下IDEA 2026.1的简单功能，没有实际使用AI Assistant推出的ACP自定义模型。本节将通过安装opencode了解其使用过程。

02 安装

安装上一节已经介绍了，这里不在赘述。但是在安装过程中可能会出现一些问题。

2.1 安装后无法使用

明显显示已经安安装好了，几乎秒级安装，怎么感觉都有点离谱。

但是在对话框无法使用，无法发出信息，也没有选择模型的地方。

其实这个时候是后台在下载opencode的安装包，只不过界面没有明确的提示。可能由于网络原因下载失败，导致对话框无法使用。如果有网络原因，也可以从GitHub手动下载。

真正下载完成之后保存的位置：

C:\Users\{user.name}\AppData\Local\JetBrains\acp-agents\.downloads\opencode

重启IDEA编辑器，就会发现正常了。可以选择模式以及模型

2.2 测试

我们选择免费的模型测试一下：Qwen3.6 Plus

到这里基本就安装成功了。

我们在是是一下能不能改页面。恰好有个页面中文乱码，我们让他修复一下。

我们先通过plan模式分析，没有问题了在修改。

修复效果：

修复过程中文件的变动，IDEA没有像Qoder等一样提示用户页面的修改位置以及修复前后对比。

03 接入本地客户端

上面介绍了在线安装的方法。但是我本地已经使用npm的方式安装了opencode，能不能直接使用呢？

3.1 查看安装位置

bash 复制代码

# windows环境
where opencode

3.2 本地配置

在AI Chat->设置->add custom agent中，就会打开acp.json。

默认只为：

json 复制代码

{"default_mcp_settings":{}}

我们需要配置如下内容：

json 复制代码

{
  "default_mcp_settings": {
    "use_idea_mcp": true,     // 是否启用 IDE 内置 MCP
    "use_custom_mcp": true    // 是否启用自定义 MCP
  },
  "agent_servers": {
    "你的代理名称": {
      "command": "E:\install\npm\opencode.cmd",  // 如 "opencode", "python", "node" 等
      "args": ["acp"]       // 如 ["acp"] 或 ["run", "--mode=agent"]
    }
  }
}

字段解释

default_mcp_settings - MCP (Model Context Protocol) 默认设置

use_idea_mcp: true 表示启用 JetBrains 内置的 MCP 服务，让 AI 代理可以访问 IDE 功能（如代码搜索、文件操作等）
use_custom_mcp: true 表示允许使用自定义的 MCP 服务配置
agent_servers - 定义可用的 AI 代理服务器

OpenCode: 代理服务器名称（可自定义）

command: 启动代理的命令路径，这里是 OpenCode 的可执行文件路径
args: 启动参数， $"acp"$ 表示以 ACP 模式运行

文件地址：C:\Users\{user.name}\.jetbrains

3.3 测试

没有问题。

由于OpenCode高版本中，必须登录之后才能使用，如果初次使用需要认证输入Api Key，这个自行申请即可。

04 小结

其他的AI客户端大同小异，感兴趣的老铁快去试试吧。