用了一段時(shí)間 Claude Code，最大的問(wèn)題是我一直沒(méi)離開(kāi)過(guò)終端窗口。

寫(xiě)著寫(xiě)著要切回 IDEA 看報(bào)錯(cuò)，看完再切回終端告訴 Claude，Claude 改完我再切回去確認(rèn)——這個(gè)來(lái)回，每天少說(shuō)要折騰幾十次，心態(tài)容易崩。

IntelliJ IDEA 2026.1 發(fā)布的時(shí)候我第一時(shí)間更新了，理由只有一個(gè)：它把 Claude Code 這件事給做進(jìn)來(lái)了。

但接的方式有兩種，文檔說(shuō)得輕描淡寫(xiě)，實(shí)際配完你才知道差別很大。這篇我從底層講到實(shí)戰(zhàn)，14 張圖對(duì)應(yīng)每一個(gè)關(guān)鍵步驟，順著走一遍就能搞定。

先搞清楚：IDEA 里的 Claude 不止一個(gè)

很多人沒(méi)想明白這件事就動(dòng)手配了，結(jié)果搞混，這里先厘清。

IDEA 2026.1 里實(shí)際上可以同時(shí)存在三種 Claude 入口：

① JetBrains 內(nèi)置 Claude Agent——JetBrains 自己買(mǎi)的調(diào)用權(quán)，走 JetBrains AI 訂閱配額，跟你的 Claude 賬號(hào)沒(méi)有任何關(guān)系。

② Claude Code 官方插件——Anthropic 在 JetBrains Marketplace 發(fā)的官方插件，走你的 Claude 賬號(hào)，在 IDEA 內(nèi)置終端里運(yùn)行，插件負(fù)責(zé)橋接終端和編輯器。

③ Claude Code via ACP——通過(guò) ACP 協(xié)議接入，不需要開(kāi)終端，在 AI Chat 面板里直接對(duì)話，支持完整 MCP 工具鏈。

三者并不互斥，我現(xiàn)在同時(shí)用②和③，按任務(wù)類型切換。

方式一：官方插件，5 分鐘裝好

第一步：安裝 Claude Code CLI

打開(kāi)終端，執(zhí)行：

npm install -g @anthropic-ai/claude-code

裝完驗(yàn)證：

claude --version

第二步：安裝 IDEA 插件

進(jìn)入 Settings → Plugins → Marketplace，搜索：

Claude Code

找到 **Claude Code [Beta]**（開(kāi)發(fā)者顯示為 Anthropic），點(diǎn) Install，重啟 IDEA。

第三步：在 IDEA 內(nèi)置終端啟動(dòng)

點(diǎn)底部工具欄的 Terminal，在 IDEA 自己的終端里運(yùn)行：

claude

首次運(yùn)行會(huì)彈瀏覽器引導(dǎo)你授權(quán) Claude 賬號(hào)，完成后回到 IDEA，插件全部功能激活。

注意一定要在 IDEA 的內(nèi)置終端里啟動(dòng)，在外部終端啟動(dòng)插件檢測(cè)不到，功能不會(huì)激活。

插件給你帶來(lái)什么

除了快捷鍵，插件還有兩個(gè)被動(dòng)能力：當(dāng)前選中代碼和當(dāng)前 Tab 自動(dòng)同步給 Claude；編輯器里的 lint 錯(cuò)誤、語(yǔ)法錯(cuò)誤實(shí)時(shí)傳遞給 Claude，你不需要手動(dòng)復(fù)制粘貼報(bào)錯(cuò)。

Claude 改完的代碼不在終端里展示，而是在 IDEA 自己的 Diff Viewer 里——左邊原來(lái)的，右邊改后的，Accept / Reject 都在這里操作。

方式二：ACP 接入，才是真正的王炸

官方插件已經(jīng)好用，為什么還要講 ACP？

一句話：官方插件本質(zhì)上是在 IDEA 里嵌了一個(gè)終端會(huì)話，而 ACP 讓 Claude Code 成為 IDEA 原生的 AI Agent，兩者的集成深度完全不是一個(gè)量級(jí)。

最核心的差異在 MCP 工具鏈——ACP 方式接入后，你在 ~/.claude.json 里配過(guò)的所有 MCP Server，在 IDEA 的 AI Chat 面板里全部可用。連數(shù)據(jù)庫(kù)、訪問(wèn)文件系統(tǒng)、調(diào)外部 API，Claude 在 Chat 面板里直接能做到。

ACP 是什么

ACP（Agent Client Protocol），由 Zed Industries 主導(dǎo)、JetBrains 和 Anthropic 共同參與制定的開(kāi)放協(xié)議。目標(biāo)是讓任何 AI Agent 都能接入任何編輯器，不用各自單獨(dú)造適配器。

類比一下：LSP 統(tǒng)一了語(yǔ)言服務(wù)（寫(xiě)了一個(gè) Java Language Server，VS Code、IDEA、Vim 都能用），ACP 做的是同一件事，只不過(guò)統(tǒng)一的是 AI Agent 的接入方式。

底層走 JSON-RPC 2.0，Agent 作為獨(dú)立進(jìn)程運(yùn)行，IDEA 通過(guò) stdin/stdout 和它通信。Agent 是獨(dú)立進(jìn)程不是插件，這意味著 Claude Code 的版本升級(jí)完全不依賴 IDEA 插件的更新節(jié)奏，兩邊解耦。

第一步：安裝 ACP 適配器

Zed 官方提供了一個(gè)橋接包，把 Claude Code 包成符合 ACP 協(xié)議的 Server：

# npm
npm install -g @zed-industries/claude-code-acp
# pnpm（推薦）
pnpm add -g @zed-industries/claude-code-acp

裝完確認(rèn)可執(zhí)行文件路徑（后面配置要用）：

# npm
npm bin -g
# pnpm
pnpm bin -g

第二步：打開(kāi) acp.json 配置入口

在 IDEA 里：打開(kāi) AI Chat 面板 → 右上角三點(diǎn)菜單 → 「配置 ACP 智能體」。

IDEA 會(huì)自動(dòng)打開(kāi)或創(chuàng)建 ~/.jetbrains/acp.json。

第三步：填寫(xiě) acp.json

把文件內(nèi)容替換成：

{
  "default_mcp_settings": {},
  "agent_servers": {
    "Claude Code": {
      "command": "npx",
      "args": ["@zed-industries/claude-code-acp"],
      "env": {
        "ACP_PERMISSION_MODE": "bypassPermissions"
      },
      "use_idea_mcp": true,
      "use_custom_mcp": true
    }
  }
}

command按系統(tǒng)和包管理器調(diào)整：

# Mac + npm
"command": "npx"
# Mac + pnpm（推薦寫(xiě)絕對(duì)路徑，穩(wěn)定）
"command": "/Users/你的用戶名/Library/pnpm/claude-code-acp"
# Windows（必須用 npx.cmd，不是 npx）
"command": "npx.cmd"

Windows 這里是一個(gè)高頻踩坑點(diǎn)：用 npx 會(huì)報(bào) IOException: Cannot run program "npx"，必須改成 npx.cmd。

第四步：選擇 Claude Code

保存 acp.json 后，回到 AI Chat 面板，點(diǎn)模型/Agent 下拉框，Claude Code 會(huì)出現(xiàn)在列表里，選中即可開(kāi)始對(duì)話。

重點(diǎn)：兩個(gè)參數(shù)，很多人沒(méi)搞懂

use_custom_mcp——把你已有的 MCP 工具全帶進(jìn)來(lái)

這個(gè)參數(shù)設(shè)為 true 后，Claude Code 會(huì)讀取你 ~/.claude.json 里已配置的所有 MCP Server，在 IDEA 的 AI Chat 里全部可用。

比如你之前給 Claude Code 配了數(shù)據(jù)庫(kù)和文件系統(tǒng)的 MCP：

// ~/.claude.json（你之前配好的，無(wú)需改動(dòng)）
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRESQL_CONNECTION_STRING": "postgresql://localhost/mydb"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/你的項(xiàng)目目錄"]
    }
  }
}

開(kāi)了 use_custom_mcp: true，這些工具在 IDEA 的 AI Chat 里全部激活，你可以直接用自然語(yǔ)言操作數(shù)據(jù)庫(kù)、讀寫(xiě)文件，不用切任何工具。

use_idea_mcp——有一個(gè)副作用要知道

這個(gè)參數(shù)開(kāi)啟后，IDEA 會(huì)把自己的 MCP Server 暴露給 Claude Code，Claude 因此能調(diào)用 IDEA 的內(nèi)部能力：查看運(yùn)行時(shí)變量、分析調(diào)用棧、執(zhí)行調(diào)試命令等等。

聽(tīng)起來(lái)很強(qiáng)，但有一個(gè)副作用：IDEA 的 MCP 配置會(huì)被寫(xiě)入你的 ~/.claude.json，而這是全局配置。

后果是：你在其他地方用 Claude Code（比如終端直接跑 claude，或者在 VS Code 里）時(shí)，IDEA 的 MCP 工具描述也會(huì)被加載進(jìn)上下文——足足 10.7K Token 的 IDEA 內(nèi)部工具，對(duì)那些場(chǎng)景完全是噪音，白白占用上下文窗口。

我的建議：

• 只用 IDEA 一個(gè)編輯器 → use_idea_mcp: true，享受完整能力
• 多編輯器混用 → use_idea_mcp: false，避免全局污染

// 多編輯器用戶推薦配置
{
  "agent_servers": {
    "Claude Code": {
      "command": "npx",
      "args": ["@zed-industries/claude-code-acp"],
      "env": { "ACP_PERMISSION_MODE": "bypassPermissions" },
      "use_idea_mcp": false,
      "use_custom_mcp": true
    }
  }
}

進(jìn)階：同時(shí)接入多個(gè) Agent，隨時(shí)切換

agent_servers 支持配多個(gè)，Claude Code 和 Codex 可以同時(shí)在列：

{
  "agent_servers": {
    "Claude Code": {
      "command": "npx",
      "args": ["@zed-industries/claude-code-acp"],
      "env": { "ACP_PERMISSION_MODE": "bypassPermissions" },
      "use_idea_mcp": false,
      "use_custom_mcp": true
    },
    "Codex": {
      "command": "npx.cmd",
      "args": ["@zed-industries/codex-acp"],
      "env": { "OPENAI_API_KEY": "你的Key" }
    }
  }
}

進(jìn)階：Claude 直連數(shù)據(jù)庫(kù)，不開(kāi)任何工具

IDEA 2026.1 新增了數(shù)據(jù)庫(kù)直連能力——如果你在 IDEA Database 面板里配過(guò)數(shù)據(jù)庫(kù)連接，開(kāi)啟 use_idea_mcp 后，Claude 可以直接在 AI Chat 里查詢，不用再單獨(dú)配數(shù)據(jù)庫(kù) MCP。

實(shí)際對(duì)話是這樣的：

我：幫我看一下 orders 表里狀態(tài)是 PENDING 且創(chuàng)建超過(guò) 24 小時(shí)的記錄有多少條

Claude：我來(lái)查詢一下……SELECT COUNT(*) FROM orders WHERE status = 'PENDING' AND created_at < NOW() - INTERVAL '24 hours'

查詢結(jié)果：共 1,247 條

不切工具，不手寫(xiě) SQL，不開(kāi)數(shù)據(jù)庫(kù)客戶端。

我目前的完整配置

直接貼，可以抄：

{
  "default_mcp_settings": {},
  "agent_servers": {
    "Claude Code": {
      "command": "/Users/xxx/Library/pnpm/claude-code-acp",
      "env": {
        "ACP_PERMISSION_MODE": "bypassPermissions"
      },
      "use_idea_mcp": false,
      "use_custom_mcp": true
    }
  }
}

用的是 pnpm 安裝后的絕對(duì)路徑（比 npx 啟動(dòng)更快，沒(méi)有解析延遲），關(guān)掉了 use_idea_mcp（因?yàn)橥瑫r(shí)用 VS Code，不想污染全局配置），保留了 use_custom_mcp（~/.claude.json 里配了 filesystem 和 postgres 兩個(gè) MCP Server）。

常見(jiàn)問(wèn)題

Q：Mac 上不需要單獨(dú)裝 ACP 適配器包？對(duì)，macOS 上 Claude Code 可以直接通過(guò)內(nèi)置 Claude Agent 使用，不需要額外安裝 ACP 包。但如果你想用 ACP 方式接入 AI Chat 面板，還是需要裝適配器。

Q：Windows 上 npx 報(bào)錯(cuò)怎么辦？把 command 改成 "npx.cmd"，Windows 上 IDEA 無(wú)法識(shí)別不帶擴(kuò)展名的 npx。

Q：ACP 和官方插件能同時(shí)用嗎？可以，兩個(gè)完全獨(dú)立，互不影響。我自己就是同時(shí)裝的，小任務(wù)用官方插件快捷鍵，復(fù)雜任務(wù)開(kāi) ACP 的 AI Chat。

Q：devcontainer 里能用嗎？目前有已知 Bug，2026.1 的新 devcontainer 架構(gòu)不在容器內(nèi)運(yùn)行 JetBrains 后端進(jìn)程，Diff 查看等功能失效。本地項(xiàng)目正常使用不受影響。

工具配好了，王炸不王炸，用一周你自己就有答案。

到此這篇關(guān)于IDEA 2026.1 + Claude Code 使用全解析的文章就介紹到這了,更多相關(guān)IDEA Claude Code使用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論