IntelliJ IDEA 集成 DeepSeek：Claude Code + ACP 实战

DeepSeek 目前没有官方的 IntelliJ IDEA 插件，但它提供了不少接入第三方 AI 工具的方式，比如 Claude Code、OpenCode 等。本文走 Claude Code 接入路线，配合 JetBrains 官方的 AI Assistant 插件和 ACP 协议，把 DeepSeek 变成 IDEA 里的编程助手。

核心概念先搞清楚

DeepSeek

DeepSeek 是国产大模型厂商，提供兼容 Anthropic 协议的 API 端点（https://api.deepseek.com/anthropic），因此凡是支持 Anthropic 协议的客户端（如 Claude Code）都能通过环境变量直接接入，这也是本文不需要等待官方插件的原因。

AI Assistant 插件

AI Assistant 是 JetBrains 官方推出的 AI 助手插件，集成在 IDEA 中提供 AI 聊天、代码补全、代码审查等能力。它原生支持官方模型，同时也开放了 Add Custom Agent 入口，允许接入第三方模型服务。

ACP（Agent Client Protocol）

ACP 全称 Agent Client Protocol，是一套开放协议，目标是让任何 AI 编码 Agent 都能接入任何编辑器：Agent 侧实现 ACP 服务，编辑器侧通过标准协议与之通信，两者解耦。claude-code-acp 就是 Claude Code 官方提供的 ACP 实现，IDEA 的 Custom Agent 正是通过它把 Claude Code（以及背后接的 DeepSeek）拉进编辑器。

安装 AI Assistant 插件

在 IDEA 的插件市场搜索 AI Assistant 并安装：

安装 AI Assistant 插件

安装成功后，界面上会出现 AI 操作的入口（右侧 AI 面板或右键菜单）：

AI 操作入口

DeepSeek 接入 Claude Code

先让 Claude Code 本身能正常使用 DeepSeek，官方文档见：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code

Linux / Mac 用户的核心配置（写入 shell 配置文件或每次启动前执行）：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432

关键变量说明：

变量	含义
`ANTHROPIC_BASE_URL`	把 Claude Code 的 API 地址指向 DeepSeek 的 Anthropic 兼容端点
`ANTHROPIC_AUTH_TOKEN`	你的 DeepSeek API Key
`ANTHROPIC_MODEL`	默认使用的模型，`deepseek-v4-pro` 为主力模型，`[1m]` 表示百万级上下文窗口
`ANTHROPIC_DEFAULT_*_MODEL`	把 Claude 的 Opus / Sonnet / Haiku 档位映射到 DeepSeek 对应模型
`CLAUDE_CODE_SUBAGENT_MODEL`	子任务（subagent）使用的模型，这里用更快的 `deepseek-v4-flash`
`CLAUDE_CODE_EFFORT_LEVEL`	推理强度，max 表示最高
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	自动压缩上下文窗口的阈值（token 数）

配置完成后启动 claude，在命令行里确认能正常使用 DeepSeek 的模型，再进行下一步。

安装 claude-code-acp

ACP 全称 Agent Client Protocol，是一套协议：让任何 AI 编码 Agent 都能接入任何编辑器。安装 Claude Code 的 ACP 实现：

1	npm install -g @zed-industries/claude-code-acp

安装完成后查看安装位置：

1	where claude-code-acp

记录这个路径，后面配置会用到。例如 xxx/versions/node/v24.19.0/bin/claude-code-acp。

在 IDEA 中添加自定义 Agent

点击 AI Chat 面板里的 Add Custom Agent，会弹出 acp.json 配置文件：

Add Custom Agent 配置界面

在 acp.json 中把 command 配置为第 3 步获取的真实路径：

{
  "default_mcp_settings": {},
  "agent_servers": {
    "deepseek": {
      "command": "xxx/versions/node/v24.19.0/bin/claude-code-acp",
      "args": [
        "acp"
      ],
      "env": {
      }
    }
  }
}

配置项说明：

配置项	含义
`agent_servers.deepseek`	自定义 Agent 名称，IDEA 里会显示这个名字
`command`	claude-code-acp 的真实路径（`where claude-code-acp` 的结果）
`args`	固定传 `acp`，表示以 ACP 服务模式启动
`env`	可选的附加环境变量，按需补充

使用 DeepSeek

配置完成后，在 AI Chat 面板选择刚才添加的 deepseek Agent，就可以在 IDEA 里直接和 DeepSeek 对话、让它读代码、生成修改建议：

在 IDEA 中使用 DeepSeek

常见问题

command 必须替换成真实路径：acp.json 里不能直接写 claude-code-acp 或示例路径，要用 where claude-code-acp 输出的完整路径；
环境变量不生效：DeepSeek 的 ANTHROPIC_* 变量是在终端里 export 的，IDEA 不一定继承；可以把它们写进 acp.json 的 env 字段，最稳妥；
先验证 Claude Code 再进 IDEA：第 2 步的终端验证能通过，再折腾 ACP 配置，能少走弯路；
模型名对不上：确保 ANTHROPIC_MODEL 等变量里的模型名和 DeepSeek API 实际支持的模型名一致。