平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“IntelliJ IDEA AI Assistant 携带OpenCod……”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

01 引言

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

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

02 安装

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

2.1 安装后无法采用

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

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

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

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

C:Users{user.name}AppDataLocalJetBrainsacp-agents.downloadsopencode

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

2.2 测试

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

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

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

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

修复效果：

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

03 接入本地客户端

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

3.1 查看安装位置

# windows环境
where opencode

3.2 本地设置

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

默认只为：

{"default_mcp_settings":{}}

我们需设置如下所示内容：

{
  "default_mcp_settings": {
    "use_idea_mcp": true,     // 是否启用 IDE 内置 MCP
    "use_custom_mcp": true    // 是否启用自定义 MCP
  },
  "agent_servers": {
    "你的代理名称": {
      "command": "E:installnpmopencode.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客户端大同小异，感兴趣的老铁快去试试吧。

实际处理时，总的来说，idea ai assistant携带opencode适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。